【变更声明】DPU/SDI卡WEB页面调整

Interface SIG
1

变更声明

为支持 DPU 在 Web 界面单独分类显示，Web 界面在“系统管理 - 系统信息”下新增独立的“DPU”页面，DPU 信息不再通过 PCIe 卡页面承载。相应地，PCIe 卡列表接口 /UI/Rest/System/Boards/PCIeCard 在 DPU 场景下的回显格式发生变更（部分 DPU 专有属性被移除、并新增少量通用属性），同时新增 DPU 列表接口 /UI/Rest/System/DPUs 与 DPU 详情接口 /UI/Rest/System/DPUs/:dpuid。

关联评审：【已评审】新增webrest接口支持DPU在web界面单独分类显示

受影响的版本

  • openUBMC 26.06 及之前的版本

变更描述

规格变化

不涉及

外观变化

Web 界面“系统管理 - 系统信息”下新增“DPU”页面，用于集中展示 DPU 信息（含 SDI 场景的 DPU）；原 PCIe 卡页面不再展示 DPU 专有信息。

变更前（DPU 信息在 PCIe 卡页面展示）：

变更后（新增 DPU 页面）：

外部接口变化

变化点 1：PCIe 卡列表接口在 DPU 场景下回显格式变更

URI: /UI/Rest/System/Boards/PCIeCard

GET 操作响应体

字段 类型 变化类型 说明
FirmwareVersion 字符串 新增 固件版本
PCIeFunction.MaxPCIeType 字符串 新增 支持的最高 PCIe 传输协议，如 “GEN3”
VrdFirmwareVersion 字符串 删除 Vrd 固件版本
McuFirmwareVersion 字符串 删除 Mcu 固件版本
Power 数字 删除 功耗
ExtendInfo.StorageManagementIP 字符串 删除 存储管理网口 IP 地址
ExtendInfo.StorageManagementVlanId 数字 删除 存储管理网口 VlanID
ExtendInfo.BootOption 字符串 删除 启动选项
ExtendInfo.M2Device1Presence 布尔 删除 M2 设备 1 在位状态
ExtendInfo.M2Device2Presence 布尔 删除 M2 设备 2 在位状态
ExtendInfo.ExtendCardInfo 对象 删除 扩展卡信息
ExtendInfo.MRCLogLevel 数字 删除 MRC 日志级别
ExtendInfo.UEFILogLevel 数字 删除 UEFI 日志级别
ExtendInfo.PowerState 字符串 删除 电源状态
ExtendInfo.OSSupported 布尔 删除 OS 相关功能是否开启的标识
ExtendInfo.IndependentPowerControlEnabled 布尔 删除 DPU 是否独立控制电源状态的标识

变更前

[
    {
        "Id": "",
        "Position": "",
        "Description": "",
        "Manufacturer": "",
        "Model": "",
        "PartNumber": "",
        "FunctionType": "DPU Card",
        "DeviceBDF": "",
        "RootBDF": "",
        "RootBDFs": [""],
        "DevBDFs": [""],
        "ComponentUniqueID": "",
        "VrdFirmwareVersion": "1.1.1",
        "McuFirmwareVersion": "1.1.1",
        "Power": 10,
        "ExtendInfo": {
            "BoardId": "",
            "PCBVersion": "",
            "ProductName": "",
            "StorageManagementIP": "0.0.0.0",
            "StorageManagementVlanId": 0,
            "BootOption": "HDD Boot",
            "M2Device1Presence": true,
            "M2Device2Presence": true,
            "MRCLogLevel": 1,
            "UEFILogLevel": 1,
            "PowerState": "On",
            "OSSupported": true,
            "IndependentPowerControlEnabled": true,
            "ExtendCardInfo": {}
        },
        "PCIeFunction": {
            "VendorId": "",
            "DeviceId": "",
            "SubsystemVendorId": "",
            "SubsystemId": "",
            "AssociatedResource": "",
            "AssociatedResources": [""],
            "LinkSpeed": "8.0GT/s",
            "LinkSpeedAbility": "8.0GT/s",
            "LinkWidth": "X8",
            "LinkWidthAbility": "X8"
        }
    }
]

变更后

[
    {
        "Id": "",
        "Position": "",
        "Description": "",
        "Manufacturer": "",
        "Model": "",
        "PartNumber": "",
        "FunctionType": "",
        "DeviceBDF": "",
        "RootBDF": "",
        "RootBDFs": [""],
        "DevBDFs": [""],
        "ComponentUniqueID": "",
        "FirmwareVersion": "",
        "ExtendInfo": {
            "BoardId": "",
            "PCBVersion": "",
            "ProductName": ""
        },
        "PCIeFunction": {
            "VendorId": "",
            "DeviceId": "",
            "SubsystemVendorId": "",
            "SubsystemId": "",
            "AssociatedResource": "",
            "AssociatedResources": [""],
            "MaxPCIeType": "GEN3",
            "LinkSpeed": "8.0GT/s",
            "LinkSpeedAbility": "8.0GT/s",
            "LinkWidth": "X8",
            "LinkWidthAbility": "X8"
        }
    }
]

变化点 2：新增 DPU 列表接口

URI: /UI/Rest/System/DPUs

变化类型：新增接口
操作类型：GET
操作权限：ReadOnly
应用场景：获取 DPU 列表

一级字段 二级字段 类型 示例/取值约束 说明
List / 数组 / DPU 列表
Description 字符串 “DPU1” 描述
Url 字符串 “/UI/Rest/System/DPUs/PCIeCard1” 关联 DPU 的 Url

