CSR配置字典之MPCConfig类
更新时间:2025/7/22
在Gitcode上查看源码📋 文档信息
项目 | 内容 |
---|---|
文档标题 | MPCConfig类配置字典 |
版本 | v1.0 |
创建日期 | 2025-01-27 |
最后更新 | 2025-01-27 |
维护状态 | ⚠️ 已废弃 (MPC3.0已废弃) |
📋 变更历史记录
文档变更记录
版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
---|---|---|---|---|---|
v1.0 | 2025-01-27 | 初始版本 | 创建MPCConfig类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
MPCConfig 类
属性 | 值 |
---|---|
类名称 | MPCConfig |
功能描述 | MPC调速配置对象,提供MPC(Model Predictive Control)调速相关配置,注意:MPC3.0已废弃 |
所属SIG组 | thermal |
所属组件 | MPC调速 |
责任人 | 热设计组 |
最后更新 | 2025-01-27 |
状态 | ⚠️ 已废弃 |
📊 属性定义详表
必选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
Enabled | Boolean | false | true/false | - | MPC是否使能,默认为false | MPC配置:MPC开关 | false | CSR | 软件 |
可选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
Retraining | Boolean | false | true/false | - | MPC模型重训练标志,要求非空 MPC3.0已废弃 | MPC配置:MPC重训练标志 | false | CSR | 软件 |
MinPwmAtDiffInletTemp | U8[] | [] | U8[] | - | 不同入风口温度下的最低转速百分比,要求非空 MPC3.0已废弃 | MPC配置:23度~28度进风口温度对应最低转速 | [35, 35, 35, 35, 36, 39] | CSR | 软件 |
PowerDiff | S16 | 0 | S16 | - | 模型更新前后稳态整机功率差,要求非空 MPC3.0已废弃 | MPC配置:MPC模型更新前后稳态整机功率差 | 0 | CSR | 软件 |
Version | U16 | 0 | U16 | - | MPC版本号,要求非空 MPC3.0已废弃 | MPC配置:MPC版本号,模型更新后版本号加1 | 1 | CSR | 软件 |
StableTotalPower | U16 | 0 | U16 | - | 稳态整机功率,要求非空 MPC3.0已废弃 | MPC配置:稳态整机功率,环境处于稳态时的功耗值 | 282 | CSR | 软件 |
DiskNum | U8 | 0 | U8 | - | 硬盘数量,要求非空 MPC3.0已废弃 | MPC配置:MPC运行时的硬盘数量,若实际数量与配置不一致,需要重新训练模型 | 2 | CSR | 软件 |
TotalSteps | U8 | 0 | U8 | - | 转速寻优迭代次数 MPC3.0已废弃 | MPC配置:MPC模型预测步数 | 50 | CSR | 软件 |
MaxCpuTemp | Double | 0 | Double | - | 风扇全速对应CPU温度 MPC3.0已废弃 | MPC配置:风扇全速对应的CPU温度,用于内部逻辑计算 | 81.2 | CSR | 软件 |
CpuEdgeTemp | Double | 0 | Double | - | CPU边缘温度 MPC3.0已废弃 | 未使用 | 77.1 | CSR | 软件 |
MaxFanSpeed | U8 | 0 | U8 | - | 转速寻优支持的最大转速 MPC3.0已废弃 | MPC配置:转速寻优的最大值 | 80 | CSR | 软件 |
CpuTempDiffThreshold | U8 | 0 | U8 | - | CPU温度上升阈值 MPC3.0已废弃 | MPC配置:CPU温度上升阈值,超过该阈值触发相应动作 | 20 | CSR | 软件 |
🔗 动态关联机制
语法规范
使用标准配置语法:
yaml
# MPC基础配置
Enabled: false
# MPC模型配置(已废弃)
Retraining: false
Version: 1
StableTotalPower: 282
DiskNum: 2
# MPC调速配置(已废弃)
MinPwmAtDiffInletTemp: [35, 35, 35, 35, 36, 39]
TotalSteps: 50
MaxFanSpeed: 80
MaxCpuTemp: 81.2
CpuEdgeTemp: 77.1
CpuTempDiffThreshold: 20
PowerDiff: 0
关联说明
- 功能废弃: MPC3.0已废弃,大部分属性不再使用
- 配置保留: 为了兼容性,配置结构保留但功能已停用
- 使用建议: 建议使用新的散热控制策略替代MPC
📂 分类标准
硬件属性
- 定义:当前版本无硬件属性
- 特点:所有属性都是软件管理相关
- 示例:无
软件属性
- 定义:由软件管理和维护的MPC配置参数
- 特点:模型控制、调速策略、版本管理等
- 示例:所有属性都是软件属性
📝 配置示例
基础MPC配置(推荐)
json
{
"MPCConfig_Disabled": {
"Enabled": false
}
}
完整MPC配置(已废弃,仅供参考)
json
{
"MPCConfig_Full_Deprecated": {
"Enabled": false,
"Retraining": false,
"MinPwmAtDiffInletTemp": [35, 35, 35, 35, 36, 39],
"PowerDiff": 0,
"Version": 1,
"StableTotalPower": 282,
"DiskNum": 2,
"TotalSteps": 50,
"MaxCpuTemp": 81.2,
"CpuEdgeTemp": 77.1,
"MaxFanSpeed": 80,
"CpuTempDiffThreshold": 20
}
}
兼容性配置
json
{
"MPCConfig_Compatibility": {
"Enabled": false,
"Retraining": false,
"Version": 0,
"StableTotalPower": 0,
"DiskNum": 0
}
}
🔧 使用指南
配置步骤
- 确认废弃状态:了解MPC3.0已废弃的情况
- 基础配置:设置Enabled为false
- 兼容性处理:为兼容性保留必要的配置项
- 迁移规划:规划迁移到新的散热控制策略
废弃说明
- MPC3.0废弃: 整个MPC功能在3.0版本中已废弃
- 配置保留: 为了向后兼容,配置结构仍然保留
- 功能停用: 除了Enabled属性外,其他属性功能已停用
迁移建议
- 新系统: 建议使用CoolingConfig和CoolingPolicy替代
- 现有系统: 逐步迁移到新的散热控制策略
- 配置清理: 可以逐步清理不再使用的MPC配置
历史功能说明
- 模型预测控制: MPC基于模型预测控制理论
- 自适应调速: 根据系统负载自适应调整风扇转速
- 温度预测: 基于历史数据预测温度变化
- 功耗优化: 在满足散热需求的前提下优化功耗
注意事项
- 功能废弃: 大部分MPC功能已不再工作
- 配置兼容: 保留配置是为了系统兼容性
- 性能影响: 启用MPC可能不会产生预期效果
- 替代方案: 建议使用现代化的散热控制策略
故障排除
MPC不工作:
- 确认MPC3.0已废弃的状态
- 检查是否需要迁移到新的散热策略
- 验证替代方案是否正确配置
配置错误:
- 确认Enabled设置为false
- 检查兼容性配置是否正确
- 验证系统是否支持MPC功能
性能问题:
- 确认是否使用了新的散热控制策略
- 检查CoolingConfig和CoolingPolicy配置
- 验证散热效果是否满足需求
替代方案
- CoolingConfig: 使用现代化的散热配置
- CoolingPolicy: 使用线性调速策略
- 智能调速: 使用基于规则的智能调速
- 分区调速: 使用分区分组调速策略