文档中心
CSR配置字典之PowerStrategy类
更新时间：2025/7/22
在Gitcode上查看源码

📋 文档信息 ​

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

📋 变更历史记录 ​

文档变更记录 ​

版本发布日期变更类型变更内容影响范围维护人员
v1.02025-01-27初始版本创建PowerStrategy类配置字典全新文档系统管理员

🎯 类概览 ​

PowerStrategy 类 ​

属性值
类名称PowerStrategy
功能描述电源策略对象，提供主备供电、功耗封顶、电源管理等功能配置和状态监控
所属SIG组power
所属组件电源管理
责任人电源管理组
最后更新2025-01-27
状态🟢 正常运行

📊 属性定义详表 ​

必选属性 ​

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
PowerWorkingModeStringLoadBalancing"Active/Standby"/"LoadBalancing"-电源工作模式
主备供电：Active/Standby
若支持电源主备功能，默认按LoadBalancing
负载均衡：LoadBalancing
主备供电：Active/Standby		电源默认的工作模式"LoadBalancing"软件配置软件
PowerLimitValueU320U32-功率封顶值（单位W）配置初始功耗封顶封顶值（配置支持功耗封顶后生效）9999软件配置软件
PowerLimitEnabledBooleanfalsetrue/false-功耗封顶使能状态，软件写的，默认关闭配置初始功耗封顶封顶使能（配置支持功耗封顶后生效）true软件配置软件
PowerLimitFailedBooleanfalsetrue/false-功率封顶失败状态，软件写的，默认OK用于告警事件配置true软件刷新软件
PSUsOutputVoltageLowBooleanfalsetrue/false-N+R压差是否异常（主用电源输入电压和备用电源输出电压是否偏差超过5）用于告警事件配置true软件刷新软件
RedundancyFailureBooleanfalsetrue/false-冗余失效（当环境电源数少于AC上电时的电源数时，置为true）用于告警事件配置true软件刷新软件
PowerLimitActivatedBooleanfalsetrue/false-封顶策略是否触发
当前仅涉及CPU，触发时表明对CPU进行了降频		用于告警事件配置true软件刷新软件
PowerCappingSupportedBooleanfalsetrue/false-是否支持功耗封顶功能
是否要支持功耗封顶的配置，仅当配置开启时，其余封顶值、封顶使能配置才生效		配置是否支持功耗封顶功能trueCSR配置软件
PowerLimitExceptionSupportedBooleanfalsetrue/false-是否支持功率封顶失败动作配置是否支持功耗封顶失败动作功能trueCSR配置软件
DeepSleepSupportedBooleanfalsetrue/false-是否支持电源深度功能
当配置支持电源主备模式后，设置电源主备模式，开启深度休眠，当OS下电后，会让备用电源进入冷备		配置是否支持深度休眠功能（在配置支持电源主备模式后，进一步的配置）trueCSR配置软件
ActiveStandbySupportedBooleanfalsetrue/false-是否支持电源主备模式功能，true：支持，false：不支持配置是否支持主备模式功能trueCSR配置软件
NormalAndRedundancySupportedBooleanfalsetrue/false-是否支持N+R备电功能，true：支持，false：不支持配置是否支持主备模式功能falseCSR配置软件
PowerPredictSupportedBooleanfalsetrue/false-是否支持节能收益预测功能，true：支持，false：不支持配置是否支持节能收益预测功能falseCSR配置软件
EnergyEfficiencyOptimizationSupportedBooleanfalsetrue/false-是否支持智能能效寻优预留，暂未支持falseCSR配置软件
EnergySavingSupportedBooleanfalsetrue/false-是否支持节能功能预留，暂未支持falseCSR配置软件
PSUsUnavailableOfflineCauseBooleanfalsetrue/false-电源不可用原因
bit0:电源输入丢失
京东定制电源线未插报电源冗余告警时使用		用于告警事件配置false软件刷新软件
PSUsOutputCurrentImbalanceBooleanfalsetrue/false-电源是否为均流不平衡用于告警事件配置true软件刷新软件
ReviseParamDouble1.3Double-功耗封顶下限值计算系数配置封顶下限值计算系数1.2CSR配置软件
PowerCappingDevicesString[][]String[]-功耗封顶设备类型
CPU、NPU		配置功耗封顶设置类型["CPU"]CSR配置软件
IsSupportPowerLimitModeBooleanfalsetrue/false-是否支持功耗封顶模式
1、true：支持
2、false：不支持		配置是否支持功耗封顶模式falseCSR配置软件
AllowableMinPowerLimitInWattsU320U32-功耗封顶允许设置的最小封顶值配置功耗封顶允许设置的最小封顶值6000CSR配置软件

