# Windows 驱动安装（Beta）

## 环境准备

### 版本要求

| Windows | 版本    |
| ------- | ------- |
| 10      | 22H2    |
| 11      | >= 23H2 |

:::{note}

- **Win+R**，输入**winver**，可以查询当前的Windows版本信息。
- 仅支持Win10 64位和Win11 64位系统。
- **Win+I** 打开**设置** > **更新和安全** > **Windows更新**，自动更新Windows版本，Window10推荐用 [微软更新助手](https://www.microsoft.com/zh-cn/software-download/windows10) 更新到22H2版本。
- 关闭系统睡眠功能：**Win+I** 打开**设置** > **系统** > **电源和睡眠** > 将**睡眠**更改为**从不**。

:::

### 环境准备

1. 建议关闭防护软件，避免被误杀。
2. 下载VS2022的运行时库**VC_redist.x64.exe**，[微软下载链接](https://aka.ms/vs/17/release/vc_redist.x64.exe)，管理员权限**安装**VC_redist.x64.exe。
3. **关机断电**后将设备接入主板，**不能带电操作**。
4. 开机后在**Win+R**, 输入**devmgmt.msc** ，打开**设备管理器**，在**其他设备**中应能识别未知的**多媒体视频控制器**，通过**属性**可以确认设备VENDOR 是1F4B。
   ![](../res/ax650_win64_drv_uninstall.png)



## 安装

> 安装和卸载都需要管理员权限，需关闭系统睡眠功能。
>
> 如果系统已经安装AXCL旧版本，请先卸载！

1. Windows发布包 `axcl_win64_setup_Vx.x.x_yyyymmdd_NOxxxx.exe` 会自动安装驱动、动态链接库（含导入库）、可执行程序(比如axcl-smi.exe等)和sample示例源码，**管理员权限**运行发布包，按照提示安装即可。
2. 安装完之后请**重启系统**。
3. 重启后**Win+R**，输入**devmgmt.msc** ，打开**设备管理器**，在**系统设备**中应能发现**Axera NPU Accelerator Device**设备，如下图所示。
   ![](../res/ax650_win64_drv_installed.png)
4. 进入安装路径`AXCL\axcl\out\axcl_win_x64\bin`目录，在Windows Terminal中执行**axcl-smi.exe**，显示如下：
   ![](../res/ax650_win64_smi.png)
5. 完成。

> [安装视频](../res/ax650_win64_install.mp4)

## 卸载
  **管理员权限**双击安装目录下的**uninst.exe**，按照提示卸载。



## 编译

### 环境依赖

AXCL Windows SDK使用VS2022 C++17工具链编译，所需的环境依赖如下：

- [Visual Studio Community 2022](https://visualstudio.microsoft.com/zh-hans/vs/) ，安装[参考官方文档](https://learn.microsoft.com/zh-cn/visualstudio/install/install-visual-studio?view=vs-2022)，必选的组件：**使用C++的桌面开发**。

  :::{note}

  ​	- VS2022 安装所需硬盘空间比较大，请保证留有足够大的硬盘空间。
   - 版本号为v17.14.15

  :::

- [cmake](https://cmake.org/download/) ，版本高于3.20

- [ninja](https://github.com/ninja-build/ninja/releases)，推荐v1.31.1。将ninja.exe的路径配置到**系统环境变量 > Path**。

- [Python3](https://www.python.org/downloads/)

### 环境检查

```
PS D:\code> cd "C:\Program Files (x86)\Microsoft Visual Studio\Installer"
PS C:\Program Files (x86)\Microsoft Visual Studio\Installer> .\vswhere.exe -latest -property catalog_productDisplayVersion
17.14.15 (September 2025)

PS D:\code> ninja --version
1.13.1
PS D:\code> cmake --version
cmake version 4.1.1

CMake suite maintained and supported by Kitware (kitware.com/cmake).

PS D:\code> python --version
Python 3.11.5
```

### 示例编译

**axcl\scripts\build_win64.cmd**，编译sample。

```
PS D:\code\axcl\axcl.win64\axcl\scripts> .\build_win64.cmd
Build started at: 16:48:05.96

Detected 12 physical CPU cores
Checking for Ninja build system...
Found Ninja version: 1.13.1
========================================
CMake Windows x64 Build Script
========================================
Parallel Jobs :  12
Build Type    :  Release
Build System  :  ninja
Project Root  :  D:\code\axcl\axcl.win64\axcl
CMake Source  :  D:\code\axcl\axcl.win64\axcl\cmake
Build Dir     :  D:\code\axcl\axcl.win64\axcl\build\out\axcl_win_x64
Install Dir   :  D:\code\axcl\axcl.win64\axcl\out\axcl_win_x64
========================================

Detecting Visual Studio / Build Tools...
Found: D:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat
Generator: Visual Studio 17 2022

Configuring Visual Studio build environment...
Visual Studio environment configured successfully.
Creating build directory...

Running CMake configuration...
Using Ninja build system
CMAKE command: cmake -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="D:\code\axcl\axcl.win64\axcl\out\axcl_win_x64" "D:\code\axcl\axcl.win64\axcl\cmake" -DCONFIG_BUILD_VERSION="V3.9.0"

-- The C compiler identification is MSVC 19.44.35217.0
-- The CXX compiler identification is MSVC 19.44.35217.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: D:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.44.35207/bin/Hostx64/x64/cl.exe - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: D:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.44.35207/bin/Hostx64/x64/cl.exe - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Socket communication disabled on Windows (ZMQ not available)
-- COMPILE_USER : jingxiaoping
-- BUILD_VERSION: V3.9.0
-- BUILD_FFMPEG : OFF
-- BSP PATH: D:/code/axcl/axcl.win64/axcl/3rdparty/bsp
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD - Failed
-- Looking for pthread_create in pthreads
-- Looking for pthread_create in pthreads - not found
-- Looking for pthread_create in pthread
-- Looking for pthread_create in pthread - not found
-- Found Threads: TRUE
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/logger/generated/axcl_logger_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_sample_memory_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_sample_runtime_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_sample_sys_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_run_usrworker_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_sample_dmadim_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_run_model_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_lite_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_ppl_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_sample_transcode_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_sample_hvcp_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_sample_vdec_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_ffmpeg_venc_version.rc (version: 3.9.0)
-- Configured Windows version file: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64/sample/generated/axcl_ffmpeg_vdec_version.rc (version: 3.9.0)
-- Configuring done (4.6s)
-- Generating done (0.2s)
-- Build files have been written to: D:/code/axcl/axcl.win64/axcl/build/out/axcl_win_x64

========================================
Building project (Release configuration)...
========================================
Using Ninja build system with 12 parallel jobs...
[96/96] Linking CXX executable out\axcl_ffmpeg_vdec.exe

========================================
Installing to D:\code\axcl\axcl.win64\axcl\out\axcl_win_x64...
========================================
[0/1] Install the project...-- Install configuration: "Release"
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/lib/libcJSON.lib
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libspdlog.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/ffmpeg.exe
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/ffplay.exe
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/ffprobe.exe
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libavcodec-61.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libavfilter-10.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libavformat-61.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libavutil-59.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libpostproc-58.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libswresample-5.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libswscale-8.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libiconv-2.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libva.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libva_win32.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libwinpthread-1.dll
-- Up-to-date: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/zlib1.dll
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/lib/libaxcl_logger.lib
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libaxcl_logger.dll
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_sample_memory.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_sample_runtime.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_sample_sys.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_run_usrworker.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_sample_dmadim.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_run_model.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/lib/libaxcl_lite.lib
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libaxcl_lite.dll
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/lib/libaxcl_ppl.lib
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/libaxcl_ppl.dll
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_sample_transcode.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_sample_hvcp.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_sample_vdec.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_ffmpeg_venc.exe
-- Installing: D:/code/axcl/axcl.win64/axcl/out/axcl_win_x64/bin/axcl_ffmpeg_vdec.exe


========================================
Build completed successfully
========================================
Build started : 16:48:05.96
Build ended   : 16:48:33.25
Build elapsed : 00:00:27.29
Build Version : V3.9.0
Build Type    : Release
Build System  : ninja
Generator     : Visual Studio 17 2022
Build Dir     : D:\code\axcl\axcl.win64\axcl\build\out\axcl_win_x64
Install Dir   : D:\code\axcl\axcl.win64\axcl\out\axcl_win_x64

Binaries and libraries have been installed to:
  D:\code\axcl\axcl.win64\axcl\out\axcl_win_x64
PS D:\code\axcl\axcl.win64\axcl\scripts>
```



## 应用开发

-  推荐使用**msvc17**(即VS2022)编译工具链，不推荐mingw
-  C++标准17
-  运行库链接/MD或者/MDd，不推荐/MT和/MTd

### 目录结构

#### 驱动

- 驱动axcl_pcie.sys：C:\Windows\System32\drivers
- 设备固件和命名路径：C:\\Windows\\System32\\drivers\ax650_card.pac  # 固定路径和文件名

#### AXCL

```
axcl
   |- 3rdparty                           # 第三方库
   |- build                              # build 编译输出目录
   |- cmake                              # cmake
   |- out                                # 编译install目录
        |- axcl_win_x64
                     |- bin              # axcl-smi.exe、sample和动态库
                     |- drv              # 驱动文件
                     |- include          # 头文件
                     |- lib              # 动态库导入库
   |- sample                             # 示例源码
   |- toolkit                            # 辅助类
```



## 辅助工具

> [Windows工具包](https://hf-mirror.com/AXERA-TECH/testdata-boxdemo/resolve/main/windows%20develop%20kits.zip)
>
> 建议右键复制链接地址，在浏览器新窗口下载。

1. Windows **lspci** : [pciutils-3.5.5-win64.zip](https://wiki.aixin-chip.com/download/attachments/220464657/pciutils-3.5.5-win64.zip?version=1&modificationDate=1758526243666&api=v2) (需管理员权限执行)

2. [RWEverything](https://rweverything.com/download/)（类似Linux devmem）

   - [Win11无法使用RWEverything的解决方法](https://zhuanlan.zhihu.com/p/681795421)： 在“**设置**”中搜索框输入“**内核**”，打开“**内核隔离**”页面，将“**内存完整性**”和“**易受攻击的驱动程序列表**”全部关闭，重启计算机
   - 如果仍然无法使用，在注册表 `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\CI\Config` 添加
     Key:  **VulnerableDriverBlocklistEnable** ,  **REG_DWORD**,  Value:  **1**

3. **md5**： `certutil.exe -hashfile yourfile MD5`

4. 关闭驱动签名验签（**仅驱动调试**）

   ```
   bcdedit /set testsigning on
   bcdedit /set nointegritychecks on
   ```



## FAQ

待补充