AXCL-SMI Tool Usage
Overview
AXCL-SMI (System Management Interface) tool is used to collect device information, configure devices, etc., and supports the following device information collection:
- Hardware device model
- Firmware version number
- Driver version number
- Device utilization
- Memory usage
- Device chip temperature
- Other information
Usage
After correctly installing the AXCL driver package, axcl-smi is installed successfully, and you can directly execute axcl-smi to display the following content:
axcl-smi
rock@rock-5b-plus:~$ axcl-smi
+------------------------------------------------------------------------------------------------+
| AXCL-SMI V3.0.2_20250326020141 Driver V3.0.2_20250326020141 |
+-----------------------------------------+--------------+---------------------------------------+
| Card Name Firmware | Bus-Id | Memory-Usage |
| Fan Temp Pwr:Usage/Cap | CPU NPU | CMM-Usage |
|=========================================+==============+=======================================|
| 0 AX650N V3.0.2 | 0000:01:00.0 | 149 MiB / 945 MiB |
| -- 66C -- / -- | 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 that it is not the PCIe device number | Bus-Id | Device Bus ID |
| Name | Device name | CPU | CPU average utilization |
| Fan | Fan speed ratio (not supported) | NPU | NPU average utilization |
| Temp | Device chip temperature | Memory-Usage | System memory: used/total |
| Firmware | Device firmware version | CMM-Usage | Media memory: used/total |
| Pwr: Usage/Cap | Power (not supported) | ||
| PID | Main process PID | ||
| Process Name | Main process name | ||
| NPU Memory Usage | Device NPU used CMM memory |
Help (-h) and Version (-v)
axcl-smi -h queries help information
axcl-smi -h
rock@rock-5b-plus:~$ axcl-smi -h
usage: axcl-smi [<command> [<args>]] [--device] [--version] [--help]
axcl-smi System Management Interface V3.0.2_20250326020141
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 blow:
-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 queries the version of the AXCL-SMI tool.
axcl-smi -v
rock@rock-5b-plus:~$ axcl-smi -v
AXCL-SMI V3.0.2_20250326020141 BUILD: Mar 26 2025 02:27:24
Options
Device Number (-d, --device)
-d, --device Card index [0, connected cards number - 1]
[-d, --device] specifies the device number index, the range is: [0, connected device number - 1], default is 0th device.
Information Query (info)
axcl-smi info is used to display the detailed information of the device, support subcommands as follows:
| Subcommand | Description |
|---|---|
| temp | Display the temperature of the device chip, unit is Celsius x 1000. |
| mem | Display the detailed memory usage of the device system. |
| cmm | Display the media memory usage of the device. If you need more detailed media memory, execute axcl-smi sh cat /proc/ax_proc/mem_cmm_info -d xx (xx is the PCIe device number). |
| cpu | Display the CPU utilization of the device. |
| npu | Display the NPU utilization of the device. |
Example：Query the media memory usage of device 0
axcl-smi info --cmm -d 0
rock@rock-5b-plus:~$ 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 is used to query the proc information of the device module, support subcommands as follows:
| Subcommand | Description |
| --vdec | Query VDEC module proc (cat /proc/ax_proc/vdec) |
| --venc | Query VENC module proc (cat /proc/ax_proc/venc) |
| --jenc | Query JENC module proc (cat /proc/ax_proc/jenc) |
| --ivps | Query IVPS module proc (cat /proc/ax_proc/ivps) |
| --rgn | Query RGN module proc (cat /proc/ax_proc/rgn) |
| --ive | Query IVE module proc (cat /proc/ax_proc/ive) |
| --pool | Query POOL module proc (cat /proc/ax_proc/pool) |
| --link | Query LINK module proc (cat /proc/ax_proc/link_table) |
| --cmm | Query CMM module proc (cat /proc/ax_proc/mem_cmm_info) |
Example：Query VDEC proc information of device 0
axcl-smi proc --vdec -d 0
rock@rock-5b-plus:~$ axcl-smi proc --vdec -d 0
--------AX VDEC VERSION ------------------------
[Axera version]: ax_vdec V3.0.2_20250326020141 Mar 26 2025 02:20:01 JK
Parameter Setting (set)
axcl-smi set is used to configure device information, support subcommands as follows:
| Subcommand | Description |
|---|---|
| -f[MHz], --freq=[MHz] | Set the CPU frequency of the device, only supports 1200000, 1400000, 1700000 three frequencies |
Example：Set the CPU frequency of the device with index 0 to 1200MHz
axcl-smi set -f 1200000 -d 0
rock@rock-5b-plus:~$ axcl-smi set -f 1200000 -d 0
set cpu frequency 1200000 to device 1 succeed.
Download Log (log)
axcl-smi log is used to download device log files to the host side, support parameters as follows:
| Parameter | Description |
|---|---|
| -t[mask], --type=[mask] | Specify the log category to download. Device-side log categories are as follows: -1: All logs 0x01: Daemon 0x02: Business process 0x10: syslog 0x20: kernel log Recommended to download all logs |
| -o[path], --output=[path] | Specify the log save path, supports absolute and relative paths, default is the current directory. Note that the directory must have write permissions. |
Example：Download all logs of device 0 and save to the current directory
axcl-smi log -d 0
rock@rock-5b-plus:~$ axcl-smi log -d 0
[2025-07-22 07:31:59.215][1858][C][log][dump][73]: log dump finished: ./dev1_log_20250722122146.tar.gz
shell command (sh)
axcl-smi sh supports shell commands to query device information, usually used to query the running proc information of the device-side module, example: query the CMM information of the device with index 0
axcl-smi sh cat /proc/ax_proc/mem_cmm_info -d 0
rock@rock-5b-plus:~$ axcl-smi sh cat /proc/ax_proc/mem_cmm_info -d 0
--------------------SDK VERSION-------------------
[Axera version]: ax_cmm V3.0.2_20250326020141 Mar 26 2025 02:19:19 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"
|-Block: phys(0x148014000, 0x148014FFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3"
|-Block: phys(0x148015000, 0x148015FFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3_CPU"
|-Block: phys(0x148016000, 0x148029FFF), cache =non-cacheable, length=80KB(0MB), name="TDP_DEV"
|-Block: phys(0x14802A000, 0x14802AFFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3"
|-Block: phys(0x14802B000, 0x14802BFFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3_CPU"
|-Block: phys(0x14802C000, 0x14862BFFF), cache =non-cacheable, length=6144KB(6MB), name="vdec_ko"
|-Block: phys(0x14862C000, 0x148647FFF), cache =non-cacheable, length=112KB(0MB), name="VGP_DEV"
|-Block: phys(0x148648000, 0x148648FFF), cache =non-cacheable, length=4KB(0MB), name="VGP_CMODE3"
|-Block: phys(0x148649000, 0x148649FFF), cache =non-cacheable, length=4KB(0MB), name="VGP_CMODE3_CPU"
|-Block: phys(0x14864A000, 0x148665FFF), cache =non-cacheable, length=112KB(0MB), name="VPP_DEV"
|-Block: phys(0x148666000, 0x148666FFF), cache =non-cacheable, length=4KB(0MB), name="VPP_CMODE3"
|-Block: phys(0x148667000, 0x148667FFF), cache =non-cacheable, length=4KB(0MB), name="VPP_CMODE3_CPU"
|-Block: phys(0x148668000, 0x1487E7FFF), cache =non-cacheable, length=1536KB(1MB), name="h26x_ko"
|-Block: phys(0x1487E8000, 0x148967FFF), cache =non-cacheable, length=1536KB(1MB), name="h26x_ko"
|-Block: phys(0x148968000, 0x148968FFF), cache =non-cacheable, length=4KB(0MB), name="h26x_ko"
|-Block: phys(0x148969000, 0x148AE8FFF), cache =non-cacheable, length=1536KB(1MB), name="jenc_ko"
|-Block: phys(0x148AE9000, 0x148C68FFF), cache =non-cacheable, length=1536KB(1MB), name="jenc_ko"
|-Block: phys(0x148C69000, 0x148C69FFF), cache =non-cacheable, length=4KB(0MB), name="jenc_ko"
|-Block: phys(0x148C6A000, 0x148C6AFFF), cache =non-cacheable, length=4KB(0MB), name="GDC_CMDA3"
|-Block: phys(0x148C6B000, 0x148C6BFFF), cache =non-cacheable, length=4KB(0MB), name="GDC_CMDA3_CPU"
|-Block: phys(0x148C6C000, 0x148C6EFFF), cache =non-cacheable, length=12KB(0MB), name="GDC_CMD"
|-Block: phys(0x148C6F000, 0x14926EFFF), cache =non-cacheable, length=6144KB(6MB), name="vdec_ko"
---CMM_USE_INFO:
total size=7208960KB(7040MB),used=18876KB(18MB + 444KB),remain=7190084KB(7021MB + 580KB),partition_number=1,block_number=23
Reboot (reboot)
axcl-smi reboot command first resets the specified device, then automatically loads the firmware, as shown below:
axcl-smi reboot -d 0
rock@rock-5b-plus:~$ axcl-smi reboot -d 0
Do you want to reboot device 0 ? (y/n): y