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

Note

See FAQ DDR Bandwidth and NPU Utilization to understand how to get detailed DDR and NPU utilization.

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

CM4Stack

CoreMP135

AI Accelerator Card

LLM-8850 Card

Quick Start

Vision Models

Large Language Models

Multimodal Models

Audio Models

Generative Models

Advanced Usage

LLM

Real-Time AI Voice Assistant

OpenAI Voice Assistant

XiaoZhi Voice Assistant

XiaoLing Voice Assistant

AtomS3R-M12 Volcengine Kit

Offline Voice Recognition

Unit ASR

Home Assistant

Industrial Control

StamPLC

IoT Measuring Instruments

Air Quality

Module13.2 PPS

VAMeter

T-Lite

Ezdata

Ethernet Camera

PoECAM

Wi-Fi Camera

TimerCAM

Unit CamS3/-5MP

AI Camera

UnitV2

M5StickV/UnitV

LoRa & LoRaWAN

TTN (The Things Network)

Meshtastic

Motor Control

Unit Roller485/CAN

Develop Tools

Hobby Kit

Restore Factory Firmware