安装NPU驱动固件

安装说明

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

确认操作系统和内核版本

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

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

Atlas 300T 训练卡低版本内核（低于4.5）的CentOS 7.6 x86_64需要将CentOS升级至8.0及以上或添加内核补丁，否则可能导致驱动固件安装失败。添加内核补丁的方法请参见添加内核补丁。

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

• 如果操作系统和内核版本为“二进制安装”安装方式对应的版本，则可以直接按照安装驱动固件内容安装驱动固件。
• 如果操作系统和内核版本为“源码编译安装”安装方式对应的版本，或者内核版本不在“二进制安装”安装方式对应的版本范围内，则需要先参见安装驱动源码编译所需依赖安装驱动源码编译所需的依赖，再按照安装驱动固件内容安装驱动固件。

安装驱动固件

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. 执行如下命令，增加驱动和固件包的可执行权限。

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

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

   ./{product}-npu-driver_{version}_linux-{arch}.run --full --install-for-all

   

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

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

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

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

   Driver package installed successfully!

6. 执行npu-smi info查看驱动加载是否成功。

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

   

7. 执行以下安装命令完成固件安装。

   ./{product}-npu-firmware_{version}.run --full

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

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

8. 执行reboot命令重启系统。
9. 执行如下命令查看芯片固件版本号。

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

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

   {
   Get component version(1.82.22.1.224) succeed for deviceId(0), componentType(0).
           {"device_id":0, "component":nve, "version":1.82.22.1.224}
   Get component version(1.82.22.1.224) succeed for deviceId(0), componentType(3).
           {"device_id":0, "component":uefi, "version":1.82.22.1.224}
   Get component version(1.82.22.1.224) succeed for deviceId(0), componentType(8).
           {"device_id":0, "component":imu, "version":1.82.22.1.224}
   Get component version(1.82.22.1.224) succeed for deviceId(0), componentType(9).
           {"device_id":0, "component":imp, "version":1.82.22.1.224}
   ........
   }

升级MCU

仅训练卡需要升级MCU，训练服务器不涉及。

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

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

MCU版本配套关系请参见表2。

1. 将获取的zip包解压至本地文件夹，获取相应的安装包。

   {product}-mcu_{version}.bin

   

   {product}表示产品型号；{version}表示MCU版本号。

2. 以root用户登录服务器，将安装包上传至Linux系统任意目录下（如“/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后再次操作。
   • 如果升级后不是目标版本或者升级失败，请重新进行升级。如果依然升级失败，请记录故障现象和操作步骤，并联系华为技术支持解决。