CSR配置字典之MPCConfig类
更新时间:2025/7/22
在Gitcode上查看源码

📋 文档信息

项目内容
文档标题MPCConfig类配置字典
版本v1.0
创建日期2025-01-27
最后更新2025-01-27
维护状态⚠️ 已废弃 (MPC3.0已废弃)

📋 变更历史记录

文档变更记录

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

🎯 类概览

MPCConfig 类

属性
类名称MPCConfig
功能描述MPC调速配置对象,提供MPC(Model Predictive Control)调速相关配置,注意:MPC3.0已废弃
所属SIG组thermal
所属组件MPC调速
责任人热设计组
最后更新2025-01-27
状态⚠️ 已废弃

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
EnabledBooleanfalsetrue/false-MPC是否使能,默认为falseMPC配置:MPC开关falseCSR软件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
RetrainingBooleanfalsetrue/false-MPC模型重训练标志,要求非空
MPC3.0已废弃
MPC配置:MPC重训练标志falseCSR软件
MinPwmAtDiffInletTempU8[][]U8[]-不同入风口温度下的最低转速百分比,要求非空
MPC3.0已废弃
MPC配置:23度~28度进风口温度对应最低转速[35, 35, 35, 35, 36, 39]CSR软件
PowerDiffS160S16-模型更新前后稳态整机功率差,要求非空
MPC3.0已废弃
MPC配置:MPC模型更新前后稳态整机功率差0CSR软件
VersionU160U16-MPC版本号,要求非空
MPC3.0已废弃
MPC配置:MPC版本号,模型更新后版本号加11CSR软件
StableTotalPowerU160U16-稳态整机功率,要求非空
MPC3.0已废弃
MPC配置:稳态整机功率,环境处于稳态时的功耗值282CSR软件
DiskNumU80U8-硬盘数量,要求非空
MPC3.0已废弃
MPC配置:MPC运行时的硬盘数量,若实际数量与配置不一致,需要重新训练模型2CSR软件
TotalStepsU80U8-转速寻优迭代次数
MPC3.0已废弃
MPC配置:MPC模型预测步数50CSR软件
MaxCpuTempDouble0Double-风扇全速对应CPU温度
MPC3.0已废弃
MPC配置:风扇全速对应的CPU温度,用于内部逻辑计算81.2CSR软件
CpuEdgeTempDouble0Double-CPU边缘温度
MPC3.0已废弃
未使用77.1CSR软件
MaxFanSpeedU80U8-转速寻优支持的最大转速
MPC3.0已废弃
MPC配置:转速寻优的最大值80CSR软件
CpuTempDiffThresholdU80U8-CPU温度上升阈值
MPC3.0已废弃
MPC配置:CPU温度上升阈值,超过该阈值触发相应动作20CSR软件

🔗 动态关联机制

语法规范

使用标准配置语法:

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
  }
}

🔧 使用指南

配置步骤

  1. 确认废弃状态:了解MPC3.0已废弃的情况
  2. 基础配置:设置Enabled为false
  3. 兼容性处理:为兼容性保留必要的配置项
  4. 迁移规划:规划迁移到新的散热控制策略

废弃说明

  • MPC3.0废弃: 整个MPC功能在3.0版本中已废弃
  • 配置保留: 为了向后兼容,配置结构仍然保留
  • 功能停用: 除了Enabled属性外,其他属性功能已停用

迁移建议

  • 新系统: 建议使用CoolingConfig和CoolingPolicy替代
  • 现有系统: 逐步迁移到新的散热控制策略
  • 配置清理: 可以逐步清理不再使用的MPC配置

历史功能说明

  • 模型预测控制: MPC基于模型预测控制理论
  • 自适应调速: 根据系统负载自适应调整风扇转速
  • 温度预测: 基于历史数据预测温度变化
  • 功耗优化: 在满足散热需求的前提下优化功耗

注意事项

  • 功能废弃: 大部分MPC功能已不再工作
  • 配置兼容: 保留配置是为了系统兼容性
  • 性能影响: 启用MPC可能不会产生预期效果
  • 替代方案: 建议使用现代化的散热控制策略

故障排除

  1. MPC不工作

    • 确认MPC3.0已废弃的状态
    • 检查是否需要迁移到新的散热策略
    • 验证替代方案是否正确配置
  2. 配置错误

    • 确认Enabled设置为false
    • 检查兼容性配置是否正确
    • 验证系统是否支持MPC功能
  3. 性能问题

    • 确认是否使用了新的散热控制策略
    • 检查CoolingConfig和CoolingPolicy配置
    • 验证散热效果是否满足需求

替代方案

  • CoolingConfig: 使用现代化的散热配置
  • CoolingPolicy: 使用线性调速策略
  • 智能调速: 使用基于规则的智能调速
  • 分区调速: 使用分区分组调速策略

📚 相关文档