📋 文档信息 ​

📋 变更历史 ​

🎯 类概览 ​

AirCoolingConfig类 是BMC固件中用于管理风冷散热配置的类。该类提供了风扇手动控制模式的转速百分比范围设置和开机初始转速配置功能，属于PSR（Power Supply and Regulation）散热管理组件。

状态: 🟢 活跃维护中
适用范围: 风冷散热管理、风扇手动控制
依赖组件: PSR、风扇控制器、散热管理系统

📊 属性定义详表 ​

必选属性 ​

🔗 动态关联机制 ​

静态配置 ​

该类主要通过静态配置进行风扇控制参数设置，不涉及Scanner/Accessor动态关联机制。

关联说明:

• SpeedPercentRange定义手动控制的转速范围
• InitialSpeedPercent设置系统启动时的风扇转速
• 配置参数直接影响风扇控制策略

📂 分类标准 ​

软件属性 ​

• SpeedPercentRange: 手动转速控制范围
• InitialSpeedPercent: 开机初始转速配置

📝 配置示例 ​

基础配置 ​

{
  "AirCoolingConfig": {
    "SpeedPercentRange": [10, 100],
    "InitialSpeedPercent": 100
  }
}

保守配置 ​

{
  "AirCoolingConfig": {
    "SpeedPercentRange": [20, 80],
    "InitialSpeedPercent": 60
  }
}

高性能配置 ​

{
  "AirCoolingConfig": {
    "SpeedPercentRange": [30, 100],
    "InitialSpeedPercent": 100
  }
}

静音配置 ​

{
  "AirCoolingConfig": {
    "SpeedPercentRange": [10, 70],
    "InitialSpeedPercent": 30
  }
}

数据中心配置 ​

{
  "AirCoolingConfig": {
    "SpeedPercentRange": [40, 100],
    "InitialSpeedPercent": 80
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 转速范围设置: 配置SpeedPercentRange数组，设置最小和最大转速百分比
2. 初始转速设置: 配置InitialSpeedPercent，设置开机时的风扇转速
3. 验证配置: 确保配置参数在合理范围内
4. 测试验证: 验证风扇控制功能正常

最佳实践 ​

• 最小转速不应低于10%，避免风扇停转
• 最大转速通常设置为100%，确保最大散热能力
• 开机初始转速建议设置较高值，确保系统启动安全
• 根据应用场景调整转速范围

注意事项 ​

• SpeedPercentRange必须是两个元素的数组
• 最小转速不能为0，避免风扇完全停转
• 初始转速应在转速范围内
• 配置变更后需要重启生效

故障排除 ​

• 转速控制失效: 检查SpeedPercentRange配置正确性
• 开机风扇异常: 验证InitialSpeedPercent设置
• 转速范围错误: 确认数组格式和数值范围
• 配置不生效: 检查配置文件格式和重启状态

📚 相关文档 ​

• Fan配置指南
• FanGroup配置指南
• CoolingFan配置指南