npu-smi コマンドリファレンス
Huawei Ascend 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 vs 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 | 必要（再起動） |
| 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> # ルートキーステータス
管理
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 デベロッパーキット
- Atlas 500 A2 スマートステーション
- Atlas 200I A2 アクセラレーションモジュール（RC/EP シナリオ）
- Atlas A2/A3 トレーニングシリーズ
- Atlas トレーニングシリーズ
注意: チップ名（例：910B3）はサーバープラットフォーム（A2 vs 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/ブートの変更は 再起動 が必要
- コマンドの利用可否はハードウェアプラットフォームによって異なります
スクリプト
- scripts/npu-health-check.sh - 包括的なデバイスヘルスチェック