📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

PowerConverter 类

属性	值
类名称	`PowerConverter`
功能描述	电源转换器管理对象，提供电源转换器基本信息、状态监控、性能指标和温度管理功能
所属SIG组	hardware
所属组件	power_mgmt
责任人	电源管理组
最后更新	2026-05-27
状态	🟢 正常运行

📊 属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`SlotNumber`	U8	0	U8	-	槽位号，主键	转换器槽位标识	`1`	CSR配置	硬件
`Manufacturer`	String	-	String	-	厂商	BMC接口展示	`"Huawei"`	FRU读取	硬件
`Model`	String	-	String	-	型号	BMC接口展示	`"DC-DC"`	FRU读取	硬件
`PowerSupplyType`	String	-	String	-	电源类型	BMC接口展示	`"DC"`	CSR配置	硬件
`Presence`	U8	-	0、1	-	在位状态 0：不在位 1：在位	在位检测	`1`	硬件检测	硬件
`SerialNumber`	String	-	String	-	序列号	BMC接口展示	`"SN12345"`	FRU读取	硬件
`PartNumber`	String	-	String	-	部件编号	BMC接口展示	`"PN001"`	FRU读取	硬件
`FirmwareVersion`	String	-	String	-	固件版本	BMC接口展示	`"1.0.0"`	设备通信	硬件
`Protocol`	String	-	String	-	通信协议	BMC接口展示	`"PMBus"`	CSR配置	硬件
`DeviceLocator`	String	-	String	-	设备定位器	BMC接口展示	`"Converter1"`	CSR配置	软件
`ProductionDate`	String	-	String	-	生产日期	BMC接口展示	`"2025-01-01"`	FRU读取	硬件
`Position`	String	-	String	-	位置	BMC接口展示	`"Conv${SlotNumber}"`	CSR配置	软件
`LineInputVoltageType`	String	-	String	-	输入电压类型	BMC接口展示	`"DC48V"`	设备通信	硬件
`PhysicalInterface`	String	-	String	-	物理接口类型	设备通信配置	`"I2C"`	CSR配置	硬件
`RefFrudata`	U8[]	-	U8[]	Frudata_Conv1	关联FRU数据对象	FRU信息获取	`"#/Frudata_Conv1"`	CSR配置	硬件
`UnsupportedProperties`	String[]	-	String[]	-	不支持的属性列表	属性过滤	`[]`	CSR配置	软件
`AlarmStatus`	U32	-	U32	-	告警状态	告警管理	`0`	软件刷新	软件
`PreAlarmStatus`	U32	-	U32	-	预告警状态	告警管理	`0`	软件刷新	软件
`RefSMCChip`	U8[]	-	U8[]	Smc_Conv1	关联SMC芯片对象	设备通信	`"#/Smc_Conv1"`	CSR配置	硬件

