4. 工具指令说明
4.1. 使用说明
通过下面指令获取后摩设备的信息：
驱动安装后，可在任意路径下使用SMI工具。
hm_smi [OPTION1 [ARG1]] [OPTION2 [ARG2]] ....
4.2. 指令参数说明
指令支持的参数如下表所示：
指令参数 |
描述 |
|---|---|
|
查看当前所有逻辑设备的信息。 |
|
查看逻辑ID为 <device_id> 的后摩设备的信息。 |
|
查看指定字段的后摩设备信息。<FIELD> 表示待查询的字段名。支持指定一个或多个字段，字段之间以空格分隔。参看 回显信息说明。 注：参数 -f 必须与 -a 参数共同使用。 |
|
设置后摩设备的 DVFS（Dynamic Voltage and Frequency Scaling，动态电压与频率调整）模式。详情参看 设置后摩设备 DVFS。 |
|
以指定时间间隔循环打印后摩设备的信息。其中：
不使用该参数时，默认信息只打印一次。 |
|
锁定后摩逻辑设备的IPU核最高时钟频率。 |
|
复位指定的逻辑设备的IPU核 <device_id>。 |
|
复位逻辑ID为 <device_id> 的后摩设备。 LM5070和LM5050智能加速卡不支持使用该方式重启后摩设备。需关闭主机并重新启动主机，以完成设备重启。 |
|
设置AI处理器板卡功耗范围。 |
|
将回显信息保存为 |
|
用于设置SMI指令的日志等级，便于用户调试和排查问题。
默认输出基础日志信息。 |
|
查看指令帮助信息。 |
指令回显信息将打印在屏幕上。
4.3. 回显信息说明
指令返回的后摩设备的主要信息如下：
字段 |
描述 |
|---|---|
|
SMI工具构建时间。 |
|
后摩软件平台版本号。 |
|
SMI工具版本号。 |
时间戳 |
SMI工具触发时当前系统的时间戳。格式为： |
|
主机端驱动版本号。 |
|
设备厂商信息。 |
|
当前逻辑设备的 PCIe BDF（Bus, Device, Function）信息，用于唯一标识 PCIe 设备在系统中的位置。格式为：
例如，01:00.0代表总线1、设备0、功能0的设备。 |
|
当前后摩设备的逻辑ID，表示操作系统或软件层管理和识别设备而分配的标识符，也可被 TCIM 接口使用。 |
|
当前逻辑设备的PCIe带宽，包括：
|
|
后摩设备电源管理，包括设备设置及状态：
|
|
CTC（Chip-to-Chip）互连组ID，标识一个独立的 CTC 互连域。仅适用于包含多颗M50芯片的设备。 当后摩设备中包含多颗M50芯片时，通过CTC互连的M50芯片会组成一个逻辑分组。每个分组代表一个独立的CTC互连域。只有属于同一分组的芯片之间，才能建立物理CTC连接。 |
|
芯片ID，表示该芯片在所属CTC互连组内部的唯一硬件索引。 |
|
当前后摩设备序列号，用于唯一标识单台设备，并支持生产与质量追溯。 |
|
当前后摩设备产品料号，用于标识设备型号及配置规格。 |
|
当前后摩设备型号。 |
|
当前逻辑设备内存信息。包括 |
|
当前逻辑设备中，系统剩余可用DDR内存容量，单位为MB。 当前内存中尚未被占用的空闲空间。 |
|
当前逻辑设备中，系统可用DDR内存总容量，单位为MB。 系统初始化后，当前逻辑设备可供分配使用的内存总量。该数值已扣除系统预留，略小于物理总容量。 |
|
当前逻辑设备每个IPU核和DDR颗粒的实时温度，单位为°C。 |
|
当前逻辑设备中，各DDR颗粒当前温度。 |
|
当前逻辑设备中，各IPU核当前温度。 |
|
当前AI处理器板卡的实时平均功耗，单位为W。 在后摩多芯片产品中，为避免数据重复采集，该字段仅通过主逻辑设备（即 |
|
当前逻辑设备IPU核信息。 |
|
当前逻辑设备包含的IPU核数。 |
|
当前逻辑设备的IPU核频率。 |
|
当前逻辑设备IPU核的电压。 |
|
所有IPU核过去1秒的平均利用率。 |
|
每个IPU核过去1秒的利用率。其中 |
|
驱动构建时间。 |
|
固件版本号。 |
|
固件构建日期。 |
|
用于构建并安装驱动程序的用户名。 |
|
M50芯片硬件修订版本。 |
|
当前逻辑设备可用的IPU核分布掩码。掩码中的特定位代表对应的IPU核状态：
|
|
通用唯一标识符，仅内部使用。 |
|
当前逻辑设备中，物理DDR颗粒总数。 |
|
当前逻辑设备中，每颗物理DDR颗粒容量（单位为 GB）。 |
|
当前逻辑设备DDR时序校准的算法版本。 |
|
主逻辑设备标识。标识当前逻辑设备是否返回AI处理器板卡的实时平均功耗。 在后摩多芯片产品中，为避免数据重复采集，仅主逻辑设备负责返回板卡功耗信息。
|
4.4. 查看所有后摩设备的信息
输入下面指令，查看当前所有后摩逻辑设备的信息：
hm_smi -a
下面为在Linux系统下的返回信息示例：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 13:58:28 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : performance
Cur_Ipu_Freq : 1300.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 1300.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 25.9 C
DDR2 : 26.6 C
DDR4 : 23.6 C
DDR5 : 24.8 C
Core0 : 27.2 C
Core1 : 26.0 C
Board_Power : 5.26 W
--------------------------------------------------------------------------------
下面为在Windows系统下的返回信息示例：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:38
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:04:37 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : performance
Cur_Ipu_Freq : 1300.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 1300.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 22.7 C
DDR2 : 23.3 C
DDR4 : 20.3 C
DDR5 : 21.5 C
Core0 : 23.9 C
Core1 : 22.7 C
Board_Power : 5.37 W
--------------------------------------------------------------------------------
4.5. 查看指定逻辑设备的信息
输入下面指令，查看指定逻辑ID的后摩设备信息，device_id 应替换为要查看的后摩设备逻辑ID：
hm_smi -d <device_id>
例如，查看逻辑ID为0的后摩设备信息：
hm_smi -d 0
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 13:58:29 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
BDF : 0000:01:00.0
Driver_Build_Time : 2026-07-15 13:52:20 CST
Dev : 0
Firmware_Version : V1.4.0
Firmware_Build_Time : 2026-07-15
Group_Id : 0
Chip_Id : 0
--------------------------------------------------------------------------------
4.6. 查看指定字段信息
输入下面指令，查看指定字段的后摩设备信息：
注意
参数 -f 必须与 -a 参数共同使用。
hm_smi -a -f <FIELD> [<FIELD> ...]
<FIELD> 表示待查询的字段名。支持指定一个或多个字段，字段之间以空格分隔。支持的字段列表参见 回显信息说明。
下面示例展示如何查看逻辑设备ID为0的主机端驱动版本号：
hm_smi -a -f Driver_Version -d 0
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:06:10 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
--------------------------------------------------------------------------------
下面示例展示如何查看逻辑设备ID为0的PCIe带宽和设备内存 DDR 未使用容量：
hm_smi -a -f Cur_BandWidth DDR_Memory_Free -d 0
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:10:28 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Cur_BandWidth : 8.0 GT/s x 4lane
DDR_Memory_Free : 12160.0MB
--------------------------------------------------------------------------------
4.7. 循环查看后摩设备信息
输入下面指令，以指定时间间隔循环查看后摩设备的信息：
hm_smi -l <sec> [OPTIONS]
<sec> 应替换为循环打印的时间间隔，单位为秒。[OPTIONS] 应替换为相关参数，如 --all 或者 --device device_id。
可以按下 Ctrl+C 终止循环，否则将无限期循环打印后摩设备的信息。
下面示例展示如何每隔5秒查看后摩设备逻辑ID为0的信息：
hm_smi -l 5 -d 0
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:10:57 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
BDF : 0000:01:00.0
Driver_Build_Time : 2026-07-15 13:52:20 CST
Dev : 0
Firmware_Version : V1.4.0
Firmware_Build_Time : 2026-07-15
Group_Id : 0
Chip_Id : 0
--------------------------------------------------------------------------------
Wed Jul 15 15:11:02 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
BDF : 0000:01:00.0
Driver_Build_Time : 2026-07-15 13:52:20 CST
Dev : 0
Firmware_Version : V1.4.0
Firmware_Build_Time : 2026-07-15
Group_Id : 0
Chip_Id : 0
--------------------------------------------------------------------------------
...
4.8. 设置后摩设备 DVFS
后摩设备 DVFS（Dynamic Voltage and Frequency Scaling，动态电压与频率调整）支持功能如下：
固定高性能模式： 支持后摩设备IPU核始终运行在最大频率下，确保性能稳定。
按需动态调整频率： 系统根据后摩设备IPU核实时负载，在不超过当前设置的IPU核最大频率值的前提下，自动调整IPU核运行频率，帮助用户在性能与功耗之间实现平衡。
功耗限制模式： 根据用户设置的AI处理器板卡功耗范围，动态调整IPU核频率，以满足功耗要求。
锁定IPU频率最大值： 支持用户锁定IPU核允许运行的最大工作频率上限，用于约束
performance、ondemand和powerlimit模式下IPU核可运行的最高频率。
详情参看 《功耗和热管理使用指南》。
4.8.1. 后摩设备IPU核频率取值
IPU核频率取值由所使用的后摩设备及板载M50芯片工作配置决定。在配置DVFS运行模式或执行频率锁定命令时，用户需要以此处定义的硬件合规边界为准。
用户可通过 hm_smi -a 指令返回的 PN 字段获取当前后摩逻辑设备的PN号，并根据PN中第7位编码值确认当前产品所搭载单颗M50芯片的工作配置。确认配置后，可参考下表查看对应的IPU核频率支持范围和默认频率。
注意
默认IPU核频率为经过测试验证的稳定运行频率，可覆盖大多数典型应用场景的性能与稳定性需求。设置高于默认值的IPU核频率可能提升部分场景下的计算性能，但会增加功耗、温升及系统负载。在极端测试用例、长时间高负载运行或散热条件受限的场景下，可能导致性能波动、任务超时、设备异常复位等稳定性风险。
产品 |
PN第7位编码值 |
板载单颗M50芯片配置 |
支持的IPU核频率值 |
默认IPU核频率最高值 |
|---|---|---|---|---|
LQ50 M.2卡 |
1 |
标准功耗配置（双IPU核，主频1400 MHz，标准工作电压） |
1300 MHz、1400 MHz |
1300 MHz |
2 |
低功耗优化配置（双IPU核，主频1400 MHz，低工作电压） |
1300 MHz、1400 MHz |
1400 MHz |
|
LQ50 Duo M.2卡 |
1 |
标准功耗配置（双IPU核，主频1400 MHz，标准工作电压） |
1300 MHz、1400 MHz |
1300 MHz |
2 |
低功耗优化配置（双IPU核，主频1400 MHz，低工作电压） |
1300 MHz、1400 MHz |
1400 MHz |
|
LM5070智能加速卡 |
1 |
标准功耗配置（双IPU核，主频1400 MHz，标准工作电压） |
1300 MHz、1400 MHz |
1300 MHz |
3 |
高频性能配置（双IPU核，超高频1700 MHz，高工作电压） |
1700 MHz、1400 MHz、1300 MHz |
1700 MHz |
|
LM5050智能加速卡 |
1 |
标准功耗配置（双IPU核，主频1400 MHz，标准工作电压） |
1300 MHz、1400 MHz |
1300 MHz |
LM5030智能加速卡 |
1 |
标准功耗配置（双IPU核，主频1400 MHz，标准工作电压） |
1300 MHz、1400 MHz |
1300 MHz |
板载单颗M50芯片的工作电压标准为：标准工作电压（0.75V）、低工作电压（0.7V）、高工作电压（0.8V）。
详细的编码规则与含义，请参看：
LQ50 M.2 卡：《LM50 M.2卡用户指南》
LQ50 Duo M.2 卡：《LM50 Duo M.2卡用户指南》
LM5070 智能加速卡：《LM50智能加速卡用户指南》
LM5050 智能加速卡：《LM50智能加速卡用户指南》
LM5030 智能加速卡：《LM50智能加速卡用户指南》
4.8.2. IPU核自动调频档位运行机制
在 ondemand 和 powerlimit 模式下，当触发系统自适应调节时，系统并不会进行无限连续的微调，而是在既定的几个频率档位之间进行切换。
下表列出了系统内部基于用户锁定的最高频率值（通过 hm_smi -lc 指定，未指定时默认为上表中的“默认最高值”），按比例自适应计算得到的控频基准数值。
表中字段含义如下：
M50芯片工作电压： 表示板载单颗M50芯片在当前工作配置下的工作电压。了解当前后摩逻辑设备的工作电压配置，参看 后摩设备IPU核频率取值。
锁定的IPU核频率值： 表示通过
hm_smi -lc <lock_clocks>指令锁定的IPU核频率最高值。75%调频频率值和50%调频频率值： 表示系统内部基于
hm_smi -lc设置频率按比例计算得到的自动调频频率值。注意
表中的75%和50%档位仅支持系统自动调整，不支持用户通过指令行手动指定或创建自定义的中间频率数值。
M50芯片工作电压 |
设置的IPU核频率值 |
75%调频频率值 |
50%调频频率值 |
|---|---|---|---|
0.75V |
1300 MHz |
975 MHz |
650 MHz |
0.75V |
1400 MHz |
1050 MHz |
700 MHz |
0.7V |
1400 MHz |
1050 MHz |
700 MHz |
0.7V |
1300 MHz |
975 MHz |
650 MHz |
0.8V |
1700 MHz |
1275 MHz |
850 MHz |
4.8.3. 指令说明
输入下面指令，设置后摩设备的DVFS模式：
hm_smi -g <mode> [OPTIONS]
参数说明如下：
<mode> 应替换为DVFS模式，支持取值如下：
performance：IPU核始终运行在最大频率下（默认模式）。详情参看 设置IPU核始终在最大频率下运行。ondemand：根据IPU核的实时利用率动态调整IPU核运行频率，调整后的频率不会超过当前设置的IPU核最大频率值。详情参看 基于IPU利用率调整频率。powerlimit：根据设置的AI处理器板卡功耗范围，在不超过当前设置的 IPU 核最大频率值的前提下，动态调整IPU核的频率，以满足功耗要求。必须同时指定-pl参数，用于设置AI 处理器板卡参考功耗范围。详情参看 基于功耗阈值调整频率。
[OPTIONS] 应替换为相关参数，如
--all、-l <sec> [OPTIONS]等。
4.8.4. 注意事项
默认模式为
performance，若指令切换到powerlimit模式，需确保该指令持续运行，若当前 SMI 会话终止（正常或异常），系统将自动恢复为performance模式。若需长期保持powerlimit模式生效，可使用-l <sec>参数使指令以指定间隔持续执行并刷新设置。ondemand模式不受SMI会话状态影响，即使关闭SMI会话，设备仍保持在ondemand模式。设备断电后，再次上电时会恢复为默认的
performance模式。当多个终端运行SMI指令时，模式设置以最新执行的指令设置为准。
在
powerlimit模式下，如果IPU核在最低频率下仍超出功耗限制，系统将保持最低频率。模式设置应用于与主机连接的所有逻辑设备，不支持对单个逻辑设备进行设置。
IPU核频率默认范围与所使用的后摩设备有关，可通过在指令中添加参数 -lc <lock_clocks> 来设置IPU核频率的最大频率。
4.8.5. 设置IPU核始终在最大频率下运行
设置当前模式为 performance，IPU核始终在最大频率下运行。
hm_smi -g performance -a
4.8.5.1. 示例
下面示例展示如何设置当前模式为 performance，并且每隔30秒查看所有后摩设备信息。
hm_smi -g performance -l 30 -a
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:11:46 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : performance
Cur_Ipu_Freq : 1300.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 1300.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 25.6 C
DDR2 : 26.0 C
DDR4 : 23.0 C
DDR5 : 24.2 C
Core0 : 26.9 C
Core1 : 25.6 C
Board_Power : 5.27 W
--------------------------------------------------------------------------------
Wed Jul 15 15:12:16 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : performance
Cur_Ipu_Freq : 1300.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 1300.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 24.8 C
DDR2 : 25.6 C
DDR4 : 22.4 C
DDR5 : 23.6 C
Core0 : 25.9 C
Core1 : 25.0 C
Board_Power : 5.25 W
--------------------------------------------------------------------------------
...
4.8.6. 基于IPU利用率调整频率
设置当前模式为 ondemand。在该模式下，系统会根据IPU核实时利用率，在不超过当前锁定的IPU核最大频率值的前提下，动态调整IPU核运行频率。支持的IPU核频率档位与所使用的后摩设备有关，详情参看 IPU核自动调频档位运行机制。
hm_smi -g ondemand -a
4.8.6.1. 示例
下面示例展示如何设置当前模式为 ondemand，并且每隔30秒查看所有后摩设备信息。
hm_smi -g ondemand -l 30 -a
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:12:49 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : ondemand
Cur_Ipu_Freq : 650.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 975.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 25.6 C
DDR2 : 26.0 C
DDR4 : 23.0 C
DDR5 : 24.5 C
Core0 : 26.6 C
Core1 : 25.6 C
Board_Power : 5.25 W
--------------------------------------------------------------------------------
Wed Jul 15 15:13:19 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : ondemand
Cur_Ipu_Freq : 650.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 650.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 24.5 C
DDR2 : 25.3 C
DDR4 : 21.9 C
DDR5 : 23.3 C
Core0 : 25.6 C
Core1 : 24.8 C
Board_Power : 3.38 W
--------------------------------------------------------------------------------
...
4.8.7. 基于功耗阈值调整频率
设置当前模式为 powerlimit，系统根据设置的AI 处理器板卡功耗范围，动态调整IPU核的频率，以满足功耗要求。
hm_smi -g powerlimit -pl <max_power> <min_power> -l <sec> -a
参数说明如下：
<max_power> ：设置用于动态调整 IPU 核频率的最大功耗阈值。最大取值为200 W。该值为调整IPU核频率的参考功耗，与实际AI 处理器板卡的功耗限制无关。
<min_power> ：设置用于动态调整 IPU 核频率的最小功耗阈值。该值为调整IPU核频率的参考功耗，与实际AI处理器板卡的功耗限制无关。
<sec>：循环打印的时间间隔，单位为秒。
4.8.7.1. 注意事项
频率调整说明：
IPU核频率动态调整的机制为：在不超过当前锁定的IPU核最大频率值的前提下，动态调整IPU核运行频率。支持的IPU核频率档位与所使用的后摩设备有关，详情参看 IPU核自动调频档位运行机制。
如果仅设置最大功耗，最低功耗阈值默认为最大功耗的80%。
如果当前功耗高于设置的最大功耗，系统会将IPU核频率自动降低一个档位。如果频率已达到下限，则不再调整。
如果当前功耗低于设置的最大功耗，且IPU核利用率超过90%时，系统将IPU核频率自动提高一个档位。如果频率已达到上限，则不再调整。
如果当前功耗低于设置的最小功耗，IPU核频率仍可能自动降低一个档位。
如果IPU核在最低频率下仍超出功耗限制，系统将保持最低频率。
指令设置注意事项：
若希望功耗设置持续有效，需保证SMI指令持续运行。如果当前SMI会话终止（正常或异常），功耗设置将会失效。若需长期保持该设置生效，可使用
-l <sec>参数使指令以指定间隔持续执行并刷新设置。设备断电后，再次上电时需重新设置。
当多个终端运行SMI指令时，模式设置以最新执行的指令设置为准。
模式设置应用于与主机连接的所有逻辑设备，不支持对单个逻辑设备进行设置。
4.8.7.2. 示例
下面示例展示如何在Linux系统下，设置当前模式为 powerlimit，设置最大参考功耗阈值为4W，并且每隔30秒查看所有后摩设备信息。
hm_smi -g powerlimit -pl 4w -l 30 -a
根据指令设置的最大功耗为4W，系统会自动设置最小功耗为3.2W，返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:13:52 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : powerlimit
Cur_Ipu_Freq : 650.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Max_Power_Limit : 4.0 W
Min_Power_Limit : 3.2 W
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 650.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 25.0 C
DDR2 : 25.9 C
DDR4 : 22.7 C
DDR5 : 23.9 C
Core0 : 26.3 C
Core1 : 25.0 C
Board_Power : 3.37 W
--------------------------------------------------------------------------------
Wed Jul 15 15:14:23 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : powerlimit
Cur_Ipu_Freq : 650.0 Mhz
Lock_Ipu_Pll_Rate : 1300.0 Mhz
IPU_Load : 0.0 %
Max_Power_Limit : 4.0 W
Min_Power_Limit : 3.2 W
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 650.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 24.5 C
DDR2 : 25.3 C
DDR4 : 22.1 C
DDR5 : 23.0 C
Core0 : 25.9 C
Core1 : 24.5 C
Board_Power : 3.37 W
--------------------------------------------------------------------------------
...
下面示例展示如何设置当前模式为 powerlimit，限制AI处理器板卡功耗范围为5W ~ 3W，并且锁定IPU核频率最大值为1400MHz，并且每隔30秒查看所有后摩设备信息：
hm_smi -a -lc 1400 -g powerlimit -pl 5w 3w -l 30
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:16:18 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : powerlimit
Cur_Ipu_Freq : 1050.0 Mhz
Lock_Ipu_Pll_Rate : 1400.0 Mhz
IPU_Load : 0.0 %
Max_Power_Limit : 5.0 W
Min_Power_Limit : 3.0 W
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 1050.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 25.6 C
DDR2 : 26.3 C
DDR4 : 23.3 C
DDR5 : 24.2 C
Core0 : 27.5 C
Core1 : 26.0 C
Board_Power : 5.26 W
--------------------------------------------------------------------------------
Wed Jul 15 15:16:48 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : powerlimit
Cur_Ipu_Freq : 1050.0 Mhz
Lock_Ipu_Pll_Rate : 1400.0 Mhz
IPU_Load : 0.0 %
Max_Power_Limit : 5.0 W
Min_Power_Limit : 3.0 W
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 1050.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 24.8 C
DDR2 : 25.6 C
DDR4 : 22.1 C
DDR5 : 23.6 C
Core0 : 26.0 C
Core1 : 25.0 C
Board_Power : 4.06 W
--------------------------------------------------------------------------------
...
4.8.8. 锁定IPU核最大工作频率
设置IPU核最大频率值。输入下面指令，设置后摩设备的IPU核的最大频率：
hm_smi -lc <lock_clocks>
参数说明如下：
<lock_clocks> ：IPU核的最大频率。IPU核频率取值与所使用的后摩设备及板载M50芯片工作配置决定，详情参看 后摩设备IPU核频率取值。
4.8.8.1. 注意事项
设备断电后，再次上电时会恢复为默认值。因此需要上电后再重新设置。
当多个终端运行SMI指令时，模式设置以最新执行的指令设置为准。
模式设置应用于与主机连接的所有逻辑设备，不支持对单个逻辑设备进行设置。
4.8.8.2. 示例
下面示例展示如何设置LQ50 M.2卡IPU核最高频率，并且查看所有后摩设备信息：
hm_smi -lc 1400 -a
返回信息示例如下：
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 15:19:12 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
Vendor : Houmo
BDF : 0000:01:00.0
Dev : 0
Cur_BandWidth : 8.0 GT/s x 4lane
Power_Management :
DVFS_Mode : performance
Cur_Ipu_Freq : 1400.0 Mhz
Lock_Ipu_Pll_Rate : 1400.0 Mhz
IPU_Load : 0.0 %
Firmware_Version : V1.4.0
IPU_Infos :
Core_Num : 2
Core_Freq : 1400.0 Mhz
Voltage : 750.0 mV
Core0_Util : 0.0 %
Core1_Util : 0.0 %
Average_Util : 0.0 %
Group_Id : 0
Chip_Id : 0
SN : 0102020100002025003800000059
PN : 100C2010
Model : LQ50-12GB
DDR_Memory_Infos :
DDR_Memory_Free : 12160.0MB
DDR_Memory_Total : 12160.0MB
Temperature :
DDR0 : 25.6 C
DDR2 : 26.3 C
DDR4 : 23.3 C
DDR5 : 24.5 C
Core0 : 27.2 C
Core1 : 25.9 C
Board_Power : 5.43 W
--------------------------------------------------------------------------------
4.9. 复位后摩设备IPU核
输入下面指令，复位指定的逻辑设备的IPU核：
hm_smi -r <device_id>
下面示例展示如何复位逻辑设备ID为0的IPU核：
hm_smi -r 0
返回信息示例如下：
reset ipuss of dev:0
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:29
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 14:01:26 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
BDF : 0000:01:00.0
Driver_Build_Time : 2026-07-15 13:52:20 CST
Dev : 0
Firmware_Version : V1.4.0
Firmware_Build_Time : 2026-07-15
Group_Id : 0
Chip_Id : 0
--------------------------------------------------------------------------------
[HM_SMI] reset ipuss of dev0
[HM_SMI] reset ipuss of dev0 ok!
4.10. 复位后摩设备
输入下面指令，复位指定逻辑ID的后摩设备：
注意
用户必须有管理员权限。
LM5070和LM5050智能加速卡不支持使用该方式重启后摩设备。需关闭主机并重新启动主机，以完成设备重启。
sudo hm_smi -rd <device_id>
下面示例展示如何复位逻辑ID为0的后摩设备：
sudo hm_smi -rd 0
返回信息示例如下：
reset device: 0
--------------------------------------------------------------------------------
sdk build infos
--------------------------------------------------------------------------------
Build_Time : 2026-07-15 09:54:23
HMSW_Version : V1.4.0
HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
Wed Jul 15 14:01:40 CST 2026
--------------------------------------------------------------------------------
device0 detail infos
--------------------------------------------------------------------------------
Driver_Version : V1.4.0
BDF : 0000:01:00.0
Driver_Build_Time : 2026-07-15 13:52:20 CST
Dev : 0
Firmware_Version : V1.4.0
Firmware_Build_Time : 2026-07-15
Group_Id : 0
Chip_Id : 0
--------------------------------------------------------------------------------
[HM_SMI] ✓ 有效的 root 权限
[HM_SMI] dev0 reset physical device...
[HM_SMI] reset_device 0 by_ebli
## sleep 5s, wait device boot...
Done!
## after sleep 5s...
[HM_SMI] PCI bus rescan success!
[HM_SMI] device0 uptime:9 reset_device OK
4.11. 保存回显信息为文件
输入下面指令，将回显信息保存为文件：
hm_smi -o <file_name>
目前支持 .txt 、.json 和 .xml 格式文件。
下面示例展示如何将回显信息保存为 smi_return.txt 文件：
hm_smi -o smi_return.txt
4.12. 设置日志等级
输入下面指令，设置日志等级：
hm_smi [-v | -vv | -vvv]
其中日志等级选项三选一：
-v：输出基础日志信息。-vv：输出详细日志信息。-vvv：输出最详细的调试信息。相对于其他日志等级选项和其他指令参数，会额外显示下面信息：Build_UserChip_RevisionAvail_Core_IdUUIDDDR_Chip_NumDDR_Chip_CapDDR_Train
仅可选择其中一个等级进行设置。
4.13. 查看指令帮助信息
输入下面指令，获取指令帮助信息：
hm_smi --help
返回信息示例如下：
usage: hm_smi [option1 [arg1]] [option2 [args2]] ...
Houmo SMI tools
optional arguments:
-h, --help show this help message and exit
-a, --all show all device infos
-f [ ...], --fields [ ...]
query information about ipu.
Call --help-fields for more info.
Specify the fields to display (supports multiple values)
-l [sec], --loop [sec]
query interval(seconds)
-r [dev], --reset [dev]
reset ipuss of device [dev_id]
default dev_id is 0
-rd [dev], --reset_device [dev]
reset device [dev_id]
default dev_id is 0
-d [dev], --device [dev]
only show device [dev_id]
default dev_id is 0
-v, --verbose Log verbosity level
-v: Show basic infos
-vvv: Show basic infos and extended infos
Extended fields include:
Driver_Build_Time: driver build timestamp
Firmware_Build_Time: firmware build timestamp
DDR_Train: the version of ddr training
Avail_Core_Id: available aicore id in hexadecimal
(e.g. 0x11 means both cores available, 0x1 or 0x10
means only one core available)
Chip_Revision: chip revision
(e.g. 0x0 means version1, 0x1 means version2)
DDR_Chip_Num: number of DDR chips on the device
DDR_Chip_Cap: capacity of each DDR chip (in GB)
UUID: Universally Unique Identifier of device
Default: basic infos only
-o OUTPUT, --output OUTPUT
Output file name (must be .txt or .json or .xml)
Text output will be human-readable
JSON output will be machine-readable
XML output will be machine-readable
-g [{ondemand,performance,powerlimit}], --gov [{ondemand,performance,powerlimit}]
Governor setting, default governor is performance, choose
from ondemand/performance/powerlimit
[ondemand]: dynamically adjust ipu frequency based on
ipu load
[performance]: ipu runs at its maximum frequency to
ensure performance
[powerlimit]: dynamically adjust ipu frequency based
on the target power consumption
-pl POWERLIMIT [POWERLIMIT ...], --powerlimit POWERLIMIT [POWERLIMIT ...]
Specifies <maximum minimum> power management limit in
watts(e.g. 10w 5w).
Maximum power value required when gov is powerlimit
If no minimum power is specified, the default minimum power
will be 80% of the maximum power (e.g. 8w).
-lc LOCK_CLOCKS [LOCK_CLOCKS ...], --lock_clocks LOCK_CLOCKS [LOCK_CLOCKS ...]
Lock IPU clock/frequency in MHz.
Firmware >= V1.4.0: set ipu pll frequency, one of
1700/1400/1300 (e.g. -lc 1400).
Firmware < V1.4.0: set max/min ipu clock range (e.g. -lc
1400 or -lc 1400 1200).