背景
BMC需要获取灵衢设备的UB端口信息
评审点
1、 议题1
新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId
资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port和bmc.kepler.UnifiedBus.Port.Metrics
2、 议题2
资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:NPUId/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port和bmc.kepler.UnifiedBus.Port.Metrics
3、议题3
资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid下的资源协作接口bmc.kepler.LCN.Card新增属性Type，表示子卡类型
方案1：新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId
路径描述 ：接口体现UBM管理的UBSW Port口信息，对应redfish接口
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| bmc.kepler.UnifiedBus.Port | 实现UB端口相关属性并提供北向redfish接口获取 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 不涉及 |
| bmc.kepler.UnifiedBus.Port.Metrics | 实现UB端口相关度量属性并提供北向redfish接口获取 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 不涉及 |
bmc.kepler.UnifiedBus.Port接口新增属性
| 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|
| Name | s | True | false | UB端口名称 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| LinkStatus | s | True | true | 端口状态 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| MTUSize | q | True | false | 最大报文长度 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| ConfiguredSpeedGbps | q | True | false | 配置带宽 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| CurrentSpeedGbps | q | True | false | 当前带宽 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| ConfiguredWidth | y | True | false | 物理lane数量 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| ActiveWidth | y | True | false | 实际lane数量 | Read: ReadOnly | UBM上报 | 不持久化 | false |
bmc.kepler.UnifiedBus.Port.Metrics接口新增属性
| 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|
| RXFlits | t | True | false | 入方向链路层Flit计数 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| TXFlits | t | True | false | 出方向链路层Flit计数 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| RXCRCErrors | t | True | false | 入方向CRC纠错统计计数 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| RXFECErrors | t | True | false | 入方向FEC纠错统计计数 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| LastNoLinkTime | s | True | false | 端口最近一次物理down时间 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| LastLinkTime | s | True | false | 端口最近一次物理up时间 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| RXBandWidthPercent | d | True | false | 入方向带宽利用率 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| TXBandWidthPercent | d | True | false | 出方向带宽利用率 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| CreditBackPressure | a(yst) | True | false | 信用证反压数据 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| VituralLaneId | y | True | false | 虚拟laneId | Read: ReadOnly | UBM上报 | 不持久化 | false |
| LastBackPressureTime | s | True | false | 最近一次反压发生时间 | Read: ReadOnly | UBM上报 | 不持久化 | true |
| BackPressureCount | t | True | false | 反压个数 | Read: ReadOnly | UBM上报 | 不持久化 | true |
议题2：变更资源协作接口 bmc.kepler.Systems.Processor.Port
路径描述 ：接口体现UBM管理的NPU Port口信息，对应redfish接口/redfish/v1/Systems/{SystemId}/Processors/{ProcessorsId}/Ports/{PortsId}
接口下新增接口和接口下属性和议题1一致
议题3：资源协作接口 mc.kepler.LCN.Card新增属性
bmc.kepler.LCN.Card接口新增属性
| 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|
| Type | s | True | false | 交换系统子卡的类型 | Read: ReadOnly | CSR配置 | 不持久化 | false |
评审结论
1、同意议题1：
新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId
资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port和bmc.kepler.UnifiedBus.Port.Metrics及其新增的接口属性。
2、 同意议题2：
资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:NPUId/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port和bmc.kepler.UnifiedBus.Port.Metrics。接口下新增接口和接口下属性和议题1一致。
3、同意议题3：
资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid下的资源协作接口bmc.kepler.LCN.Card新增属性Type，表示子卡类型
4、不复用原有的NetworkPort资源协作接口，可复用率低且无效属性过多会造成组件额外性能开销。
遗留问题
1、card子卡对象不合适描述虚拟的UB设备类型，建议通过新增属性来描述虚拟子卡，或者通过link属性指向system下对应的资源路径。—— 闭环详见议题3。