AXCL-SMI

Overview

The AXCL-SMI (System Management Interface) tool is used for device information collection, device configuration, and other functions. It supports collecting the following device information:

Hardware device model
Firmware version
Driver version
Device utilization
Memory usage
Device chip junction temperature
Other information

Instructions

Quick Start

After the AXCL driver package is correctly installed, AXCL-SMI is available. Run axcl-smi directly to display the output as follows:

+------------------------------------------------------------------------------------------------+
| AXCL-SMI  V3.6.4_20250805020145                                  Driver  V3.6.4_20250805020145 |
+-----------------------------------------+--------------+---------------------------------------+
| Card  Name                     Firmware                                                          | Bus-Id       | Memory-Usage           |
| Fan   Temp                Pwr:Usage/Cap                                                          | CPU      NPU | CMM-Usage              |
| =========================================+==============+======================================= |
| 0  AX650N                     V3.6.4                                                             | 0001:01:00.0 | 149 MiB /      945 MiB |
| --   41C                      -- / --                                                            | 1%        0% | 18 MiB /     7040 MiB  |
+-----------------------------------------+--------------+---------------------------------------+

+------------------------------------------------------------------------------------------------+
| Processes:                                                                                       |
| Card      PID  Process Name                                                   NPU Memory Usage   |
| ================================================================================================ |

Field Description

Field	Description	Field	Description
Card	Device index number — note: not the PCIe device number	Bus-Id	Device Bus ID
Name	Device name	CPU	Average CPU utilization
Fan	Fan speed ratio (not supported)	NPU	Average NPU utilization
Temp	Chip junction temperature (Tj)	Memory-Usage	System memory: used / total
Firmware	Device firmware version	CMM-Usage	Media memory: used / total
Pwr: Usage/Cap	Power consumption (not supported)
PID	Host process PID
Process Name	Host process name
NPU Memory Usage	CMM memory used by NPU on the device

Help (-h) & Version (-v)

axcl-smi -h will show the help information

m5stack@raspberrypi5:~ $ axcl-smi -h
usage: axcl-smi [<command> [<args>]] [--device] [--version] [--help]

axcl-smi System Management Interface V3.6.3_20250722020142

Commands
    info                                    Show device information
        --temp                                  Show SoC temperature
        --mem                                   Show memory usage
        --cmm                                   Show CMM usage
        --cpu                                   Show CPU usage
        --npu                                   Show NPU usage
    proc                                    cat device proc
        --vdec                                  cat /proc/ax_proc/vdec
        --venc                                  cat /proc/ax_proc/venc
        --jenc                                  cat /proc/ax_proc/jenc
        --ivps                                  cat /proc/ax_proc/ivps
        --rgn                                   cat /proc/ax_proc/rgn
        --ive                                   cat /proc/ax_proc/ive
        --pool                                  cat /proc/ax_proc/pool
        --link                                  cat /proc/ax_proc/link_table
        --cmm                                   cat /proc/ax_proc/mem_cmm_info
    set                                     Set
        -f[MHz], --freq=[MHz]                   Set CPU frequency in MHz. One of: 1200000, 1400000, 1700000
    log                                     Dump logs from device
        -t[mask], --type=[mask]                 Specifies which logs to dump by a combination (bitwise OR) value of below:
                                                  -1: all (default) 0x01: daemon 0x02: worker 0x10: syslog 0x20: kernel
        -o[path], --output=[path]               Specifies the path to save dump logs (default: ./)
    sh                                      Execute a shell command
        cmd                                     Shell command
        args...                                 Shell command arguments
    reboot                                  reboot device
-d, --device                            Card index [0, connected cards number - 1]
-v, --version                           Show axcl-smi version
-h, --help                              Show this help menu
 

axcl-smi -v will show the AXCL-SMI version

m5stack@raspberrypi5:~ $ axcl-smi -v
AXCL-SMI V3.6.3_20250722020142 BUILD: Jul 22 2025 02:30:24

Options

Device ID (-d, --device)

-d, --device                             Card index [0, connected cards number - 1]

[-d, --device] specifies the device index; range is [0, number of connected devices - 1]. Default is device 0.

Info Query (info)

axcl-smi info displays detailed device information. Supported subcommands are:

Subcommand	Description
--temp	Show chip junction temperature in Celsius x1000.
--mem	Show detailed system memory usage.
--cmm	Show media memory usage. For more detailed media memory info, run `axcl-smi sh cat /proc/ax_proc/mem_cmm_info -d xx` (xx is the PCIe device number).
--cpu	Show CPU utilization.
--npu	Show NPU utilization.

Example: Query media memory usage for device index 0:

m5stack@raspberrypi5:~ $ axcl-smi info --cmm -d 0
Device ID           : 1 (0x1)
CMM Total           :  7208960 KiB
CMM Used            :    18876 KiB
CMM Remain          :  7190084 kiB

PROC Query (proc)

axcl-smi proc queries device module proc info. Supported subcommands are:

