简介这是电子设计大赛参赛作品基于STM32微控制器实现水温PID闭环控制适合嵌入式初学者、竞赛选手及自动控制爱好者也可作为智能恒温设备开发的参考原型。压缩包共254个文件约4.19MB主要由C源码、H头文件与编译生成的O/CRF中间文件构成同时包含HEX/MAP烧录调试文件、UV2工程及初始化配置文件目录结构清晰可完整还原开发环境。已有2449人学习参考价值经过验证。工程实现ADC采集温度传感器信号、PID算法计算输出、控制加热元件通断等核心流程并涵盖定时器、中断、GPIO等STM32外设配置。仔细研读可掌握PID参数调节方法理解比例、积分、微分对水温响应速度与稳态精度的影响也能为其他温度控制系统提供可直接移植的代码框架。 做水温控制这个题目是我当年参加电子设计大赛印象最深的一段经历。题目本身不复杂给定目标水温让系统自动加热并稳定住。但真上手才发现温度读准只是第一步加热器怎么驱动、PID参数怎么定、为什么到了设定值还会冲过头这些才是真正卡人的地方。这篇就把这个基于STM32的水温控制PID源程序从头拆一遍包括方案选型、硬件电路、核心代码以及我调参踩过的一堆坑。不管你是准备电赛、做课程设计还是第一次接触PID闭环控制都可以把这个项目当作一个能直接落地的参考。这里要提前说清楚一个认知水温控制是典型的大惯性、大滞后系统和电机调速那种快速响应完全不同。控制周期、参数初值、执行器策略都有讲究。网上很多源码能下载但换到你的板子上就失控多半不是代码问题而是没理解这套系统和PID的配合关系。下面我从一个参赛者的视角把整件事讲透。1. 题目拆解与整体方案选型1.1 电赛水温控制到底在考什么电赛控制类题目一般不会直接说“你给我做个PID”而是描述成容器里有水加热装置工作要求把水温快速加热到设定温度并稳下来允许误差可能是±1℃甚至±0.5℃有的题还加风冷要求能主动降温。如果你只看表面指标很容易一上来就写个“低于设定就开高于设定就关”的开关逻辑。跑起来就会发现水温在目标值附近反复震荡而且因为加热体有余热冲过设定值后还会继续往上飘误差远超要求。这就是闭环控制的经典问题反馈量变化惯性大开关控制永远在过度纠偏。核心矛盾是加热不能瞬间停止温度读数也代表的是过去一段时间的状态所以需要PID这种能结合当前差值、历史累计、变化趋势一起做决策的控制器。1.2 主控、传感器和执行器怎么选主控我选的是STM32F103C8T6。电赛里这颗芯片出现频率极高72MHz主频ADC、定时器PWM、串口、I2C全都够用资料铺天盖地。源程序用的标准外设库其实用HAL也一样核心算法跟库本身没关系。传感器对比过几个方案方案精度响应速度成本适合场景DS18B20±0.5℃慢转换约750ms低课程设计、简易控温NTC 10K B3950 ADC标定后可达±0.2℃快极低电赛、需要实时控制PT100 运放很高中高工业级高精度平台我用了NTC方案。原因很简单水温控制需要快速感知变化趋势NTC响应比DS18B20快很多ADC采样平滑后稳定性也够用。代价是需要自己做阻值转温度公式这个不复杂后面代码里直接给。执行器选了固态继电器SSRPID输出PWM占空比控制SSR通断。普通电磁继电器撑不住高频动作噪音和寿命都是问题。SSR内部是可控硅无触点可以把通断周期做到1秒级别对控制算法很友好。2. PID算法为什么是它怎么落地2.1 从洗澡调水温理解PID理解PID最直观的方式就是洗澡。觉得水凉了往热水方向拧太烫了赶紧调回来而且会根据温差决定拧多少看到快烫了提前减速。PID本质就是把这种经验数字化P看现在差多少I看以前累计差多少D预测下一步会怎么变。水温加热系统跟洗澡很像加热器功率大、热惯性大、温度反馈滞后。如果没有D的预判到目标才停余热会继续推高温度。这正是PID适合这个题目的原因——它不要求精确数学模型只要参数合理就能用简单公式控制住复杂物理过程。2.2 位置式、增量式以及代码实现PID有两个常用形态。位置式输出的是控制量绝对值直接就是“应该给多少功率”out Kp * err Ki * err_sum Kd * (err - err_last);增量式输出的是本次相对上次的变化量一般用于电机调速这类执行器需要平滑变化的场景。水温控制我让PID直接输出0~100的占空比更适合位置式。位置式的坑是积分项不断累积如果加热过程中误差一直为正积分项会冲到限幅温度到设定后输出迟迟降不下来。所以代码里必须做抗积分饱和和输出限幅这比公式本身更重要。typedef struct { float Kp; float Ki; float Kd; float target; float err; float err_last; float err_sum; float out; float out_max; } PID_t; float PID_Calc(PID_t *pid, float actual) { pid-err pid-target - actual; pid-out pid-Kp * pid-err pid-Ki * pid-err_sum pid-Kd * (pid-err - pid-err_last); if (pid-out pid-out_max) pid-out pid-out_max; else if (pid-out 0) pid-out 0; pid-err_sum pid-err; if (pid-err_sum pid-out_max) pid-err_sum pid-out_max; else if (pid-err_sum -pid-out_max) pid-err_sum -pid-out_max; pid-err_last pid-err; return pid-out; }这个函数有两个细节积分项只在输出限幅内累积防止积分饱和输出下限设为0因为加热系统不能负功率。想快速降温需要额外加风冷那就变成双通道结构这里不展开。2.3 控制周期和参数初值水温系统惯性大控制周期选1秒比较合理。太短会把采样噪声算进去尤其D项容易让输出发抖太长又跟不上温度变化震荡周期变大。调参顺序和教材一致先P后I再D。初值怎么给先做开环测试固定PWM输出50%记录水温从室温升到目标附近的时间。假设满功率升温速率约每分钟5℃那误差20℃时输出100%Kp取5左右起步然后逐步增加观察曲线。千万不要一上来就乱试一组参数。3. 硬件电路与STM32资源分配3.1 引脚规划参考我的作品里引脚分配是这样的功能引脚说明NTC温度采集PA1ADC1_CH1加热PWM输出PA0TIM2_CH1OLED显示PB6/PB7I2C1设定温度按键PB0~PB2加减、切换蜂鸣器报警PB12超温、按键反馈PA0和PA1相邻方便布线。注意TIM2_CH1的复用功能GPIO要配置成AF_PP部分板子可能需要重映射先查原理图再写代码。3.2 NTC采集电路与温度换算NTC测温原理就是分压。用10K电阻和10K25℃的NTC串联接到3.3V中间抽头进ADC。温度升高NTC阻值下降或上升取决于接法公式并不复杂。float NTC_GetTemp(uint16_t adc_val) { float Rntc 10.0f * (4096.0f / adc_val - 1.0f); float tempK 1.0f / (1.0f / 298.15f logf(Rntc / 10.0f) / 3950.0f); return tempK - 273.15f; }这里用B值公式ADC是12位满量程4096。采样时间尽量配置长一点硬件上加一个10K1uF的RC低通滤波软件上每轮控制用20次采样取平均能明显减小温度跳变。3.3 加热驱动与安全隔离PWM信号从PA0出来后不能直接驱动SSR。我加了一级光耦隔离和限流电阻再接到SSR控制端。好处是单片机地和强电地彻底分开避免地环路干扰保护调试器不被高压击穿。强电部分必须提醒调试时先确认弱电和强电隔离可靠再上电加热部分加独立保险丝这是保命的事。SSR用1秒PWM周期驱动。过零型SSR必须在交流过零点附近动作1Hz的PWM对它完全没有压力表现为“1秒内导通时间占多少百分比”。如果你用随机导通型SSR可以适当提高频率但水温系统响应不过来没必要。4. 工程搭建与源程序结构4.1 Keil工程和固件库的坑这套源程序用的是STM32F1标准外设库。在Keil MDK新建工程最容易踩三个坑一是忘了把stm32f10x_it.c、system_stm32f10x.c加入Source Group编译报一堆未定义二是头文件路径没加全出现“cannot open source file stm32f10x.h”三是宏定义漏了STM32F10X_MD导致器件类型不对外设注册表错乱。如果你用VSCode或CLion打开工程报“找不到.h”先检查c_cpp_properties.json里有没有把固件库include路径全部列全宏定义要写STM32F10X_MD和USE_STDPERIPH_DRIVER。这个原理和Keil魔棒设置一样。4.2 定时器PWM和ADC初始化PWM用TIM2_CH1输出周期设为1秒。72MHz主频下PSC7199ARR9999计数频率10kHz溢出周期约1秒。比较值CCR从0到9999对应占空比0~100%。ADC用轮询方式选ADC1通道1采样时间55.5 cycles每轮读20次取平均。没有用DMA因为水温控制对实时性要求不高主循环里完成完全够。如果后面要处理复杂显示和菜单再上DMA也不迟。4.3 主循环逻辑与串口调试主循环代码很简单while (1) { if (flag_1s) { flag_1s 0; temp NTC_GetTemp(ADC_GetAverage(20)); out PID_Calc(pid, temp); TIM_SetCompare1(TIM2, (uint16_t)(out * 99.9f)); printf(temp:%.2f,set:%.2f,out:%.1f\r\n, temp, pid.target, out); OLED_ShowTemp(temp, pid.target, out); } Key_Scan(); }1秒定时用Systick中断置位flag主循环处理按键和显示。这套框架很容易扩展想改10ms控制周期把flag改为对应时间即可。5. 从调参到排障实测经验5.1 先开环标定别急着上PID我见过太多人拿到源码改一下参数就烧录结果温度要么不动要么乱震荡。正确做法是先做开环标定把PID暂时去掉固定PWM占空比50%加热几分钟记录温度曲线。这个曲线能告诉你系统的时间常数和滞后量。比如实测室温25℃PWM50%水温4分钟升到45℃。这意味着满功率升温速率约每分钟5℃。那误差5℃时输出100%不算过分误差1℃时输出20%可能已经能维持温度。Kp初值可以通过“满量程输出/预期最大误差”估算然后逐步往下试。这个动作不花太多时间但对后面调参帮助极大。5.2 三步调参法第一步只留PKi和Kd先设0。Kp从小到大比如10、20、40、80观察温度曲线。太小升温慢、稳态误差大太大开始震荡。找到临界值比如Kp55时温度开始等幅震荡取它的一半约27作为工作Kp。第二步加I。Ki从0.02开始每次调整观察稳态误差。太小温度离设定值永远差一点太大系统低频震荡。我最终Ki在0.1左右误差能进±0.3℃。第三步加D。D对水温系统是双刃剑确实能抑制超调但温度采样有噪声D放大了噪声会让PWM输出跳变。我最后Kd只给了1.0效果足够。5.3 常见问题速查表现象可能原因解决办法温度显示乱跳NTC走线太长、电源噪声加RC滤波、多采样取平均到设定值还在冲加热棒余热大加大Kd、限制接近目标时的输出稳态误差消不掉Ki太小、积分限幅太小增大Ki、放宽积分限幅输出狂跳、PWM闪D过大、采样噪声降低Kd、增加滤波升温速度不够Kp太小、输出限幅太低增大Kp、检查输出上限程序上电卡死HSE起振失败、延时阻塞查晶振、查初始化顺序编译找不到stm32f10x.hinclude路径没配置添加固件库头文件目录5.4 余热问题的实战处理水温控制最讨厌的就是余热。加热器表面温度很高即使PID输出已经降到0热量还会继续传进水里。我后来加了两个处理一是接近设定值时限制最大占空比比如误差小于2℃时输出上限强制降为40%让系统提前减速二是加死区误差在±0.3℃之内不改变PWM输出避免输出频繁变化造成温度锯齿状波动。调水温PID那几天我最深的体会是代码不难难的是愿意静下心去观察系统的性子。每套加热器都有自己的滞后和余热换一个水杯、换一个加热功率参数都要重来。所以我后来把调试工具链搭完整串口曲线、开环标定、参数表格都顺手做了。这个项目之后再写电机调速、智能车里的PID核心思路完全通用只是执行器和响应速度变了。如果你准备做类似的比赛题建议先把硬件摸透再开始改参数你会发现一切顺很多。本文还有配套的精品资源点击获取