npu-smi

npu-smi 命令参考

Huawei Ascend NPU 设备管理命令速查。

已在真实主机上验证：2026-03-27，在 Ascend 910B3 服务器（npu-smi 软件版本 25.5.1）上验证。不同平台／固件上的命令可用性和输出字段可能有所不同。

快速入门

npu-smi info -l                           # List all devices
npu-smi info -t health -i 0               # Check device health
npu-smi info -t temp -i 0 -c 0            # Check temperature
npu-smi info -t power -i 0 -c 0           # Check power
npu-smi info -t memory -i 0 -c 0          # Check memory

设备查询

基本信息

npu-smi info -l                           # List devices
npu-smi info -t health -i <id>            # Health status (OK/Warning/Error)
npu-smi info -t board -i <id>             # Board details (firmware, software version)
npu-smi info -m                           # List card/chip mapping and chip names

实时指标

npu-smi info -t temp -i <id> -c <chip>    # Temperature (NPU, AI Core)
npu-smi info -t power -i <id> -c <chip>   # Power usage and limit
npu-smi info -t memory -i <id> -c <chip>  # Memory usage, total, rate

高级查询

npu-smi info -t ecc -i <id> -c <chip>     # ECC errors and mode
npu-smi info -t usages -i <id> -c <chip>  # Utilization (AI Core, memory, bandwidth)
npu-smi info -t proc-mem -i <id> -c <chip>   # Per-process memory usage
npu-smi info -t pcie-err -i <id> -c <chip>   # PCIe error counters
npu-smi info -t topo -i <id> -c <chip>       # Inter-NPU topology / affinity
npu-smi info -t p2p-enable -i <id> -c <chip> # P2P capability (if supported)
npu-smi info -t product -i <id> -c <chip> # Product name and serial

注意：已验证的主机不接受 npu-smi info -t npu；请使用 npu-smi info -m 查看芯片映射，并使用 health/temp/power/usages/memory 获取每个芯片的运行时数据。

参阅：references/device-queries.md，了解输出格式、示例、监控脚本和平台识别（A2 与 A3）。

配置

温度和功率阈值

npu-smi set -h                                             # Show supported configurable types on this host
npu-smi set -t pwm-mode -d <0|1>                           # Fan control mode
npu-smi set -t pwm-duty-ratio -d <0-100>                   # Fan duty ratio

模式配置

npu-smi set -t ecc-enable -i <id> -c <chip> -d <0|1>      # ECC enable switch
npu-smi set -t p2p-mem-cfg -i <id> -c <chip> -d <0|1>     # P2P memory configuration
npu-smi set -t vnpu-mode -d <0|1>                          # vNPU mode
npu-smi set -t cpu-freq-up -i <id> -d <0|1>               # CPU frequency profile

风扇控制

npu-smi set -t pwm-mode -d <0|1>                          # 0=Manual, 1=Automatic
npu-smi set -t pwm-duty-ratio -d <0-100>                  # Fan speed (percent)

系统设置

npu-smi set -t mac-addr -i <id> -c <chip> -d <mac_id> -s "XX:XX:XX:XX:XX:XX"
npu-smi set -t boot-select -i <id> -c <chip> -d <3|4>     # 3=M.2 SSD, 4=eMMC
npu-smi set -t cpu-freq-up -i <id> -d <0|1>               # 0=1.9GHz/800MHz, 1=1.0GHz/800MHz
npu-smi set -t sys-log-enable -d <0|1>                    # System logging

清除命令

npu-smi clear -t ecc-info -i <id> -c <chip>               # Clear ECC errors
npu-smi clear -t tls-cert-period -i <id> -c <chip>        # Restore cert threshold

参阅：references/configuration.md，了解参数表和示例。

固件管理

升级工作流

Query → Upgrade → Check Status → Activate → Restart

npu-smi upgrade -b <item> -i <id>                         # Query current version
npu-smi upgrade -t <item> -i <id> -f <file.hpm>           # Upload firmware
npu-smi upgrade -q <item> -i <id>                         # Check upgrade status
npu-smi upgrade -a <item> -i <id>                         # Activate firmware

组件和重启要求

组件	项目名称	是否需要重启
MCU	mcu	是（重启）
Bootloader	bootloader	是（重启）
VRD	vrd	是（断电 30s）

参阅：references/firmware-upgrade.md，了解完整流程。

虚拟化（vNPU）

查询

npu-smi info -t vnpu-mode                                 # Query AVI mode (0=Container, 1=VM)
npu-smi info -t template-info                             # List all templates
npu-smi info -t template-info -i <id>                     # Templates for specific device
npu-smi info -t info-vnpu -i <id> -c <chip>               # View vNPU info

管理

npu-smi set -t vnpu-mode -d <0|1>                         # Set AVI mode
npu-smi set -t create-vnpu -i <id> -c <chip> -f <template> [-v <vnpu_id>] [-g <vgroup_id>]
npu-smi set -t destroy-vnpu -i <id> -c <chip> -v <vnpu_id>

vNPU ID 范围：[phy_id*16+100, phy_id*16+115]

参阅：references/virtualization.md，了解 vNPU 的创建和管理。

证书管理

查询

npu-smi info -t tls-csr-get -i <id> -c <chip>             # Generate CSR (PEM format)
npu-smi info -t tls-cert -i <id> -c <chip>                # View certificate details
npu-smi info -t tls-cert-period -i <id> -c <chip>         # Check expiration threshold
npu-smi info -t rootkey -i <id> -c <chip>                 # Rootkey status

管理

npu-smi set -t tls-cert -i <id> -c <chip> -f "<tls.pem> <ca.pem> <subca.pem>"
npu-smi set -t tls-cert-period -i <id> -c <chip> -s <days>  # Set threshold (7-180 days)
npu-smi clear -t tls-cert-period -i <id> -c <chip>        # Restore default (90 days)

参阅：references/certificate-management.md，了解证书生命周期管理。

参数参考

参数	说明	获取方式
id	设备 ID（NPU ID）	npu-smi info -l
chip_id	运行时芯片 ID	npu-smi info -m（在已验证的主机上，Ascend 芯片通常为 0，MCU 为 1）
vnpu_id	vNPU ID	自动分配或在范围内指定
mac_id	MAC 接口	0=eth0，1=eth1，2=eth2，3=eth3

支持的平台

• Atlas 200I DK A2 Developer Kit
• Atlas 500 A2 Smart Station
• Atlas 200I A2 Acceleration Module（RC/EP 场景）
• Atlas A2/A3 Training Series
• Atlas Training Series

注意：芯片名称（例如 910B3）不能表明服务器平台（A2 还是 A3）。请使用 dmidecode -t system | grep Product 或 npu-smi info -t product 识别服务器型号。详情请参阅 references/device-queries.md。

重要说明

• 大多数配置命令需要root 权限
• 设备 ID 可通过 npu-smi info -l 获取
• 芯片 ID 可通过 npu-smi info -m 获取
• MCU／bootloader 升级激活后需要重启
• VRD 升级需要断电（断电 30 秒以上）
• MAC／启动项更改需要重启
• 命令可用性因硬件平台而异
• 已验证的 910B3 主机不支持 npu-smi info proc；npu-smi info -t proc-mem 可用
• 在某些服务器 SKU 上，npu-smi info -t product 可能会返回 This device does not support querying product.

脚本

• scripts/npu-health-check.sh - 全面的设备健康检查

官方文档

• npu-smi 参考：https://www.hiascend.com/document/detail/zh/canncommercial/81RC1/envdeployment/instg/instg_0045.html