npu-smi-Befehlsreferenz
Kurzreferenz für Verwaltungsbefehle von Huawei Ascend NPU-Geräten.
Schnellstart
npu-smi info -l # Alle Geräte auflisten
npu-smi info -t health -i 0 # Gerätezustand prüfen
npu-smi info -t temp -i 0 -c 0 # Temperatur prüfen
npu-smi info -t power -i 0 -c 0 # Leistung prüfen
npu-smi info -t memory -i 0 -c 0 # Speicher prüfen
Geräteabfragen
Grundlegende Informationen
npu-smi info -l # Geräte auflisten
npu-smi info -t health -i <id> # Gesundheitsstatus (OK/Warning/Error)
npu-smi info -t board -i <id> # Board-Details (Firmware, Softwareversion)
npu-smi info -t npu -i <id> -c <chip> # Chip-Details (Name, Zustand, Auslastung)
npu-smi info -m # Alle Chips auflisten
Echtzeit-Metriken
npu-smi info -t temp -i <id> -c <chip> # Temperatur (NPU, AI Core)
npu-smi info -t power -i <id> -c <chip> # Leistungsverbrauch und -grenze
npu-smi info -t memory -i <id> -c <chip> # Speichernutzung, Gesamt, Auslastung
Erweiterte Abfragen
npu-smi info proc -i <id> -c <chip> # Laufende Prozesse (PID, Speicher, AI Core-Auslastung)
npu-smi info -t ecc -i <id> -c <chip> # ECC-Fehler und -Modus
npu-smi info -t usages -i <id> -c <chip> # Auslastung (AI Core, Speicher, Bandbreite)
npu-smi info -t pcie-info -i <id> -c <chip> # PCIe-Geschwindigkeit und -Breite
npu-smi info -t p2p -i <id> -c <chip> # P2P-Status und -Modus
npu-smi info -t product -i <id> -c <chip> # Produktname und Seriennummer
Siehe: references/device-queries.md für Ausgabeformate, Beispiele, Überwachungsskripte und Plattformidentifikation (A2 vs. A3).
Konfiguration
Temperatur- und Leistungsschwellwerte
npu-smi set -t temperature -i <id> -c <chip> -d <value> # Temperaturschwelle (°C)
npu-smi set -t power-limit -i <id> -c <chip> -d <value> # Leistungsgrenze (W)
Moduskonfiguration
npu-smi set -t ecc-mode -i <id> -c <chip> -d <0|1> # 0=Deaktivieren, 1=Aktivieren
npu-smi set -t compute-mode -i <id> -c <chip> -d <mode> # 0=Standard, 1=Exklusiv, 2=Verboten
npu-smi set -t persistence-mode -i <id> -d <0|1> # Persistenzmodus
npu-smi set -t p2p-mem-cfg -i <id> -c <chip> -d <0|1> # P2P-Konfiguration
Lüftersteuerung
npu-smi set -t pwm-mode -d <0|1> # 0=Manuell, 1=Automatisch
npu-smi set -t pwm-duty-ratio -d <0-100> # Lüftergeschwindigkeit (Prozent)
Systemeinstellungen
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> # Systemprotokollierung
Löschbefehle
npu-smi clear -t ecc-info -i <id> -c <chip> # ECC-Fehler löschen
npu-smi clear -t tls-cert-period -i <id> -c <chip> # Zertifikatsschwelle zurücksetzen
Siehe: references/configuration.md für Parametertabellen und Beispiele.
Firmware-Verwaltung
Upgrade-Workflow
Anfragen → Upgraden → Status prüfen → Aktivieren → Neustarten
npu-smi upgrade -b <item> -i <id> # Aktuelle Version abfragen
npu-smi upgrade -t <item> -i <id> -f <datei.hpm> # Firmware hochladen
npu-smi upgrade -q <item> -i <id> # Upgrade-Status prüfen
npu-smi upgrade -a <item> -i <id> # Firmware aktivieren
Komponenten und Neustartanforderungen
| Komponente | Elementname | Neustart erforderlich |
|---|---|---|
| MCU | mcu | Ja (Neustart) |
| Bootloader | bootloader | Ja (Neustart) |
| VRD | vrd | Ja (Stromausschalten 30s) |
Siehe: references/firmware-upgrade.md für vollständige Verfahren.
Virtualisierung (vNPU)
Abfragen
npu-smi info -t vnpu-mode # AVI-Modus abfragen (0=Container, 1=VM)
npu-smi info -t template-info # Alle Vorlagen auflisten
npu-smi info -t template-info -i <id> # Vorlagen für bestimmtes Gerät
npu-smi info -t info-vnpu -i <id> -c <chip> # vNPU-Informationen anzeigen
Verwaltung
npu-smi set -t vnpu-mode -d <0|1> # AVI-Modus setzen
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-Bereich: [phy_id*16+100, phy_id*16+115]
Siehe: references/virtualization.md für vNPU-Erstellung und -Verwaltung.
Zertifikatsverwaltung
Abfragen
npu-smi info -t tls-csr-get -i <id> -c <chip> # CSR generieren (PEM-Format)
npu-smi info -t tls-cert -i <id> -c <chip> # Zertifikatsdetails anzeigen
npu-smi info -t tls-cert-period -i <id> -c <chip> # Ablaufschwelle prüfen
npu-smi info -t rootkey -i <id> -c <chip> # Rootkey-Status
Verwaltung
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 <tage> # Schwelle setzen (7-180 Tage)
npu-smi clear -t tls-cert-period -i <id> -c <chip> # Standard wiederherstellen (90 Tage)
Siehe: references/certificate-management.md für die Zertifikatslebenszyklusverwaltung.
Parameterreferenz
| Parameter | Beschreibung | So erhalten Sie ihn |
|---|---|---|
id | Geräte-ID (NPU-ID) | npu-smi info -l |
chip_id | Chip-ID | npu-smi info -m |
vnpu_id | vNPU-ID | Automatisch zugewiesen oder im Bereich angegeben |
mac_id | MAC-Schnittstelle | 0=eth0, 1=eth1, 2=eth2, 3=eth3 |
Unterstützte Plattformen
- Atlas 200I DK A2 Developer Kit
- Atlas 500 A2 Smart Station
- Atlas 200I A2 Beschleunigungsmodul (RC/EP-Szenarien)
- Atlas A2/A3 Training Series
- Atlas Training Series
Hinweis: Der Chipname (z. B. 910B3) gibt nicht die Serverplattform an (A2 vs. A3). Verwenden Sie
dmidecode -t system | grep Productodernpu-smi info -t product, um das Servermodell zu identifizieren. Siehe references/device-queries.md für Details.
Wichtige Hinweise
- Die meisten Konfigurationsbefehle erfordern Root-Berechtigungen
- Geräte-IDs von
npu-smi info -l - Chip-IDs von
npu-smi info -m - MCU-/Bootloader-Upgrades erfordern Neustart nach Aktivierung
- VRD-Upgrades erfordern Stromausschalten (30+ Sekunden aus)
- MAC-/Boot-Änderungen erfordern Neustart
- Die Verfügbarkeit von Befehlen variiert je nach Hardwareplattform
Skripte
- scripts/npu-health-check.sh – Umfassender Gerätezustandscheck