📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

CoolingConfig 类

属性	值
类名称	`CoolingConfig`
功能描述	调速配置对象，提供智能调速、风扇控制、温度监控等散热配置功能
所属SIG组	thermal
所属组件	散热配置
责任人	热设计组
最后更新	2025-01-27
状态	🟢 正常运行

📊 属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`SmartCoolingState`	String	"Enabled"	"Enabled"/"Disabled"	-	智能调速SmartCooling是否处于使能状态 1、true：处于使能状态 2、false：不处于使能状态	基础调速全局配置：是否支持智能调速模式	`"Enabled"`	CSR	软件
`SmartCoolingMode`	String	"EnergySaving"	"EnergySaving"/"Custom"/"HighPerformance"/"LowNoise"/"LiquidCooling"	-	智能调速模式 1、"Custom" 2、"HighPerformance" 3、"LowNoise" 4、"EnergySaving" 5、"LiquidCooling" 默认为"EnergySaving"	基础调速全局配置：当前智能调速模式	`"EnergySaving"`	CSR	软件
`LevelPercentRange`	U8[]	[]	U8[]	-	手动模式转速级别范围	基础调速全局配置：手动转速取值范围，用于手动转速下发的判断	`[20, 100]`	CSR	软件
`InitLevelInStartup`	U8	100	U8	-	开机默认初值	基础调速全局配置：BMC启动时下发的风扇转速，保证BMC启动时散热可靠性	`100`	CSR	软件
`DiskRowTemperatureAvailable`	Boolean	false	true/false	-	背板上硬盘温度是否能正常获取 1、false:有硬盘温度获取不到 2、true：硬盘温度都能获取到	基础调速全局配置：用于环温调速时判断是否可获取硬盘温度，用于环温调速生效判断	`false`	CSR	软件
`SysHDDsMaxTemperature`	Double	32768	Double	-	HDD硬盘的最大温度，单位：摄氏度	基础调速全局配置：硬盘温度参与调速	`80`	软件刷新	软件
`SysSSDsMaxTemperature`	Double	32768	Double	-	SSD硬盘最大温度(仅SAS/SATA)，单位：摄氏度	基础调速全局配置：硬盘温度参与调速	`80`	软件刷新	软件
`SensorLocationSupported`	Boolean	false	true/false	-	是否支持温度海洋（属性配置时默认为false（即不配置是为false），产品支持则需自行配置psr中属性为true）	基础调速全局配置：用于温度海洋界面展示，不支持机型可不配置，支持机型需配置为true	`false`	CSR	软件

可选属性

无可选属性

🔗 动态关联机制

语法规范

使用标准配置语法：

yaml

# 智能调速配置
SmartCoolingState: "Enabled"
SmartCoolingMode: "EnergySaving"

# 手动调速配置
LevelPercentRange: [20, 100]
InitLevelInStartup: 100

# 硬盘温度配置
DiskRowTemperatureAvailable: false
SysHDDsMaxTemperature: 80.0
SysSSDsMaxTemperature: 80.0

# 温度海洋配置
SensorLocationSupported: false

关联说明

智能调速: SmartCoolingState控制智能调速总开关
调速模式: SmartCoolingMode决定具体的调速策略
硬盘温度: 硬盘温度参与环温调速计算
温度海洋: SensorLocationSupported控制温度海洋界面展示

📂 分类标准

硬件属性

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

软件属性

定义：由软件管理和维护的散热配置参数
特点：调速模式、温度监控、配置管理等
示例：所有属性都是软件属性

📝 配置示例

基础调速配置

json

{
  "CoolingConfig_Basic": {
    "SmartCoolingState": "Enabled",
    "SmartCoolingMode": "EnergySaving",
    "LevelPercentRange": [20, 100],
    "InitLevelInStartup": 100,
    "DiskRowTemperatureAvailable": false,
    "SysHDDsMaxTemperature": 80.0,
    "SysSSDsMaxTemperature": 80.0,
    "SensorLocationSupported": false
  }
}

高性能调速配置

json

{
  "CoolingConfig_HighPerformance": {
    "SmartCoolingState": "Enabled",
    "SmartCoolingMode": "HighPerformance",
    "LevelPercentRange": [30, 100],
    "InitLevelInStartup": 100,
    "DiskRowTemperatureAvailable": true,
    "SysHDDsMaxTemperature": 75.0,
    "SysSSDsMaxTemperature": 75.0,
    "SensorLocationSupported": true
  }
}

低噪音调速配置

json

{
  "CoolingConfig_LowNoise": {
    "SmartCoolingState": "Enabled",
    "SmartCoolingMode": "LowNoise",
    "LevelPercentRange": [15, 80],
    "InitLevelInStartup": 80,
    "DiskRowTemperatureAvailable": true,
    "SysHDDsMaxTemperature": 85.0,
    "SysSSDsMaxTemperature": 85.0,
    "SensorLocationSupported": false
  }
}

