📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

AirCoolingConfig 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

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

# 基础调速配置
SpeedPercentRange: [20, 100]
InitialSpeedPercent: 100
# 从BMC控制配置
MinAllowedSpeedPercent: 100

关联说明 ​

• 基础调速: SpeedPercentRange定义手动控制的转速范围，InitialSpeedPercent设置系统启动时的风扇转速
• 从BMC调速: MinAllowedSpeedPercent设置失联场景从BMC风扇转速

📂 分类标准 ​

硬件属性 ​

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

软件属性 ​

• 定义：由软件管理和维护的散热配置参数
• 特点：基础调速配置管理
• 示例：所有属性都是软件属性

📝 配置示例 ​

基础调速配置 ​

{
  "AirCoolingConfig_Basic": {
    "SpeedPercentRange": [20, 100],
    "InitialSpeedPercent": 100
  }
}

从BMC调速控制配置 ​

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

🔧 使用指南 ​

配置步骤 ​

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

最佳实践 ​

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

注意事项 ​

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

故障排除 ​

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

📚 相关文档 ​

• CoolingConfig配置指南