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

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

FanGroup 类

属性
类名称FanGroup
功能描述风扇组对象,提供风扇分组管理功能,用于分区分组风扇调速
所属SIG组thermal
所属组件风扇组管理
责任人热设计组
最后更新2025-01-27
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
IdU80U8-风扇组ID风扇组ID,用于分区分组风扇调速1CSR软件
FanSlotsU8[][]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]
  }
}

🔧 使用指南

配置步骤

  1. 组ID规划:规划风扇组的ID分配策略
  2. 槽位分组:根据散热需求将风扇槽位分组
  3. 配置创建:创建对应的FanGroup配置
  4. 联动配置:配置BasicCoolingConfig的转速差阈值
  5. 测试验证:验证分组调速功能是否正常

风扇组ID管理

  • 唯一性: 每个风扇组的ID必须唯一
  • 连续性: 建议使用连续的ID编号
  • 语义化: 可以根据功能区域分配ID

槽位分组策略

  • 功能分组: 按照散热功能分组(CPU、内存、存储等)
  • 区域分组: 按照物理位置分组(前部、后部、左侧、右侧等)
  • 性能分组: 按照散热性能分组(高性能、标准性能等)

分区调速原理

  • 组内协调: 同一组内的风扇协调工作
  • 转速同步: 组内风扇转速保持相对一致
  • 差异控制: 通过转速差阈值控制组内风扇的转速差异

使用场景

  • 分区散热: 不同区域需要不同的散热策略
  • 协调调速: 多个风扇需要协调工作
  • 故障隔离: 某个风扇故障时不影响其他组
  • 性能优化: 优化整体散热效果

配置最佳实践

  • 合理分组: 根据实际散热需求合理分组
  • 避免冲突: 确保风扇槽位不会重复分配
  • 组数适中: 避免分组过多导致管理复杂
  • 预留扩展: 为未来扩展预留ID空间

注意事项

  • ID唯一性: 确保风扇组ID在系统中唯一
  • 槽位有效性: 确保FanSlots中的槽位号有效
  • 分组合理性: 确保分组策略符合散热需求
  • 配置一致性: 确保与其他散热配置保持一致

故障排除

  1. 分组调速不生效

    • 检查风扇组ID是否正确配置
    • 确认FanSlots中的槽位号是否有效
    • 验证BasicCoolingConfig是否正确配置
  2. 风扇转速异常

    • 检查风扇硬件是否正常
    • 确认分组策略是否合理
    • 验证调速算法是否正确
  3. 组内转速差异过大

    • 检查转速差阈值设置
    • 确认风扇硬件状态
    • 验证调速控制逻辑

性能优化

  • 分组算法: 优化风扇分组算法
  • 调速策略: 优化组内调速策略
  • 监控频率: 优化转速监控频率

扩展功能

  • 动态分组: 根据负载动态调整分组
  • 智能调速: 基于AI算法的智能分组调速
  • 故障转移: 风扇故障时的自动转移机制

📚 相关文档