CSR配置字典之PowerDistributionId类
更新时间: 2026/05/27
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | PowerDistributionId类配置字典 |
| 版本 | v1.1 |
| 创建日期 | 2026-05-27 |
| 最后更新 | 2026-05-27 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-05-27 | 初始版本 | 创建PowerDistributionId类配置字典 | 全新文档 | 系统管理员 |
| v1.1 | 2026-05-27 | 补充属性 | 补充PowerDistributionId对象属性信息 | 属性定义 | 系统管理员 |
🎯 类概览
PowerDistributionId 类
| 属性 | 值 |
|---|---|
| 类名称 | PowerDistributionId |
| 功能描述 | 电源分配ID对象,提供电源分配设备的基本信息、健康状态、版本管理、位置信息、容量配置和转换控制功能 |
| 所属SIG组 | hardware |
| 所属组件 | power_mgmt |
| 责任人 | 电源管理组 |
| 最后更新 | 2026-05-27 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Health | String | - | String | - | 健康状态 | BMC接口展示 | "OK" | 软件刷新 | 软件 |
Version | String | - | String | - | 版本信息 | BMC接口展示 | "1.0.0" | 硬件提供 | 硬件 |
UUID | String | - | String | - | UUID标识 | BMC接口展示 | "uuid-001" | 硬件提供 | 硬件 |
EquipmentType | String | - | String | - | 设备类型 | BMC接口展示 | "TransferSwitch" | CSR配置 | 硬件 |
FirmwareVersion | String | - | String | - | 固件版本 | BMC接口展示 | "1.0.0" | 硬件提供 | 硬件 |
Manufacturer | String | - | String | - | 厂商 | BMC接口展示 | "Huawei" | 硬件提供 | 硬件 |
Model | String | - | String | - | 型号 | BMC接口展示 | "PDU-001" | 硬件提供 | 硬件 |
PartNumber | String | - | String | - | 部件编号 | BMC接口展示 | "PN001" | 硬件提供 | 硬件 |
SerialNumber | String | - | String | - | 序列号 | BMC接口展示 | "SN12345" | 硬件提供 | 硬件 |
ProductionDate | String | - | String | - | 生产日期 | BMC接口展示 | "2025-01-01" | 硬件提供 | 硬件 |
PowerCapacityVA | Double | - | Double | - | 电源容量(VA) | BMC接口展示 | 10000.0 | 硬件规格 | 硬件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
UserLabel | String | - | String | - | 用户标签 | BMC接口展示 | "PDU_1" | 用户配置 | 软件 |
AssetTag | String | - | String | - | 资产标签 | BMC接口展示 | "Asset_001" | 用户配置 | 软件 |
LocationServiceLabel | String | - | String | - | 位置服务标签 | BMC接口展示 | "Location_001" | CSR配置 | 软件 |
LocationReference | String | - | String | - | 位置参考 | BMC接口展示 | "Rack_1" | CSR配置 | 软件 |
LocationOrientation | String | - | String | - | 位置方向 | BMC接口展示 | "Front" | CSR配置 | 软件 |
LocationType | String | - | String | - | 位置类型 | BMC接口展示 | "Rack" | CSR配置 | 软件 |
LocationOrdinalValue | U8 | - | U8 | - | 位置序号值 | BMC接口展示 | 1 | CSR配置 | 软件 |
ActiveMainsId | String | - | String | - | 活动主电源ID | BMC接口展示 | "Mains1" | 用户配置 | 软件 |
AutoTransferEnabled | Boolean | false | Boolean | - | 自动转换是否启用 | BMC接口展示 | false | 用户配置 | 软件 |
ClosedTransitionAllowed | Boolean | false | Boolean | - | 是否允许闭环转换 | BMC接口展示 | false | 用户配置 | 软件 |
ClosedTransitionTimeoutSeconds | U32 | - | U32 | - | 闭环转换超时时间(秒) | BMC接口展示 | 5 | 用户配置 | 软件 |
PreferredMainsId | String | - | String | - | 首选主电源ID | BMC接口展示 | "Mains1" | 用户配置 | 软件 |
RetransferDelaySeconds | U32 | - | U32 | - | 重转换延迟时间(秒) | BMC接口展示 | 30 | 用户配置 | 软件 |
RetransferEnabled | Boolean | false | Boolean | - | 重转换是否启用 | BMC接口展示 | false | 用户配置 | 软件 |
TransferInhibit | Boolean | false | Boolean | - | 是否禁止转换 | BMC接口展示 | false | 用户配置 | 软件 |
TransferDelaySeconds | U32 | - | U32 | - | 转换延迟时间(秒) | BMC接口展示 | 10 | 用户配置 | 软件 |
OverNominalFrequencyHz | Double | - | Double | - | 超标称频率(Hz) | BMC接口展示 | 55.0 | 用户配置 | 硬件 |
OverVoltageRMSPercent | Double | - | Double | - | 超电压RMS百分比 | BMC接口展示 | 10.0 | 用户配置 | 硬件 |
TransferSensitivity | String | - | String | - | 转换敏感度 | BMC接口展示 | "High" | 用户配置 | 软件 |
UnderNominalFrequencyHz | Double | - | Double | - | 低于标称频率(Hz) | BMC接口展示 | 45.0 | 用户配置 | 硬件 |
UnderVoltageRMSPercent | Double | - | Double | - | 低电压RMS百分比 | BMC接口展示 | 10.0 | 用户配置 | 硬件 |
AbsoluteHumidity | Double | - | Double | - | 绝对湿度 | BMC接口展示 | 10.0 | 软件刷新 | 硬件 |
EnergyApparentkVAh | Double | - | Double | - | 累计视在能量(kVAh) | BMC接口展示 | 100.0 | 软件刷新 | 硬件 |
EnergyLifetimekWh | Double | - | Double | - | 累计生命周期能量(kWh) | BMC接口展示 | 1000.0 | 软件刷新 | 硬件 |
EnergyReactivekVARh | Double | - | Double | - | 累计无功能量(kVARh) | BMC接口展示 | 50.0 | 软件刷新 | 硬件 |
EnergykWh | Double | - | Double | - | 累计能量(kWh) | BMC接口展示 | 500.0 | 软件刷新 | 硬件 |
EnergySensorResetTime | String | - | String | - | 能量传感器重置时间 | BMC接口展示 | "2025-01-01" | 软件刷新 | 软件 |
HumidityPercent | Double | - | Double | - | 湿度百分比 | BMC接口展示 | 50.0 | 软件刷新 | 硬件 |
PowerLoadPercent | Double | - | Double | - | 电源负载百分比 | BMC接口展示 | 70.0 | 软件刷新 | 硬件 |
PowerApparentVA | Double | - | Double | - | 视在功率(VA) | BMC接口展示 | 7000.0 | 软件刷新 | 硬件 |
PowerPhaseAngleDegrees | Double | - | Double | - | 功率相位角(度) | BMC接口展示 | 30.0 | 软件刷新 | 硬件 |
PowerFactor | Double | - | Double | - | 功率因子 | BMC接口展示 | 0.95 | 软件刷新 | 硬件 |
PowerReactiveVAR | Double | - | Double | - | 无功功率(VAR) | BMC接口展示 | 500.0 | 软件刷新 | 硬件 |
PowerWatts | Double | - | Double | - | 功率(瓦) | BMC接口展示 | 7000.0 | 软件刷新 | 硬件 |
TemperatureCelsius | Double | - | 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
}
}🔧 使用指南
配置步骤
- 基本信息配置:设置版本、UUID、厂商等基本信息
- 容量配置:设置PowerCapacityVA标识电源容量
- 位置配置:设置位置相关属性标识设备位置
- 转换配置:配置转换开关相关属性
- 指标监控:通过Metrics属性监控电源指标
- 健康监控:通过Health监控设备健康状态
注意事项
- UUID唯一性:确保UUID唯一标识设备
- 容量配置:根据实际硬件规格配置正确的电源容量
- 转换配置:正确配置转换开关相关属性
- 健康监控:实时监控设备健康状态