# AXCL SMI ## 概述 AXCL-SMI (System Management Interface) 工具用于设备信息收集，对设备进行配置等功能，支持如下设备信息收集： - 硬件设备型号 - 固件版本号 - 驱动版本号 - 设备利用率 - 内存使用情况 - 设备芯片结温 - 其他信息 ## 使用说明 ### 快速使用 在正确安装AXCL驱动包后，AXCL-SMI即安装成功，直接执行`axcl_smi`显示内容如下： ```bash # ./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内存 | | | ### 帮助 (-h) 和版本 (-v) `axcl_smi -h` 查询帮助信息 ```bash # ./axcl_smi -h usage: ./axcl_smi [ []] [--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工具的版本 ```bash # ./axcl_smi -v AXCL-SMI V2.18.0 BUILD: Dec 2 2024 13:14:36 ``` ### 选项 #### 设备ID (-d, --device) ```bash -d, --device Specifies a device ID or 0 (default) select all devices ``` `[-d, --device]` 指定设备，默认参数 = 0，标识连接到HOST的全部设备， **-d或者--device 参数是十进制。** :::{Note} 如何查询设备ID，参阅 [`FAQ`](#configdevice) ::: ### 信息查询（info） `axcl_smi info`用于显示设备的详细信息，支持子命令如下： | 子命令 | 说明 | | ------ | ------------------------------------------------------------ | | --temp | 显示设备芯片结温，单位是摄氏度x1000。 | | --mem | 显示设备系统详细内存使用情况。 | | --cmm | 显示设备媒体内存使用情况。如果需要更详细的媒体内存，执行`axcl_smi sh cat /proc/ax_proc/mem_cmm_info -d xx` (xx是PCIe设备号)。 | | --cpu | 显示设备CPU利用率。 | | --npu | 显示设备NPU利用率。 | :::{Important} 结合`[-d, --device]`选项查询指定设备的信息，不指定设备则查询全部连接的设备 ```bash # 查询设备129的媒体内存使用情况 # ./axcl_smi info --cmm -d 129 Device ID : 129 (0x81) CMM Total : 3145728 KiB CMM Used : 18876 KiB CMM Remain : 3126852 kiB ``` ::: ### 参数设置（set） `axcl_smi set` 用户配置设备信息，支持的子命令如下： | 子命令 | 说明 | | --------------------- | ------------------------------------------------------------ | | -f[MHz], --freq=[MHz] | 设置设备的CPU频率，只支持 1200000, 1400000, 1700000 三种频率 | :::{Note} 必须结合`[-d, --device]`选项指定设备 ```bash # ./axcl_smi set -f 1200000 -d 129 set cpu frequency 1200000 to device 129 succeed. ``` ::: ### 下载日志（log） `axcl_smi log` 用于下载设备的日志文件到主控侧，支持的参数如下： | 参数 | 说明 | | ------------------------- | ------------------------------------------------------------ | | -t[mask], --type=[mask] | 指定下载的日志类别。设备侧日志类别如下：
-1： 全部日志
0x01：守护进程
0x02: 业务进程
0x10：syslog
0x20：内核日志
推荐-1下载全部日志 | | -o[path], --output=[path] | 指定日志保存路径，支持绝对和相对路径，默认是当前目录。注意目录需要有写权限。 | :::{Important} 结合`[-d, --device]`选项下载指定设备的日志，不指定设备则依次下载全部连接的设备日志。 ```bash # 下载设备号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 ``` ::: ### 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 ``` :::{Important} - 必须结合`[-d, --device]`选项指定设备 - shell命令参数如果包含`-`,`--`,`>`等字段，可以用双引号`"-l"`将命令和参数包含在一个字符串中，比如`axcl_smi sh "ls -l" -d 129` - 谨慎使用shell命令对设备进行配置 ::: ## FAQ ### [查询设备ID，配置 -d, --device](#configdevice) 执行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 | +-----------------------------------------+--------------+---------------------------------------+ ```