【已评审】新增PowerSupplyMetrics相关资源协作接口属性

背景

当前redfish标准接口存在缺失,需要评审新增资源协作接口属性。

关联ISSUE

[需求]: 支持PowerSupplyMetrics接口新标准

评审点

评审点1: 在资源协作接口中新增属性EnergykWh、EnergySensorResetTime、EnergyApparentkVAh、EnergyLifetimekWh、EnergyReactivekVARh、InputCurrentAmpsCrestFactor、InputCurrentAmpsTHDPercent、InputPowerWattsApparentVA、InputPowerWattsPhaseAngleDegrees、InputPowerWattsPowerFactor、InputPowerWattsReactiveVAR、InputVoltageCrestFactor、OutputPowerWattsApparentVA、OutputPowerWattsPhaseAngleDegrees、OutputPowerWattsPowerFactor、OutputPowerWattsReactiveVAR

新增方法Reset

详细描述

评审点1:新增资源协作接口属性

path(已有): /bmc/kepler/Systems/:SystemId/PowerMgmt/:ID
interface(新增): bmc.kepler.Chassis.PowerSubsystem.PowerSupply.Metrics

属性名称 变化类型 签名 默认值 取值范围 持久化 变化通知 操作权限 说明
EnergyApparentkVAh 新增属性 d 0 / false 只读,读权限:ReadOnly 电气能量测量中的显式能量值(单位为千伏安时)
EnergykWh 新增属性 d 0 / false 只读,读权限:ReadOnly 设备能耗
InputCurrentAmpsCrestFactor 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输入电流的峰值系数
InputCurrentAmpsTHDPercent 新增属性 d 0 [0,100] false 只读,读权限:ReadOnly 电源输入电流总谐波失真百分比
InputPowerWattsApparentVA 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输入中交流电中电压与电流的乘积
InputPowerWattsPhaseAngleDegrees 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输入电流波形与电压波形之间的相位角
InputPowerWattsPowerFactor 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输入功率的功率因数
InputPowerWattsReactiveVAR 新增属性 d 0 / false 只读,读权限:ReadOnly 电路中表观视在功率与功率之差的平方根值
InputVoltageCrestFactor 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输入电压的峰值系数
EnergyLifetimekWh 新增属性 d 0 / false 只读,读权限:ReadOnly 设备能耗的总累计值
OutputPowerWattsApparentVA 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输出交流电中电压与电流的乘积
OutputPowerWattsPhaseAngleDegrees 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输出电流波形与电压波形之间的相位角
OutputPowerWattsPowerFactor 新增属性 d 0 / false 只读,读权限:ReadOnly 电源输出功率的功率因数
OutputPowerWattsReactiveVAR 新增属性 d 0 / false 只读,读权限:ReadOnly 电路中表观视在功率与功率之差的平方根值
EnergyReactivekVARh 新增属性 d 0 / false 只读,读权限:ReadOnly 电能测量的无功能量(以千伏安时(无功)为单位)
EnergySensorResetTime 新增属性 s “” 格式为 YYYY-MM-DDThh:mm:ssZ 的合法时间字符串 false 只读,读权限:ReadOnly 基于时间的属性最后一次被重置的日期和时间。
取值及说明
方法名称 Reset
方法描述 重置采集的历史数据,重置之后重新开始采集
方法权限 PowerMgmt
请求签名
请求参数 NA
响应签名
响应参数 NA

评审结论

通过,同意新增资源协作接口 bmc.kepler.Chassis.PowerSubsystem.PowerSupply.Metrics,接口下新增属性:EnergyApparentkVAhEnergykWhInputCurrentAmpsCrestFactorInputCurrentAmpsTHDPercentInputPowerWattsApparentVAInputPowerWattsPhaseAngleDegreesInputPowerWattsPowerFactorInputPowerWattsReactiveVARInputVoltageCrestFactorEnergyLifetimekWhOutputPowerWattsApparentVAOutputPowerWattsPhaseAngleDegreesOutputPowerWattsPowerFactorOutputPowerWattsReactiveVAREnergyReactivekVARhEnergySensorResetTime,属性详细定义见议题;接口新增方法 Reset,方法无请求和响应参数。

遗留问题

参照标准资源树评审格式,要有签名,数值不是number

已修改 参考标准文档 把多余条件已删除

参照标准资源树评审格式,要有签名,数值不是number;

按照资源协作接口设计合规性必检指南,排查修改命名等

PhysicalContext 这种有取值范围的 要写清楚支持的取值范围

内容已修改

1、先把格式整改好,字段与字段之间空格间隙过大
2、EnergykWhReading、FrequencyHzReading参考标准规范命名,其他排查修改
3、PhysicalContext 要审视哪些是合理字段,不必全部枚举
4、SensorResetTime string类型 与 取值范围不符,需要体现data-time格式


注意类型的 mdb上查全是double

FanSpeedsPercent、RailCurrentAmps等标准资源为数组的,需要考虑属性设计

SensorResetTime增加前缀Energy、SpeedRPM、PhysicalContext、PhysicalSubContext增加前缀Fan

FrequencyHz 删除,使用现有的 InputFrequencyHz