【已评审】新增支持显示pcie网卡SN显示需求相关的接口

背景(必填,文字描述议题背景,如需求来源、问题场景):

互联网需求,支持web界面显示网卡SN

决策点(必填,一句话描述待决策点):

  1. 新增IPMI命令:用于BIOS上报网卡SN的IPMI接口
  2. 新增web-rest接口属性: /UI/Rest/System/NetworkAdapter/:adapterid 接口网卡SN属性

整体架构/方案(可选,文字/图描述接口设计背后的整体管理架构/方案):

详细描述(必填,描述待评审接口的详细内容):

  1. IPMI命令字:06 58
    变化类型:新增子命令
    应用场景:BIOS启动时上报PCIe设备 VPD信息
    操作类型: SET
    操作权限:BasicSetting
req 说明
byte1 subcmd 0xd2
byte2 CardType OCP or PCIe
byte3 PCIe SlotNumber
byte4 Card Bus Number
byte5 Card Device Number
byte6 Card Function Number
byte7 VPD Item Count
byte8:9 VPD Item Keyword
byte10 VPD Item Length N
byte10:10+N-1 VPD Item Data
byteX 重复VPD Item内容

示例:BIOS 上报请求 06 58 d2 01 02 17 00 00 01 53 4e 06 31 32 33 34 35 36 – 即slot2 PCIe卡BDF为17 00 00;SN 123456
BMC响应 完成码 00 错误码复用06 58命令原定义

  1. 新增web-rest接口属性
    uri:/UI/Rest/System/NetworkAdapter/:adapterid
    变化类型:新增属性
    操作类型: GET
    应用场景:网卡界面查询时显示
    属性名称:SerialNumber
    取值类型:string
    操作权限:ReadOnly
    错误说明:属性值获取错误展示默认值
    性能说明:与/UI/Rest/System/NetworkAdapter/:adapterid中 rootBDF共用一次资源调用,对性能无影响
    兼容性策略:新增属性不涉及

评审结论

同意新增IPMI命令及rest接口属性

遗留事项

  • IPMI命令资料刷新事项确认,社区IPMI资料如何刷新 – @pengqiang-gs

请联系harware SIG组maintainer交流下,资源协作接口设计是否合理。另外,建议在接口中一并增加PCIe卡的PN属性

已与harware SIG组maintainer进行方案评估,最新方案已更新