背景
BMC需要获取灵衢设备的UB端口信息
评审点
1、 评审点1
新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId
2、 评审点2
资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port
3、评审点3
资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port.Metrics
4、评审点4
资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid下的资源协作接口bmc.kepler.LCN.Card新增属性Type，表示子卡类型和Model
详细描述
评审点1：新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId
路径描述 ：承载灵衢总线交换设备端口信息，对应redfish接口 /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| bmc.kepler.UnifiedBus.Port | UB端口基础信息 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 不涉及 |
| bmc.kepler.UnifiedBus.Port.Metrics | UB端口度量指标 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 不涉及 |
评审点2：新增资源协作接口 bmc.kepler.UnifiedBus.Port
接口描述：用于管理UB端口属性。
新增属性
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | 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 | true | 当前带宽 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| 新增 | ConfiguredWidth | y | True | false | 物理lane数量 | Read: ReadOnly | UBM上报 | 不持久化 | false |
| 新增 | ActiveWidth | y | True | true | 实际lane数量 | Read: ReadOnly | UBM上报 | 不持久化 | false |
评审点3：新增资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics
接口描述：用于管理UB端口度量统计信息。
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | 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 |
评审点4：资源协作接口 bmc.kepler.LCN.Card新增属性
新增属性
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | Type | s | True | false | 灵衢总线交换设备的类型，取值范围：Switch | Read: ReadOnly | CSR配置 | 不持久化 | false |
| 新增 | Model | s | True | false | 灵衢总线交换设备的型号 | Read: ReadOnly | CSR配置 | 不持久化 | false |
评审结论
1、同意新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId
2、同意在资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port
3、同意在资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Ports/:PortId下新增资源协作接口bmc.kepler.UnifiedBus.Port.Metrics
4、 同意资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid下的资源协作接口bmc.kepler.LCN.Card新增属性Type和Model
遗留问题
1、审视是否复用已有的NetworkPort接口
结论：不复用原有的NetworkPort资源协作接口，可复用率低且无效属性过多会造成组件额外内存开销。