Subcommand	Description
--vdec	Query VDEC module proc info (`cat /proc/ax_proc/vdec`)
--venc	Query VENC module proc info (`cat /proc/ax_proc/venc`)
--jenc	Query JENC module proc info (`cat /proc/ax_proc/jenc`)
--ivps	Query IVPS module proc info (`cat /proc/ax_proc/ivps`)
--rgn	Query RGN module proc info (`cat /proc/ax_proc/rgn`)
--ive	Query IVE module proc info (`cat /proc/ax_proc/ive`)
--pool	Query POOL module proc info (`cat /proc/ax_proc/pool`)
--link	Query LINK module proc info (`cat /proc/ax_proc/link_table`)
--cmm	Query CMM module proc info (`cat /proc/ax_proc/mem_cmm_info`)

Example: Query VENC proc info for device 0

m5stack@raspberrypi5:~ $ axcl-smi proc --venc -d 0
-------- VENC VERSION ------------------------
[Axera version]: ax_venc V3.6.3_20250722020142 Jul 22 2025 02:22:04 JK

-------- MODULE PARAM ------------------------
MaxChnNum   MaxRoiNum   MaxProcNum
64          8           32

Parameter Settings (set)

axcl-smi set configures the device. Supported subcommands are:

Subcommand	Description
-f [MHz], --freq=[MHz]	Set device CPU frequency. Supported values: 1200000, 1400000, 1700000 MHz.

Example: Set CPU frequency of device index 0 to 1200MHz

m5stack@raspberrypi5:~ $ axcl-smi set -f 1200000 -d 0
set cpu frequency 1200000 to device 1 succeed.

Download Logs (log)

axcl-smi log downloads device log files to the host side. Supported parameters:

Parameter	Description
-t [mask], --type=[mask]	Specifies log types to download. Device-side log types: -1: all logs 0x01: daemon 0x02: worker 0x10: syslog 0x20: kernel log Recommended: `-1` to download all logs
-o [path], --output=[path]	Specifies save path for logs, supports absolute/relative paths, default is current directory. Directory must have write permissions.

Example: Download all logs from device index 0 to current directory

m5stack@raspberrypi5:~ $ axcl-smi log -d 0
[2025-07-25 10:04:30.332][1802][C][log][dump][73]: log dump finished: ./dev1_log_20250724210251.tar.gz 

Shell Commands (sh)

axcl-smi sh supports running shell commands on the device, typically used to query device module runtime proc info.

Example: Query CMM information for device index 0

m5stack@raspberrypi5:~ $ axcl-smi sh cat /proc/ax_proc/mem_cmm_info -d 0
--------------------SDK VERSION-------------------
[Axera version]: ax_cmm V3.6.3_20250722020142 Jul 22 2025 02:21:25 JK
+---PARTITION: Phys(0x148000000, 0x2FFFFFFFF), Size=7208960KB(7040MB),    NAME="anonymous"
 nBlock(Max=0, Cur=23, New=0, Free=0)  nbytes(Max=0B(0KB,0MB), Cur=19329024B(18876KB,18MB), New=0B(0KB,0MB), Free=0B(0KB,0MB))  Block(Max=0B(0KB,0MB), Min=0B(0KB,0MB), Avg=0B(0KB,0MB))
   |-Block: phys(0x148000000, 0x148013FFF), cache =non-cacheable, length=80KB(0MB),    name="TDP_DEV"
   ...
---CMM_USE_INFO:
 total size=7208960KB(7040MB),used=18876KB(18MB + 444KB),remain=7190084KB(7021MB + 580KB),partition_number=1,block_number=23

Important

If shell command parameters contain -, --, > etc., use double quotes, e.g., axcl-smi sh "ls -l" -d 0.
Use shell commands cautiously when configuring the device.

Reboot (reboot)

axcl-smi reboot first resets the specified device, then automatically reloads firmware. Example:

m5stack@raspberrypi5:~ $ axcl-smi reboot
Do you want to reboot device 0 ? (y/n): y

Next Overview

Linux PC

CardputerZero

CM4Stack

CoreMP135

AI Accelerator Card

LLM-8850 Card

Quick Start

Vision Models

Large Language Models

Multimodal Models

Audio Models

Generative Models

Application List

Advanced Usage

AI & Agent

Chat Coding

Real-Time AI Voice Assistant

OpenAI Voice Assistant

XiaoZhi Voice Assistant

XiaoLing Voice Assistant

AtomS3R-M12 Volcengine Kit

Offline Voice Recognition

Unit ASR

Module ASR

Industrial Control

StamPLC

IoT Measuring Instruments

Air Quality

PowerHub

Module13.2 PPS

VAMeter

T-Lite

Input & Output Devices

HID Input Devices

Audio Playback Devices

Display Devices

PaperColor

StopWatch

Ezdata

Ethernet Camera

PoECAM

Wi-Fi Camera

TimerCAM

Unit CamS3/-5MP

AI Camera

UnitV2

M5StickV/UnitV