CSR配置字典之FanGroup类
更新时间:2025/7/22
在Gitcode上查看源码📋 文档信息
项目 | 内容 |
---|---|
文档标题 | FanGroup类配置字典 |
版本 | v1.0 |
创建日期 | 2025-01-27 |
最后更新 | 2025-01-27 |
维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
---|---|---|---|---|---|
v1.0 | 2025-01-27 | 初始版本 | 创建FanGroup类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
FanGroup 类
属性 | 值 |
---|---|
类名称 | FanGroup |
功能描述 | 风扇组对象,提供风扇分组管理功能,用于分区分组风扇调速 |
所属SIG组 | thermal |
所属组件 | 风扇组管理 |
责任人 | 热设计组 |
最后更新 | 2025-01-27 |
状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
Id | U8 | 0 | U8 | - | 风扇组ID | 风扇组ID,用于分区分组风扇调速 | 1 | CSR | 软件 |
FanSlots | U8[] | [] | U8[] | - | 风扇组内槽位号 分区分组调速场景下,统一风扇组的风扇槽位号 | 风扇组中的风扇ID,即对应分区分组的风扇ID 只有分组调速时才需要进行适配,与BasicCoolingConfig中的FanGroupSpeedDiffThresholdPercent配合使用 | [1, 2] | CSR | 软件 |
可选属性
无可选属性
🔗 动态关联机制
语法规范
使用标准配置语法:
yaml
# 风扇组配置
Id: 1
FanSlots: [1, 2, 3, 4]
关联说明
- 分组管理: Id用于唯一标识风扇组
- 槽位分配: FanSlots定义该组内包含的风扇槽位
- 调速协调: 与BasicCoolingConfig配合实现分组调速
📂 分类标准
硬件属性
- 定义:当前版本无硬件属性
- 特点:所有属性都是软件管理相关
- 示例:无
软件属性
- 定义:由软件管理和维护的风扇组配置参数
- 特点:分组管理、槽位分配、调速协调等
- 示例:
Id
,FanSlots
📝 配置示例
基础风扇组配置
json
{
"FanGroup_1": {
"Id": 1,
"FanSlots": [1, 2]
}
}
多风扇组配置
json
{
"FanGroup_CPU": {
"Id": 1,
"FanSlots": [1, 2, 3]
},
"FanGroup_Memory": {
"Id": 2,
"FanSlots": [4, 5]
},
"FanGroup_Storage": {
"Id": 3,
"FanSlots": [6, 7, 8]
}
}
分区调速配置
json
{
"FanGroup_Zone1": {
"Id": 1,
"FanSlots": [1, 2, 3, 4]
},
"FanGroup_Zone2": {
"Id": 2,
"FanSlots": [5, 6, 7, 8]
}
}
单风扇组配置
json
{
"FanGroup_Single": {
"Id": 1,
"FanSlots": [1]
}
}
🔧 使用指南
配置步骤
- 组ID规划:规划风扇组的ID分配策略
- 槽位分组:根据散热需求将风扇槽位分组
- 配置创建:创建对应的FanGroup配置
- 联动配置:配置BasicCoolingConfig的转速差阈值
- 测试验证:验证分组调速功能是否正常
风扇组ID管理
- 唯一性: 每个风扇组的ID必须唯一
- 连续性: 建议使用连续的ID编号
- 语义化: 可以根据功能区域分配ID
槽位分组策略
- 功能分组: 按照散热功能分组(CPU、内存、存储等)
- 区域分组: 按照物理位置分组(前部、后部、左侧、右侧等)
- 性能分组: 按照散热性能分组(高性能、标准性能等)
分区调速原理
- 组内协调: 同一组内的风扇协调工作
- 转速同步: 组内风扇转速保持相对一致
- 差异控制: 通过转速差阈值控制组内风扇的转速差异
使用场景
- 分区散热: 不同区域需要不同的散热策略
- 协调调速: 多个风扇需要协调工作
- 故障隔离: 某个风扇故障时不影响其他组
- 性能优化: 优化整体散热效果
配置最佳实践
- 合理分组: 根据实际散热需求合理分组
- 避免冲突: 确保风扇槽位不会重复分配
- 组数适中: 避免分组过多导致管理复杂
- 预留扩展: 为未来扩展预留ID空间
注意事项
- ID唯一性: 确保风扇组ID在系统中唯一
- 槽位有效性: 确保FanSlots中的槽位号有效
- 分组合理性: 确保分组策略符合散热需求
- 配置一致性: 确保与其他散热配置保持一致
故障排除
分组调速不生效:
- 检查风扇组ID是否正确配置
- 确认FanSlots中的槽位号是否有效
- 验证BasicCoolingConfig是否正确配置
风扇转速异常:
- 检查风扇硬件是否正常
- 确认分组策略是否合理
- 验证调速算法是否正确
组内转速差异过大:
- 检查转速差阈值设置
- 确认风扇硬件状态
- 验证调速控制逻辑
性能优化
- 分组算法: 优化风扇分组算法
- 调速策略: 优化组内调速策略
- 监控频率: 优化转速监控频率
扩展功能
- 动态分组: 根据负载动态调整分组
- 智能调速: 基于AI算法的智能分组调速
- 故障转移: 风扇故障时的自动转移机制