跳到主要内容

Windows 平台支持

智核 DX-M1 / DX-M1M 支持 Windows 10 / 11 x64 平台。本页介绍驱动安装、运行时配置及应用示例,帮助你快速在 Windows 上使用 NPU 推理。

使用前提

  • 硬件:智核 DX-M1 或 DX-M1M 模组,已通过 PCIe / M.2 接口接入主机
  • 操作系统:Windows 10 或 Windows 11(x64)
  • 运行库Microsoft Visual C++ 2015-2022 Redistributable (x64)
  • 权限:管理员权限(驱动安装和服务注册需要)

驱动安装

智核 DX-M1 / DX-M1M 在 Windows 上通过 PCIe 接口通信,需安装配套驱动。

首先克隆 dx_rt_windows 仓库,后续步骤中的相对路径(如 m1\v3.2.0\...)均基于该仓库根目录:

git clone https://github.com/DEEPX-AI/dx_rt_windows.git
cd dx_rt_windows
  1. 进入 m1/v3.2.0/dxm1drv/ 目录
  2. 解压 dxm1drv.zip,得到 dxm1drv.infdxm1drv.sysdxm1drv.cat
  3. 右键点击 dxm1drv.inf,选择 安装
  4. 安装完成后,打开设备管理器,在 处理加速器 (Processing accelerators) 下应能看到 DEEPX DEVICE - M1 PCI CONTROLLER

运行时安装

驱动安装完成后,安装运行时守护进程。

  1. 以管理员身份打开 命令提示符 (cmd)PowerShell
  2. 进入运行时目录(以 v3.2.0 为例):
cd m1\v3.2.0\dx_rt\bin
  1. 注册并启动 DXRT 守护进程:
dxrtd.exe --install
dxrtd.exe --start

dxrtd.exe 注册为 Windows 服务后,系统启动时会自动运行。你也可以使用 services.msc 管理该服务。

版本选择

v3.2.0v3.3.1 使用相同的驱动,可按需选用。v3.2.0 提供完整的驱动 + 运行时 + 应用示例;v3.3.1 仅包含运行时。

设备验证

使用 dxrt-cli.exe 验证 NPU 设备是否正常识别:

dxrt-cli.exe -s

正常输出应显示设备信息,类似:

Device Information:
Device ID: 0
Device Name: DX-M1
Firmware Version: ...
Status: Ready

你也可以使用 dxtop.exe 实时监控 NPU 状态:

dxtop.exe

应用示例

演示应用(v3.0.2,推荐)

m1/v3.2.0/dx_app/v3.0.2/ 提供预编译的演示程序,涵盖目标检测、人脸识别、姿态估计、语义分割等任务。

  1. 首次使用需运行 m1/v3.2.0/dx_app/setup.bat 下载模型和示例视频
  2. 运行交互式菜单:
cd m1\v3.2.0\dx_app\v3.0.2
run_demo.bat
  1. 按菜单提示选择对应模型即可运行推理演示

常用模型包括 yolov5_syncyolov8_syncscrfd_syncefficientnet_sync 等,均提供同步 (_sync) 和异步 (_async) 两种模式。

Python 接口

安装 Python wheel 包后可直接在 Python 中调用 NPU:

# 根据 Python 版本选择对应的 wheel(支持 Python 3.10 ~ 3.14)
pip install m1\v3.2.0\dx_rt\python\dx_engine-1.1.4-cp312-cp312-win_amd64.whl

Python CLI 推理示例:

python m1\v3.2.0\dx_rt\python\cli\run_model.py -m <model.dxnn> -l 100

Python API 调用示例:

from dx_engine import InferenceEngine

engine = InferenceEngine()
engine.load_model("model.dxnn")
engine.run()

故障排除

  • 设备管理器中看不到 DEEPX 设备:检查 PCIe / M.2 物理连接,确认模组已正确插入。尝试重新扫描硬件(devmgmt.msc → 操作 → 扫描检测硬件改动)。
  • dxrt-cli.exe -s 报错:确认 dxrtd.exe 已启动(services.msc 中查看 DXRT Daemon 服务状态)。
  • 运行 demo 无输出:确认已执行 setup.bat 下载模型和视频文件,网络需能访问 sdk.deepx.ai
  • VC++ 报错:确认已安装 Microsoft Visual C++ 2015-2022 Redistributable (x64)。

    您需要登录 GitHub 才能发表评论。如果您已登录,请忽略此消息。

    Radxa-docs © 2026 by Radxa Computer (Shenzhen) Co.,Ltd. is licensed under CC BY 4.0