安装NPU驱动固件

安装说明

• 首次安装场景：硬件设备刚出厂时未安装驱动，或者硬件设备前期安装过驱动固件但是当前已卸载，上述场景属于首次安装场景，需按照“驱动 > 固件”的顺序安装驱动固件。
• 覆盖安装场景：硬件设备前期安装过驱动固件且未卸载，当前要再次安装驱动固件，此场景属于覆盖安装场景，需按照“固件 > 驱动”的顺序安装固件驱动。

检查安装环境

在安装驱动固件前，建议按照以下检查项检查环境，确保驱动固件能正常安装。

确认操作系统和内核版本

在安装驱动前，需要用户确认现场操作系统和内核版本，从而确定是否需要安装驱动编译所需依赖。

uname -m && cat /etc/*release
uname -r

操作系统内核版本和对应的安装方式如表2~表4所示。

Atlas 300V Pro 视频解析卡不支持Kylin V10 SP2操作系统。

安装驱动固件

1. 以root用户登录服务器。
2. 创建驱动运行用户HwHiAiUser（运行驱动进程的用户），安装驱动时无需指定运行用户，默认即为HwHiAiUser。

   groupadd HwHiAiUser
   useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

   

   若用户后续需使用从AscendHub拉取的容器镜像，则请用户执行如下命令创建uid和gid为1000的驱动运行用户HwHiAiUser。

   groupadd -g 1000 HwHiAiUser
   useradd -g HwHiAiUser -u 1000 -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

   若回显如下信息，请参见创建uid和gid为1000的驱动运行用户HwHiAiUser失败解决。

   groupadd：GID '1000' already exists

3. 将驱动包和固件包上传到服务器任意目录如“/home”。
4. 进入驱动包和固件包所在目录，执行如下命令，增加驱动和固件包的可执行权限。
   • Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡

     chmod +x Ascend-hdk-xxx-npu-driver_23.0.rc3_linux-aarch64.run
     chmod +x Ascend-hdk-xxx-npu-firmware_7.0.0.5.242.run

   • Atlas 300I A2 推理卡

     chmod +x Ascend-hdk-xxx-npu-driver_23.0.rc3_linux-aarch64.run
     chmod +x Ascend-hdk-xxx-npu-firmware_6.4.0.4.220.run

5. 执行以下命令，完成驱动固件安装，软件包默认安装路径为“/usr/local/Ascend”。
   • 安装驱动
     执行以下命令，完成驱动安装。

     • Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡

       ./Ascend-hdk-xxx-npu-driver_23.0.rc3_linux-aarch64.run --full  --install-for-all

     • Atlas 300I A2 推理卡

       ./Ascend-hdk-xxx-npu-driver_23.0.rc3_linux-aarch64.run --full  --install-for-all

     若执行上述安装命令出现类似如下回显信息，请参见安装驱动固件报错解决。

     [ERROR]The list of missing tools: lspci,ifconfig,

     若系统出现如下关键回显信息，则表示驱动安装成功。

     Driver package installed successfully!

   • 安装固件
     执行以下命令，完成固件安装。

     • Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡

       ./Ascend-hdk-xxx-npu-firmware_7.0.0.5.242.run --full

     • Atlas 300I A2 推理卡

       ./Ascend-hdk-xxx-npu-firmware_6.4.0.4.220.run --full

     若系统出现如下关键回显信息，表示固件安装成功。

     Firmware package installed successfully! Reboot now or after driver installation for the installation/upgrade to take effect 

6. 执行reboot命令重启系统。
7. 执行npu-smi info查看驱动加载是否成功。
   若出现类似如下图所示回显信息，说明加载成功。否则，说明加载失败。请联系华为技术支持处理。

   • Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡

     

   • Atlas 300I A2 推理卡

     

升级MCU

MCU是推理卡带外管理模块，具备单板监测、故障上报等功能。出厂时推理卡已集成了初始版本，为了保障所有功能正常使用，请将MCU升级到配套版本。

本章内容主要介绍通过npu-smi工具升级MCU，npu-smi工具可以将单个推理卡的MCU升级到相应版本，如果配备了多个推理卡，需要逐个升级。

1. 将获取的zip包解压至本地文件夹，获取安装包。
   • Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡：Ascend-hdk-xxx-mcu_23.2.2.hpm。
   • Atlas 300I A2 推理卡：Ascend-hdk-xxx-mcu_23.2.8.hpm。

2. 以root用户登录服务器，将安装包上传至Linux系统任意目录下（如“/home”）。
3. 执行npu-smi info -l命令查询NPU ID（推理卡的设备编号）。
   回显类似如下信息：

           Card Count                     : 1
           NPU ID                     : 8
           Product Name                   : IT21DMPB01
           Serial Number                  : 033EFS10M8000087
           Chip Count                     : 4

4. 进入MCU软件包所在路径，执行如下命令启动升级。
   • Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡

     npu-smi upgrade -t mcu -i NPU ID -f Ascend-hdk-xxx-mcu_23.2.2.hpm

   • Atlas 300I A2 推理卡

     npu-smi upgrade -t mcu -i NPU ID -f Ascend-hdk-xxx-mcu_23.2.8.hpm

   出现类似如下回显表示升级成功。

   Start upgrade [100].
           Status                         : OK
           Message                        : The device upgrade is started successfully
           Message                        : need active mcu

5. 执行如下命令使新版本生效，类似以下回显表示已生效。

   npu-smi upgrade -a mcu -i NPU ID

   Status                         : OK
           Message                : The upgrade has taken effect after performed reboot successfully.

6. 在生效新版本之后，等待30s，查询MCU版本号，确保升级成功。

   npu-smi upgrade -b mcu -i NPU ID

   • Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡

     Version                        : 23.2.2

   • Atlas 300I A2 推理卡

     Version                        : 23.2.8

   

   • MCU新版本生效后，如需再次升级，请等待5min后再次操作。
   • 如果升级后不是目标版本或者升级失败，请重新进行升级。如果依然升级失败，请记录故障现象和操作步骤，并联系华为技术支持解决。