CSR配置字典之LiquidCoolingConfig类
更新时间: 2025/07/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | LiquidCoolingConfig类配置字典 |
| 版本 | v1.1 |
| 创建日期 | 2025-01-27 |
| 最后更新 | 2026-05-12 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2025-01-27 | 初始版本 | 创建LiquidCoolingConfig类配置字典 | 全新文档 | 系统管理员 |
| V1.1 | 2026-05-12 | 补丁版本 | 修改类概览描述信息 | 类概览描述信息 | 汪航 |
🎯 类概览
LiquidCoolingConfig 类
| 属性 | 值 |
|---|---|
| 类名称 | LiquidCoolingConfig |
| 功能描述 | 液冷调速配置对象,提供液冷散热器件手动模式功能配置 |
| 所属SIG组 | thermal |
| 所属组件 | 液冷调速 |
| 责任人 | 热设计组 |
| 最后更新 | 2026-05-12 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
LevelPercentRange | U8[] | [] | U8[] | - | 液冷散热器件手动模式支持设置的调速范围 | 液冷散热器件手动模式功能配置 | [25, 100] | CSR配置 | 软件 |
MaxPumpNum | U8 | 0 | U8 | - | 含有液冷调速的泵个数 | 液冷泵环境适配 | 2 | CSR配置 | 软件 |
可选属性
无可选属性
🔗 动态关联机制
语法规范
使用标准配置语法:
yaml
# 液冷调速范围配置
LevelPercentRange: [25, 100] # 25%到100%的调速范围
# 泵个数配置
MaxPumpNum: 2关联说明
- 调速范围: LevelPercentRange定义液冷散热器件的手动调速范围
- 百分比控制: 数组包含最小和最大百分比值
- 手动模式: 仅在手动模式下生效
- 泵个数: MaxPumpNum涉及正常调速泵个数
📂 分类标准
硬件属性
- 定义:当前版本无硬件属性
- 特点:所有属性都是软件管理相关
- 示例:无
软件属性
- 定义:当前版本无软件属性
- 特点:手动调速控制,泵个数加载
- 示例:所有属性都是软件属性
📝 配置示例
基础液冷配置
json
{
"LiquidCoolingConfig_Basic": {
"LevelPercentRange": [25, 100],
"MaxPumpNum": 2
}
}🔧 使用指南
配置步骤
- 评估需求: 确定液冷散热器件的调速需求
- 范围设置: 根据热设计要求设置调速范围
- 测试验证: 验证液冷调速功能是否正常
- 性能优化: 根据实际使用情况优化调速范围
调速范围说明
- 数组格式: [最小百分比, 最大百分比]
- 百分比范围: 通常在0-100之间
- 最小值: 确保液冷系统能够正常工作的最小转速
- 最大值: 液冷系统支持的最大转速
液冷调速原理
- 手动模式: 用户可以手动设置液冷散热器件的转速
- 范围限制: 系统限制用户设置的转速范围
- 安全保护: 防止用户设置过低或过高的转速
配置选择原则
- 保守配置: 设置较窄的调速范围,确保系统稳定
- 性能配置: 设置较宽的调速范围,提供更多调节空间
- 静音配置: 限制最大转速,减少噪音
- 节能配置: 优化调速范围,平衡性能和功耗
使用场景
- 手动调速: 用户需要手动控制液冷散热器件转速
- 性能调优: 根据负载情况调整散热性能
- 噪音控制: 控制液冷系统的噪音水平
- 功耗优化: 优化液冷系统的功耗
注意事项
- 范围合理: 确保调速范围符合硬件规格
- 安全考虑: 避免设置过低的最小转速
- 性能平衡: 平衡散热性能和噪音控制
- 硬件兼容: 确保配置与液冷硬件兼容
故障排除
调速不生效:
- 检查LevelPercentRange是否正确配置
- 确认液冷硬件是否正常工作
- 验证手动模式是否启用
调速范围异常:
- 检查百分比值是否在合理范围内
- 确认最小值是否小于最大值
- 验证硬件是否支持该调速范围
液冷性能问题:
- 检查调速范围是否过于保守
- 确认液冷系统是否正常工作
- 验证散热效果是否满足需求
转速下发失败:
- 检查MaxPumpNum是否正确配置
维护建议
- 定期检查: 定期检查液冷系统状态
- 清洁维护: 定期清洁液冷散热器
- 液体更换: 定期更换冷却液
- 泄漏检测: 定期检查是否有泄漏