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 を使用してください。

参照：出力形式、例、監視スクリプト、プラットフォームの識別（A2 と A3 の違い）については、references/device-queries.md をご覧ください。

設定

温度と電力のしきい値

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	はい（再起動）
VRD	vrd	はい（電源を30秒間オフ）

参照：手順の全容については、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]

参照：vNPU の作成と管理については、references/virtualization.md をご覧ください。

証明書管理

照会

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 開発キット
• Atlas 500 A2 スマートステーション
• 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/ブートローダーのアップグレードは、有効化後に再起動が必要です
• 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