安装NPU驱动固件

安装说明

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

确认操作系统和内核版本

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

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

华为发布的驱动配套的操作系统和内核版本如表1~表9所示。

安装驱动固件

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

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

3. 安装驱动源码编译所需依赖。
   • CentOS 7.6、Ubuntu 20.04、Ubuntu 22.04操作系统可跳过该步骤。
   • CentOS 7.8、CentOS 8.0、CULinux 3.0、Kylin V10 SP1、Kylin V10 SP2、Kylin V10 SP3、CTyunOS 22.06、openEuler 22.03 LTS、UOS20 1050e、BC Linux 8.2、BC-Linux 21.10、UOS20 1020e、UOS20 1050e操作系统请参见安装驱动源码编译所需依赖安装依赖。
4. 将驱动包和固件包上传到服务器任意目录如“/home”。
5. 进入驱动包和固件包所在目录，执行如下命令，增加驱动和固件包的可执行权限。

   chmod +x 驱动/固件包名称.run

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

   首次安装场景，需按照“驱动 > 固件”的顺序安装驱动固件；覆盖安装场景，需按照“固件 > 驱动”的顺序安装固件驱动。

   • 安装驱动
     执行以下命令，完成驱动安装。

     ./Ascend-hdk-xxx-npu-driver_{version}_linux-{arch}.run --full --install-for-all

     

     {version}表示软件包版本；{arch}表示架构，请以实际软件包名替换。

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

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

     • 若执行上述安装命令出现类似如下回显信息，请参见驱动安装过程中出现dkms编译失败报错解决。

       [ERROR]Dkms install failed, details in : var/log/ascend_seclog/ascend_install.log. 
       [ERROR]Driver_ko_install failed, details in : /var/log/ascend_seclog/ascend_install.log.

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

       Driver package installed successfully!

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

     ./Ascend-hdk-xxx-npu-firmware_{version}.run --full

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

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

7. 执行reboot命令重启系统。
8. 重启系统后，以root用户登录服务器。
9. 执行npu-smi info查看驱动加载是否成功。

   若出现类似如下图所示回显信息，说明加载成功。否则，说明加载失败。请联系华为技术支持处理。

   

10. 执行如下命令查看芯片固件版本号。若与目标版本一致，则说明安装成功。

    /usr/local/Ascend/driver/tools/upgrade-tool --device_index -1 --component -1 --version

    若出现类似以下回显信息，且与目标版本一致，则说明安装成功。

    {
    Get component version(1.82.22.1.211) succeed for deviceId(0), componentType(11).
            {"device_id":0, "component":hboot1a, "version":1.82.22.1.211}
    Get component version(1.82.22.1.211) succeed for deviceId(0), componentType(12).
            {"device_id":0, "component":hboot1b, "version":1.82.22.1.211}
    Get component version(1.82.22.1.211) succeed for deviceId(0), componentType(18).
            {"device_id":0, "component":hlink, "version":1.82.22.1.211}
    }

升级MCU

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

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

1. 将获取的zip包解压至本地文件夹，获取相应的安装包“Ascend-hdk-xxx-mcu_{version}.hpm”。
   

   {version}表示MCU版本号。

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

   [root@localhost ~]# npu-smi info -l
           Card Count                     : 1
           NPU ID                     : 8
           Product Name                   : IT21DMPB01
           Serial Number                  : 033EFS10M8000087
           Chip Count                     : 4

4. 进入MCU软件包所在路径，执行如下命令启动升级。

   npu-smi upgrade -t mcu -i NPU ID -f X

   X表示1中获取的安装包文件名称，出现类似如下回显表示升级成功。

   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

   Version                        : {version}

   

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