9. AXCL SMI#
9.1. 概述#
AXCL-SMI (System Management Interface) 工具用于设备信息收集，对设备进行配置等功能，支持如下设备信息收集：
硬件设备型号
固件版本号
驱动版本号
设备利用率
内存使用情况
设备芯片结温
其他信息
9.2. 使用说明#
9.2.1. 快速使用#
在正确安装AXCL驱动包后，AXCL-SMI即安装成功，直接执行axcl_smi显示内容如下：
# ./axcl_smi
+------------------------------------------------------------------------------------------------+
| AXCL-SMI V2.18.0 Driver V2.18.0 |
+-----------------------------------------+--------------+---------------------------------------+
| Card Name Firmware | Bus-Id | Memory-Usage |
| Fan Temp Pwr:Usage/Cap | CPU NPU | CMM-Usage |
|=========================================+==============+=======================================|
| 0 AX650N V2.18.0 | 0001:81:00.0 | 181 MiB / 954 MiB |
| -- 52C -- / -- | 3% 0% | 22 MiB / 3072 MiB |
+-----------------------------------------+--------------+---------------------------------------+
+------------------------------------------------------------------------------------------------+
| Processes: |
| Card PID Process Name NPU Memory Usage |
|================================================================================================|
| 0 763 /opt/bin/axcl/axcl_run_model 160 KiB |
+------------------------------------------------------------------------------------------------+
字段说明
字段 |
说明 |
字段 |
说明 |
|---|---|---|---|
Card |
设备编号，注意不是PCIe的设备号 |
Bus-Id |
设备Bus ID |
Name |
设备名称 |
CPU |
CPU平均利用率 |
Fan |
风扇转速比（未支持） |
NPU |
NPU平均利用率 |
Temp |
设备芯片结温 |
Memory-Usage |
系统内存： 使用/总量 |
Firmware |
设备固件版本号 |
CMM-Usage |
媒体内存： 使用/总量 |
Pwr: Usage/Cap |
功耗（未支持） |
||
PID |
主控进程PID |
||
Process Name |
主控进程 |
||
NPU Memory Usage |
设备NPI已使用的CMM内存 |
9.2.2. 帮助 (-h) 和版本 (-v)#
axcl_smi -h 查询帮助信息
# ./axcl_smi -h
usage: ./axcl_smi [<command> [<args>]] [--device] [--version] [--help]
AXCL-SMI System Management Interface V2.18.0
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
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
-d, --device Specifies a device ID or 0 (default) select all devices
-v, --version Show AXCL-SMI version
-h, --help Show this help menu
axcl_smi -v 查询AXCL-SMI工具的版本
# ./axcl_smi -v
AXCL-SMI V2.18.0 BUILD: Dec 2 2024 13:14:36
9.2.3. 选项#
9.2.3.1. 设备ID (-d, --device)#
-d, --device Specifies a device ID or 0 (default) select all devices
[-d, --device] 指定设备，默认参数 = 0，标识连接到HOST的全部设备， -d或者--device 参数是十进制。
备注
如何查询设备ID，参阅 FAQ
9.2.4. 信息查询（info）#
axcl_smi info用于显示设备的详细信息，支持子命令如下：
子命令 |
说明 |
|---|---|
--temp |
显示设备芯片结温，单位是摄氏度x1000。 |
--mem |
显示设备系统详细内存使用情况。 |
--cmm |
显示设备媒体内存使用情况。如果需要更详细的媒体内存，执行 |
--cpu |
显示设备CPU利用率。 |
--npu |
显示设备NPU利用率。 |
重要
结合[-d, --device]选项查询指定设备的信息，不指定设备则查询全部连接的设备
# 查询设备129的媒体内存使用情况
# ./axcl_smi info --cmm -d 129
Device ID : 129 (0x81)
CMM Total : 3145728 KiB
CMM Used : 18876 KiB
CMM Remain : 3126852 kiB
9.2.5. 参数设置（set）#
axcl_smi set 用户配置设备信息，支持的子命令如下：
子命令 |
说明 |
|---|---|
-f[MHz], --freq=[MHz] |
设置设备的CPU频率，只支持 1200000, 1400000, 1700000 三种频率 |
备注
必须结合[-d, --device]选项指定设备
# ./axcl_smi set -f 1200000 -d 129
set cpu frequency 1200000 to device 129 succeed.
9.2.6. 下载日志（log）#
axcl_smi log 用于下载设备的日志文件到主控侧，支持的参数如下：
参数 |
说明 |
|---|---|
-t[mask], --type=[mask] |
指定下载的日志类别。设备侧日志类别如下： |
-o[path], --output=[path] |
指定日志保存路径，支持绝对和相对路径，默认是当前目录。注意目录需要有写权限。 |
重要
结合[-d, --device]选项下载指定设备的日志，不指定设备则依次下载全部连接的设备日志。
# 下载设备号129的全部日志，并保存到当前目录
# ./axcl_smi log -d 129
[2024-12-02 15:41:00.015][934][C][log][dump][73]: log dump finished: ./dev129_log_20241202154059.tar.gz
9.2.7. shell命令（sh）#
axcl_smi sh 支持shell命令查询设备信息，通常用于查询设备侧模块的运行proc信息，示例：
# ./axcl_smi sh cat /proc/ax_proc/mem_cmm_info -d 129
--------------------SDK VERSION-------------------
[Axera version]: ax_cmm V2.18.0_20241201230759 Dec 1 2024 23:23:40 JK
+---PARTITION: Phys(0x180000000, 0x23FFFFFFF), Size=3145728KB(3072MB), 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(0x180000000, 0x180013FFF), cache =non-cacheable, length=80KB(0MB), name="TDP_DEV"
|-Block: phys(0x180014000, 0x180014FFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3"
|-Block: phys(0x180015000, 0x180015FFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3_CPU"
|-Block: phys(0x180016000, 0x180029FFF), cache =non-cacheable, length=80KB(0MB), name="TDP_DEV"
|-Block: phys(0x18002A000, 0x18002AFFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3"
|-Block: phys(0x18002B000, 0x18002BFFF), cache =non-cacheable, length=4KB(0MB), name="TDP_CMODE3_CPU"
|-Block: phys(0x18002C000, 0x180047FFF), cache =non-cacheable, length=112KB(0MB), name="VGP_DEV"
|-Block: phys(0x180048000, 0x180048FFF), cache =non-cacheable, length=4KB(0MB), name="VGP_CMODE3"
|-Block: phys(0x180049000, 0x180049FFF), cache =non-cacheable, length=4KB(0MB), name="VGP_CMODE3_CPU"
|-Block: phys(0x18004A000, 0x1801C9FFF), cache =non-cacheable, length=1536KB(1MB), name="h26x_ko"
|-Block: phys(0x1801CA000, 0x180349FFF), cache =non-cacheable, length=1536KB(1MB), name="h26x_ko"
|-Block: phys(0x18034A000, 0x18034AFFF), cache =non-cacheable, length=4KB(0MB), name="h26x_ko"
|-Block: phys(0x18034B000, 0x18094AFFF), cache =non-cacheable, length=6144KB(6MB), name="vdec_ko"
|-Block: phys(0x18094B000, 0x180ACAFFF), cache =non-cacheable, length=1536KB(1MB), name="jenc_ko"
|-Block: phys(0x180ACB000, 0x180C4AFFF), cache =non-cacheable, length=1536KB(1MB), name="jenc_ko"
|-Block: phys(0x180C4B000, 0x180C4BFFF), cache =non-cacheable, length=4KB(0MB), name="jenc_ko"
|-Block: phys(0x180C4C000, 0x180C67FFF), cache =non-cacheable, length=112KB(0MB), name="VPP_DEV"
|-Block: phys(0x180C68000, 0x180C68FFF), cache =non-cacheable, length=4KB(0MB), name="VPP_CMODE3"
|-Block: phys(0x180C69000, 0x180C69FFF), cache =non-cacheable, length=4KB(0MB), name="VPP_CMODE3_CPU"
|-Block: phys(0x180C6A000, 0x181269FFF), cache =non-cacheable, length=6144KB(6MB), name="vdec_ko"
|-Block: phys(0x18126A000, 0x18126AFFF), cache =non-cacheable, length=4KB(0MB), name="GDC_CMDA3"
|-Block: phys(0x18126B000, 0x18126BFFF), cache =non-cacheable, length=4KB(0MB), name="GDC_CMDA3_CPU"
|-Block: phys(0x18126C000, 0x18126EFFF), cache =non-cacheable, length=12KB(0MB), name="GDC_CMD"
---CMM_USE_INFO:
total size=3145728KB(3072MB),used=18876KB(18MB + 444KB),remain=3126852KB(3053MB + 580KB),partition_number=1,block_number=23
重要
必须结合
[-d, --device]选项指定设备shell命令参数如果包含
-,--,>等字段，可以用双引号"-l"将命令和参数包含在一个字符串中，比如axcl_smi sh "ls -l" -d 129谨慎使用shell命令对设备进行配置
9.3. FAQ#
9.3.1. 查询设备ID，配置 -d, --device#
执行axcl_smi或者lspci，从Bus-Id字段可以获取设备ID，填入-d或--device参数。
示例1：
Bus-Id: 0000:03:00.0，那么设备ID = 0x03，即-d 3
[axera@localhost ~]$ lspci
00:00.0 Host bridge: Intel Corporation 8th Gen Core Processor Host Bridge/DRAM Registers (rev 07)
...
03:00.0 Multimedia video controller: Axera Semiconductor Co., Ltd Device 0650 (rev 01)
[axera@localhost ~]$ axcl_smi
+------------------------------------------------------------------------------------------------+
| AXCL-SMI V2.18.0_20241202180518 Driver V2.18.0_20241202180518 |
+-----------------------------------------+--------------+---------------------------------------+
| Card Name Firmware | Bus-Id | Memory-Usage |
| Fan Temp Pwr:Usage/Cap | CPU NPU | CMM-Usage |
|=========================================+==============+=======================================|
| 0 AX650N V2.18.0 | 0000:03:00.0 | 154 MiB / 954 MiB |
| -- 37C -- / -- | 1% 0% | 18 MiB / 3072 MiB |
+-----------------------------------------+--------------+---------------------------------------+
示例2：
Bus-Id: 0001:81:00.0，那么设备ID = 0x81 = 129，即-d 129
lspci
0000:00:00.0 Class 0604: Device 16c3:abcd (rev 01)
0001:80:00.0 Class 0604: Device 16c3:abcd (rev 01)
0001:81:00.0 Class 0400: Device 1f4b:0650 (rev 01)
/opt/bin/axcl # ./axcl_smi
i 0 = 748 pid = 748
+------------------------------------------------------------------------------------------------+
| AXCL-SMI V2.18.0 Driver V2.18.0 |
+-----------------------------------------+--------------+---------------------------------------+
| Card Name Firmware | Bus-Id | Memory-Usage |
| Fan Temp Pwr:Usage/Cap | CPU NPU | CMM-Usage |
|=========================================+==============+=======================================|
| 0 AX650N V2.18.0 | 0001:81:00.0 | 157 MiB / 954 MiB |
| -- 42C -- / -- | 2% 0% | 18 MiB / 3072 MiB |
+-----------------------------------------+--------------+---------------------------------------+