4.5.2. Windows 环境配置

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

工具包目录结构如下：

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

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. 环境准备

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

在后摩设备端，烧写和升级Flash镜像。详情参看《后摩大道 $^\circledR$ M50 HmUpdateTool 工具使用指南》。
在Linux系统主机端安装最新版本驱动。详情参看《后摩大道 $^\circledR$ M50 软件平台驱动安装指南》。
下载运行时开发工具包：
1. 登录后摩开发者社区。
2. 在 请先选择板级类别 下拉列表中选择使用的后摩板级产品。
3. 在版本列表中选择下载的版本号，再在 AI模型类别筛选器 、平台架构筛选器 、操作系统筛选器 下拉菜单中分别选择AI模型类型、平台架构和操作系统，找到资源名为Runtime SDK的下载资源，选中该资源左边复选框。
4. 点击 直接下载、wget链接、批量直接下载 或 wget批量下载 按钮。
检查并安装使用依赖。
满足以下 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 解释器路径。
下载和配置Visual Studio C++生成工具。
1. 下载方式如下：
  - 下载社区版vs2022工具。
  - 下载Visual Studio 2022官方版本。
2. 运行Visual Studio C++生成工具，勾选 使用 C++ 的桌面开发 工作负载，然后完成安装。
安装运行时开发工具包。

执行下面指令安装运行时开发工具：
```
pip3 install houmo-tcim-runtime_<target_hw>_${distro}_$arch-<release>.tar.gz
```
下载开发样例包。
在命令提示符窗口中，设置环境变量。在 houmo-examples-xh2 目录下执行下面指令设置环境变量：

注意

必须使用管理员权限打开命令行提示符窗口。
1. 清除历史环境变量设置：
  env.bat --reset
  指令执行过程中可能需要设置 HOUMO_SDK_PATH、CMAKE_PATH、OPENCV_PATH 等环境变量。
2. 关闭命令行提示符窗口。
3. 使用管理员权限打开命令行提示符窗口，设置环境变量：
  env.bat --set
  用户需要检查reset指令输出的Warning部分的路径是否正确。如果不正确需要自行删除。
4. 关闭命令行提示符窗口。
如果需要运行开发样例，可在开发样例包中 houmo-examples_<release>\houmo-examples\tools\win_envs 目录下，运行下面指令安装其他依赖：
```
pip install -r requirements.txt
```

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