安装NPU驱动固件
安装说明
- 首次安装场景:硬件设备刚出厂时未安装驱动,或者硬件设备前期安装过驱动固件但是当前已卸载,上述场景属于首次安装场景,需按照“驱动 > 固件”的顺序安装驱动固件。
- 覆盖安装场景:硬件设备前期安装过驱动固件且未卸载,当前要再次安装驱动固件,此场景属于覆盖安装场景,需按照“固件 > 驱动”的顺序安装固件驱动。
确认操作系统和内核版本
在安装驱动前,需要用户确认现场操作系统和内核版本,从而确定是否需要安装驱动编译所需依赖。
uname -m && cat /etc/*release uname -r
- 如果操作系统和内核版本为“二进制文件直接安装”安装方式对应的版本,则可以直接按照安装驱动固件内容安装驱动固件。
- 如果操作系统和内核版本为“源码编译安装”安装方式对应的版本,或者内核版本不在“二进制文件直接安装”安装方式对应的版本范围内,则需要先参见安装驱动源码编译所需依赖安装驱动源码编译所需的依赖,再按照安装驱动固件内容安装驱动固件。
host操作系统版本 |
host操作系统架构 |
软件包默认的host操作系统内核版本 |
gcc编译器版本 |
安装方式 |
---|---|---|---|---|
CentOS 7.6 |
aarch64 |
4.14.0-115.el7a.0.1.aarch64 |
4.8.5 |
二进制文件直接安装 |
Ubuntu 18.04.1 |
aarch64 |
4.15.0-29-generic |
7.5.0 |
|
Ubuntu 20.04 |
aarch64 |
5.4.0-26-generic |
原生gcc(源自带gcc版本) |
|
Ubuntu 18.04.5 |
aarch64 |
4.15.0-112-generic |
7.5.0 |
源码编译安装 |
openEuler 20.03 LTS |
aarch64 |
4.19.90-2003.4.0.0036.oe1.aarch64 |
7.3.0 |
|
openEuler 22.03 LTS |
aarch64 |
5.10.0-60.18.0.50.oe2203.aarch64 |
10.3.1 |
|
Kylin V10 SP1 |
aarch64 |
4.19.90-17.ky10.aarch64 |
7.3.0 |
|
Kylin V10 SP2 |
aarch64 |
4.19.90-24.4.v2101.ky10.aarch64 |
7.3.0 |
Atlas 300V Pro 视频解析卡不支持Kylin V10 SP2操作系统。
host操作系统版本 |
host操作系统架构 |
软件包默认的host操作系统内核版本 |
gcc编译器版本 |
安装方式 |
---|---|---|---|---|
CentOS 7.6 |
x86_64 |
3.10.0-957.el7.x86_64 |
4.8.5 |
二进制文件直接安装 |
Ubuntu 20.04 |
x86_64 |
5.4.0-26-generic |
原生gcc(源自带gcc版本) |
|
CentOS 7.8 |
x86_64 |
3.10.0-1127.el7.x86_64 |
4.8.5 |
源码编译安装 |
SLES 12.5 |
x86_64 |
4.12.14-120-default |
4.8.5 |
|
Ubuntu 18.04.5 |
x86_64 |
4.15.0-112-generic |
7.5.0 |
|
Ubuntu 20.04 |
x86_64 |
5.4.0-26-generic |
9.3.0 |
|
openEuler 20.03 LTS |
x86_64 |
4.19.90-2003.4.0.0036.oe1.x86_64 |
7.3.0 |
|
openEuler 22.03 LTS |
x86_64 |
5.10.0-60.18.0.50.oe2203.x86_64 |
10.3.1 |
|
Kylin V10 SP1 |
x86_64 |
4.19.90-17.ky10.x86_64 |
7.3.0 |
host操作系统版本 |
host操作系统架构 |
软件包默认的host操作系统内核版本 |
gcc编译器版本 |
安装方式 |
---|---|---|---|---|
Ubuntu 20.04 |
aarch64 |
5.4.0-26-generic |
原生gcc(源自带gcc版本) |
二进制文件直接安装 |
openEuler 22.03 LTS |
aarch64 |
5.10.0-60.18.0.50.oe2203.aarch64 |
10.3.1 |
源码编译安装 |
host操作系统版本 |
host操作系统架构 |
软件包默认的host操作系统内核版本 |
gcc编译器版本 |
安装方式 |
---|---|---|---|---|
Ubuntu 20.04 |
x86_64 |
5.4.0-26-generic |
原生gcc(源自带gcc版本) |
二进制文件直接安装 |
CentOS7.6 |
x86_64 |
3.10.0-957.el7.x86_64 |
4.8.5 |
|
CentOS7.8 |
x86_64 |
3.10.0-1127.el7.x86_64 |
4.8.5 |
源码编译安装 |
openEuler 22.03 LTS |
x86_64 |
5.10.0-60.18.0.50.oe2203.x86_64 |
10.3.1 |
host操作系统版本 |
host操作系统架构 |
软件包默认的host操作系统内核版本 |
gcc编译器版本 |
安装方式 |
---|---|---|---|---|
Ubuntu 22.04 |
aarch64 |
5.15.0-25-generic |
原生gcc(源自带gcc版本) |
二进制安装。 |
Kylin V10 SP2 |
aarch64 |
4.19.90-24.4.v2101.ky10.aarch64 |
7.3.0 |
源码编译安装。 |
安装驱动固件
- 以root用户登录服务器。
- 创建驱动运行用户HwHiAiUser(运行驱动进程的用户),安装驱动时无需指定运行用户,默认即为HwHiAiUser。
groupadd HwHiAiUser useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash
- 将驱动包和固件包上传到服务器任意目录如“/home”。
- 进入驱动包和固件包所在目录,执行如下命令,增加驱动和固件包的可执行权限。
chmod +x 驱动/固件包名称.run
- 执行以下命令,完成驱动安装,软件包默认安装路径为“/usr/local/Ascend”。
- 6.0.rc1.2版本以下
./{product}-npu-driver_{version}_linux-{arch}.run --full --install-for-all
- 6.0.rc1.2及以上版本
./Ascend-hdk-xxx-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.0.rc1.2版本以下
- 执行npu-smi info查看驱动加载是否成功。若出现类似如下图所示回显信息,说明加载成功。否则,说明加载失败。请联系华为技术支持处理。
- Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡
- Atlas 300I A2 推理卡
- Atlas 300I Pro 推理卡/Atlas 300V Pro 视频解析卡/Atlas 300V 视频解析卡
- 执行以下安装命令完成固件安装。
- 6.0.rc1.2版本以下
./{product}-npu-firmware_{version}.run --full
- 6.0.rc1.2及以上版本
./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
- 6.0.rc1.2版本以下
- 执行reboot命令重启系统。
系统重启后,执行如下命令查看芯片固件版本号。若与目标版本一致,则说明安装成功。
/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升级到相应版本,如果配备了多个推理卡,需要逐个升级。
MCU版本配套关系请参见表2。
- 将获取的zip包解压至本地文件夹,获取相应的安装包。
- 3.3.4版本以下:{product}-mcu_{version}.hpm
- 3.3.4及以上版本:Ascend-hdk-xxx-mcu_{version}.hpm
{product}表示产品型号;{version}表示MCU版本号。
- 以root用户登录服务器,将安装包上传至服务器任意目录下(如“/home”)。
- 执行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
- 进入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
- 执行如下命令使新版本生效,类似以下回显表示已生效。
npu-smi upgrade -a mcu -i NPU ID
Status : OK Message : The upgrade has taken effect after performed reboot successfully.
- 在生效新版本之后,等待30s,查询MCU版本号,确保升级成功。
npu-smi upgrade -b mcu -i NPU ID
Version : {version}
- MCU新版本生效后,如需再次升级,请等待5min后再次操作。
- 如果升级后不是目标版本或者升级失败,请重新进行升级。如果依然升级失败,请记录故障现象和操作步骤,并联系华为技术支持解决。