Referência de Comandos npu-smi
Referência rápida para comandos de gerenciamento de dispositivos NPU Huawei Ascend.
Início Rápido
npu-smi info -l # Listar todos os dispositivos
npu-smi info -t health -i 0 # Verificar saúde do dispositivo
npu-smi info -t temp -i 0 -c 0 # Verificar temperatura
npu-smi info -t power -i 0 -c 0 # Verificar energia
npu-smi info -t memory -i 0 -c 0 # Verificar memória
Consultas de Dispositivo
Informações Básicas
npu-smi info -l # Listar dispositivos
npu-smi info -t health -i <id> # Status de saúde (OK/Aviso/Erro)
npu-smi info -t board -i <id> # Detalhes da placa (firmware, versão de software)
npu-smi info -t npu -i <id> -c <chip> # Detalhes do chip (nome, saúde, uso)
npu-smi info -m # Listar todos os chips
Métricas em Tempo Real
npu-smi info -t temp -i <id> -c <chip> # Temperatura (NPU, AI Core)
npu-smi info -t power -i <id> -c <chip> # Uso e limite de energia
npu-smi info -t memory -i <id> -c <chip> # Uso de memória, total, taxa
Consultas Avançadas
npu-smi info proc -i <id> -c <chip> # Processos em execução (PID, memória, uso AI Core)
npu-smi info -t ecc -i <id> -c <chip> # Erros ECC e modo
npu-smi info -t usages -i <id> -c <chip> # Utilização (AI Core, memória, largura de banda)
npu-smi info -t pcie-info -i <id> -c <chip> # Velocidade e largura PCIe
npu-smi info -t p2p -i <id> -c <chip> # Status e modo P2P
npu-smi info -t product -i <id> -c <chip> # Nome do produto e número de série
Veja: references/device-queries.md para formatos de saída, exemplos, scripts de monitoramento e identificação de plataforma (A2 vs A3).
Configuração
Limiares de Temperatura e Energia
npu-smi set -t temperature -i <id> -c <chip> -d <valor> # Limiar de temperatura (°C)
npu-smi set -t power-limit -i <id> -c <chip> -d <valor> # Limite de energia (W)
Configuração de Modo
npu-smi set -t ecc-mode -i <id> -c <chip> -d <0|1> # 0=Desabilitar, 1=Habilitar
npu-smi set -t compute-mode -i <id> -c <chip> -d <modo> # 0=Padrão, 1=Exclusivo, 2=Proibido
npu-smi set -t persistence-mode -i <id> -d <0|1> # Modo de persistência
npu-smi set -t p2p-mem-cfg -i <id> -c <chip> -d <0|1> # Configuração P2P
Controle da Ventoinha
npu-smi set -t pwm-mode -d <0|1> # 0=Manual, 1=Automático
npu-smi set -t pwm-duty-ratio -d <0-100> # Velocidade da ventoinha (percentual)
Configurações do Sistema
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> # Log do sistema
Comandos de Limpeza
npu-smi clear -t ecc-info -i <id> -c <chip> # Limpar erros ECC
npu-smi clear -t tls-cert-period -i <id> -c <chip> # Restaurar limiar de certificado
Veja: references/configuration.md para tabelas de parâmetros e exemplos.
Gerenciamento de Firmware
Fluxo de Atualização
Consulta → Atualização → Verificar Status → Ativar → Reiniciar
npu-smi upgrade -b <item> -i <id> # Consultar versão atual
npu-smi upgrade -t <item> -i <id> -f <arquivo.hpm> # Carregar firmware
npu-smi upgrade -q <item> -i <id> # Verificar status da atualização
npu-smi upgrade -a <item> -i <id> # Ativar firmware
Componentes e Requisitos de Reinicialização
| Componente | Nome do Item | Reinicialização Necessária |
|---|---|---|
| MCU | mcu | Sim (reinício) |
| Bootloader | bootloader | Sim (reinício) |
| VRD | vrd | Sim (ciclo de energia de 30s) |
Veja: references/firmware-upgrade.md para procedimentos completos.
Virtualização (vNPU)
Consultas
npu-smi info -t vnpu-mode # Consultar modo AVI (0=Container, 1=VM)
npu-smi info -t template-info # Listar todos os templates
npu-smi info -t template-info -i <id> # Templates para dispositivo específico
npu-smi info -t info-vnpu -i <id> -c <chip> # Visualizar informações da vNPU
Gerenciamento
npu-smi set -t vnpu-mode -d <0|1> # Definir modo 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>
Faixa de IDs vNPU: [phy_id*16+100, phy_id*16+115]
Veja: references/virtualization.md para criação e gerenciamento de vNPU.
Gerenciamento de Certificados
Consultas
npu-smi info -t tls-csr-get -i <id> -c <chip> # Gerar CSR (formato PEM)
npu-smi info -t tls-cert -i <id> -c <chip> # Visualizar detalhes do certificado
npu-smi info -t tls-cert-period -i <id> -c <chip> # Verificar limiar de expiração
npu-smi info -t rootkey -i <id> -c <chip> # Status da chave raiz
Gerenciamento
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 <dias> # Definir limiar (7-180 dias)
npu-smi clear -t tls-cert-period -i <id> -c <chip> # Restaurar padrão (90 dias)
Veja: references/certificate-management.md para gerenciamento do ciclo de vida de certificados.
Referência de Parâmetros
| Parâmetro | Descrição | Como Obter |
|---|---|---|
id | ID do Dispositivo (NPU ID) | npu-smi info -l |
chip_id | ID do Chip | npu-smi info -m |
vnpu_id | ID da vNPU | Atribuído automaticamente ou especificado na faixa |
mac_id | Interface MAC | 0=eth0, 1=eth1, 2=eth2, 3=eth3 |
Plataformas Suportadas
- Kit de Desenvolvimento Atlas 200I DK A2
- Estação Inteligente Atlas 500 A2
- Módulo de Aceleração Atlas 200I A2 (cenários RC/EP)
- Séries de Treinamento Atlas A2/A3
- Séries de Treinamento Atlas
Nota: O nome do chip (ex.: 910B3) não indica a plataforma do servidor (A2 vs A3). Use
dmidecode -t system | grep Productounpu-smi info -t productpara identificar o modelo do servidor. Veja references/device-queries.md para detalhes.
Notas Importantes
- A maioria dos comandos de configuração requer permissões de root
- IDs de dispositivo de
npu-smi info -l - IDs de chip de
npu-smi info -m - Atualizações de MCU/bootloader requerem reinício após ativação
- Atualizações de VRD requerem ciclo de energia (30+ segundos desligado)
- Alterações de MAC/boot requerem reinício
- A disponibilidade de comandos varia conforme a plataforma de hardware
Scripts
- scripts/npu-health-check.sh - Verificação abrangente de saúde do dispositivo