CSR配置字典之CoolingArea类
更新时间: 2025/07/22
在Gitcode上查看源码

📋 文档信息

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

📋 变更历史记录

文档变更记录

版本发布日期变更类型变更内容影响范围维护人员
v1.02025-01-27初始版本创建CoolingArea类配置字典全新文档系统管理员
v1.12026-05-12补丁版本修改类概览描述信息类概览描述信息汪航

🎯 类概览

CoolingArea 类

属性
类名称CoolingArea
功能描述自动调速域对象,提供风扇自动调速区域管理功能
所属SIG组hardware
所属组件thermal_mgmt
责任人能效管理组
最后更新2026-05-12
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
AreaIdU80U8-调速域ID,用不同的AreaId来区分不同调速区域风扇自动调速8CSR配置软件
FanIdxGroupU8[][]U8[]-调速域风扇组,用来记录参与该区域调速的风扇id风扇自动调速[1, 2, 3, 4]CSR配置热设计
PolicyIdxGroupU8[][]U8[]-线性调速策略ID组,用来记录不同线性调速策略风扇自动调速[1]CSR配置热设计
RequirementIdxU80U8-目标调速策略ID,用来区分不同目标调速策略风扇自动调速8CSR配置热设计

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
LiquidCoolingDeviceGroupU8[][]U8[]-调速域泵组,用来记录参与该区域调速的泵id泵自动调速[1, 2]CSR配置热设计
PriorityU81U8-调速域优先级,相同AreaId的调速域根据优先级进行生效,数字越大优先级越高风扇自动调速1CSR配置热设计

🔗 动态关联机制

语法规范

使用标准配置语法和动态关联:

yaml
# 调速域基础配置
AreaId: 1
FanIdxGroup: [1, 2, 3, 4]
PolicyIdxGroup: [1, 2, 6, 8]
RequirementIdx: 1
# 泵组配置
LiquidCoolingDeviceGroup: [1, 2]
# 优先级配置
Priority: 1

关联说明

  • AreaId与RequirementIdx: 将AreaId与RequipmentIdx配置保持一致,用于业务逻辑处理时寻找指定目标调速策略的对应调速域
  • PolicyIdxGroup: 线性调速策略Id
  • FanIdxGroup与LiquidCoolingDeviceGroup: 对应RequirementIdx的目标调速策略或对应PolicyIdxGroup的线性调速策略生效时控制的调速器件Id
  • Priority: 调速域优先级,高优先级生效

📂 分类标准

硬件属性

  • 定义:当前版本无硬件属性
  • 特点:所有属性都是热设计相关
  • 示例:无

软件属性

  • 定义:由软件管理的调速域配置参数
  • 特点:调速域ID、目标调速策略Id、线性调速策略Id、调速期间Id、优先级
  • 示例:AreaId, RequirementIdx, PolicyIdxGroup, FanIdxGroup, LiquidCoolingDeviceGroup, Priority

📝 配置示例

基础调速域配置

json
{
  "CoolingArea_8": {
    "AreaId": 8,
    "FanIdxGroup": [],
    "PolicyIdxGroup": [],
    "RequirementIdx": 8
  }
}

泵相关调速域配置

json
{
  "CoolingArea_CPU": {
    "AreaId": 1,
    "FanIdxGroup": [1, 2, 3],
    "LiquidCoolingDeviceGroup": [1, 2],
    "PolicyIdxGroup": [1, 2],
    "RequirementIdx": 1
  }
}

高优先级调速域配置

json
{
  "CoolingArea_CPU": {
    "AreaId": 1,
    "FanIdxGroup": [1, 2, 3],
    "LiquidCoolingDeviceGroup": [1, 2],
    "PolicyIdxGroup": [1, 2],
    "RequirementIdx": 1,
    "Priority": 1
  }
}

🔧 使用指南

配置步骤

  1. 区域规划: 规划调速域的分布和范围
  2. 风扇分配: 将风扇分配到对应的调速域
  3. 泵分配: 将泵分配到对应的调速域
  4. 策略关联: 关联对应的调速策略
  5. 优先级确认: 设置合理的优先级
  6. 测试验证: 验证调速域功能是否正常

使用场景

  • 分区调速: 不同区域需要不同的调速策略
  • 风扇协调: 协调多个风扇的调速行为
  • 策略管理: 管理多种调速策略

📚 相关文档