Skip to main content

Windows 环境配置

Windows版本的运行时开发工具包，提供Windows主机上模型推理的运行时开发环境。

工具包目录结构如下：

|--bin                    # TCIM runtime动态库文件
|--include                # 模型部署C++接口文件
|--python                 # 模型部署Python接口文件
|--lib                    # 用于链接动态链接库（DLL）的导入库
`--env.bat                # 环境设置

4.5.2.1. 限制说明​

由于不支持在Windows系统主机上编译模型，因此需要直接下载已编译后模型，或在Linux系统主机上完成模型编译后，再将编译好的模型文件拷贝到Windows系统主机上进行推理。

4.5.2.2. 使用依赖​

使用依赖如下：

  • Windows 11

  • Python 3.9至3.13

  • Loguru

  • CMake 3.16.3+

  • Visual Studio 2022 version 17.0

  • OpenCV（可选）

4.5.2.3. 环境准备​

执行下面步骤完成环境准备：

  1. 在Winidows系统主机端安装最新版本驱动。

详情参看 《软件平台驱动安装指南》。

  1. 在后摩设备端，烧写和升级Flash镜像。

详情参看 《HmUpdateTool 工具使用指南》。

  1. 下载运行时开发工具包：

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

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

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

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

  2. 检查并安装 使用依赖。

  3. 满足以下 Python 环境要求：

    1. 系统中已安装符合要求的 Python 版本，版本范围为3.9至3.13版本。

    2. Python 已正确配置到系统 PATH 中。可在命令提示符（cmd）中执行以下命令进行验证：

注意

不支持通过 py 启动器选择 Python 版本，请确保运行环境中不依赖 py 命令。

python --version

若输出的 Python 版本号符合要求，则表示环境配置正确。

 3. 当系统中存在多个 Python 解释器时，需将使用的 Python 安装目录调整到系统环境变量 `PATH` 列表的最前位置。修改完成后，需重新打开命令行窗口，使环境变量配置生效。

Python 命令最终调用的是 PATH 环境变量中排在最前的 Python 可执行文件。如果该解释器版本不符合要求，就会导致工具运行失败或行为异常。

可通过以下命令查看当前系统中可被找到的所有 Python 解释器路径：

where python

该命令会按 PATH 环境变量的搜索顺序依次输出 Python 解释器路径。

  1. 下载和配置Visual Studio C++生成工具。

    1. 下载方式如下：
    * 下载[社区版vs2022工具](https://aka.ms/vs/17/release/vs_community.exe)。

    * 下载[Visual Studio 2022官方版本](https://learn.microsoft.com/en-us/visualstudio/releases/2022/release-history)。
 2. 运行Visual Studio C++生成工具，勾选 **使用 C++ 的桌面开发** 工作负载，然后完成安装。

7. 安装运行时开发工具包。

执行下面指令安装运行时开发工具：

pip3 install houmo-tcim-runtime_<target_hw>_${distro}_$arch-<release>.tar.gz

  1. 下载开发样例包。

  2. 在命令提示符窗口中，设置环境变量。在 houmo-examples-xh2 目录下执行下面指令设置环境变量：

注意

必须使用管理员权限打开命令行提示符窗口。

 1. 清除历史环境变量设置：
env.bat --reset

指令执行过程中可能需要设置 HOUMO_SDK_PATH、CMAKE_PATH、OPENCV_PATH 等环境变量。

 2. 关闭命令行提示符窗口。

 3. 使用管理员权限打开命令行提示符窗口，设置环境变量：
env.bat --set

用户需要检查输出的Warning部分的路径是否正确。如果不正确需要自行删除。

 4. 关闭命令行提示符窗口。

10. 如果需要 运行开发样例，可在开发样例包中 houmo-examples_<release>\houmo-examples-xh2\tools\win_envs 目录下，运行下面指令安装其他依赖：

pip install -r requirements.txt

详情参看 houmo-examples-xh2\tools\win_envs\README.MD。