可选属性 ​

无可选属性

🔗 动态关联机制 ​

语法规范 ​

使用标准配置语法：

yaml
# 电源工作模式配置
PowerWorkingMode: "LoadBalancing"  # 或 "Active/Standby"

# 功耗封顶配置
PowerLimitValue: 9999
PowerLimitEnabled: true
PowerCappingSupported: true
PowerLimitExceptionSupported: true
AllowableMinPowerLimitInWatts: 6000
ReviseParam: 1.2
PowerCappingDevices: ["CPU"]
IsSupportPowerLimitMode: false

# 电源模式支持配置
ActiveStandbySupported: true
NormalAndRedundancySupported: false
DeepSleepSupported: true

# 节能功能配置
PowerPredictSupported: false
EnergyEfficiencyOptimizationSupported: false
EnergySavingSupported: false

# 状态监控配置
PowerLimitFailed: true
PSUsOutputVoltageLow: true
RedundancyFailure: true
PowerLimitActivated: true
PSUsUnavailableOfflineCause: false
PSUsOutputCurrentImbalance: true

关联说明 ​

  • 功耗封顶: PowerCappingSupported决定功耗封顶功能是否生效
  • 主备模式: ActiveStandbySupported决定是否支持主备供电模式
  • 深度休眠: DeepSleepSupported需要在支持主备模式基础上配置
  • 状态监控: 各种状态属性用于告警事件配置

📂 分类标准 ​

硬件属性 ​

  • 定义：当前版本无硬件属性
  • 特点：所有属性都是软件管理相关
  • 示例：无

软件属性 ​

  • 定义：由软件管理和维护的电源策略参数
  • 特点：电源模式配置、功耗封顶、状态监控等
  • 示例：所有属性都是软件属性

📝 配置示例 ​

基础电源策略配置 ​

json
{
  "PowerStrategy_Basic": {
    "PowerWorkingMode": "LoadBalancing",
    "PowerLimitValue": 9999,
    "PowerLimitEnabled": true,
    "PowerLimitFailed": false,
    "PSUsOutputVoltageLow": false,
    "RedundancyFailure": false,
    "PowerLimitActivated": false,
    "PowerCappingSupported": true,
    "PowerLimitExceptionSupported": true,
    "DeepSleepSupported": false,
    "ActiveStandbySupported": true,
    "NormalAndRedundancySupported": false,
    "PowerPredictSupported": false,
    "EnergyEfficiencyOptimizationSupported": false,
    "EnergySavingSupported": false,
    "PSUsUnavailableOfflineCause": false,
    "PSUsOutputCurrentImbalance": false,
    "ReviseParam": 1.2,
    "PowerCappingDevices": ["CPU"],
    "IsSupportPowerLimitMode": false,
    "AllowableMinPowerLimitInWatts": 6000
  }
}

主备供电模式配置 ​

json
{
  "PowerStrategy_ActiveStandby": {
    "PowerWorkingMode": "Active/Standby",
    "PowerLimitValue": 8000,
    "PowerLimitEnabled": true,
    "PowerLimitFailed": false,
    "PSUsOutputVoltageLow": false,
    "RedundancyFailure": false,
    "PowerLimitActivated": false,
    "PowerCappingSupported": true,
    "PowerLimitExceptionSupported": true,
    "DeepSleepSupported": true,
    "ActiveStandbySupported": true,
    "NormalAndRedundancySupported": false,
    "PowerPredictSupported": false,
    "EnergyEfficiencyOptimizationSupported": false,
    "EnergySavingSupported": false,
    "PSUsUnavailableOfflineCause": false,
    "PSUsOutputCurrentImbalance": false,
    "ReviseParam": 1.3,
    "PowerCappingDevices": ["CPU"],
    "IsSupportPowerLimitMode": true,
    "AllowableMinPowerLimitInWatts": 5000
  }
}

N+R备电模式配置 ​

