mx-smi 用户手册

mx-smi（MOFFETT System Management Interface）是基于 MOFFETT Management Library（MXML）的系统管理命令行工具，用于收集设备信息、查看设备健康状态、重启设备、加载固件以及设置风扇控制的相关参数等。

命令格式：mx-smi [选项] [子命令]

-h,--help

显示帮助信息。

--version

显示 mx-smi 的版本。

-l,--loop

按指定的时间间隔持续输出命令结果。取值范围：1-3600 秒，默认间隔：5 秒。使用 Ctrl+C 终止输出。

示例

mx-smi

╭──────────────────────────────────────────────────────────────────────────────────────────╮
│MOFFETT-SMI 2.10.0          Driver Version 3.13.0          SOLA Version 3.13.0            │
╰──────────────────────────────────────────────────────────────────────────────────────────╯
 Card
┌──────────────────────────────────────────────────────────────────────────────────────────┐
│Index     Name    Freq.  Voltage Temp. Fan Pwr  Util  Bus ID   Memory-Usage       SN      │
├──────────────────────────────────────────────────────────────────────────────────────────┤
│Card0  S40-02-A02 700MHz  930mV   42C  31% 108W  0%  0:26:00.0 0MiB/81920MiB 2515040220002│
├──────────────────────────────────────────────────────────────────────────────────────────┤
│Card1  S40-02-A02 700MHz  930mV   38C  27% 109W  0%  0:30:00.0 0MiB/81920MiB 2520040220005│
├──────────────────────────────────────────────────────────────────────────────────────────┤
│Card2  S40-02-A02 700MHz  930mV   38C  28% 112W  0%  0:38:00.0 0MiB/81920MiB 2515040220004│
├──────────────────────────────────────────────────────────────────────────────────────────┤
│Card3  S40-02-A02 700MHz  930mV   40C  30% 110W  0%  0:42:00.0 0MiB/81920MiB 2515040220003│
└──────────────────────────────────────────────────────────────────────────────────────────┘
 Processes
┌──────────────────────────────────────────────────────────────────────────────────────────┐
│Index    PID   Process Name                                                   Memory Usage│
├──────────────────────────────────────────────────────────────────────────────────────────┤
│   [No running processes found]                                                           │
└──────────────────────────────────────────────────────────────────────────────────────────┘

须知

显示的板卡信息为该卡下 Bus ID 值最小的设备信息。

输出字段（Card） 说明
Index 板卡索引
Name 产品名称
Freq. 板卡的频率
Voltage 板卡的电压
Temp. 板卡的温度
Fan 风扇调速比（单位：%），默认为 20%。仅支持 S40AC 计算卡，其他型号板卡显示为 N/A
Pwr 板卡功率，对不支持获取板卡功率的板卡则显示卡上所有设备的总功率
Util 板卡的使用率（负载）
Bus ID PCI 总线 ID，格式为 bus:domain:device.function
Memory-Usage 板卡的内存使用情况，格式为 Usage/Total，即（已使用内存/内存总量）
SN 板卡的序列号，是板卡的唯一标识。
输出字段（Processes） 说明
Index 运行该进程的板卡编号以及对应的设备 ID，输出格式为：（板卡编号：设备 ID）
PID 进程 ID
Process Name 进程名，最大展示长度为 32 个字符，超出长度后以 … 省略开头的字符
Memory Usage 进程占用的内存大小

子命令 list

查看设备的基本信息。

mx-smi list [选项]

-h,--help

显示帮助信息。

-i,--index

指定设备 ID，取值范围：0-31。如果未指定，则显示所有设备信息；如果指定多个值：

  • 空格分隔，例如：-i 0 1 2。

  • 花括号中逗号分隔，例如：-i {0,1,2}。

-l,--loop

按指定的时间间隔持续输出命令结果。取值范围：1-3600 秒，默认间隔：5 秒。使用 Ctrl+C 终止输出。

示例

mx-smi list

