背景
新产品需求，为支持处理器端口直连光模块管理，需要新增相关对象与属性
关联ISSUE
暂无
整体方案
- 新增资源协作路径 /bmc/kepler/Chassis/:ChassisId/Transceivers/:ID，实现 bmc.kepler.Systems.OpticalModule、BiasCurrent、Power、Temperature、Voltage、Diagnose、RelatedItems 及 bmc.kepler.Metric 共8个接口
- 新增资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/CPU/:CPUId/Ports/:ID，实现 bmc.kepler.Systems.Processor.Port、UnifiedBus.Port、UnifiedBus.Port.Metrics 及 bmc.kepler.Metric 共4个接口
- 为接口 bmc.kepler.Systems.OpticalModule.RelatedItems 新增 ProcessorPortLanes 属性，描述光模块与处理器端口通道的连接关系
评审点
- 新增资源协作路径 /bmc/kepler/Chassis/:ChassisId/Transceivers/:ID
- 新增资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/CPU/:CPUId/Ports/:ID
- 变更资源协作接口 bmc.kepler.Systems.OpticalModule.RelatedItems 新增 ProcessorPortLanes 属性
详细描述
评审点1：新增资源协作路径 /bmc/kepler/Chassis/:ChassisId/Transceivers/:ID
评审背景：原有光模块资源协作接口路径需与网卡，网口对象绑定，处理器端口直连光模块需要新增相关对象满足管理需求。
路径描述：提供光模块资源信息查询功能，包括光模块基本信息、偏置电流、光功率、温度、电压、诊断信息及关联处理器端口信息等。归属于机箱管理功能域。
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| bmc.kepler.Systems.OpticalModule | 提供光模块基本信息查询功能 | 无影响 | 无影响 | 需实现接口 |
| bmc.kepler.Systems.OpticalModule.BiasCurrent | 提供光模块偏置电流信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.Systems.OpticalModule.Power | 提供光模块光功率信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.Systems.OpticalModule.Temperature | 提供光模块温度信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.Systems.OpticalModule.Voltage | 提供光模块电压信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.Systems.OpticalModule.Diagnose | 提供光模块诊断信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.Systems.OpticalModule.RelatedItems | 提供光模块关联处理器端口信息查询功能 | 按需配置，无影响 | 不涉及持久化，无影响 | 需实现新增ProcessorPortLanes属性 |
| bmc.kepler.Metric | 提供光模块指标统计信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
评审点2：新增资源协作路径 /bmc/kepler/Systems/:SystemId/Processors/CPU/:CPUId/Ports/:ID
路径描述：提供CPU处理器端口链路配置和状态信息查询功能，用于获取端口链路配置和链路状态统计信息。归属于CPU管理功能域。
实现接口
| 实现接口 | 实现接口描述 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| bmc.kepler.Systems.Processor.Port | 提供处理器端口信息查询功能 | 无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.UnifiedBus.Port | 提供UB总线端口配置信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.UnifiedBus.Port.Metrics | 提供UB总线端口状态信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
| bmc.kepler.Metric | 提供端口指标统计信息查询功能 | 不涉及CSR配置，无影响 | 不涉及持久化，无影响 | 需实现接口 |
评审点3：变更资源协作接口 bmc.kepler.Systems.OpticalModule.RelatedItems
变更描述：光模块关联处理器端口接口新增 ProcessorPortLanes 属性，用于描述光模块与处理器端口通道的连接拓扑关系，支持北向接口展示光模块与处理器端口的关联信息。属性值在组件初始化时赋初值，运行时不变。
接口链接：bmc.kepler.Systems.OpticalModule.RelatedItems接口定义
变更属性
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | ProcessorPortLanes | a(syyy) | True | false | 该光模块关联处理器端口，四个参数依次表示处理器的类型、处理器Id、端口的ID以及关联端口的通道ID。举例：[(‘CPU’,1,1,1),(‘NPU’,2,4,2)]表示该光模块的两个通道依次关联当前系统下Id为1的CPU的第1个端口的通道1、Id为2的NPU的第4个端口的通道2 | Read: ReadOnly | 初始化赋值 | 复位持久化 | 新增属性，无兼容性问题 |
ProcessorPortLanes 结构体字段说明
| 字段名称 | 签名 | 只读 | 描述 |
|---|---|---|---|
| ProcessorType | s | True | 处理器类型，可能取值为’CPU’、‘NPU’ |
| ProcessorId | y | True | 处理器逻辑Id，从0开始 |
| PortId | y | True | 端口逻辑ID，从0开始 |
| PortLaneId | y | True | 端口通道逻辑ID，从0开始 |
变更接口影响
| 路径 | 变更接口影响 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| /bmc/kepler/Chassis/:ChassisId/Transceivers/:ID | 新增ProcessorPortLanes属性，提供光模块与处理器端口关联关系查询功能 | 不涉及重名属性，无影响 | 不涉及新增和废弃主键，无兼容性问题 | 需实现新增属性 |
| /bmc/kepler/Systems/:SystemId/NetworkAdapters/:Id/Ports/:Id/OpticalModule | 新增ProcessorPortLanes属性，提供光模块与处理器端口关联关系查询功能 | 不涉及重名属性，无影响 | 不涉及新增和废弃主键，无兼容性问题 | 需实现新增属性 |
评审结论
遗留问题
1、明确涉及接口属性读写需求，是否能完全继承
2、明确新增属性类型，默认值是否符合芯片演进需求