2. 简介

部署环境检测工具覆盖软硬件多个关键维度，检测内容包括但不限于：

软件版本信息
- 设备固件版本
- 驱动版本
- SDK 版本
- Runtime 库版本
- 版本一致性校验
硬件与性能指标
- 芯片主频
- 实测算力
- DDR 读带宽
- DDR 写带宽
- PCIe Host 到 Device 传输带宽
- PCIe Device 到 Host 传输带宽

所有性能指标均基于实际运行测试获得，可真实反映当前系统配置、硬件状态及运行环境对性能的综合影响。

注意

该工具仅支持在后摩硬件设备上运行，无法在模拟器中执行。为确保在硬件平台上运行，请将环境变量设置为 export HDPL_PLATFORM=ASIC。

2.1. 特点

部署环境检测工具具备以下特点：

自动化程度高

工具可一键执行全部检测流程，无需用户手动配置测试参数。
结果直观明确

所有检测项均给出 PASS、WARN 或 FAIL 状态标识，并在必要时提供阈值说明，便于快速定位问题。
贴近实际部署场景

所有测试均在真实后摩硬件设备上执行，避免模拟环境与实际部署之间的偏差。
可作为环境基线参考

检测结果可用于记录和对比不同时间点、不同设备的部署环境状态，为性能分析和问题回溯提供依据。

3. 环境准备

3.1. 环境依赖

该工具支持平台如下：

Linux系统：
- Ubuntu 24.04（x86_64）
- Ubuntu 22.04（x86_64）
- Ubuntu 20.04（x86_64、AArch64）
Windows系统：
- Windows11
Android系统：
- 操作系统：Android 15 (API level 35)
- CPU 架构：arm64‑v8a
- 内核版本：Linux 6.1
- 开发调试工具：adb (Android Debug Bridge)
  
  注：adb 工具默认不随系统安装。

3.2. 运行环境

工具可在下面环境中运行：

软件平台Docker镜像：

（仅支持Linux系统）软件平台提供的 Docker 镜像已预置工具运行所需环境。有关Docker镜像的安装与部署，参看《后摩大道^® M50 软件平台快速入门》。
运行时开发工具包：

可使用运行时开发工具包 houmo_tcim_runtime_<target_hw>_${distro}_$arch-<release>.tar.gz。详情参看《后摩大道^® M50 TCIM用户手册》。

3.3. Linux环境准备

工具使用前，执行下面指令配置运行环境：

下载应用开发示例包。该工具位于应用开发示例包 houmo-examples_<release>.zip 中 houmo-examples-xh2/tools/hm_check 目录下。
将应用开发示例包拷贝到可运行环境。
在 houmo-examples-xh2 目录下，执行下面命令编译：
```
cd tools/hm_check
./build_linux.sh -b build -c Release -j 8 --install
```
编译完成后，生成 hm-check 可执行文件，位于 build 目录下。
设置环境变量。

工具启动时会检查 cmake 是否已加入 PATH 环境变量中，并解析 TCIM Runtime 与 Houmo SDK 的安装路径。默认情况下，工具优先使用环境变量 TCIM_RUNTIME_PATH 和 HOUMO_SDK_PATH 指定的路径。
- 如果上述环境变量未设置，脚本会尝试在常见安装路径（例如 /opt/tcim、/usr/local/tcim 等）中自动检测。
- 若仍未检测到有效路径，用户需要通过命令行参数 --tcim 与 --houmo，或通过设置对应环境变量的方式显式提供路径，否则工具将无法继续执行检测流程。

详情参看 houmo-examples-xh2/tools/hm_check/README.md。

3.4. Android环境准备

工具使用前，执行下面指令配置运行环境：

Android设备端环境准备：配置最新版本Andorid驱动和固件镜像，详情参看《后摩大道^® M50 软件平台驱动安装指南》和《后摩大道^® M50 HmUpdateTool 工具使用指南》。
主机端，设置Android NDK。
1. 下载官方Android NDK 软件包。该工具仅在 android-ndk-r28c 版本上验证通过。如使用其他版本，请根据实际环境进行适配。
2. 设置 NDK_PATH 环境变量，指向 Android NDK 软件包的解压路径。
主机端，配置应用开发示例：
1. 下载应用开发示例包。
2. 执行下面指令解压应用开发示例包。
```
unzip houmo-examples-<targe_hw>_<release>.zip
```
  解压后为 houmo-examples-xh2/ 文件夹。