╭─────────────────────────────────────────────────────────────────────────────────────────╮
│MOFFETT-SMI 2.10.0          Driver Version 3.13.0          SOLA Version 3.13.0           │
╰─────────────────────────────────────────────────────────────────────────────────────────╯
 Devices
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Index     Name    Freq.  Voltage Temp. Fan Pwr Util  Bus ID   Memory-Usage       SN      │
├─────────────────────────────────────────────────────────────────────────────────────────┤
│  +    S40-02-A02                          30W                              2515040220002│
│  0               700MHz  930mV   35C  24% 2W   0%  0:26:00.0 0MiB/20480MiB              │
│  1               700MHz  930mV   33C  24% 2W   0%  0:27:00.0 0MiB/20480MiB              │
│  2               700MHz  930mV   34C  24% 4W   0%  0:28:00.0 0MiB/20480MiB              │
│  3               700MHz  930mV   35C  24% 4W   0%  0:29:00.0 0MiB/20480MiB              │
├─────────────────────────────────────────────────────────────────────────────────────────┤
│  +    S40-02-A02                          30W                              2520040220005│
│  4               700MHz  930mV   32C  22% 3W   0%  0:30:00.0 0MiB/20480MiB              │
│  5               700MHz  930mV   33C  22% 3W   0%  0:31:00.0 0MiB/20480MiB              │
│  6               700MHz  930mV   32C  22% 4W   0%  0:32:00.0 0MiB/20480MiB              │
│  7               700MHz  930mV   33C  20% 2W   0%  0:33:00.0 0MiB/20480MiB              │
├─────────────────────────────────────────────────────────────────────────────────────────┤
│  +    S40-02-A02                          33W                              2515040220004│
│  8               700MHz  930mV   32C  22% 4W   0%  0:38:00.0 0MiB/20480MiB              │
│  9               700MHz  930mV   33C  22% 3W   0%  0:39:00.0 0MiB/20480MiB              │
│  10              700MHz  930mV   33C  22% 1W   0%  0:3a:00.0 0MiB/20480MiB              │
│  11              700MHz  930mV   33C  22% 2W   0%  0:3b:00.0 0MiB/20480MiB              │
├─────────────────────────────────────────────────────────────────────────────────────────┤
│  +    S40-02-A02                          32W                              2515040220003│
│  12              700MHz  930mV   33C  20% 2W   0%  0:42:00.0 0MiB/20480MiB              │
│  13              700MHz  930mV   34C  20% 4W   0%  0:43:00.0 0MiB/20480MiB              │
│  14              700MHz  930mV   34C  20% 4W   0%  0:44:00.0 0MiB/20480MiB              │
│  15              700MHz  930mV   34C  20% 2W   0%  0:45:00.0 0MiB/20480MiB              │
└─────────────────────────────────────────────────────────────────────────────────────────┘
 Processes
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Index    PID   Process Name                                                  Memory Usage│
├─────────────────────────────────────────────────────────────────────────────────────────┤
│   [No running processes found]                                                          │
└─────────────────────────────────────────────────────────────────────────────────────────┘

子命令 query

显示设备的详细信息。

mx-smi query [选项]

-h,--help

显示帮助信息。

-i,--index

指定设备 ID，取值范围：0-31。如果未指定，则显示所有设备信息；如果指定多个值：

  • 空格分隔，例如：-i 0 1 2。

  • 花括号中逗号分隔，例如：-i {0,1,2}。

-d,--display

仅显示选定字段的信息。如果未指定，则显示所有字段信息；如果指定多个字段：

  • 空格分隔，例如：-d MEMORY POWER。

  • 花括号中逗号分隔，例如：-d {MEMORY，POWER}。

可选字段

说明

MEMORY

设备内存信息

UTILIZATION

设备使用率信息

TEMPERATURE

设备的温度信息

POWER

设备的功耗信息

FREQUENCY

设备的频率信息

FAN

风扇信息

VOLTAGE

设备的电压信息

PIDS

执行中任务的系统进程 ID

ECC

ECC 信息
-l,--loop

按指定的时间间隔持续输出命令结果。取值范围：1-3600 秒，默认间隔：5 秒。使用 Ctrl+C 终止输出。

示例

mx-smi query -i 0

Timestamp                             : Wed Aug  6 15:20:06 2025
Driver Version                        : 3.13.0
SOLA Version                          : 3.13.0

Attached Devices                      : 16

