【已评审】支持光模块相关接口新增属性，redfish光模块资源新增部分DFX参数

Interface SIG Interface评审
1

背景

支持通过redfish采集光模块参数，含SNR、host/media LTP、Tx Rx LoS/LOL、TxFault、私有参数
部分属性当前资源协作接口上无对应属性，需要新增

关联ISSUE

[需求]: 支持通过redfish采集光模块参数

整体方案

bmc.kepler.Systems.OpticalModule 接口新增 MediaLTP、HostLTP 属性
bmc.kepler.Systems.OpticalModule.Voltage 接口新增 VCSELVoltage、TxVPPVoltage、RxVPPVoltage 属性
bmc.kepler.Systems.OpticalModule.Temperature 接口新增 ORFICTemperatureCelsius 属性
redfish光模块资源 https://device_ip/redfish/v1/Chassis/chassis_id/Transceivers/transceivers_id 新增部分DFX参数

评审点

支持光模块相关接口新增属性
光模块Transceiver资源新增部分DFX参数

详细描述

评审点1：变更资源协作接口 bmc.kepler.Systems.OpticalModule

变更描述：支持通过redfish采集光模块参数，需要从资源协作接口上获取对应属性
接口链接：bmc.kepler.Systems.OpticalModule 接口定义

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
新增 HostLTP ad True false 主机侧各通道电平转换参数 Read: ReadOnly 从HDK获取 不持久化 无影响
新增 MediaLTP ad True false 介质侧各通道电平转换参数 Read: ReadOnly 从HDK获取 不持久化 无影响

评审点2：变更资源协作接口 bmc.kepler.Systems.OpticalModule.Voltage

变更描述：支持通过redfish采集光模块参数，需要从资源协作接口上获取对应属性
接口链接：bmc.kepler.Systems.OpticalModule.Voltage 接口定义

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
新增 TxVPPVoltage ad True false 光模块各通道发送信号输入幅度电压，单位毫伏 Read: ReadOnly 从HDK获取 不持久化 无影响
新增 RxVPPVoltage ad True false 光模块各通道接收信号输入幅度电压，单位毫伏 Read: ReadOnly 从HDK获取 不持久化 无影响
新增 VCSELVoltage aq True false 光模块各通道激光器前向电压，单位毫伏 Read: ReadOnly 从HDK获取 不持久化 无影响

评审点3：变更资源协作接口 bmc.kepler.Systems.OpticalModule.Temperature

变更描述：支持通过redfish采集光模块参数，需要从资源协作接口上获取对应属性
接口链接：bmc.kepler.Systems.OpticalModule.Temperature 接口定义

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
新增 ORFICTemperatureCelsius d True false 光模块光射频集成电路芯片温度，单位摄氏度 Read: ReadOnly 从HDK获取 不持久化 无影响

变更接口影响

路径 变更接口影响 CSR配置影响 持久化影响 其他影响
/bmc/kepler/Systems/:SystemID/NetworkAdapters/:ID/Ports/:ID/OpticalModule 新增光模块属性 不涉及重名属性，无影响 不涉及新增和废弃主键，无兼容性问题 无
/bmc/kepler/Chassis/:ChassisId/Transceivers/:ID 新增光模块属性 不涉及重名属性，无影响 不涉及新增和废弃主键，无兼容性问题 无

评审点4：光模块Transceiver资源新增部分DFX参数

资源URI： https://device_ip/redfish/v1/Chassis/chassis_id/Transceivers/transceivers_id
变化类型：新增属性
操作类型：GET
应用场景：获取光模块DFX参数

一级属性 二级属性 类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
HostSNRdB / array(number, null) / true 是 / ReadOnly 光模块主机侧各通道接收信噪比，单位dB
HostLTPdB / array(number, null) / true 是 / ReadOnly 光模块主机侧各通道电平转换参数，单位dB
MediaSNRdB / array(number, null) / true 是 / ReadOnly 光模块介质侧各通道接收信噪比，单位dB
MediaLTPdB / array(number, null) / true 是 / ReadOnly 光模块介质侧各通道电平转换参数，单位dB
TxLosState / bool true或false true 否 / ReadOnly 光模块发送信号丢失状态
TxLolState / bool true或false true 否 / ReadOnly 光模块发送信号失锁状态
RxLolState / bool true或false true 否 / ReadOnly 光模块接收信号失锁状态
VendorDefinedMetrics / object / / / / / 光模块厂商自定义度量参数
VendorDefinedMetrics ORFICTemperatureCelsius number, null / true 是 / ReadOnly 光模块光射频集成电路芯片温度，单位摄氏度
VendorDefinedMetrics ODSPTemperatureCelsius number, null / true 是 / ReadOnly 光模块光数字信号处理器温度，单位摄氏度
VendorDefinedMetrics ODSPHighTemperatureRuntimeSeconds int, null / true 否 / ReadOnly 光模块光数字信号处理器高温运行时间，单位秒
VendorDefinedMetrics TxVPPVoltage array(number, null) / true 是 / ReadOnly 光模块各通道发送信号输入幅度电压，单位伏
VendorDefinedMetrics RxVPPVoltage array(number, null) / true 是 / ReadOnly 光模块各通道接收信号输入幅度电压，单位伏
VendorDefinedMetrics VCSELVoltage array(number, null) / true 是 / ReadOnly 光模块各通道激光器前向电压，单位伏
VendorDefinedMetrics UptimeSeconds int, null / true 是 / ReadOnly 光模块启动时长，单位秒
VendorDefinedMetrics LaserTemperatureCelsius number, null / true 是 / ReadOnly 光模块激光器温度，单位摄氏度
VendorDefinedMetrics LaserRuntimeSeconds int, null / true 是 / ReadOnly 光模块激光器运行时间，单位秒
VendorDefinedMetrics PowerOnCount int, null / true 否 / ReadOnly 光模块累计上电次数

