【已评审】支持查询PCIeSlots资源信息 CSR新增字段

Hardware SIG Hardware评审
1

ISSUE链接

支持查询PCIeSlots资源信息

背景

支持查询PCIeSlots资源信息，涉及redfish接口URI: /redfish/v1/Chassis/chassis_id/PCIeSlots，当前redfish接口待新增。接口返回槽位信息包含PCIe插槽支持的最大PCIe通道数、PCIe插槽支持的最高PCIe规范版本、PCIe插槽类型，当前PcieAddrInfo对象缺少属性待新增。

决策点

1、IEU产品CSR里新增资源协作接口属性：PcieAddrInfo对象 Lanes、PCIeType、SlotType，分别表示PCIe插槽支持的最大PCIe通道数、PCIe插槽支持的最高PCIe规范版本、PCIe插槽类型。涉及所有产品仓IEU的CSR。

详细描述

URI： /redfish/v1/Chassis/chassis_id/PCIeSlots

变化类型：新增接口

应用场景：北向redfish接口查询PCIe插槽信息集合

操作类型：GET

详细描述：

字段 类型 说明
@odata.context 字符串 PCIe插槽资源模型的OData描述信息
@odata.id 字符串 PCIe插槽资源的访问路径
@odata.type 字符串 PCIe插槽资源的类型
Id 字符串 PCIe插槽的资源ID
Name 字符串 PCIe插槽的资源名称
Slots 数组 PCIe插槽对象集合
Lanes 数字 PCIe插槽支持的最大PCIe通道数，最大值32
PCIeType 字符串 PCIe插槽支持的最高PCIe规范版本，包括：Gen1；Gen2；Gen3；Gen4；Gen5；Gen6
SlotType 字符串 PCIe插槽类型，表明卡是长的还是短的：FullLength；HalfLength；LowProfile；Mini；M2；OEM；OCP3Small；OCP3Large；U2
Location.PartLocation 对象 部件位置
LocationType 字符串 部件位置的类型，目前只支持Slot
LocationOrdinalValue 数字 部件位置的数字
ServiceLabel 字符串 部件位置的标签
Links.PCIeDevice 对象 PCIe设备集合，插槽上的PCIe卡信息集合

返回样例

{
    "@odata.context": "/redfish/v1/$metadata#PCIeSlots.PCIeSlots",
    "@odata.id": "/redfish/v1/Chassis/1/PCIeSlots",
    "@odata.type": "#PCIeSlots.v1_5_1.PCIeSlots",
    "Id": "1",
    "Name": "PCIe Slot Information",
    "Slots": [
        {
            "PCIeType": "Gen3",
            "Lanes": 16,
            "SlotType": "FullLength",
            "Location": {
                "PartLocation": {
                    "ServiceLabel": "Slot 1",
                    "LocationOrdinalValue": 1,
                    "LocationType": "Slot"
                }
            },
            "Links": {
                "PCIeDevice": [
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard3"
                    }
                ]
            }
        },
        ...
    ]
}

资源path： /bmc/kepler/Systems/:SystemId/PCIeDevices/PcieAddrInfo/:ID

资源interface： bmc.kepler.Systems.PcieAddrInfo

变化类型：新增属性

应用场景：北向redfish接口查询槽位信息。

持久化类型： 不持久化

操作权限：ReadOnly

详细描述：

属性名称 变化类型 签名 读写&权限 持久化 变化通知 接口说明 接口约束
Lanes 新增属性 y 只读 R：ReadOnly 否 false PCIe插槽支持的最大PCIe通道数 默认值为0
PCIeType 新增属性 s 只读 R：ReadOnly 否 false PCIe插槽支持的最高PCIe规范版本 枚举类型，取值范围：“Gen1”,“Gen2”, “Gen3”, “Gen4”, “Gen5”, “Gen6”。默认值为空字符串。
SlotType 新增属性 s 只读 R：ReadOnly 否 false PCIe插槽类型 枚举类型，取值范围：“FullLength”, “HalfLength”, “LowProfile”, “Mini”, “M2”, “OEM”, “OCP3Small”, “OCP3Large”, “U2”。默认值为空字符串。

以下两个属性可通过下行连接器属性获取：

  • Lanes：表示PCIe插槽支持的最大PCIe通道数
  • PCIeType：表示PCIe插槽支持的最高PCIe规范版本

SlotType需要在CSR增加配置。

评审结论

1、同意产品仓IEU的CSR里PcieAddrInfo对象新增如下属性：

  • SlotType：表示PCIe插槽类型

遗留问题

同步修改CSR字典