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 Developer Kit
- Atlas 500 A2 Smart Station
- Atlas 200I A2 Acceleration Module (RC/EP 시나리오)
- Atlas A2/A3 Training 시리즈
- Atlas Training 시리즈
참고: 칩 이름(예: 910B3)은 서버 플랫폼(A2 vs A3)을 나타내지 않습니다. 서버 모델을 식별하려면
dmidecode -t system | grep Product또는npu-smi info -t product를 사용하세요. 자세한 내용은 references/device-queries.md를 참조하십시오.
중요 참고 사항
- 대부분의 구성 명령어는 루트 권한이 필요합니다.
- 장치 ID는
npu-smi info -l명령어로 확인합니다. - 칩 ID는
npu-smi info -m명령어로 확인합니다. - MCU/부트로더 업그레이드는 활성화 후 재시작이 필요합니다.
- VRD 업그레이드는 전원 차단(30초 이상)이 필요합니다.
- MAC/부트 변경은 재시작이 필요합니다.
- 명령어 가용성은 하드웨어 플랫폼에 따라 다릅니다.
스크립트
- scripts/npu-health-check.sh - 포괄적인 장치 상태 점검 스크립트