背景
新增UB端口信息资源协作接口属性，具体包括：
-
为资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID 新增 bmc.kepler.UnifiedBus.Port 和 bmc.kepler.UnifiedBus.Port.Metrics 接口
-
为 bmc.kepler.UnifiedBus.Port 接口新增 LinkedLaneBitmap 属性
-
为 bmc.kepler.UnifiedBus.Port.Metrics 接口新增 LinkUpCount、LinkDownCount、RXSNR、CorrectableFECErrors、UncorrectableFECErrors、RXFrames、RXDiscards、TXFrames、TXDiscards 属性
关联ISSUE
暂无
整体方案
-
为资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID 新增 bmc.kepler.UnifiedBus.Port 和 bmc.kepler.UnifiedBus.Port.Metrics 接口
-
为资源协作接口 bmc.kepler.UnifiedBus.Port 新增 LinkedLaneBitmap 属性
-
为资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics 新增 LinkUpCount、LinkDownCount、RXSNR、CorrectableFECErrors、UncorrectableFECErrors、RXFrames、RXDiscards、TXFrames、TXDiscards 属性
评审点
-
资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID 新增 bmc.kepler.UnifiedBus.Port 和 bmc.kepler.UnifiedBus.Port.Metrics 接口
-
资源协作接口 bmc.kepler.UnifiedBus.Port 新增 LinkedLaneBitmap 属性
-
资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics 新增 LinkUpCount、LinkDownCount、RXSNR、CorrectableFECErrors、UncorrectableFECErrors、RXFrames、RXDiscards、TXFrames、TXDiscards 属性
详细描述
评审点1：资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID 新增接口
路径描述：提供NPU处理器端口信息查询功能，用于获取端口信息。
路径链接：/bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 | ||
|---|---|---|---|---|---|---|
| bmc.kepler.UnifiedBus.Port | 提供UB端口信息查询功能 | 不涉及重名属性，无影响 | 不涉及持久化，无影响 | 无 | ||
| bmc.kepler.UnifiedBus.Port.Metrics | 提供UB端口统计信息查询功能 | 不涉及重名属性，无影响 | 不涉及持久化，无影响 | 无 |
评审点2：资源协作接口 bmc.kepler.UnifiedBus.Port 新增 LinkedLaneBitmap 属性
接口描述：提供UB端口信息查询功能，用于获取已建立链接的Lane位图等信息。
接口链接：bmc.kepler.UnifiedBus.Port
新增属性
| 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|
| LinkedLaneBitmap | u | true | true | 已建立链接的Lane位图，每一位表示对应Lane是否已建立链接，1表示已建立链接，0表示未建立链接 | Read: ReadOnly | 带外获取 | 不持久化 | true |
新增接口影响
| 路径 | 新增接口影响 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID | 为npu port对象提供已建立链接的Lane位图查询功能，默认值为0 | 不涉及重名属性，无影响 | 不涉及持久化，无影响 | 无 |
评审点3：资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics 新增属性
接口描述：提供UB端口信息查询功能，用于获取链路状态变化计数、信噪比、FEC错误统计和帧收发统计等信息。
接口链接：bmc.kepler.UnifiedBus.Port.Metrics
新增属性
| 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|
| LinkUpCount | s | true | true | 表示链路从断开状态变为连接状态的累计次数，记录上一次上电以来的累计值，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
| LinkDownCount | s | true | true | 表示链路从连接状态变为断开状态的累计次数，记录上一次上电以来的累计值，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
| RXSNR | ad | true | true | 包含多个Lane的接收信噪比值，用于评估接收信号质量，示例：[10.5, 12.3, 11.2, 13.1, 9.8, 11.0, 10.9, 12.4]，默认值为[] |
Read: ReadOnly | 带外获取 | 不持久化 | true |
| CorrectableFECErrors | s | true | true | 表示可以纠正的前向纠错错误计数，记录上一次上电以来的累计值，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
| UncorrectableFECErrors | s | true | true | 表示无法纠正的前向纠错错误计数，记录上一次上电以来的累计值，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
| RXFrames | s | true | false | 最近一次重置后端口上接收到的帧总数，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
| RXDiscards | s | true | false | 最近一次重置后端口接收路径中丢弃的帧总数，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
| TXFrames | s | true | false | 最近一次重置后端口上传输的帧总数，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
| TXDiscards | s | true | false | 最近一次重置后端口传输路径中丢弃的帧总数，默认值为空串 | Read: ReadOnly | 带外获取 | 不持久化 | true |
新增接口影响
| 路径 | 新增接口影响 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID | 为npu port对象提供链路状态信息及帧收发统计查询功能 | 不涉及重名属性，无影响 | 不涉及持久化，无影响 | 无 |
是否准备好AI预审
是
评审结论
同意新增资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID，提供NPU处理器端口信息查询功能，用于获取端口信息。实现以下接口：
- bmc.kepler.UnifiedBus.Port（提供UB端口信息查询功能）
- bmc.kepler.UnifiedBus.Port.Metrics（提供UB端口统计信息查询功能）
CSR配置不涉及重名属性，无影响；不涉及持久化，无影响。
同意资源协作接口 bmc.kepler.UnifiedBus.Port 新增 LinkedLaneBitmap 属性，签名为 u，只读，变化通知为 true，已建立链接的Lane位图（每一位表示对应Lane是否已建立链接，1表示已建立链接，0表示未建立链接），默认值为0，属性来源为带外获取，持久化类型为不持久化，易变属性为 true。
变更影响路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID，为 npu port 对象提供已建立链接的Lane位图查询功能，默认值为0，CSR配置不涉及重名属性，无影响，不涉及持久化，无影响。
同意资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics 新增以下属性：
-
链路状态计数属性（LinkUpCount、LinkDownCount）与 FEC 错误统计属性（CorrectableFECErrors、UncorrectableFECErrors）：签名均为
s（String 类型），只读，变化通知为 true，默认值为空串，取值模式为^(0|[1-9][0-9]*|)$（仅允许非负整数或空串），属性来源为带外获取，不持久化，易变属性。采用 String 类型以空串表示数据不可用或未初始化状态，避免数值溢出问题。 -
信噪比属性 RXSNR：签名为
ad（double 数组类型），只读，变化通知为 true，默认值为空数组[]，包含多个 Lane 的接收信噪比值，用于评估接收信号质量，属性来源为带外获取，不持久化，易变属性。 -
帧收发统计属性（RXFrames、RXDiscards、TXFrames、TXDiscards）：签名均为
s（String 类型），只读，变化通知为 false，默认值为空串，取值模式为^(0|[1-9][0-9]*|)$，属性来源为带外获取，不持久化，易变属性。
变更同时影响路径 /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID/Ports/:ID，为 npu port 对象提供链路状态信息及帧收发统计查询功能，CSR配置不涉及重名属性，无影响，不涉及持久化，无影响。
遗留问题
默认值与异常值如何设置（已解决）
解决方案：将计数类属性（LinkUpCount、LinkDownCount、CorrectableFECErrors、UncorrectableFECErrors、RXFrames、RXDiscards、TXFrames、TXDiscards）的类型从数值型改为String，默认值为空串，异常值为空串。采用String类型可避免数值溢出问题，空串表示数据不可用或未初始化状态。属性pattern约束为 ^(0|[1-9][0-9]*|)$，仅允许非负整数或空串。