背景
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 查询链路缺失,导致宽度不可读。
-
接口层(mdb_interface)
bmc.kepler.Chassis.Dimension新增只读属性Width,类型U8,作为机框宽度的唯一资源树来源对外开放。- 取值口径:
1=半宽、2=全宽、3=Double;默认值0,表示产品未配置宽度,当前保留。 - 变化通知:不使能,
Width与HeightU一样是静态 CSR 属性。 - 明确边界:不新增方法、不新增信号,不改变
HeightU的类型、只读属性和现有行为。
-
chassis 侧
- chassis 从
/bmc/kepler/Chassis/1/Dimension读取Width,新增 IPMIGetChassisWidth: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 决定。
- chassis 从
达成效果: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 生成物和单元测试已自检完成,待评审。