【待评审】新增CapacityBandWidth属性和PowerCapacityWatts属性

Component Drivers SIG 部件驱动评审
1

背景

当前系统需要在上层Redfish接口中展示GPU的带宽信息，但设备树资源协作接口bmc.dev.Memory.Metrics缺少最大带宽（CapacityBandWidth）信息，无法为上层提供GPU带宽的基准值用于百分比计算和展示。

同时，bmc.dev.Processor.Metrics仅包含PowerWatts属性，缺少最大功率（PowerCapacityWatts）信息，上层无法获取处理器的额定功率上限。

以上两个属性均可通过CSR配置获取，需要在设备树资源协作接口中新增对应属性。

关联ISSUE

整体方案

在设备树资源协作接口bmc.dev.Memory.Metrics中新增CapacityBandWidth属性，在bmc.dev.Processor.Metrics中新增PowerCapacityWatts属性。两个属性数据均来源于CSR配置，由CSR解析模块在系统启动时将配置值写入设备树对象，上层组件通过资源协作接口读取。

评审点

评审点1：变更资源协作接口 bmc.dev.Memory.Metrics，新增CapacityBandWidth属性

评审点2：变更资源协作接口 bmc.dev.Processor.Metrics，新增PowerCapacityWatts属性

详细描述

评审点1：变更资源协作接口 bmc.dev.Memory.Metrics

变更描述：在设备树Memory.Metrics接口中新增CapacityBandWidth属性，用于表示带宽容量（配置死的固定值），数据来源为CSR配置，供上层Redfish接口展示GPU带宽信息使用。

接口链接：bmc.dev.Memory.Metrics接口定义

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 | 访问权限 属性来源 持久化类型 变更影响
新增 CapacityBandWidth u True false 带宽容量（GB/s），固定值，来源于CSR配置 Read: ReadOnly CSR读取 无需持久化 新增属性，无兼容性影响

变更接口影响

路径 变更接口影响 | CSR配置影响 持久化影响 其他影响
/bmc/dev/Memory/${Id}/Metrics 新增CapacityBandWidth属性，提供带宽容量查询能力，支持上层展示GPU带宽信息 CSR中需配置CapacityBandWidth字段，无重名属性冲突 不涉及新增和废弃主键，无兼容性问题 需在CSR解析逻辑中将CapacityBandWidth值写入设备树对象

评审点2：变更资源协作接口 bmc.dev.Processor.Metrics

变更描述：在设备树Processor.Metrics接口中新增PowerCapacityWatts属性，用于表示处理器功率容量上限，数据来源为CSR配置。

接口链接：bmc.dev.Processor.Metrics接口定义

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 | 访问权限 属性来源 持久化类型 变更影响
新增 PowerCapacityWatts d True false 处理器功率容量上限（W），来源于CSR配置 Read: ReadOnly CSR读取 无需持久化 新增属性，无兼容性影响

变更接口影响

路径 变更接口影响 | CSR配置影响 持久化影响 其他影响
/bmc/dev/Processor/${Id}/Metrics 新增PowerCapacityWatts属性，提供处理器功率容量上限查询能力 CSR中需配置PowerCapacityWatts字段，无重名属性冲突 不涉及新增和废弃主键，无兼容性问题 需在CSR解析逻辑中将PowerCapacityWatts值写入设备树对象

是否准备好AI预审

是

评审结论

  1. 同意变更资源协作接口bmc.dev.Memory.Metrics，新增CapacityBandWidth属性（签名u，ReadOnly，来源CSR，无需持久化），内容见详细描述。

  2. 同意变更资源协作接口bmc.dev.Processor.Metrics，新增PowerCapacityWatts属性（签名d，ReadOnly，来源CSR，无需持久化），内容见详细描述。

遗留问题