Device 0
    Product Name                      : S40-02-A02
    SPU Cores Number                  : 4
    FW Version                        : 1.0.17
    MCU Version                       : 3V02
    Serial Number                     : 2515040220002
    UUID                              : 04000000000000000000000002515040220002
    Board Id                          : 0x000
    PCI
        Bus                           : 0x26
        Device                        : 0x00
        Domain                        : 0x0000
        Bus Id                        : 0:26:00.0
        Device Id                     : 0x70401f36
        Sub System Id                 : 0x70011f36
    Memory Usage
        Total                         : 20480 MiB
        Reserved                      : 4484 MiB
        Used                          : 0 MiB
        Free                          : 15996 MiB
    Utilization
        Core 0                        : 0 %
        Core 1                        : 0 %
        Core 2                        : 0 %
        Core 3                        : 0 %
        Max                           : 0 %
        Min                           : 0 %
        Avg                           : 0 %
    ECC Errors
        Volatile
            Device Memory Corrected   : 0
            Device Memory Uncorrected : 0
        Aggregate
            Device Memory Corrected   : 7
            Device Memory Uncorrected : 0
    Fan
        Fan Policy                    : balance
        Fan Speed                     : 20% (1440 RPM)
    Temperature                       : 34 C
    Power
        Power Draw                    : 2 W
        Power Limit                   : 83 W
    Frequency                         : 700 MHz
    Voltage                           : 930 mV
    Processes
输出字段 说明
Timestamp 当前时间戳
Driver Version 驱动版本
Sola Version SOLA Toolkit 版本
Attached Devices 设备数量
Device 设备标识
Product Name 产品名称
SPU Cores Number 设备核心数量
FW Version 固件版本
MCU Version MCU 版本
Serial Number 序列号（同一张板卡拥有相同序列号）
UUID UUID（每个设备全局唯一 ID）
Board Id 板卡 ID
PCI PCI 信息
Bus PCI bus（16 进制）
Device PCI device（16 进制）
Domain PCI domain（16 进制）
Bus Id PCI bus ID，格式为 domain:bus:device.function（16 进制）
Device Id PCI vendor device ID（16 进制）
Sub System Id PCI 子系统 ID（16 进制）
Fan 风扇信息
Fan Policy 风扇模式
Fan Speed 风扇调速比（%）及每分钟转速（RPM）
Memory Usage 内存使用情况
Total SPU 总内存（单位：MiB）
Reserved SPU 预留内存（单位：MiB）
Used SPU 已使用内存（单位：MiB）
Free SPU 总空闲内存（单位：MiB）
Utilization 使用率（各核心上的平均使用率）
ECC Errors ECC 错误信息
Volatile 易失性设备内存错误信息
Device Memory Corrected 已纠正的易失性设备内存错误数量
Device Memory Uncorrected 未纠正的易失性设备内存错误数量
Aggregate 聚合设备内存错误信息
Device Memory Corrected 已纠正的聚合设备内存错误数量
Device Memory Uncorrected 未纠正的聚合设备内存错误数量
Temperature 设备的温度（单位：℃）
Power 设备功率信息
Power Draw 设备的当前功率
Power Limit 设备的最大功率（单位：W）
Frequency 设备的频率（单位：MHz）
Voltage 设备的电压（单位：mV）

子命令 select

打印指定的设备属性信息。

mx-smi select [选项]

通用选项

-h,--help

显示帮助信息。

-noheader

不显示属性名表头。

-l,--loop

按指定的时间间隔持续输出命令结果。取值范围：1-3600 秒，默认间隔：5 秒。使用 Ctrl+C 终止输出。

field 选项（二选一）

指定显示板卡信息的字段。

（可选）-b, --board：指定板卡 ID，取值范围：0-7。如果未指定，默认显示所有板卡的信息。

如果指定多个 board-field 或板卡：

  • 空格分隔，例如：--board-field board board.power -b 0 1。

  • 花括号中逗号分隔，例如：--board-field {board,board.power} -b {0,1}。