3. 设置环境变量：
```
cd houmo-examples-xh2
souce env.sh
```
主机端，配置Andorid 驱动：
1. 下载新版本 Andorid 驱动安装包。
  1. 登录后摩开发者社区。
  2. 在 请先选择板级类别 下拉列表中选择使用的后摩板级产品。
  3. 在版本列表中选择下载的版本号，再在 AI模型类别筛选器 、平台架构筛选器 、操作系统筛选器 下拉菜单中分别选择AI模型类型、平台架构和操作系统，找到资源名为芯片驱动的下载资源，选中该资源左边复选框。
  4. 点击 直接下载、wget链接、批量直接下载 或 wget批量下载 按钮，下载驱动安装包。
2. 执行下面指令解压驱动安装包。
```
tar -xzf houmo-drv-<targe_hw>_<release>_android_$arch.tar.gz
```
  解压后为 houmo-drv-xh2。
3. 设置 HOUMO_SDK_PATH 环境变量，指向驱动安装包的解压路径，示例如下：
```
export HOUMO_SDK_PATH=/home/houmo-drv-xh2
```
主机端，配置运行时开发工具包：
1. 下载新版本运行时开发工具包。
  1. 登录后摩开发者社区。
  2. 在 请先选择板级类别 下拉列表中选择使用的后摩板级产品。
  3. 在版本列表中选择下载的版本号，再在 AI模型类别筛选器 、平台架构筛选器 、操作系统筛选器 下拉菜单中分别选择AI模型类型、平台架构和操作系统，找到资源名为Runtime SDK的下载资源，选中该资源左边复选框。
  4. 点击 直接下载、wget链接、批量直接下载 或 wget批量下载 按钮。
2. 执行下面指令解压运行时开发工具包。
```
tar -xzf houmo-tcim-runtime-<target_hw>_${distro}_$arch-<release>.tar.gz
```
  解压后为 houmo-tcim-runtime-xh2。
3. 设置 TCIM_RUNTIME_PATH 环境变量，指向运行时开发工具包的解压路径，示例如下：
```
export TCIM_RUNTIME_PATH=/home/houmo-tcim-runtime-xh2
```
在主机端，进入 houmo-examples-xh2/tools/hm_check 目录下，执行下面指令编译工具：
```
./build_android.sh
```
编译完成后，生成 hm_check 可执行文件，位于 tools/android 目录下。
在主机端，将生成的 hm_check 传输到Android设备的 /data/houmo 目录：
```
adb push hm_check /data/houmo
```
在主机端，将运行时开发工具包解压后文件夹 houmo-tcim-runtime-xh2 传输到Android设备的 /data/houmo 目录：
```
adb push houmo-tcim-runtime-xh2 /data/houmo
```
在主机端，通过 adb 进入Android设备开发板命令行，并获取 root 权限：
```
adb shell
su
```
在Android设备端，设置环境变量：
```
export TCIM_BACKEND=Xh2HalBackend
export TCIM_RUNTIME_PATH=$TCIM_RUNTIME
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/data/houmo/houmo-drv-xh2/hal/lib
```
其中 $TCIM_RUNTIME 为传输的运行时开发工具包的路径，如 /data/houmo/houmo-tcim-runtime-xh2。

工具启动时会检查 cmake 是否已加入 PATH 环境变量中，并解析 TCIM Runtime 与 Houmo SDK 的安装路径。默认情况下，工具优先使用环境变量 TCIM_RUNTIME_PATH 和 HOUMO_SDK_PATH 指定的路径。如果上述环境变量未设置，脚本会尝试在常见安装路径（例如 /opt/tcim、/usr/local/tcim 等）中自动检测。若仍未检测到有效路径，用户需要通过命令行参数 --tcim 与 --houmo，或通过设置对应环境变量的方式显式提供路径，否则工具将无法继续执行检测流程。

执行以上步骤后，即可在 Android 环境下使用 hm_check 工具。

详情参看 houmo-examples-xh2/tools/hm_check/README.md。

3.5. Windows环境准备

工具使用前，执行下面指令配置运行环境：

下载应用开发示例包。该工具位于应用开发示例包 houmo-examples_<release>.zip 中 houmo-examples-xh2\tools\hm_check 目录下。
将应用开发示例包拷贝到可运行环境。
使用 Windows环境部署工具部署环境。
打开命令行提示符窗口，执行下面命令编译：
```
cd houmo-examples-xh2\tools\hm_check
build_windows.bat
```
编译完成后，生成 hm-check.exe 可执行文件，位于 houmo-examples-xh2\tools\hm_check\build\Release 目录下。