【已评审】新增灵衢总线管理健康状态属性及灵衢交换光模块资源对象路径

Interface SIG Interface评审
1

背景

BMC需要支持获取UBM交换域相关设备（子卡、fpga等）的硬件故障信息（如pcie故障等），并通过资源协作接口呈现，用于标准精细化告警/传感器配置

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

新增属性

变更类型 属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
新增 FaultCode t true true UBM上报的故障状态，bitmap结构，默认值0，每个bit置1表示特定告警/事件：Bit 0：预留、Bit 1：UBM DDR ECC 错误超过特定阈值、Bit 2：UBM CPU UCE、Bit 3：UBM DDR UCE、Bit 4：UBM外部请求触发复位、Bit 5、6：预留、Bit 7：FPGA CE、Bit 8：预留、Bit 9：FPGA UCE、Bit 10~63：预留 Read: ReadOnly 轮询UBM获取 复位持久化 false

评审点2： 资源协作接口 bmc.kepler.LCN.Card 新增属性

新增属性

变更类型 属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
新增 FaultCode t true true UB Switch故障状态，bitmap结构，默认值0，每个bit置1表示特定告警/事件：Bit 0：UB Switch芯片 PCIE CE错误、Bit 1：UB Switch芯片 PCIE UCE错误、Bit 2~63：预留 Read: ReadOnly 轮询UBM获取 复位持久化 false

评审点3：新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Transceivers/:OpticalModuleId

路径描述 ：承载灵衢总线交换设备的光模块信息，对应redfish接口 /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortsId}/Metrics 中的Transceivers信息

实现接口

实现接口 实现接口描述 CSR配置影响 持久化影响 其他影响
bmc.kepler.Systems.OpticalModule 复用已有资源协作接口 不涉及CSR配置，无影响 不涉及持久化，无影响 不涉及
bmc.kepler.Systems.OpticalModule.BiasCurrent 复用已有资源协作接口 不涉及CSR配置，无影响 不涉及持久化，无影响 不涉及
bmc.kepler.Systems.OpticalModule.Power 复用已有资源协作接口 不涉及CSR配置，无影响 不涉及持久化，无影响 不涉及
bmc.kepler.Systems.OpticalModule.Voltage 复用已有资源协作接口 不涉及CSR配置，无影响 不涉及持久化，无影响 不涉及

是否准备好AI预审

是

评审结论

1、同意资源协作接口 bmc.kepler.LCN 新增属性 FaultCode
2、同意资源协作接口 bmc.kepler.LCN.Card 新增属性 FaultCode
3、同意新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/Transceivers/:OpticalModuleId

遗留问题

1、FaultCode每个bitmap的定义：

（1）bmc.kepler.LCN的FaultCode的bitmap定义如下，置1表示事件触发，置0表示恢复：
Bit 0：预留
Bit 1：UBM DDR ECC 错误超过特定阈值
Bit 2：UBM CPU UCE
Bit 3：UBM DDR UCE
Bit 4：UBM外部请求触发复位
Bit 5、6：预留
Bit 7：FPGA CE
Bit 8：预留
Bit 9：FPGA UCE
Bit 10~63：预留

（2）bmc.kepler.LCN.Card的bitmap定义如下，置1表示事件触发，置0表示恢复：
Bit 0：UB Switch芯片 PCIE CE错误
Bit 1：UB Switch芯片 PCIE UCE错误
Bit 2~63：预留

2

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

帖子评审结论：【待评审】LCN、LCNCard对象新增资源属性FaultCode

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

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

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

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

结果：通过

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

评审点 2：变更资源协作接口 bmc.kepler.LCN.Card【MDB】

结果：通过

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

评审点 3：新增资源协作路径 /bmc/kepler/LCNs/:Id/Cards/:Cardid/OpticalModules/:OpticalModuleId【MDB】

结果：通过

  • 规则合规性检查：通过（27 项检查全部通过）
    • 警告项（建议性）：
      规则ID：MDB-NAMING-007
      级别：建议性
      问题描述：路径参数 Cardid 应采用驼峰命名 CardId，以提高可读性。
      处理建议：severity=‘should’ 建议性规则，建议修改以提升规范符合性