Community程式設計與開發github.com

Ascend/agent-skills

華為昇騰 NPU npu-smi 命令參考。用於裝置查詢(健康狀態、溫度、功耗、記憶體、進程、ECC)、配置(閾值、模式、風扇)、韌體升級(MCU、Bootloader)等。

agent-skills 是什麼?

此技能提供華為昇騰 NPU 的 `npu-smi` 命令完整參考手冊,專為開發者與 AI 代理設計。它涵蓋裝置查詢(如健康狀態、溫度、功耗、記憶體使用率、執行中進程及 ECC 錯誤)、即時指標監控、配置管理(溫度/功耗閾值、運算模式、ECC 模式及風扇控制)、韌體升級(MCU、Bootloader、VRD)以及虛擬化(vNPU)功能。支援 Atlas 200I/500 A2、A2/A3 訓練系列等多種平台。技能參考資料包含輸出格式範例、監控腳本及平台識別方法(如 A2 與 A3 區分),並提供實用的 Shell 腳本進行全面健康檢查。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Ascend/agent-skills

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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>                         # 啟動韌體

組件與重新啟動需求

組件項目名稱需要重新啟動
MCUmcu是(重新啟動)
Bootloaderbootloader是(重新啟動)
VRDvrd是(斷電 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晶片 IDnpu-smi info -m
vnpu_idvNPU ID自動指派或指定範圍內
mac_idMAC 介面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/啟動變更需要重新啟動
  • 指令可用性因硬體平台而異

腳本

官方文件

相關技能