通过BMC网页升级UEFI失败问题分析与解决方案

根据您提供的信息，您在使用 openUBMC 25.06 版本通过网页界面升级UEFI固件时失败，系统提示 “升级文件与待升级设备不匹配”。以下是基于系统日志、知识库和相关上下文的详细分析与解决建议。

问题定位

从您提供的 app.log 日志内容可以明确发现问题的根本原因：

firmware_mgmt ERROR: hpm_package.lua(357): sys-uid(1030abf00) not in update.cfg’s ProductUIDList
firmware_mgmt ERROR: hpm_package.lua(511): Package file does not match the device
firmware_mgmt WARNING: The upgrade file does not match the device to be upgraded.
firmware_mgmt ERROR: control.lua(321): parse package(new_BT05.hpm) failed, ret:FirmwareFileMismatch

核心错误：固件文件与设备不匹配（Firmware File Mismatch）

这表明您上传的UEFI升级包 new_BT05.hpm 中的 设备唯一标识符（ProductUniqueID） 为 0x030ABF00（日志中显示为 sys-uid(1030abf00)），但该ID未包含在固件包的 update.cfg 文件的 ProductUIDList 列表中。

这是 firmware_mgmt 模块 在解析 HPM 固件包时执行设备兼容性校验失败的直接结果。

相关实体参考：

• Firmware File Mismatch：固件文件与目标设备配置不匹配导致的错误。
• firmware_mgmt：负责固件管理的系统模块，会进行签名验证、设备匹配等检查。
• hpm_package.lua：负责解析 .hpm 固件包内容的关键脚本。

原因分析

原因	说明
签名已验证成功	日志显示 verify signature successfully，说明您对固件包的签名处理是正确的，签名不是问题根源。
设备唯一ID不兼容	系统实际硬件的 ProductUniqueID = 0x030ABF00，但固件包未声明支持此设备ID。
HPM包配置错误	update.cfg 文件中的 ProductUIDList 缺少 030ABF00，导致校验失败。
时间戳异常	日志时间为 1970-01-01，提示系统时间未正确设置（可能影响某些服务），但不直接影响升级流程。

解决方案

方案一：修改HPM固件包的 update.cfg

1. 解压 HPM 文件
   HPM 文件是一种归档格式。使用支持 .hpm 的工具（如 hpmutils 或厂商提供的打包工具）解压 new_BT05.hpm。

2. 编辑 update.cfg 文件
   找到并打开 update.cfg，在 ProductUIDList 字段中添加您的设备ID：

   [Product]
   ProductID = ...
   ProductVendorID = 0x00000001
   ProductUIDList = 0x030ABF00, 0x...  # 确保包含 0x030ABF00
   

3. 重新签名并打包 HPM

   • 使用正确的私钥对修改后的固件包重新签名。
   • 重新打包为 .hpm 格式。
   • 注意：确保构建环境与 openUBMC 签名机制兼容。

4. 重新上传并升级

方案二：确认固件包是否适用于当前硬件平台

• 您使用的固件包 new_BT05.hpm 是否专为 S920X20 或类似平台设计？
• 如果是从社区或第三方获取的UEFI/HBM包，请确认其目标平台（Target Board Name）是否包括您的设备。
• 可检查 manifest.yml 或构建配置中是否设置了正确的 board_name=openUBMC 或具体型号。

参考知识：
在 openUBMC 构建过程中，board_name=openUBMC 是一个常见配置（来自 Board_Name_OpenUBMC 实体）。若未正确配置，可能导致生成的固件包不包含对应设备ID。

方案三：关闭设备ID校验（仅开发/测试环境）

如果您是开发者且处于测试阶段，可尝试在 构建固件时关闭严格设备匹配检查：

• 在 manifest.yml 或 Conan 配置中查找是否可设：

  -o firmware_mgmt/:community_enable=True
  

• 社区版 openUBMC 有时允许通过 community_enable 选项放宽部分安全限制（如设备ID校验）。
• 或修改 Lua 脚本逻辑（不推荐生产环境）：
  • 修改 /opt/bmc/libmc/service/spdm/service/main.lua 等相关路径中的校验逻辑（需重新编译部署）。

推荐操作流程

graph TD
    A[升级失败: 文件不匹配] --> B{是否自定义构建HPM?}
    B -->|是| C[解压HPM包]
    B -->|否| D[确认是否为目标设备专用包]
    C --> E[修改update.cfg加入ProductUIDList]
    E --> F[重新签名并打包]
    F --> G[上传新HPM文件]
    G --> H[执行升级]
    D -->|是| G
    D -->|否| I[联系供应商或社区获取适配版本]

其他建议

1. 同步系统时间
   设置正确的 NTP 时间，避免因时间戳异常影响日志追踪和证书验证。

2. 参考官方指导文档

   • BMC 3.xx.xx.xx Version Upgrade to OpenUBMC 提供了完整的社区版本升级流程。
   • 自签名与出包流程参考：https://discuss.openubmc.cn/t/topic/2503

3. 使用 CLI 进行调试（可选）
   若 Web 界面限制较多，可通过 SSH 登录 BMC，使用命令行工具调用 firmware_mgmt 接口进行更细粒度控制。

总结

如仍无法解决，建议：

1. 提供您的 update.cfg 内容（脱敏后）用于分析；
2. 确认 new_BT05.hpm 的来源及适用平台；
3. 访问 openUBMC 社区论坛 https://discuss.openubmc.cn 发帖求助，附上完整日志。