响应示例：

{
    "List": [
        {
            "Description": "DPU1",
            "Url": "/UI/Rest/System/DPUs/PCIeCard1"
        },
        {
            "Description": "DPU2",
            "Url": "/UI/Rest/System/DPUs/PCIeCard2"
        }
    ]
}

变化点 3：新增 DPU 详情接口

URI: /UI/Rest/System/DPUs/:dpuid

变化类型：新增接口
操作类型：GET
操作权限：ReadOnly
应用场景：获取指定 DPU 的详细信息

一级字段 二级字段 类型 示例/取值约束 说明
Description / 字符串 “DPU1” 描述
Position / 字符串 “PCIeRiser1” 位置
Manufacturer / 字符串 “Huawei” 厂商
Slot / 数字 1 槽位
VrdFirmwareVersion / 字符串 “1.1.1” Vrd 固件版本
McuFirmwareVersion / 字符串 “1.1.1” Mcu 固件版本
Power / 数字 10 功耗
StorageManagementIP / 字符串 “0.0.0.0” 存储管理网口 IP 地址
StorageManagementVlanId / 数字 0 存储管理网口 VlanID
MRCLogLevel / 数字 1 MRC 日志级别
UEFILogLevel / 数字 1 UEFI 日志级别
BoardId / 字符串 “0xffff” 单板 ID
M2Device1Presence / 布尔 true M2 设备 1 在位状态
M2Device2Presence / 布尔 true M2 设备 2 在位状态
IndependentPowerControlEnabled / 布尔 true DPU 是否独立控制电源状态的标识
PowerState / 字符串 “On” 电源状态
OSSupported / 布尔 true OS 相关功能是否开启的标识
BootOption / 字符串 “HDD Boot” 启动选项
FunctionType / 字符串 “DPU Card” 功能分类
ExtendCardInfo / 数组 / 扩展卡信息
Slot 数字 1 扩展卡槽位
VendorId 字符串 “0xffff” 厂商 ID
DeviceId 字符串 “0xffff” 设备 ID
SubsystemVendorId 字符串 “0xffff” 子厂商 ID
SubsystemId 字符串 “0xffff” 子设备 ID
Manufacturer 字符串 “Huawei” 厂商
ChipManufacturer 字符串 “” 芯片厂商
ProductName 字符串 “” 产品名称
BoardId 字符串 “0xffff” 单板 ID
BoardName 字符串 “” 单板名称
PCBVersion 字符串 “” PCB 版本
Model 字符串 “” 型号
Description 字符串 “” 描述信息
PfMacInfo 数组 [{ “PermanentMac”: “00:00:00:00:00:00”, “Port”: 1, “PfId”: 0 }] 扩展卡 PF Port、PfId 和永久 MAC 地址信息

响应示例：

{
    "Description": "DPU1",
    "Position": "PCIeRiser1",
    "Manufacturer": "Huawei",
    "Slot": 1,
    "VrdFirmwareVersion": "1.1.1",
    "McuFirmwareVersion": "1.1.1",
    "Power": 10,
    "StorageManagementIP": "0.0.0.0",
    "StorageManagementVlanId": 0,
    "MRCLogLevel": 1,
    "UEFILogLevel": 1,
    "BoardId": "0xffff",
    "M2Device1Presence": true,
    "M2Device2Presence": true,
    "IndependentPowerControlEnabled": true,
    "PowerState": "On",
    "OSSupported": true,
    "BootOption": "HDD Boot",
    "FunctionType": "DPU Card",
    "ExtendCardInfo": [
        {
            "Slot": 1,
            "SubsystemVendorId": "0xffff",
            "Manufacturer": "Huawei",
            "SubsystemId": "0xffff",
            "ProductName": "",
            "Description": "",
            "BoardId": "0xffff",
            "PfMacInfo": [],
            "BoardName": "",
            "ChipManufacturer": "",
            "DeviceId": "0xffff",
            "PCBVersion": "",
            "Model": "",
            "VendorId": "0xffff"
        }
    ]
}

安装方式变化

不涉及

兼容性说明

  • BMC 固件兼容性：当前变更仅涉及 BMC 的固件软件版本，不涉及硬件兼容性
  • openUBMC 和 BMC SDK 兼容性：此接口不依赖 SDK，不涉及兼容性
  • BMC 与上层网管/客户端的兼容性：/UI/Rest 为 Web 界面内部接口，官方不承诺对外兼容。如果存在直接调用 /UI/Rest/System/Boards/PCIeCard 获取 DPU 专有属性的使用方式，升级后将无法从该接口获取，需改为访问新增的 /UI/Rest/System/DPUs/:dpuid
  • SDI 场景：SDI 的 DPU 同样迁移至新增的 DPU 页面下显示

文档影响

  • Web 界面用户指南：新增“系统管理 - 系统信息 - DPU”页面章节，更新 PCIe 卡页面章节中 DPU 相关描述
  • WebRest 接口文档：新增 /UI/Rest/System/DPUs、/UI/Rest/System/DPUs/:dpuid，修改 /UI/Rest/System/Boards/PCIeCard 属性说明

建议动作

  • 确认是否存在直接调用 /UI/Rest/System/Boards/PCIeCard 获取 DPU 专有属性的自动化脚本或上层软件；若存在，请改为调用 /UI/Rest/System/DPUs 与 /UI/Rest/System/DPUs/:dpuid，并在实现中兼容 openUBMC 旧版本接口
  • 需要长期稳定对外接口的场景，建议改用 Redfish 接口获取 DPU 相关信息