使用 Gemini 3 Pro 生成并经过验证

准备好驱动 (Driver) 和固件 (Firmware)：

• Atlas-A3-hdk-npu-driver_25.2.3_linux-aarch64.run
• Atlas-A3-hdk-npu-firmware_7.7.0.10.220.run

先安装驱动，再安装固件。

第一步：准备工作与检查

在开始安装之前，确保有 root 权限，并确认硬件已被系统识别。

1. 登录服务器： 使用 root 用户或具有 sudo 权限的用户登录。

2. 检查 NPU 是否被物理识别：
   执行以下命令，查看是否有 Huawei 的 PCI 设备：

   lspci | grep Huawei
   

   如果看到类似 Processing accelerators: Huawei Technologies Co., Ltd. 的输出，说明硬件连接正常。

3. 创建安装用户（可选但推荐）：
   华为 NPU 驱动通常推荐使用 HwHiAiUser 用户运行。如果系统中没有该用户，驱动安装程序通常会自动创建，或者可以手动创建：

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

第二步：赋予执行权限

下载的 .run 文件默认可能没有执行权限。在存放文件的目录下执行以下命令：

chmod +x Atlas-A3-hdk-npu-driver_25.2.3_linux-aarch64.run
chmod +x Atlas-A3-hdk-npu-firmware_7.7.0.10.220.run

第三步：安装驱动 (Driver)

首先安装驱动。

1. 执行安装命令（使用 --full 参数进行全量安装）：

   ./Atlas-A3-hdk-npu-driver_25.2.3_linux-aarch64.run --full
   

   • 注：如果需要指定运行用户，可以添加 --install-username=HwHiAiUser --install-usergroup=HwHiAiUser，默认通常就是这个。

2. 等待安装完成：
   屏幕上出现 Driver install success 字样表示安装成功。

3. 检查驱动加载状态：
   安装完成后，可以尝试执行以下命令（如果尚未重启，可能需要先重启才能看到完整信息，但通常驱动装完即可查看简略信息）：

   npu-smi info
   

   如果能看到类似表格的输出，说明驱动已加载。

第四步：安装固件 (Firmware)

驱动安装成功后，接着安装固件。

1. 执行安装命令：

   ./Atlas-A3-hdk-npu-firmware_7.7.0.10.220.run --full
   

2. 等待安装完成：
   屏幕上出现 Firmware install success 字样表示安装成功。

第五步：重启生效与最终验证

固件升级通常需要冷复位或重启系统才能生效。

1. 重启服务器：

   reboot
   

2. 最终验证：
   重启完成后，再次登录并执行查询命令：

   npu-smi info
   

   请检查输出界面中的以下关键信息：

   • Status: 应显示 OK。
   • Health: 应显示 OK。
   • Version: 确认 Driver Version 和 Firmware Version 是否为您刚才安装的版本号。

常见问题排查 (Troubleshooting)

• 如果不确定之前的版本： 如果这是升级操作而非全新安装，建议先使用 --check 参数检查版本兼容性，或者查看华为官网的版本配套表。
• 报错 “虽然安装成功但 npu-smi 报错”： 可能是因为没有重启，或者系统内核头文件缺失。请确保操作系统内核版本与驱动支持列表匹配。
• 日志位置： 如果安装失败，日志通常位于 /var/log/ascend_seclog/ 或 /var/log/driver_install.log 下，请查看日志获取具体错误代码。