mx-mft 用户手册

mx-mft 是用于管理墨芯 AI 计算卡设备固件的工具。固件分为板载固件和动态加载的固件两个部分。板载固件是存储在计算卡 Flash 上的固件，又分为板卡设备固件和板卡上的 MCU 固件。使用该工具可以查看设备固件版本、加载动态固件、重启设备、更新板载设备固件和 MCU 固件。

mx-mft [选项] 子命令

  • -h,--help：显示帮助信息。

  • -v,--version：显示工具的版本信息。

子命令 status

查看设备固件信息。设备固件 Mode 分为 Bootloader 和 Kernel UMD：

  • 设备重启后进入 Bootloader 状态，该状态下可进行设备固件升降级操作。

  • 加载设备固件后进入 Kernel UMD 状态，该状态下可使用 mx-qual 等工具进行常规测试。

mx-mft status [<id>]

<id>：指定设备的索引或范围，例如：1 或 0-2 或 all。未指定默认为 all。

mx-mft status 1

Device 1 info:
    SN: 2023513080332
    PN: 00S30-00A
    PCI bus: 0000:04:00.0
    Mode: Kernel UMD
    Firmware version: V1.0.17
字段 说明
SN 序列号
PN 产品编号
PCI bus PCI 总线 BDF（bus:device:function）标识
Mode 板卡模式，包括：Kernel UMD 和 Bootloader
Firmware version Mode 为 Kernel UMD 时显示的固件版本
Bootloader version info Mode 为 Bootloader 时显示的版本信息：version、type、build date 和 active slot。

子命令 boot

为设备加载动态固件。

mx-mft boot <id> <firmware_package>

  • <id>：指定设备的索引或范围，例如：1 或 0-2 或 all。未指定默认为 all。

  • <firmware_package>：指定主机上固件的路径，例如：/usr/local/sola/driver/firmware/moffett-antoum-V3.110.17-20250331.tar.gz。

mx-mft boot all /usr/local/sola/driver/firmware/moffett-antoum-V3.110.17-20250331.tar.gz

子命令 reboot

重启设备进入 Bootloader 模式。

命令格式：sudo mx-mft reboot <id>

<id>：指定设备的索引或范围，例如：1 或 0-2 或 all。未指定默认为 all。

示例

sudo mx-mft reboot all

子命令 mcu-ota

更新 MCU 固件。

命令格式：mx-mft mcu-ota <id> [<fw_file_path>]

  • <id>：指定设备的索引或范围，例如：1 或 0-2 或 all。未指定默认为 all。

  • <fw_file_path>：指定主机上 MCU 固件的路径，例如：/usr/local/sola/driver/firmware/ota-test/mcu_fw.tar.gz。仅降级时使用。

限制

  • S4 计算卡不支持该命令。

  • 升级板卡 MCU 固件时，S30 计算卡的 MCU 版本必须在 4X04 及以上版本。

  • 降级板卡 MCU 固件时，S30 计算卡的 MCU 版本必须在 4X05 及以上版本。

示例

mx-mft mcu-ota all /usr/local/sola/driver/firmware/ota-test/mcu_fw.tar.gz

子命令 update

更新设备固件。先重启设备进入 Bootloader 模式。

命令格式：sudo mx-mft update <id> <firmware_package> [-f]

  • <id>：指定设备的索引或范围，例如：1 或 0-2 或 all。未指定默认为 all。

  • <firmware_package>：指定主机上固件的路径，例如：/usr/local/sola/driver/firmware/moffett-antoum-V3.110.17-20250331.tar.gz。

  • -f：强制更新固件版本，适用于降级或平级。

升级固件版本：

sudo mx-mft update all /usr/local/sola/driver/firmware/moffett-antoum-V3.110.17-20250331.tar.gz

应用场景

降级板载设备固件版本

  1. 执行 sudo mx-mft reboot all 命令，重启设备并进入 Bootloader 模式。

  2. （可选）获取降级版本的固件压缩包（以 V1.0.15 版本为例，如果主机上已存在该版本固件压缩包，跳过此步骤）。

    wget https://moffett-oss-bucket.tos-cn-shanghai.volces.com/driver/firmware/moffett-antoum-V3.91.15-20241219.tar.gz

  3. 在当前目录执行以下命令，降级板载设备固件版本。

    sudo mx-mft update all ./moffett-antoum-V3.91.15-20241219.tar.gz -f

  4. 根据以上命令执行结果选择操作：

    • 如果出现以下提示，请关闭并重启服务器，以使用新的设备固件。

      注意

      ************************************************************************
**                                                                    **
**   Please power off this server to use device new firmware          **
**                                                                    **
************************************************************************

    • 如果未出现以上提示，重启 mx-daemon 服务，并等待一分钟后查询。

      sudo systemctl restart mx-daemon

  5. 执行以下命令，查看降级后的板载设备固件版本。

    mx-smi select -f firmware_version

    Firmware version:   1.0.15
Firmware version:   1.0.15
Firmware version:   1.0.15

  6. 测试完降级后，参见以下升级步骤，将固件恢复为 /usr/local/sola/driver/firmware/ 目录中的版本。

升级板载设备固件版本

  1. 执行 sudo mx-mft reboot all 命令，重启设备并进入 Bootloader 模式。

  2. 升级板载设备固件版本（以 V1.0.17 版本为例）。

    sudo mx-mft update all /usr/local/sola/driver/firmware/moffett-antoum-V3.110.17-20250331.tar.gz

  3. 根据以上命令执行结果选择操作：

    • 如果出现以下提示，请关闭并重启服务器，以使用新的设备固件。

      注意

      ************************************************************************
**                                                                    **
**   Please power off this server to use device new firmware          **
**                                                                    **
************************************************************************

    • 如果未出现以上提示，重启 mx-daemon 服务，并等待一分钟后查询。

      sudo systemctl restart mx-daemon

  4. 查看升级后的板载设备固件版本。

    mx-smi select -f firmware_version

    Firmware version:   1.0.17
Firmware version:   1.0.17
Firmware version:   1.0.17

降级板载 MCU 固件版本

  1. 降级板载 MCU 固件版本。

    mx-mft mcu-ota all /usr/local/sola/driver/firmware/ota-test/mcu_fw.tar.gz

  2. 执行 mx-smi select -f mcu_version 命令，查看降级后的 MCU 版本。

注意

测试完降级后，参见以下升级步骤，将 MCU 固件恢复当前版本。

升级板载 MCU 固件版本

  1. 选择以下任意一种方式升级板载 MCU 固件：

    • 通过加载主机上最新版本的设备固件包升级。

      a. 执行 sudo mx-mft reboot all 命令，重启设备并进入 Bootloader 模式。

      b. 加载主机上的最新版本的设备固件包（以 1.0.17 版本为例），同时升级 MCU 版本。

      mx-mft boot all /usr/local/sola/driver/firmware/moffett-antoum-V3.110.17-20250331.tar.gz

    • 执行 mx-mft mcu-ota all 命令直接升级。与降级 MCU 不同，升级 MCU 无需指定固件包。

  2. 执行 mx-smi select -f mcu_version 命令，查看升级后的 MCU 版本：

    mcu_version
4X011
4X011
4X011

    • S30 计算卡的 MCU 版本：4X011 或 2V48。

    • S40 计算卡的 MCU 版本：1V48。

    • S40AC 计算卡的 MCU 版本：3V02。