1、Marlin温度系统概览：温度管理在3D打印中的重要性、Marlin温度子系统架构、核心数据结构与全局变量
1.1 为什么温度管理是3D打印的命脉？
做3D打印固件这些年，我见过太多因为温度失控导致的翻车现场。说白了，温度管理就是3D打印的「心脏起搏器」。你想想看，喷头温度不准，第一层就粘不住；热床温度波动大，模型直接翘边报废。
我个人习惯把温度管理比作「三座大山」：
- 打印质量：温度偏差±2℃以上，层间结合力就会明显下降
- 安全底线：热失控是3D打印火灾的头号元凶
- 打印成功率：我统计过，超过60%的打印失败与温度异常有关
⚠️ 我曾经踩过的坑： 有一次客户反馈打印头冒烟，排查发现是温度传感器线缆被挤出机皮带磨破，导致间歇性短路。从那以后，我坚持在固件里开启热失控保护，并且建议所有项目都做传感器断线检测。
1.2 Marlin温度子系统架构
Marlin的温度管理不是简单读个温度就完事。它是一套完整的闭环系统，我把它拆成四个层次：
- 硬件抽象层：负责与ADC、热电偶、热敏电阻等物理器件打交道
- 采样与滤波层：原始ADC值经过中值滤波、指数平滑，变成可用温度
- PID控制层：根据目标温度与实际温度的偏差，计算加热功率
- 安全监控层：热失控检测、温度上限保护、传感器异常报警
嗯，这里要注意：每一层之间都有明确的接口。我见过一些魔改固件，直接跳过滤波层拿原始ADC值做PID计算，结果温度曲线抖得像心电图。
1.3 核心数据结构
Marlin用几个关键结构体来管理温度数据。我挑最重要的说：
1.3.1 heater_t 结构体
每个加热通道（喷头、热床）对应一个实例：
typedef struct {
int16_t target; // 目标温度，单位℃
int16_t current; // 当前温度，单位℃
uint8_t pid_output; // PID输出值，0-255
uint8_t soft_pwm; // 软件PWM值
bool is_active; // 加热是否启用
uint8_t sensor_type; // 传感器类型：热敏电阻/热电偶
} heater_t;
💡 个人经验： target和current都是int16_t，取值范围-273~1023℃。我遇到过有人把target设成负数，结果PID疯狂加热——因为负温度比实际温度低，PID以为温差很大。所以我现在都会在固件里加一个target合法性检查。
1.3.2 PID参数结构体
typedef struct {
float Kp; // 比例系数
float Ki; // 积分系数
float Kd; // 微分系数
float i_state; // 积分累计值
float d_state; // 上次偏差值
float i_max; // 积分上限，防止积分饱和
} pid_data_t;说白了，PID就是三个系数的博弈。Kp大了会超调，Ki大了会震荡，Kd大了对噪声敏感。我调试过一台三角洲打印机，热床特别厚，Kp调到80才勉强跟上温度，但一超调就是15℃的过冲。
1.4 全局变量
Marlin的温度管理依赖几个全局变量，它们就像整个系统的「神经中枢」：
| 变量名 | 类型 | 作用 |
|---|---|---|
| thermalManager | ThermalManager类实例 | 温度管理的核心对象，管理所有加热通道 |
| heater_t heater[HEATER_COUNT] | 数组 | 每个加热通道的状态，包括目标温度、当前温度 |
| pid_data_t pid_data[HEATER_COUNT] | 数组 | 每个通道的PID参数和状态 |
| uint16_t raw_temp_value[HEATER_COUNT] | 数组 | ADC原始采样值，用于滤波计算 |
| bool thermal_runaway_state | bool | 热失控保护是否触发 |
🔧 调试技巧： 我习惯在Marlin的M105命令响应里，把raw_temp_value也打印出来。这样能快速判断是传感器问题还是滤波算法问题。如果raw_temp_value跳变很大但温度显示平稳，说明滤波参数太激进，响应会变慢。
1.5 温度管理的核心流程
每次主循环调用temperature task时，会执行以下步骤：
- 采样：读取ADC值，存入raw_temp_value
- 滤波：对原始值做中值滤波和指数平滑
- 查表：根据传感器类型，用温度-电阻对照表换算成℃
- PID计算：根据目标温度和当前温度，计算加热功率
- 输出：设置PWM占空比，控制加热管
- 安全检查：检查温度是否超限、升温速率是否异常
你想想看，这个流程每200ms就跑一次。如果某个环节卡住，比如ADC读取被中断阻塞，温度控制就会出问题。我遇到过因为SPI总线被占用，导致温度采样延迟了500ms，结果PID输出了一个过大的加热功率，差点烧了热端。
⚠️ 重要提醒： 千万不要在主循环里用delay()阻塞温度任务。Marlin的温度管理是时间敏感的，任何超过50ms的阻塞都可能导致温度失控。我建议用非阻塞的定时器中断来触发温度采样。
好了，这一章我们理清了Marlin温度管理的整体框架。从硬件抽象到安全监控，从数据结构到全局变量，这些都是后续章节的基础。下一章我们会深入ADC采样和滤波算法的具体实现——那才是真正考验固件工程师功底的地方。