RspBody响应体示例：

{
    "@odata.context": "/redfish/v1/$metadata#HwTransceiver.HwTransceiver",
    "@odata.id": "/redfish/v1/Chassis/1/Transceivers/OpticalModule_mainboardPCIeCard5Port1",
    "@odata.type": "#HwTransceiver.v1_0_0.HwTransceiver",
    "Name": "OpticalModule",
    "Id": "OpticalModule_mainboardPCIeCard5Port1",
    ...
    "TXBiasCurrent": [ 
        {
            "ReadingMilliAmperes": 7504,
            "LowerThresholdCritical": null,
            "UpperThresholdCritical": null
        }
    ],
    "MediaSNRdB": [
        20.0
    ],
    "HostSNRdB": [
        30.0
    ],
    "MediaLTPdB": [
        30.0
    ],
    "HostLTPdB": [
        30.0
    ],
    "TxFaultState": false,
    "RxLolState": false,
    "TxLolState": false,
    "RxLosState": false,
    "TxLosState": false,
    "VendorDefinedMetrics": {
        "UptimeSeconds": 360098,
        "PowerOnCount": 852,
        "VCSELVoltage": [1.5],
        "TxVPPVoltage": [1.2],
        "RxVPPVoltage": [1.1],
        "ORFICTemperatureCelsius": 50,
        "LaserRuntimeSeconds": 51,
        "ODSPTemperatureCelsius": 51,
        "ODSPHighTemperatureRuntimeSeconds": 3687,
        "LaserTemperatureCelsius": 52
    }
}

是否准备好AI预审

是

评审结论

1、同意bmc.kepler.Systems.OpticalModule 接口新增 MediaLTP、HostLTP 属性，bmc.kepler.Systems.OpticalModule.Voltage 接口新增 VCSELVoltage、TxVPPVoltage、RxVPPVoltage 属性，bmc.kepler.Systems.OpticalModule.Temperature 接口新增 ORFICTemperatureCelsius 属性，详细描述见评审点1~3
2、同意redfish光模块资源 https://device_ip/redfish/v1/Chassis/chassis_id/Transceivers/transceivers_id 新增DFX参数等属性，详细描述见评审点4

遗留问题

1、易变属性需要正确体现
已确认并修改
2、redfish接口属性名要体现单位
SNR和LTP已体现单位，电压单位修改为伏
3、示例/取值约束需审视是否完备
已确认可以正确体现
4、State属性（bool类型）命名和描述看是否能调整
与当前接口其他属性（TxFaultState、RxLosState）保持一致，不建议修改

2

预审答案内容由AI生成，仅供参考：

帖子评审结论：【待评审】支持光模块相关接口新增属性

帖子相关性：相关（MDB 相关: 内容含强特征: 资源协作）

  • 总评审点数：3
  • MDB 资源协作接口评审点：3
  • 其他评审点：0

总体结果：不通过（2/3 个评审点通过）

评审点 1：变更资源协作接口 bmc.kepler.Systems.OpticalModule【MDB】

结果：通过

  • 规则合规性检查：通过（28 项检查全部通过）

评审点 2：变更资源协作接口 bmc.kepler.Systems.OpticalModule.Voltage【MDB】

结果：不通过

  • 规则合规性检查：不通过（1/28 项失败）
    • 规则合规性失败项（必须项）：
      规则ID：MDB-PROPERTY-015
      级别：必须项
      问题描述：属性来源为“从HDK获取”（实时硬件状态），但持久化类型设置为“掉电持久化”，两者在 BMC 掉电生命周期上存在矛盾。
      处理建议：属性来源为 HDK 的实时电压值在 BMC 掉电后硬件数据将丢失；设置为‘掉电持久化’会导致重新上电后读取到历史旧值而非当前硬件状态。建议修改持久化类型为‘Memory’或‘ResetPer’，或确认该属性是否为配置类属性并修正描述。

评审点 3：变更资源协作接口 bmc.kepler.Systems.OpticalModule.Temperature【MDB】

结果：通过

  • 规则合规性检查：通过（28 项检查全部通过）