npu-smi 是华为昇腾 NPU 的命令行设备管理工具。资料基于 Ascend 910B3 服务器（npu-smi 软件版本 25.5.1，2026-03-27 验证）整理，命令可用性与输出字段可能因平台或固件不同。
用途：查询 NPU 设备状态并执行配置、固件升级、虚拟化与证书等管理。
主要能力：设备查询方面，npu-smi info -l 列出设备，-t health 查健康状态，-t board 查固件与软件版本，-m 查卡/芯片映射，-t temp、-t power、-t memory 查温度、功耗、内存，-t ecc、-t usages、-t proc-mem、-t pcie-err、-t topo、-t p2p-enable、-t product 查 ECC、利用率、进程内存、PCIe 错误、拓扑、P2P 与产品信息。配置方面，npu-smi set -h 显示可配置类型；可设风扇模式与占空比、ECC 开关、P2P 内存、vNPU 模式、CPU 频率、MAC 地址、启动选择、系统日志。清理用 npu-smi clear，如清 ECC 错误或恢复证书阈值。固件升级流程为查询→升级→查状态→激活→重启，组件含 MCU、Bootloader（需重启）与 VRD（需断电 30 秒）。虚拟化支持模板查询、创建与销毁 vNPU，vNPU ID 范围为 [phy_id16+100, phy_id16+115]。证书方面可生成 CSR、查看证书、设置阈值（7-180 天，默认 90 天）。
使用方式：按上述命令执行；设备 ID 来自 npu-smi info -l，芯片 ID 来自 npu-smi info -m。多数配置命令需 root 权限。
适用场景：昇腾服务器的日常监控、健康检查、配置调整、固件维护、vNPU 与证书管理。
限制：支持平台包括 Atlas 200I DK A2、Atlas 500 A2、Atlas 200I A2、Atlas A2/A3 训练系列与 Atlas 训练系列。命令可用性随硬件平台变化；验证主机上 npu-smi info -t npu 不被接受，npu-smi info proc 不支持但 -t proc-mem 可用；-t product 在部分 SKU 返回不支持。芯片名（如 910B3）不代表服务器平台（A2/A3），可用 dmidecode -t system 或 npu-smi info -t product 识别。MAC/启动变更需重启，MCU/bootloader 激活后需重启，VRD 升级需断电 30 秒以上。官方文档见 https://www.hiascend.com/document/detail/zh/canncommercial/81RC1/envdeployment/instg/instg_0045.html。