📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

BasicCoolingConfig 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

无可选属性

🔗 动态关联机制 ​

语法规范 ​

使用标准配置语法：

# 风扇组转速差阈值配置
FanGroupSpeedDiffThresholdPercent: 20  # 20%转速差阈值

关联说明 ​

• 转速差计算: FanGroupSpeedDiffThresholdPercent控制风扇组内转速差异检测
• 分区调控: 与FanGroup配合使用，实现分区转速调控
• 阈值判断: 当风扇组内转速差异超过阈值时触发相应处理

📂 分类标准 ​

硬件属性 ​

• 定义：与硬件风扇转速控制直接相关的参数
• 特点：转速差阈值等物理控制参数
• 示例：FanGroupSpeedDiffThresholdPercent

软件属性 ​

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

📝 配置示例 ​

基础散热配置（不进行转速差计算） ​

{
  "BasicCoolingConfig_NoSpeedDiff": {
    "FanGroupSpeedDiffThresholdPercent": 32767
  }
}

分区转速调控配置 ​

{
  "BasicCoolingConfig_SpeedDiff": {
    "FanGroupSpeedDiffThresholdPercent": 20
  }
}

严格转速差控制配置 ​

{
  "BasicCoolingConfig_StrictSpeedDiff": {
    "FanGroupSpeedDiffThresholdPercent": 10
  }
}

宽松转速差控制配置 ​

{
  "BasicCoolingConfig_RelaxedSpeedDiff": {
    "FanGroupSpeedDiffThresholdPercent": 30
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 评估需求: 确认是否需要进行风扇组转速差计算
2. 阈值设置: 根据硬件特性设置合适的转速差阈值
3. 分区配置: 配合FanGroup对象进行分区转速调控配置
4. 测试验证: 验证转速差检测和调控功能是否正常

转速差阈值说明 ​

• 32767: 默认值，表示不进行转速差计算
• 0-100: 百分比值，表示允许的最大转速差异
• 计算方式: (最大转速 - 最小转速) / 最大转速 * 100%

分区转速调控原理 ​

• 风扇分组: 将风扇分为不同的组或区域
• 转速监控: 监控每个风扇组内的转速差异
• 异常处理: 当转速差异超过阈值时触发告警或调节

配置选择原则 ​

• 不需要转速差控制: 设置为32767
• 需要转速差控制: 设置为合适的百分比值
• 严格控制: 设置较小的阈值（如10%）
• 宽松控制: 设置较大的阈值（如30%）

使用场景 ​

• 高精度散热: 需要精确控制风扇转速差异
• 分区调速: 不同区域的风扇需要协调工作
• 故障检测: 通过转速差异检测风扇故障
• 性能优化: 优化风扇组的整体散热效果

注意事项 ​

• 硬件兼容: 确保硬件支持分区转速调控
• 阈值合理: 设置的阈值应该符合实际硬件特性
• 分组配置: 需要配合FanGroup对象正确配置
• 性能影响: 转速差计算会增加系统负载

故障排除 ​

1. 转速差检测不工作：

   • 检查FanGroupSpeedDiffThresholdPercent是否设置为32767
   • 确认FanGroup对象是否正确配置
   • 验证风扇硬件是否正常工作

2. 转速差异过大：

   • 检查风扇硬件是否正常
   • 确认转速控制逻辑是否正确
   • 考虑调整转速差阈值

3. 分区调控异常：

   • 检查风扇分组配置是否正确
   • 确认转速差阈值设置是否合理
   • 验证调控算法是否正常工作

性能优化 ​

• 计算频率: 优化转速差计算的频率
• 阈值调整: 根据实际情况动态调整阈值
• 分组优化: 优化风扇分组策略

扩展功能 ​

• 动态阈值: 根据负载动态调整转速差阈值
• 多级控制: 实现多级转速差控制策略
• 预测控制: 基于历史数据预测转速差异

📚 相关文档 ​

• FanGroup配置
• CoolingConfig配置