背景
1、BMC需要获取灵衢设备的UB端口信息
2、BMC需要支持获取NPU的fmea信息，并通过资源协作接口呈现，用于告警配置
评审点
1、 资源协作接口bmc.kepler.UnifiedBus.Port新增属性
2、 资源协作接口bmc.kepler.UnifiedBus.Port.Metrics新增属性
3、新增Redfish Port接口 /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}
4、新增Redfish Metrics接口 /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}/Metrics
5、 资源协作接口bmc.kepler.Systems.Processor.NPU新增属性
详细描述
评审点1： 变更资源协作接口 bmc.kepler.UnifiedBus.Port
接口描述 ：用于管理UB端口属性。
变更属性
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | Id | u | True | false | UB端口ID，默认值为0 | Read: ReadOnly | CSR | 不持久化 | false |
| 新增 | ContainedBy | s | True | false | UB端口所在设备的资源协作对象名称，如LCNCard_1_0101 | Read: ReadOnly | 不持久化 | false | |
| 新增 | AssociatedMACAddresses | a(s) | True | false | 端口关联的已配置MAC地址列表，默认值[] | Read: ReadOnly | 不持久化 | false | |
| 新增 | Health | s | True | true | 端口健康状态，取值范围包括[“Critical”、“OK”、“Warning”]，默认值OK | Read: ReadOnly | 不持久化 | false | |
| 新增 | State | s | True | true | 端口运行状态，取值范围包括[“Enabled”、“Disabled”、“StandbyOffline”、“UnavailableOffline”、“Absent”]，默认值Enabled | Read: ReadOnly | 不持久化 | false | |
| 新增 | PortMedium | s | True | false | 端口介质类型，取值范围包括[“Electrical”、“Optical”]，默认值Optical | Read: ReadOnly | 不持久化 | false | |
| 新增 | LocationType | s | True | false | 当前节点所在的位置描述，取值范围包括[“Backplane”、“Bay”、“Connector”、“Embedded”、“Slot”、“Socket”]，默认值Backplane | Read: ReadOnly | CSR | 不持久化 | false |
| 新增 | LocationOrdinalValue | u | True | false | 位置序号值，默认值0 | Read: ReadOnly | CSR | 不持久化 | false |
| 新增 | ServiceLabel | s | True | false | 运维标签值，如"PIC 1"，默认值"" | Read: ReadOnly | CSR | 不持久化 | false |
评审点2： 变更资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics
接口描述 ：用于管理UB端口度量统计信息。
变更属性
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | RXBytes | t | True | false | 端口接收的字节总数，取值范围0到0xFFFFFFFF，默认值为0 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| 新增 | RXErrors | t | True | false | 端口接收的错误总数，取值范围0到0xFFFFFFFF，默认值为0 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| 新增 | TXBytes | t | True | false | 端口发送的字节总数，取值范围0到0xFFFFFFFF，默认值为0 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| 新增 | TXErrors | t | True | false | 端口发送的错误总数，取值范围0到0xFFFFFFFF，默认值为0 | Read: ReadOnly | UBM上报 | 不持久化 | true |
评审点3：新增Port标准资源
资源URI：/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}
资源版本：Port.v1_18_0
Required属性："@odata.id"、"@odata.type"、"Id"、"Name"
嵌套资源：本资源嵌套于 Ports 资源的 Members 属性中
Link资源：本资源的Metrics属性Link到/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}/Metrics
属性列表：
| 属性名 | 类型 | 示例/取值约束 | readonly | 易变属性 | 实现PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
Status |
object |
/ |
/ |
/ |
/ |
/ |
端口的状态与健康信息 |
State |
string |
枚举值：Enabled、Disabled、StandbyOffline、UnavailableOffline、Absent |
true |
否 |
/ |
ReadOnly |
端口的当前状态 |
Health |
string |
枚举值：OK、Warning、Critical |
true |
否 |
/ |
ReadOnly |
端口的健康状态 |
LinkStatus |
string |
枚举值：LinkUp、NoLink、LinkDown |
true |
否 |
/ |
ReadOnly |
端口的连接状态 |
PortMedium |
string |
枚举值：Electrical、Optical |
true |
否 |
/ |
ReadOnly |
端口的物理连接介质 |
Metrics |
link |
/ |
/ |
/ |
/ |
/ |
端口的度量统计信息资源。 |
Location |
object |
/ |
/ |
/ |
/ |
/ |
端口的位置信息。 |
LocationType |
string |
枚举值："Slot", "Bay","Connector", "Socket","Backplane","Embedded" |
true |
否 |
/ |
ReadOnly |
端口在机框内的位置类型 |
LocationOrdinalValue |
[integer, null] |
示例：1 |
true |
否 |
/ |
ReadOnly |
端口位置编号 |
Ethernet |
object |
/ |
/ |
/ |
/ |
/ |
端口的以太相关信息。 |
AssociatedMACAddresses |
array(string,null) |
示例：["34:17:EB:89:AB:CD","34:17:EB:89:AB:CE"] |
true |
否 |
/ |
ReadOnly |
与此端口关联的已配置 MAC 地址 |
LLDPReceive |
object |
/ |
/ |
/ |
/ |
/ |
端口接收到的LLDP信息 |
ChassisId |
[string, null] |
true |
否 |
/ |
ReadOnly |
从远端设备接收到的LLDP机框标识。 |
|
PortId |
[string, null] |
true |
否 |
/ |
ReadOnly |
从远端设备接收到的LLDP端口标识。 |
|
SystemName |
[string, null] |
true |
否 |
/ |
ReadOnly |
从远端设备接收到的系统名称。 |
评审点4：新增Metrics标准资源
资源URI：/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}/Metrics
资源版本：PortMetrics.v1_8_1
Required属性："@odata.id"、"@odata.type"、"Id"、"Name"
嵌套资源：本资源嵌套于 Port 资源的 Metrics 属性中
Link资源：不涉及
属性列表：
| 属性名 | 类型 | 示例/取值约束 | readonly | 易变属性 | 实现PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
RXBytes |
[integer, null] |
取值范围：0到0xFFFFFFFF，值不可用返回null |
true |
是 |
/ |
ReadOnly |
端口接收的字节总数 |
RXErrors |
[integer, null] |
取值范围：0到0xFFFFFFFF，值不可用返回null |
true |
是 |
/ |
ReadOnly |
端口接收的错误总数 |
TXBytes |
[integer, null] |
取值范围：0到0xFFFFFFFF，值不可用返回null |
true |
是 |
/ |
ReadOnly |
端口发送的字节总数 |
TXErrors |
[integer, null] |
取值范围：0到0xFFFFFFFF，值不可用返回null |
true |
是 |
/ |
ReadOnly |
端口发送的错误总数 |
评审点5： 变更资源协作接口 bmc.kepler.Systems.Processor.NPU
变更属性
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | FailureCode | t | True | true | NPU上报的器件故障失效码，bitmap结构，默认值0，由低到高每个bit位置1代表特定器件故障失效 | Read: ReadOnly | 轮询NPU获取 | 复位持久化 | false |
评审结论
同意评审点1：资源协作接口bmc.kepler.UnifiedBus.Port新增上述属性
同意评审点2：资源协作接口bmc.kepler.UnifiedBus.Port.Metrics新增上述属性
同意评审点3：新增Redfish Port接口： /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}
同意评审点4：新增Redfish Metrics接口： /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}/Metrics
同意评审点5：资源协作接口bmc.kepler.Systems.Processor.NPU新增上述属性