跳到主要内容

简介

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

  • 软件版本信息

    • 设备固件版本

    • 驱动版本

    • SDK 版本

    • Runtime 库版本

    • 版本一致性校验

  • 硬件与性能指标

    • 芯片主频

    • 实测算力

    • DDR 读带宽

    • DDR 写带宽

    • PCIe Host 到 Device 传输带宽

    • PCIe Device 到 Host 传输带宽

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

2.1. 特点​

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

  • 自动化程度高

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

  • 结果直观明确

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

  • 贴近实际部署场景

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

  • 可作为环境基线参考

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

3. 环境准备​

3.1. 环境依赖​

该工具支持平台如下：

  • Linux系统：

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镜像的安装与部署，参看 《快速入门指南》。

  • 运行时开发工具包：

可使用运行时开发工具包 houmo_tcim_runtime_<target_hw>_${distro}_$arch-<release>.tar.gz。详情参看 《TCIM用户指南》。

3.3. Linux环境准备​

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

  1. 下载应用开发示例包。该工具位于应用开发示例包 houmo-examples-<target_hw>_<release>.zip 中 houmo-examples-xh2/tools/hm_check 目录下。

  2. 将应用开发示例包拷贝到 可运行环境。

  3. 在 houmo-examples-xh2 目录下，执行下面命令编译：

cd tools/hm_check
./build_linux.sh -b build -c Release -j 8 --install

编译完成后，生成 hm-check 可执行文件，位于 build 目录下。

  1. 设置环境变量。

工具启动时会检查 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环境准备​

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

  1. Android设备端环境准备：配置最新版本Android驱动和固件镜像，详情参看《软件平台驱动安装指南》和 《HmUpdateTool工具使用指南》。

  2. 主机端，设置Android NDK。

    1. 下载官方Android NDK 软件包。该工具仅在 android-ndk-r28c 版本上验证通过。如使用其他版本，请根据实际环境进行适配。

    2. 设置 NDK_PATH 环境变量，指向 Android NDK 软件包的解压路径。

  3. 主机端，配置应用开发示例：

    1. 下载应用开发示例包。

    2. 执行下面指令解压应用开发示例包。

unzip houmo-examples-<targe_hw>_<release>.zip

解压后为 houmo-examples-xh2/ 文件夹。

 3. 设置环境变量：
cd houmo-examples-xh2
souce env.sh

  1. 主机端，配置Android驱动：

    1. 下载新版本Android驱动安装包。

      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. 下载新版本运行时开发工具包。

      1. 登录后摩开发者社区。

      2. 在 请先选择板级类别 下拉列表中选择使用的后摩板级产品。

      3. 在版本列表中选择下载的版本号，再在 AI模型类别筛选器 、平台架构筛选器 、操作系统筛选器 下拉菜单中分别选择AI模型类型、平台架构和操作系统，找到资源名为Runtime SDK 的下载资源，选中该资源左边复选框。

      4. 点击 直接下载 、wget链接 、批量直接下载 或 wget批量下载 按钮。

    2. 执行下面指令解压运行时开发工具包。

tar -xzf houmo-tcim-runtime-<target_hw>_<release>_${distro}_$arch.tar.gz

解压后为 houmo-tcim-runtime-xh2。

 3. 设置 `TCIM_RUNTIME_PATH` 环境变量，指向运行时开发工具包的解压路径，示例如下：
export TCIM_RUNTIME_PATH=/home/houmo-tcim-runtime-xh2
  1. 在主机端，进入 houmo-examples-xh2/tools/hm_check 目录下，执行下面指令编译工具：
./build_android.sh

编译完成后，生成 hm_check 可执行文件，位于 tools/android 目录下。

  1. 在主机端，将生成的 hm_check 传输到Android设备的 /data/houmo 目录：
adb push hm_check /data/houmo
  1. 在主机端，将运行时开发工具包解压后文件夹 houmo-tcim-runtime-xh2 传输到Android设备的 /data/houmo 目录：
adb push houmo-tcim-runtime-xh2 /data/houmo
  1. 在主机端，通过 adb 进入Android设备开发板命令行，并获取 root 权限：
adb shell
su
  1. 在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环境准备​

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

  1. 下载应用开发示例包。该工具位于应用开发示例包 houmo-examples-<target_hw>_<release>.zip 中 houmo-examples-xh2\tools\hm_check 目录下。

  2. 将应用开发示例包拷贝到 可运行环境。

  3. 使用 Windows环境部署工具 部署环境。

  4. 打开命令行提示符窗口，执行下面命令编译：

cd houmo-examples-xh2\tools\hm_check
build_windows.bat

编译完成后，生成 hm-check.exe 可执行文件，位于 houmo-examples-xh2\tools\hm_check\build\Release 目录下。