CSR配置字典之CoolingArea类
更新时间: 2025/07/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | CoolingArea类配置字典 |
| 版本 | v1.1 |
| 创建日期 | 2025-01-27 |
| 最后更新 | 2026-05-12 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2025-01-27 | 初始版本 | 创建CoolingArea类配置字典 | 全新文档 | 系统管理员 |
| v1.1 | 2026-05-12 | 补丁版本 | 修改类概览描述信息 | 类概览描述信息 | 汪航 |
🎯 类概览
CoolingArea 类
| 属性 | 值 |
|---|---|
| 类名称 | CoolingArea |
| 功能描述 | 自动调速域对象,提供风扇自动调速区域管理功能 |
| 所属SIG组 | hardware |
| 所属组件 | thermal_mgmt |
| 责任人 | 能效管理组 |
| 最后更新 | 2026-05-12 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
AreaId | U8 | 0 | U8 | - | 调速域ID,用不同的AreaId来区分不同调速区域 | 风扇自动调速 | 8 | CSR配置 | 软件 |
FanIdxGroup | U8[] | [] | U8[] | - | 调速域风扇组,用来记录参与该区域调速的风扇id | 风扇自动调速 | [1, 2, 3, 4] | CSR配置 | 热设计 |
PolicyIdxGroup | U8[] | [] | U8[] | - | 线性调速策略ID组,用来记录不同线性调速策略 | 风扇自动调速 | [1] | CSR配置 | 热设计 |
RequirementIdx | U8 | 0 | U8 | - | 目标调速策略ID,用来区分不同目标调速策略 | 风扇自动调速 | 8 | CSR配置 | 热设计 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
LiquidCoolingDeviceGroup | U8[] | [] | U8[] | - | 调速域泵组,用来记录参与该区域调速的泵id | 泵自动调速 | [1, 2] | CSR配置 | 热设计 |
Priority | U8 | 1 | U8 | - | 调速域优先级,相同AreaId的调速域根据优先级进行生效,数字越大优先级越高 | 风扇自动调速 | 1 | CSR配置 | 热设计 |
🔗 动态关联机制
语法规范
使用标准配置语法和动态关联:
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
}
}🔧 使用指南
配置步骤
- 区域规划: 规划调速域的分布和范围
- 风扇分配: 将风扇分配到对应的调速域
- 泵分配: 将泵分配到对应的调速域
- 策略关联: 关联对应的调速策略
- 优先级确认: 设置合理的优先级
- 测试验证: 验证调速域功能是否正常
使用场景
- 分区调速: 不同区域需要不同的调速策略
- 风扇协调: 协调多个风扇的调速行为
- 策略管理: 管理多种调速策略