npu-smi 指令參考
華為昇騰 NPU 裝置管理指令快速參考。
快速開始
npu-smi info -l # 列出所有裝置
npu-smi info -t health -i 0 # 檢查裝置健康狀態
npu-smi info -t temp -i 0 -c 0 # 檢查溫度
npu-smi info -t power -i 0 -c 0 # 檢查功耗
npu-smi info -t memory -i 0 -c 0 # 檢查記憶體
裝置查詢
基本資訊
npu-smi info -l # 列出裝置
npu-smi info -t health -i <id> # 健康狀態 (OK/Warning/Error)
npu-smi info -t board -i <id> # 電路板詳細資訊(韌體、軟體版本)
npu-smi info -t npu -i <id> -c <chip> # 晶片詳細資訊(名稱、健康狀態、使用率)
npu-smi info -m # 列出所有晶片
即時指標
npu-smi info -t temp -i <id> -c <chip> # 溫度(NPU、AI Core)
npu-smi info -t power -i <id> -c <chip> # 功耗與限制
npu-smi info -t memory -i <id> -c <chip> # 記憶體使用量、總量、使用率
進階查詢
npu-smi info proc -i <id> -c <chip> # 執行中程序(PID、記憶體、AI Core 使用率)
npu-smi info -t ecc -i <id> -c <chip> # ECC 錯誤與模式
npu-smi info -t usages -i <id> -c <chip> # 使用率(AI Core、記憶體、頻寬)
npu-smi info -t pcie-info -i <id> -c <chip> # PCIe 速度與通道寬度
npu-smi info -t p2p -i <id> -c <chip> # P2P 狀態與模式
npu-smi info -t product -i <id> -c <chip> # 產品名稱與序號
參閱:references/device-queries.md 了解輸出格式、範例、監控腳本以及平台識別(A2 與 A3 的區分)。
配置
溫度與功耗閾值
npu-smi set -t temperature -i <id> -c <chip> -d <value> # 溫度閾值 (°C)
npu-smi set -t power-limit -i <id> -c <chip> -d <value> # 功耗限制 (W)
模式配置
npu-smi set -t ecc-mode -i <id> -c <chip> -d <0|1> # 0=停用, 1=啟用
npu-smi set -t compute-mode -i <id> -c <chip> -d <mode> # 0=預設, 1=獨佔, 2=禁止
npu-smi set -t persistence-mode -i <id> -d <0|1> # 持久模式
npu-smi set -t p2p-mem-cfg -i <id> -c <chip> -d <0|1> # P2P 配置
風扇控制
npu-smi set -t pwm-mode -d <0|1> # 0=手動, 1=自動
npu-smi set -t pwm-duty-ratio -d <0-100> # 風扇轉速(百分比)
系統設定
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> # 系統記錄
清除指令
npu-smi clear -t ecc-info -i <id> -c <chip> # 清除 ECC 錯誤
npu-smi clear -t tls-cert-period -i <id> -c <chip> # 恢復憑證閾值
參閱:references/configuration.md 了解參數表與範例。
韌體管理
升級流程
查詢 → 升級 → 檢查狀態 → 啟動 → 重新啟動
npu-smi upgrade -b <item> -i <id> # 查詢目前版本
npu-smi upgrade -t <item> -i <id> -f <file.hpm> # 上傳韌體
npu-smi upgrade -q <item> -i <id> # 檢查升級狀態
npu-smi upgrade -a <item> -i <id> # 啟動韌體
組件與重新啟動需求
| 組件 | 項目名稱 | 需要重新啟動 |
|---|---|---|
| MCU | mcu | 是(重新啟動) |
| Bootloader | bootloader | 是(重新啟動) |
| VRD | vrd | 是(斷電 30 秒) |
參閱:references/firmware-upgrade.md 了解完整程序。
虛擬化 (vNPU)
查詢
npu-smi info -t vnpu-mode # 查詢 AVI 模式(0=容器, 1=VM)
npu-smi info -t template-info # 列出所有範本
npu-smi info -t template-info -i <id> # 指定裝置的範本
npu-smi info -t info-vnpu -i <id> -c <chip> # 檢視 vNPU 資訊
管理
npu-smi set -t vnpu-mode -d <0|1> # 設定 AVI 模式
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> # 產生 CSR(PEM 格式)
npu-smi info -t tls-cert -i <id> -c <chip> # 檢視憑證詳細資訊
npu-smi info -t tls-cert-period -i <id> -c <chip> # 檢查到期閾值
npu-smi info -t rootkey -i <id> -c <chip> # Rootkey 狀態
管理
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> # 設定閾值(7-180 天)
npu-smi clear -t tls-cert-period -i <id> -c <chip> # 恢復預設值(90 天)
參閱:references/certificate-management.md 了解憑證生命週期管理。
參數參考
| 參數 | 描述 | 取得方式 |
|---|---|---|
id | 裝置 ID(NPU ID) | npu-smi info -l |
chip_id | 晶片 ID | npu-smi info -m |
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 加速模組(RC/EP 場景)
- Atlas A2/A3 訓練系列
- Atlas 訓練系列
注意:晶片名稱(例如 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/啟動變更需要重新啟動
- 指令可用性因硬體平台而異
腳本
- scripts/npu-health-check.sh - 全面的裝置健康狀態檢查