json
{
  "PowerStrategy_NormalRedundancy": {
    "PowerWorkingMode": "LoadBalancing",
    "PowerLimitValue": 10000,
    "PowerLimitEnabled": true,
    "PowerLimitFailed": false,
    "PSUsOutputVoltageLow": false,
    "RedundancyFailure": false,
    "PowerLimitActivated": false,
    "PowerCappingSupported": true,
    "PowerLimitExceptionSupported": true,
    "DeepSleepSupported": false,
    "ActiveStandbySupported": false,
    "NormalAndRedundancySupported": true,
    "PowerPredictSupported": true,
    "EnergyEfficiencyOptimizationSupported": false,
    "EnergySavingSupported": true,
    "PSUsUnavailableOfflineCause": false,
    "PSUsOutputCurrentImbalance": false,
    "ReviseParam": 1.2,
    "PowerCappingDevices": ["CPU", "NPU"],
    "IsSupportPowerLimitMode": true,
    "AllowableMinPowerLimitInWatts": 7000
  }
}

高级电源策略配置 ​

json
{
  "PowerStrategy_Advanced": {
    "PowerWorkingMode": "LoadBalancing",
    "PowerLimitValue": 12000,
    "PowerLimitEnabled": true,
    "PowerLimitFailed": false,
    "PSUsOutputVoltageLow": false,
    "RedundancyFailure": false,
    "PowerLimitActivated": false,
    "PowerCappingSupported": true,
    "PowerLimitExceptionSupported": true,
    "DeepSleepSupported": true,
    "ActiveStandbySupported": true,
    "NormalAndRedundancySupported": true,
    "PowerPredictSupported": true,
    "EnergyEfficiencyOptimizationSupported": true,
    "EnergySavingSupported": true,
    "PSUsUnavailableOfflineCause": false,
    "PSUsOutputCurrentImbalance": false,
    "ReviseParam": 1.1,
    "PowerCappingDevices": ["CPU", "NPU"],
    "IsSupportPowerLimitMode": true,
    "AllowableMinPowerLimitInWatts": 8000
  }
}

🔧 使用指南 ​

配置步骤 ​

  1. 电源工作模式配置：设置PowerWorkingMode为LoadBalancing或Active/Standby
  2. 功耗封顶配置：配置PowerCappingSupported、PowerLimitValue、PowerLimitEnabled等
  3. 电源模式支持配置：设置ActiveStandbySupported、NormalAndRedundancySupported等
  4. 节能功能配置：配置PowerPredictSupported、EnergySavingSupported等
  5. 状态监控配置：设置各种状态属性用于告警事件
  6. 参数调优配置：配置ReviseParam、PowerCappingDevices等

电源工作模式 ​

  • LoadBalancing: 负载均衡模式，多个电源平均分担负载
  • Active/Standby: 主备模式，一个电源工作，其他电源待机
  • 模式选择: 根据系统需求和电源配置选择合适的工作模式

功耗封顶机制 ​

  • PowerCappingSupported: 总开关，决定是否支持功耗封顶
  • PowerLimitValue: 功耗封顶值，单位为瓦特
  • PowerLimitEnabled: 功耗封顶使能开关
  • PowerCappingDevices: 支持封顶的设备类型，如CPU、NPU
  • AllowableMinPowerLimitInWatts: 允许设置的最小封顶值

电源模式支持 ​

  • ActiveStandbySupported: 是否支持主备模式
  • NormalAndRedundancySupported: 是否支持N+R备电
  • DeepSleepSupported: 是否支持深度休眠，需要主备模式支持

状态监控 ​

  • PowerLimitFailed: 功率封顶失败状态
  • PSUsOutputVoltageLow: 电源输出电压低告警
  • RedundancyFailure: 冗余失效告警
  • PowerLimitActivated: 封顶策略激活状态
  • PSUsOutputCurrentImbalance: 电源均流不平衡告警

注意事项 ​

  • 功能依赖: 深度休眠需要主备模式支持
  • 封顶限制: 功耗封顶值不能低于AllowableMinPowerLimitInWatts
  • 设备支持: PowerCappingDevices需要根据实际硬件配置
  • 参数调优: ReviseParam影响封顶下限值计算

故障排除 ​

  1. 功耗封顶不生效：

    • 检查PowerCappingSupported是否为true
    • 确认PowerLimitEnabled是否开启
    • 验证PowerLimitValue是否合理

  2. 主备模式异常：

    • 检查ActiveStandbySupported配置
    • 确认PowerWorkingMode设置
    • 验证电源硬件是否支持主备模式

  3. 告警事件异常：

    • 检查相关状态属性配置
    • 确认告警阈值设置
    • 验证状态监控机制

性能优化 ​

  • 状态更新: 优化状态属性的更新频率和机制
  • 封顶响应: 优化功耗封顶的响应速度
  • 模式切换: 优化电源模式切换的效率

📚 相关文档 ​

版权所有 © 2025 openUBMC 保留一切权利粤A2-20044005号-293
隐私政策|法律声明|关于cookies