液冷调速配置

json

{
  "CoolingConfig_LiquidCooling": {
    "SmartCoolingState": "Enabled",
    "SmartCoolingMode": "LiquidCooling",
    "LevelPercentRange": [10, 60],
    "InitLevelInStartup": 60,
    "DiskRowTemperatureAvailable": true,
    "SysHDDsMaxTemperature": 70.0,
    "SysSSDsMaxTemperature": 70.0,
    "SensorLocationSupported": true
  }
}

手动调速配置

json

{
  "CoolingConfig_Manual": {
    "SmartCoolingState": "Disabled",
    "SmartCoolingMode": "Custom",
    "LevelPercentRange": [25, 100],
    "InitLevelInStartup": 100,
    "DiskRowTemperatureAvailable": false,
    "SysHDDsMaxTemperature": 80.0,
    "SysSSDsMaxTemperature": 80.0,
    "SensorLocationSupported": false
  }
}

🔧 使用指南

配置步骤

智能调速配置：设置SmartCoolingState和SmartCoolingMode
手动调速配置：设置LevelPercentRange和InitLevelInStartup
硬盘温度配置：设置DiskRowTemperatureAvailable和温度阈值
温度海洋配置：根据产品支持情况设置SensorLocationSupported
参数验证：验证配置参数的合理性和有效性

智能调速模式

EnergySaving: 节能模式，优先降低功耗和噪音
HighPerformance: 高性能模式，优先保证散热效果
LowNoise: 低噪音模式，优先降低风扇噪音
Custom: 自定义模式，用户自定义调速策略
LiquidCooling: 液冷模式，适用于液冷散热系统

手动调速管理

LevelPercentRange: 定义手动调速的转速范围
范围限制: 通常设置为[最小转速%, 最大转速%]
安全考虑: 最小转速不能过低，确保散热安全
用户控制: 用户可以在此范围内手动设置转速

启动保护机制

InitLevelInStartup: BMC启动时的初始风扇转速
安全启动: 通常设置为100%，确保启动时散热可靠
渐进调节: 启动后根据温度逐步调节到合适转速

硬盘温度监控

DiskRowTemperatureAvailable: 硬盘温度是否可获取
SysHDDsMaxTemperature: HDD硬盘最大温度阈值
SysSSDsMaxTemperature: SSD硬盘最大温度阈值
调速参与: 硬盘温度参与环温调速计算

温度海洋功能

SensorLocationSupported: 是否支持温度海洋界面
界面展示: 在Web界面显示各传感器的温度分布
产品差异: 不同产品根据支持情况配置

注意事项

模式兼容: 确保调速模式与硬件兼容
范围合理: 手动调速范围应该合理设置
温度准确: 硬盘温度监控需要准确配置
功能支持: 温度海洋功能需要硬件支持

故障排除

调速不生效：
- 检查SmartCoolingState是否为"Enabled"
- 确认SmartCoolingMode设置是否正确
- 验证相关CoolingPolicy是否正确配置
手动调速异常：
- 检查LevelPercentRange设置是否合理
- 确认转速范围是否在硬件支持范围内
- 验证手动调速接口是否正常
硬盘温度异常：
- 检查DiskRowTemperatureAvailable设置
- 确认硬盘温度传感器是否正常工作
- 验证温度阈值设置是否合理

性能优化

响应速度: 优化调速模式切换的响应速度
温度采样: 优化硬盘温度采样频率
界面刷新: 优化温度海洋界面的刷新频率

📚 相关文档

CoolingPolicy配置

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

CoolingConfig 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

关联说明 ​

📂 分类标准 ​

硬件属性 ​

软件属性 ​

📝 配置示例 ​

基础调速配置 ​

高性能调速配置 ​

低噪音调速配置 ​

液冷调速配置 ​

手动调速配置 ​

🔧 使用指南 ​

配置步骤 ​

智能调速模式 ​

手动调速管理 ​

启动保护机制 ​

硬盘温度监控 ​

温度海洋功能 ​

注意事项 ​

故障排除 ​

性能优化 ​

📚 相关文档 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

CoolingConfig 类

📊 属性定义详表

必选属性

可选属性

🔗 动态关联机制

语法规范

关联说明

📂 分类标准

硬件属性

软件属性

📝 配置示例

基础调速配置

高性能调速配置

低噪音调速配置

液冷调速配置

手动调速配置

🔧 使用指南

配置步骤

智能调速模式

手动调速管理

启动保护机制

硬盘温度监控

温度海洋功能

注意事项

故障排除

性能优化

📚 相关文档