CSR配置字典之OnePower类
更新时间: 2026/05/27
在Gitcode上查看源码

📋 文档信息

项目内容
文档标题OnePower类配置字典
版本v1.1
创建日期2026-05-27
最后更新2026-05-27
维护状态✅ 活跃维护

📋 变更历史记录

文档变更记录

版本发布日期变更类型变更内容影响范围维护人员
v1.02026-05-27初始版本创建OnePower类配置字典全新文档系统管理员
v1.12026-05-27补充属性补充OnePower对象属性信息属性定义系统管理员

🎯 类概览

OnePower 类

属性
类名称OnePower
功能描述单体电源管理对象,提供电源基本信息、状态监控、性能指标、温度管理和输出控制功能
所属SIG组hardware
所属组件power_mgmt
责任人电源管理组
最后更新2026-05-27
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
SlotNumberU80U8-槽位号电源槽位标识1CSR配置硬件
ManufacturerString-String-厂商BMC接口展示"Huawei"FRU读取硬件
ModelString-String-电源型号BMC接口展示"PSU-800W"FRU读取硬件
PowerSupplyTypeString-String-电源模块的供电类型,0:DC; 1:AC; 2: ACorDC; 3: UnknownBMC接口展示"AC"CSR配置硬件
PresenceU8-0、1-在位状态,0:不在位,1:在位电源在位检测1硬件检测硬件
SerialNumberString-String-序列号BMC接口展示"SN12345"FRU读取硬件
PartNumberString-String-部件编码BMC接口展示"PN001"FRU读取硬件
FirmwareVersionString-String-电源固件版本BMC接口展示"1.0.0"电源通信硬件
ProtocolString-String-电源协议BMC接口展示"pmbus"CSR配置硬件
DeviceLocatorString-String-物理位置BMC接口展示"PSU1"CSR配置软件
ProductionDateString-String-生产日期BMC接口展示"2020-10-31"FRU读取硬件
PositionString-String-容器信息BMC接口展示"EXU"CSR配置软件
DMTFPowerSupplyTypeU84U8-DMTF电源类型: 1 Other;2 Unknown;3 Linear; 4 Switching; 5 Battery; 6 UPS; 7 Converter; 8 RegulatorBMC接口展示4CSR配置硬件
SourceTypeU81U8-功率读数来源,0:chip(功率传感器芯片,如INA220); 1:PSU(电源MCU)BMC接口展示1CSR配置硬件
IsPartOfSysPowerBooleantrueBoolean-是否参与整机功耗计算,true:功耗纳入整机功耗计算,false:功耗不纳入整机功耗计算电源管理trueCSR配置软件
LineInputVoltageTypeString-String-电源模块支持的供电类型BMC接口展示"AC220V"电源通信硬件
WorkModeString-String-单个电源主备工作模式(主用:Enabled,备用:StandbySpare)BMC接口展示"Active"CSR配置软件
DeepSleepStandbyPowerWattsU32-U32-电源模块深度休眠状态下的待机功耗BMC接口展示0CSR配置硬件
InputNumU8-U8-电源供电线路数量,1:单路供电 2:双路供电BMC接口展示1CSR配置硬件
PhysicalInterfaceString-String-物理接口类型电源通信配置"I2C"CSR配置硬件
RefFrudataU8[]-U8[]Frudata_PSU1关联FRU数据对象FRU信息获取"#/Frudata_PSU1"CSR配置硬件
UnsupportedPropertiesString[]-String[]-不支持的属性列表属性过滤[]CSR配置软件
AlarmStatusU32-U32-告警状态告警管理0软件刷新软件
PreAlarmStatusU32-U32-预告警状态告警管理0软件刷新软件
RefSMCChipU8[]-U8[]Smc_PSU1关联SMC芯片对象电源通信"#/Smc_PSU1"CSR配置硬件
UpgradeSupportedBooleantrueBoolean-是否支持升级升级管理trueCSR配置软件
InputStateU8-U8-输入状态BMC接口展示1软件刷新软件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
PowerSupplyChannelString-String-电源供电电路,0:主路 1:备路电源管理"Channel1"CSR配置硬件
TotalRunningHoursU32-U32-总运行时间BMC接口展示1000电源通信硬件
RelaySwitchedCountU320U32-电源内部继电器切换次数,仅适用于机柜管理场景双输入电源BMC接口展示0电源通信硬件
OutputPowerLimitWattsU320U32-输出功率限制(瓦)输出控制800CSR配置软件
OutputVoltageAdjustmentEnabledBooleanfalseBoolean-输出电压调整是否启用输出控制falseCSR配置软件
TargetOutputVoltageDouble0Double-目标输出电压输出控制12.0CSR配置软件
OutputStateString-String-输出状态BMC接口展示"Enabled"软件刷新软件
CommunicationStatusString-String-通信状态BMC接口展示"OK"软件刷新软件
FailureBooleanfalseBoolean-故障状态告警监控false软件刷新软件
Fan1FaultBooleanfalseBoolean-风扇1故障告警监控false软件刷新硬件
Fan2FaultBooleanfalseBoolean-风扇2故障告警监控false软件刷新硬件
FanFaultBooleanfalseBoolean-风扇故障告警监控false软件刷新硬件
InputVoltageFaultU1632768U16-输入电压故障告警监控0软件刷新硬件
LossOfInputBooleanfalseBoolean-输入丢失告警监控false软件刷新硬件
OutputCurrentFaultBooleanfalseBoolean-输出电流故障告警监控false软件刷新硬件
OutputVoltageFaultBooleanfalseBoolean-输出电压故障告警监控false软件刷新硬件
OverTemperatureBooleanfalseBoolean-过温状态告警监控false软件刷新硬件
SleepModeString-String-睡眠模式BMC接口展示"Normal"软件刷新软件
DeepSleepEnabledBooleanfalseBoolean-深睡眠是否启用BMC接口展示false软件刷新软件
InputVoltageStatusString-String-输入电压状态BMC接口展示"Normal"软件刷新硬件
DualInputVoltageStatusU16-U16-双路输入电压状态BMC接口展示0软件刷新硬件
ScanStatusString-String-扫描状态BMC接口展示"OK"软件刷新软件
EquipmentModeString-String-设备模式BMC接口展示"Normal"软件刷新软件
TPSUStatusHighU80U8-TPSU状态高位告警监控0软件刷新硬件
TPSUStatusLowU80U8-TPSU状态低位告警监控0软件刷新硬件
MainCircuitVINStatusU8255U8-主电路VIN状态BMC接口展示255软件刷新硬件
BackupCircuitVINStatusU8255U8-备电路VIN状态BMC接口展示255软件刷新硬件
MfrSpecificStatusU8255U8-厂商特定状态BMC接口展示255软件刷新硬件
CMLStatusU8255U8-CML状态BMC接口展示255软件刷新硬件
OutputPowerWattsDouble-Double-输出功率(瓦)volatileBMC接口展示650.0软件刷新硬件
InputPowerWattsDouble-Double-输入功率(瓦)volatileBMC接口展示700.0软件刷新硬件
InputVoltageDouble-Double-输入电压volatileBMC接口展示220.0软件刷新硬件
OutputVoltageDouble-Double-输出电压volatileBMC接口展示12.0软件刷新硬件
InputCurrentAmpsDouble-Double-输入电流(安培)volatileBMC接口展示3.2软件刷新硬件
OutputCurrentAmpsDouble-Double-输出电流(安培)volatileBMC接口展示54.0软件刷新硬件
RateDouble-Double-效率volatileBMC接口展示0.93软件刷新硬件
RatedCurrentAmpsDouble-Double-额定电流(安培)volatileBMC接口展示66.0电源通信硬件
InputFrequencyHzDouble-Double-输入频率(Hz)volatileBMC接口展示50.0软件刷新硬件
EnergykWhDouble0Double-累计能量(kWh)BMC接口展示0软件刷新硬件
EnergySensorResetTimeString""String-能量传感器重置时间BMC接口展示""软件刷新软件
EnergyApparentkVAhDouble0Double-累计视在能量(kVAh)BMC接口展示0软件刷新硬件
EnergyLifetimekWhDouble0Double-累计生命周期能量(kWh)BMC接口展示0软件刷新硬件
EnergyReactivekVARhDouble0Double-累计无功能量(kVARh)BMC接口展示0软件刷新硬件
InputCurrentAmpsCrestFactorDouble0Double-输入电流峰值因子BMC接口展示0软件刷新硬件
InputCurrentAmpsTHDPercentDouble0Double-输入电流总谐波失真百分比BMC接口展示0软件刷新硬件
InputPowerWattsApparentVADouble0Double-输入视在功率(VA)BMC接口展示0软件刷新硬件
InputPowerWattsPhaseAngleDegreesDouble0Double-输入功率相位角(度)BMC接口展示0软件刷新硬件
InputPowerWattsPowerFactorDouble0Double-输入功率因子BMC接口展示0软件刷新硬件
InputPowerWattsReactiveVARDouble0Double-输入无功功率(VAR)BMC接口展示0软件刷新硬件
InputVoltageCrestFactorDouble0Double-输入电压峰值因子BMC接口展示0软件刷新硬件
OutputPowerWattsApparentVADouble0Double-输出视在功率(VA)BMC接口展示0软件刷新硬件
OutputPowerWattsPhaseAngleDegreesDouble0Double-输出功率相位角(度)BMC接口展示0软件刷新硬件
OutputPowerWattsPowerFactorDouble0Double-输出功率因子BMC接口展示0软件刷新硬件
OutputPowerWattsReactiveVARDouble0Double-输出无功功率(VAR)BMC接口展示0软件刷新硬件
EnvTemperatureCelsiusDouble-Double-环境温度(摄氏度)volatileBMC接口展示25.0软件刷新硬件
PrimaryChipTemperatureCelsiusDouble-Double-主芯片温度(摄氏度)volatileBMC接口展示45.0软件刷新硬件
SecondaryChipTemperatureCelsiusDouble-Double-副芯片温度(摄氏度)volatileBMC接口展示40.0软件刷新硬件
InletTemperatureCelsiusDouble-Double-进风口温度(摄氏度)volatileBMC接口展示30.0软件刷新硬件
InnerTemperatureCelsiusDouble-Double-内部温度(摄氏度)volatileBMC接口展示50.0软件刷新硬件
EfficiencyCurveDouble[]-Double[]-效率曲线数据效率计算[0.85, 0.90, 0.93]CSR配置硬件
PowerLevelDouble[]-Double[]-功率水平数据效率计算[100, 200, 400]CSR配置硬件

