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

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

PowerDistributionId 类

属性
类名称PowerDistributionId
功能描述电源分配ID对象,提供电源分配设备的基本信息、健康状态、版本管理、位置信息、容量配置和转换控制功能
所属SIG组hardware
所属组件power_mgmt
责任人电源管理组
最后更新2026-05-27
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
HealthString-String-健康状态BMC接口展示"OK"软件刷新软件
VersionString-String-版本信息BMC接口展示"1.0.0"硬件提供硬件
UUIDString-String-UUID标识BMC接口展示"uuid-001"硬件提供硬件
EquipmentTypeString-String-设备类型BMC接口展示"TransferSwitch"CSR配置硬件
FirmwareVersionString-String-固件版本BMC接口展示"1.0.0"硬件提供硬件
ManufacturerString-String-厂商BMC接口展示"Huawei"硬件提供硬件
ModelString-String-型号BMC接口展示"PDU-001"硬件提供硬件
PartNumberString-String-部件编号BMC接口展示"PN001"硬件提供硬件
SerialNumberString-String-序列号BMC接口展示"SN12345"硬件提供硬件
ProductionDateString-String-生产日期BMC接口展示"2025-01-01"硬件提供硬件
PowerCapacityVADouble-Double-电源容量(VA)BMC接口展示10000.0硬件规格硬件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
UserLabelString-String-用户标签BMC接口展示"PDU_1"用户配置软件
AssetTagString-String-资产标签BMC接口展示"Asset_001"用户配置软件
LocationServiceLabelString-String-位置服务标签BMC接口展示"Location_001"CSR配置软件
LocationReferenceString-String-位置参考BMC接口展示"Rack_1"CSR配置软件
LocationOrientationString-String-位置方向BMC接口展示"Front"CSR配置软件
LocationTypeString-String-位置类型BMC接口展示"Rack"CSR配置软件
LocationOrdinalValueU8-U8-位置序号值BMC接口展示1CSR配置软件
ActiveMainsIdString-String-活动主电源IDBMC接口展示"Mains1"用户配置软件
AutoTransferEnabledBooleanfalseBoolean-自动转换是否启用BMC接口展示false用户配置软件
ClosedTransitionAllowedBooleanfalseBoolean-是否允许闭环转换BMC接口展示false用户配置软件
ClosedTransitionTimeoutSecondsU32-U32-闭环转换超时时间(秒)BMC接口展示5用户配置软件
PreferredMainsIdString-String-首选主电源IDBMC接口展示"Mains1"用户配置软件
RetransferDelaySecondsU32-U32-重转换延迟时间(秒)BMC接口展示30用户配置软件
RetransferEnabledBooleanfalseBoolean-重转换是否启用BMC接口展示false用户配置软件
TransferInhibitBooleanfalseBoolean-是否禁止转换BMC接口展示false用户配置软件
TransferDelaySecondsU32-U32-转换延迟时间(秒)BMC接口展示10用户配置软件
OverNominalFrequencyHzDouble-Double-超标称频率(Hz)BMC接口展示55.0用户配置硬件
OverVoltageRMSPercentDouble-Double-超电压RMS百分比BMC接口展示10.0用户配置硬件
TransferSensitivityString-String-转换敏感度BMC接口展示"High"用户配置软件
UnderNominalFrequencyHzDouble-Double-低于标称频率(Hz)BMC接口展示45.0用户配置硬件
UnderVoltageRMSPercentDouble-Double-低电压RMS百分比BMC接口展示10.0用户配置硬件
AbsoluteHumidityDouble-Double-绝对湿度BMC接口展示10.0软件刷新硬件
EnergyApparentkVAhDouble-Double-累计视在能量(kVAh)BMC接口展示100.0软件刷新硬件
EnergyLifetimekWhDouble-Double-累计生命周期能量(kWh)BMC接口展示1000.0软件刷新硬件
EnergyReactivekVARhDouble-Double-累计无功能量(kVARh)BMC接口展示50.0软件刷新硬件
EnergykWhDouble-Double-累计能量(kWh)BMC接口展示500.0软件刷新硬件
EnergySensorResetTimeString-String-能量传感器重置时间BMC接口展示"2025-01-01"软件刷新软件
HumidityPercentDouble-Double-湿度百分比BMC接口展示50.0软件刷新硬件
PowerLoadPercentDouble-Double-电源负载百分比BMC接口展示70.0软件刷新硬件
PowerApparentVADouble-Double-视在功率(VA)BMC接口展示7000.0软件刷新硬件
PowerPhaseAngleDegreesDouble-Double-功率相位角(度)BMC接口展示30.0软件刷新硬件
PowerFactorDouble-Double-功率因子BMC接口展示0.95软件刷新硬件
PowerReactiveVARDouble-Double-无功功率(VAR)BMC接口展示500.0软件刷新硬件
PowerWattsDouble-Double-功率(瓦)BMC接口展示7000.0软件刷新硬件
TemperatureCelsiusDouble-Double-温度(摄氏度)BMC接口展示25.0软件刷新硬件

