[待评审]新增光模块端口状态信息资源协作接口

Interface SIG Interface评审
1

背景

新增统一总线端口链路统计信息资源协作接口属性，供其他组件使用。具体包括：

  • 为 bmc.kepler.UnifiedBus.Port 接口新增 LinkedLaneBitmap 属性，用于查询已建立链接的Lane位图

  • 为 bmc.kepler.UnifiedBus.Port.Metrics 接口新增链路状态统计属性，包括链路状态变化计数、SNR值和FEC错误统计等

关联ISSUE

暂无

整体方案

  1. 为资源协作接口 bmc.kepler.UnifiedBus.Port 新增1个链路配置属性

  2. 为资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics 新增5个链路统计属性

评审点

  1. 资源协作接口 bmc.kepler.UnifiedBus.Port 新增链路配置属性

  2. 资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics 新增链路统计属性

详细描述

评审点1：资源协作接口 bmc.kepler.UnifiedBus.Port 新增属性

接口描述：提供统一总线端口链路配置信息查询功能，用于获取已建立链接的Lane位图等信息。归属于统一总线端口管理功能域。

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
LinkedLaneBitmap u True false 已建立链接的Lane位图，每一位表示对应Lane是否已建立链接，1表示已建立链接，0表示未建立链接 Read: ReadOnly 带外获取 不持久化 true

新增接口影响

路径 新增接口影响 CSR配置影响 持久化影响 其他影响
/bmc/kepler/UnifiedBus/:UnifiedBusId/Ports/:PortId 为unified_bus_port对象提供已建立链接的Lane位图查询功能，默认值为0 不涉及重名属性，无影响 不涉及持久化，无影响 需实现新增属性，需从network_adapter组件获取数据

评审点2：资源协作接口 bmc.kepler.UnifiedBus.Port.Metrics 新增属性

接口描述：提供统一总线端口链路状态信息查询功能，用于获取链路状态变化计数、信噪比和FEC错误统计等信息。归属于统一总线端口管理功能域。

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
LinkUpCount t True false 表示链路从断开状态变为连接状态的累计次数，记录上一次上电以来的累计值，默认值为0 Read: ReadOnly 带外获取 不持久化 true
LinkDownCount t True false 表示链路从连接状态变为断开状态的累计次数，记录上一次上电以来的累计值，默认值为0 Read: ReadOnly 带外获取 不持久化 true
RxSNR ad True false 包含多个Lane的接收信噪比值，用于评估接收信号质量，示例：[10.5, 12.3, 11.2, 13.1, 9.8, 11.0, 10.9, 12.4]，默认值为 Read: ReadOnly 带外获取 不持久化 true
CorrectableFECErrors t True false 表示可以纠正的前向纠错错误计数，默认值为0 Read: ReadOnly 带外获取 不持久化 true
UncorrectableFECErrors t True false 表示无法纠正的前向纠错错误计数，默认值为0 Read: ReadOnly 带外获取 不持久化 true

新增接口影响

路径 新增接口影响 CSR配置影响 持久化影响 其他影响
/bmc/kepler/UnifiedBus/:UnifiedBusId/Ports/:PortId 为unified_bus_port对象提供链路状态信息查询功能 不涉及重名属性，无影响 不涉及持久化，无影响 需实现新增属性，需从network_adapter组件获取数据

评审结论

遗留问题

无