🔗 动态关联机制

语法规范

使用 #/xxx 格式实现动态关联:

yaml
# FRU数据关联
RefFrudata: "#/Frudata_PSU1"

# SMC芯片关联
RefSMCChip: "#/Smc_PSU1"

关联说明

  • RefFrudata: 关联FRU数据对象获取电源FRU信息
  • RefSMCChip: 关联SMC芯片对象实现电源通信

📂 分类标准

硬件属性

  • 定义:与电源硬件直接相关的参数
  • 特点:反映硬件设计和物理特性
  • 示例SlotNumber, Manufacturer, Model, PowerSupplyType, Presence, SerialNumber, PartNumber, FirmwareVersion, Protocol, ProductionDate, DMTFPowerSupplyType, SourceType, LineInputVoltageType, DeepSleepStandbyPowerWatts, InputNum, PhysicalInterface, RefFrudata, RefSMCChip

软件属性

  • 定义:由软件管理和维护的参数
  • 特点:配置管理、状态监控和接口展示
  • 示例DeviceLocator, Position, IsPartOfSysPower, WorkMode, UnsupportedProperties, AlarmStatus, PreAlarmStatus, UpgradeSupported, InputState

📝 配置示例

标准单体电源配置

json
{
  "OnePower_1": {
    "SlotNumber": 1,
    "Manufacturer": "Huawei",
    "Model": "PSU-800W",
    "PowerSupplyType": "AC",
    "Presence": 1,
    "SerialNumber": "SN12345",
    "PartNumber": "PN001",
    "FirmwareVersion": "1.0.0",
    "Protocol": "PMBus",
    "DeviceLocator": "PSU1",
    "ProductionDate": "2025-01-01",
    "Position": "PSU${SlotNumber}",
    "DMTFPowerSupplyType": 4,
    "SourceType": 1,
    "IsPartOfSysPower": true,
    "LineInputVoltageType": "AC220V",
    "WorkMode": "Active",
    "DeepSleepStandbyPowerWatts": 5,
    "InputNum": 1,
    "PhysicalInterface": "I2C",
    "RefFrudata": "#/Frudata_PSU1",
    "RefSMCChip": "#/Smc_PSU1",
    "UpgradeSupported": true
  }
}

🔧 使用指南

配置步骤

  1. 基本信息配置:设置槽位号、厂商、型号等基本信息
  2. 关联FRU对象:配置RefFrudata关联FRU数据对象
  3. 关联芯片对象:配置RefSMCChip关联SMC芯片对象
  4. 性能监控:通过Metrics属性监控电源性能指标
  5. 状态监控:通过Status属性监控电源状态
  6. 温度监控:通过Temperatures属性监控温度

注意事项

  • 主键唯一性:确保SlotNumber唯一标识电源槽位
  • FRU关联:确保RefFrudata关联有效的FRU数据对象
  • 芯片关联:确保RefSMCChip关联有效的SMC芯片对象
  • 状态同步:确保电源状态的及时更新

📚 相关文档