🔗 动态关联机制

语法规范

当前版本无动态关联机制,所有属性均为静态配置或软件刷新。


关联说明

  • Health: 健康状态由软件刷新
  • Version: 版本信息由硬件提供
  • UUID: UUID标识由硬件提供
  • UserLabel: 用户标签由用户配置
  • AssetTag: 资产标签由用户配置

📂 分类标准

硬件属性

  • 定义:与电源分配硬件直接相关的参数
  • 特点:反映硬件设计和物理特性
  • 示例Version, UUID, EquipmentType, FirmwareVersion, Manufacturer, Model, PartNumber, SerialNumber, ProductionDate, PowerCapacityVA, OverNominalFrequencyHz, OverVoltageRMSPercent, UnderNominalFrequencyHz, UnderVoltageRMSPercent, AbsoluteHumidity, EnergyApparentkVAh, EnergyLifetimekWh, EnergyReactivekVARh, EnergykWh, HumidityPercent, PowerLoadPercent, PowerApparentVA, PowerPhaseAngleDegrees, PowerFactor, PowerReactiveVAR, PowerWatts, TemperatureCelsius

软件属性

  • 定义:由软件管理和维护的参数
  • 特点:配置管理、状态监控和接口展示
  • 示例Health, UserLabel, AssetTag, LocationServiceLabel, LocationReference, LocationOrientation, LocationType, LocationOrdinalValue, ActiveMainsId, AutoTransferEnabled, ClosedTransitionAllowed, ClosedTransitionTimeoutSeconds, PreferredMainsId, RetransferDelaySeconds, RetransferEnabled, TransferInhibit, TransferDelaySeconds, TransferSensitivity, EnergySensorResetTime

📝 配置示例

标准电源分配配置

json
{
  "PowerDistributionId_001": {
    "Health": "OK",
    "Version": "1.0.0",
    "UUID": "uuid-001",
    "EquipmentType": "TransferSwitch",
    "FirmwareVersion": "1.0.0",
    "Manufacturer": "Huawei",
    "Model": "PDU-001",
    "PartNumber": "PN001",
    "SerialNumber": "SN12345",
    "ProductionDate": "2025-01-01",
    "PowerCapacityVA": 10000.0,
    "UserLabel": "PDU_1",
    "AssetTag": "Asset_001"
  }
}

转换开关配置

json
{
  "PowerDistributionId_002": {
    "Health": "OK",
    "EquipmentType": "TransferSwitch",
    "ActiveMainsId": "Mains1",
    "AutoTransferEnabled": true,
    "ClosedTransitionAllowed": false,
    "PreferredMainsId": "Mains1",
    "RetransferDelaySeconds": 30,
    "RetransferEnabled": true,
    "TransferDelaySeconds": 10,
    "TransferSensitivity": "High"
  }
}

位置信息配置

json
{
  "PowerDistributionId_003": {
    "LocationServiceLabel": "Location_001",
    "LocationReference": "Rack_1",
    "LocationOrientation": "Front",
    "LocationType": "Rack",
    "LocationOrdinalValue": 1
  }
}

🔧 使用指南

配置步骤

  1. 基本信息配置:设置版本、UUID、厂商等基本信息
  2. 容量配置:设置PowerCapacityVA标识电源容量
  3. 位置配置:设置位置相关属性标识设备位置
  4. 转换配置:配置转换开关相关属性
  5. 指标监控:通过Metrics属性监控电源指标
  6. 健康监控:通过Health监控设备健康状态

注意事项

  • UUID唯一性:确保UUID唯一标识设备
  • 容量配置:根据实际硬件规格配置正确的电源容量
  • 转换配置:正确配置转换开关相关属性
  • 健康监控:实时监控设备健康状态

📚 相关文档