--board-field 可选字段（不区分大小写） 说明
board 板卡 ID
board.fan.policy 风扇模式
board.fan.speed 风扇调速比（单位：%）
board.fan.speed_rpm 风扇每分钟转速（RPM）
board.power 风扇功率
--field 可选字段（不区分大小写） 说明
board 板卡 ID
cores 设备核心数量
count 检测到的设备数量
driver_version 驱动版本
ecc.errors.corrected.volatile.device_memory 已纠正的易失性设备内存错误数量
ecc.errors.corrected.aggregate.device_memory 已纠正的聚合设备内存错误数量
ecc.errors.uncorrected.volatile.device_memory 未纠正的易失性设备内存错误数量
ecc.errors.uncorrected.aggregate.device_memory 未纠正的聚合设备内存错误数量
fan.policy 风扇模式
fan.speed 风扇调速比（单位：%）
fan.speed_rpm 风扇每分钟转速（RPM）
firmware_version 固件版本
frequency 设备的频率（单位：MHz）
index 设备 ID（根据 PCI bus ID 生成）
mcu_version MCU 版本
memory.free SPU 总空闲内存（单位：MiB）
memory.reserved SPU 预留内存（单位：MiB）
memory.total SPU 总内存（单位：MiB）
memory.used SPU 已使用内存（单位：MiB）
name 产品名称
pci.bus PCI bus（16 进制）
pci.device PCI device（16 进制）
pci.domain PCI domain（16 进制）
pci.bus_id PCI bus id，格式为 domain:bus:device.function（16 进制）
pci.device_id PCI vendor device id（16 进制）
pci.sub_device_id PCI Sub System id（16 进制）
power.draw 设备的当前功率（单位：W）
power.limit 设备的最大功率（单位：W）
serial 序列号（同一张板卡拥有相同序列号，不同板卡的序列号不同）
sola_version SOLA 版本
temperature 设备的温度（单位：℃）
timestamp 当前时间戳
utilization 使用率（各核心上的平均使用率）
uuid UUID（每个设备全局唯一 ID）
voltage 设备的电压（单位：mV）

示例

以下示例查看设备的指定信息。默认第一行展示输出的属性名，后续每一行为用户指定的设备的属性信息。

mx-smi select -f {index,pci.bus_id,board} -i 2 1 0

index, pci.bus_id, board
2, 0:3a:00.0, 0
1, 0:39:00.0, 0
0, 0:38:00.0, 0

以下示例查看板卡的指定信息：

mx-smi select --board-field {board,board.power} -b 0 1 2

board, board.power
0, 7 W
1, 3 W
2, 4 W

子命令 config

设置风扇模式和转速，操作记录保存在 /var/log/moffett/sola/smi.log 文件中。仅支持 S40AC 计算卡。

mx-smi config [选项] fan [子选项]

通用选项

-h,--help

显示帮助信息。

指定设备选项（三选一）

指定要修改配置的设备 ID，取值范围：0-31。如果指定多个值：

  • 空格分隔，例如：-i 0 1 2。

  • 花括号中逗号分隔，例如：-i {0,1,2}。

fan 命令选项

-h,--help

显示帮助信息。

--policy

墨芯设备支持基于 PWM（Pulse-Width Modulation）和 PID（Proportional Integral Differential）算法自动调整风扇转速，两种调速策略根据当前设备的最大温度输出占空比，并选取更大的占空比进行调速，具体如下表所示。

风扇调速模式

说明

balance

设置风扇工作在均衡模式。
该模式介于性能模式和静音模式之间，兼顾性能和降噪。

performance

设置风扇工作在性能模式。
该模式下风扇转速较高，优先保证设备在较低的结温下工作。此模式下设备噪音会增大，推荐在对性能要求高的场景下使用。

silent

设置风扇工作在静音模式。
该模式下风扇转速较低，噪音较小。此模式下设备结温会相对升高，推荐对降噪要求高的场景下使用。

manual

手动模式，与 --speed 选项同时使用，设置固定的风扇调速比。
--speed

在 manual 模式下，设置风扇调速比（单位：%）。取值范围：20-100，默认值：20。

示例

mx-smi config -b 1 fan --policy manual --speed 80

子命令 reboot

重启设备并加载固件，操作记录保存在 /var/log/moffett/sola/smi.log 文件中。

sudo mx-smi reboot [选项]

通用选项

-h,--help

显示帮助信息。

指定设备选项（二选一）

指定要重启的设备 ID，取值范围：0-31。如果指定多个值：

  • 空格分隔，例如：-i 0 1 2。

  • 花括号中逗号分隔，例如：-i {0,1,2}。

示例

sudo mx-smi reboot --all