【待评审】新增 bmc.kepler.Chassis.Dimension 的 Width 属性

背景

bmc.kepler.Chassis.Dimension 当前只对外提供 HeightU(Double,只读,CSR 配置),用于表示机框高度;chassis 侧已有 IPMI GetChassisHeight(0x30/0x94、子命令 0x6C、参数选择子 0x0100)读取该属性,按 2 字节返回高度整数部分和半 U 标志。

IPMI 规范 6Dh 附表 1 已定义设备宽度:参数选择子 0x0200,1 字节,1=半宽、2=全宽、3=Double。但资源树没有对应属性,chassis 也没有实现 0x0200 查询,导致按规范发 ipmitool raw 0x30 0x94 ... 0x6C 0x00 0x02 ... 时命令无法命中,宽度信息只能由使用方自行维护,易与 SR 配置不一致。

因此需要给 bmc.kepler.Chassis.Dimension 增加 Width 属性,由 SR 统一配置,chassis 通过新增 IPMI GetChassisWidth 读取并返回。

关联ISSUE

整体方案

本需求要解决的是:SR 已能按规范描述机框宽度,但资源树和 IPMI 查询链路缺失,导致宽度不可读。

  1. 接口层(mdb_interface)

    • bmc.kepler.Chassis.Dimension 新增只读属性 Width,类型 U8,作为机框宽度的唯一资源树来源对外开放。
    • 取值口径:1=半宽、2=全宽、3=Double;默认值 0,表示产品未配置宽度,当前保留。
    • 变化通知:不使能,Width 与 HeightU 一样是静态 CSR 属性。
    • 明确边界:不新增方法、不新增信号,不改变 HeightU 的类型、只读属性和现有行为。
  2. chassis 侧

    • chassis 从 /bmc/kepler/Chassis/1/Dimension 读取 Width,新增 IPMI GetChassisWidth:NetFn 0x30、Cmd 0x94、SubCmd 0x6C、ParamSelector 0x0200,按 1 字节返回。
    • 读取规则复用高度链路:ReadOffset >= 1、ReadLen > 1、ReadOffset + ReadLen > 1 返回 ParmOutOfRange;资源树对象不存在或属性异常返回 DataNotAvailable。
    • 未配置 Width 时资源树默认值为 0,IPMI 返回 0x00,不新增其他失败分支。
    • 责任边界:chassis 只负责按 SR 原值透传,不判断机型宽度类型是否合理;具体配置由产品 SR 决定。

达成效果:SR 配置 Dimension_1.Width 后,可通过 IPMI 0x30/0x94 的 0x0200 选择子读取单板宽度;未配置时返回默认值 0,对现有高度查询和未使用宽度的产品无影响,接口保持向后兼容。

评审点

评审点1:变更资源协作接口 bmc.kepler.Chassis.Dimension 的 Width 属性

详细描述

评审点1:变更资源协作接口 bmc.kepler.Chassis.Dimension 的 Width

变更描述:

bmc.kepler.Chassis.Dimension 承载机框物理尺寸信息,当前只有 HeightU(Double,只读,CSR 配置,默认 0),没有宽度定义。

宽度与高度属于同一机框尺寸信息,放在同一接口可以保持取值口径一致,避免再建对象或从其他组件拼接。该属性由 SR 的 Dimension 对象配置,chassis 直接读取并通过 IPMI 返回,属于唯一权威来源。

契约:Width 为 U8,只读,默认 0;有效业务值为 1/2/3,分别表示半宽/全宽/Double,0 表示未配置;当前不使能属性变化通知。下游使用方不得自行推导或改写该值,未配置时按 0 处理。

现有 HeightU 的类型、只读属性、默认值和 IPMI GetChassisHeight 链路均不变,不影响既有使用方。

"Width": {
    "baseType": "U8",
    "readOnly": true,
    "description": "机框宽度"
}

接口链接:bmc.kepler.Chassis.Dimension 接口定义

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
新增 Width y true false 机框宽度,1=半宽、2=全宽、3=Double,0=未配置 Read: ReadOnly CSR 配置 无需持久化 chassis 新增 IPMI GetChassisWidth 读取;其他组件无影响

变更接口影响

路径 变更接口影响 CSR 配置影响 持久化影响 其他影响
/bmc/kepler/Chassis/:ChassisId/Dimension 新增只读属性 Width,提供机框宽度查询能力 需要在 PSR 的 Dimension_1 中增加 Width;不配置时默认 0 无新增/废弃主键,无需持久化 chassis 注册新增 IPMI GetChassisWidth(0x30/0x94、选择子 0x0200);现有资源树属性和 IPMI 命令不变

兼容性说明

  • 现有 HeightU 的语义、取值、只读属性和刷新机制保持不变;
  • Width 不配置时为默认值 0,不读取时对现有产品无影响;
  • 不新增对象、不新增资源树方法、不新增信号;
  • 新增 IPMI GetChassisWidth,复用既有 0x30/0x94 子命令族和 0x6C 子命令,仅新增参数选择子 0x0200,不影响现有高度、机架、超节点等命令;
  • 生成物 mds/schema.json、gen/** 由 bingo gen 生成,禁止手改;
  • mdb_interface 需先合入或在 chassis 合入时同步提供 Width 属性契约,避免重跑代码生成时属性丢失。

是否准备好AI预审

是,接口定义、chassis 生成物和单元测试已自检完成,待评审。

评审结论

遗留问题

预审答案内容由AI生成,仅供参考:

帖子评审结论:【待评审】新增 bmc.kepler.Chassis.Dimension 的 Width 属性

帖子相关性:相关(MDB 相关: 标题含强特征: bmc.kepler)

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

总体结果:通过(1/1 个评审点通过)

评审点 1:变更资源协作接口 bmc.kepler.Chassis.Dimension 的 Width 属性【MDB】

结果:通过

  • 规则合规性检查:通过(29 项检查全部通过)