可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`PowerSupplyChannel`	String	-	String	-	电源通道	电源管理	`"Channel1"`	CSR配置	硬件
`TotalRunningHours`	U32	-	U32	-	总运行时间（volatile）	BMC接口展示	`1000`	设备通信	硬件
`OutputState`	String	-	String	-	输出状态	BMC接口展示	`"Enabled"`	软件刷新	软件
`CommunicationStatus`	String	-	String	-	通信状态	BMC接口展示	`"OK"`	软件刷新	软件
`Failure`	Boolean	false	Boolean	-	故障状态	告警监控	`false`	软件刷新	软件
`Fan1Fault`	Boolean	false	Boolean	-	风扇1故障	告警监控	`false`	软件刷新	硬件
`Fan2Fault`	Boolean	false	Boolean	-	风扇2故障	告警监控	`false`	软件刷新	硬件
`FanFault`	Boolean	false	Boolean	-	风扇故障	告警监控	`false`	软件刷新	硬件
`InputVoltageFault`	Boolean	false	Boolean	-	输入电压故障	告警监控	`false`	软件刷新	硬件
`LossOfInput`	Boolean	false	Boolean	-	输入丢失	告警监控	`false`	软件刷新	硬件
`OutputCurrentFault`	Boolean	false	Boolean	-	输出电流故障	告警监控	`false`	软件刷新	硬件
`OutputVoltageFault`	Boolean	false	Boolean	-	输出电压故障	告警监控	`false`	软件刷新	硬件
`OverTemperature`	Boolean	false	Boolean	-	过温状态	告警监控	`false`	软件刷新	硬件
`SleepMode`	String	-	String	-	睡眠模式	BMC接口展示	`"Normal"`	软件刷新	软件
`DeepSleepEnabled`	Boolean	false	Boolean	-	深睡眠是否启用	BMC接口展示	`false`	软件刷新	软件
`InputVoltageStatus`	String	-	String	-	输入电压状态	BMC接口展示	`"Normal"`	软件刷新	硬件
`DualInputVoltageStatus`	U16	-	U16	-	双路输入电压状态	BMC接口展示	`0`	软件刷新	硬件
`ScanStatus`	String	-	String	-	扫描状态	BMC接口展示	`"OK"`	软件刷新	软件
`CMLStatus`	U8	255	U8	-	CML状态	BMC接口展示	`255`	软件刷新	硬件
`OtherStatus`	String	-	String	-	其他状态	BMC接口展示	`"Normal"`	软件刷新	软件
`MfrSpecificStatus`	U8	255	U8	-	厂商特定状态	BMC接口展示	`255`	软件刷新	硬件
`OutputPowerWatts`	Double	-	Double	-	输出功率（瓦）volatile	BMC接口展示	`650.0`	软件刷新	硬件
`InputPowerWatts`	Double	-	Double	-	输入功率（瓦）volatile	BMC接口展示	`700.0`	软件刷新	硬件
`InputVoltage`	Double	-	Double	-	输入电压volatile	BMC接口展示	`48.0`	软件刷新	硬件
`OutputVoltage`	Double	-	Double	-	输出电压volatile	BMC接口展示	`12.0`	软件刷新	硬件
`InputCurrentAmps`	Double	-	Double	-	输入电流（安培）volatile	BMC接口展示	`14.6`	软件刷新	硬件
`OutputCurrentAmps`	Double	-	Double	-	输出电流（安培）volatile	BMC接口展示	`54.0`	软件刷新	硬件
`Rate`	Double	-	Double	-	效率volatile	BMC接口展示	`0.93`	软件刷新	硬件
`RatedCurrentAmps`	Double	-	Double	-	额定电流（安培）volatile	BMC接口展示	`66.0`	设备通信	硬件
`InputFrequencyHz`	Double	-	Double	-	输入频率（Hz）volatile	BMC接口展示	`0`	软件刷新	硬件
`EnvTemperatureCelsius`	Double	-	Double	-	环境温度（摄氏度）volatile	BMC接口展示	`25.0`	软件刷新	硬件
`PrimaryChipTemperatureCelsius`	Double	-	Double	-	主芯片温度（摄氏度）volatile	BMC接口展示	`45.0`	软件刷新	硬件
`SecondaryChipTemperatureCelsius`	Double	-	Double	-	副芯片温度（摄氏度）volatile	BMC接口展示	`40.0`	软件刷新	硬件
`InletTemperatureCelsius`	Double	-	Double	-	进风口温度（摄氏度）volatile	BMC接口展示	`30.0`	软件刷新	硬件
`InnerTemperatureCelsius`	Double	-	Double	-	内部温度（摄氏度）volatile	BMC接口展示	`50.0`	软件刷新	硬件

🔗 动态关联机制

语法规范

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

yaml

# FRU数据关联
RefFrudata: "#/Frudata_Conv1"

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

关联说明

RefFrudata: 关联FRU数据对象获取转换器FRU信息
RefSMCChip: 关联SMC芯片对象实现设备通信

📂 分类标准

硬件属性

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

软件属性

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

📝 配置示例

标准电源转换器配置

json

{
  "PowerConverter_1": {
    "SlotNumber": 1,
    "Manufacturer": "Huawei",
    "Model": "DC-DC",
    "PowerSupplyType": "DC",
    "Presence": 1,
    "SerialNumber": "SN12345",
    "PartNumber": "PN001",
    "FirmwareVersion": "1.0.0",
    "Protocol": "PMBus",
    "DeviceLocator": "Converter1",
    "ProductionDate": "2025-01-01",
    "Position": "Conv${SlotNumber}",
    "LineInputVoltageType": "DC48V",
    "PhysicalInterface": "I2C",
    "RefFrudata": "#/Frudata_Conv1",
    "RefSMCChip": "#/Smc_Conv1"
  }
}

🔧 使用指南

配置步骤

基本信息配置：设置槽位号、厂商、型号等基本信息
关联FRU对象：配置RefFrudata关联FRU数据对象
关联芯片对象：配置RefSMCChip关联SMC芯片对象
性能监控：通过Metrics属性监控性能指标
状态监控：通过Status属性监控状态

注意事项

主键唯一性：确保SlotNumber唯一标识转换器槽位
FRU关联：确保RefFrudata关联有效的FRU数据对象
芯片关联：确保RefSMCChip关联有效的SMC芯片对象

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

PowerConverter 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

关联说明 ​

📂 分类标准 ​

硬件属性 ​

软件属性 ​

📝 配置示例 ​

标准电源转换器配置 ​

🔧 使用指南 ​

配置步骤 ​

注意事项 ​

📚 相关文档 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

PowerConverter 类

📊 属性定义详表

必选属性

可选属性

🔗 动态关联机制

语法规范

关联说明

📂 分类标准

硬件属性

软件属性

📝 配置示例

标准电源转换器配置

🔧 使用指南

配置步骤

注意事项

📚 相关文档