企业官网建设流程全解析

CraftBeerPi温控算法深度解析：PID、过冲与迟滞三种自动控温逻辑源码逐行剖析

【免费下载链接】craftbeerpiBrew Controller项目地址: https://gitcode.com/gh_mirrors/cr/craftbeerpi

CraftBeerPi 是一款基于树莓派的自酿啤酒智能控温系统，其核心是自动控温算法模块。本文带你深入 CraftBeerPi 的 PID 温控、过冲（Overshoot）与迟滞（Hysteresis）三种自动控温逻辑源码，理解自酿啤酒温控算法如何把一锅麦汁精准加热到工艺曲线要求的温度，新手也能快速读懂这套温度控制逻辑。

一、先看硬件：温控算法在控制什么？

CraftBeerPi 的温控算法最终控制的是加热器的通断。树莓派通过继电器或可控硅驱动加热棒，温度传感器（如 1-Wire 传感器）实时回传温度值：

算法代码集中在brewapp/base/automatic/目录，每种控温逻辑都是一个 Python 文件，通过init.py 统一导入注册。

二、自动控温的公共基类：一切逻辑的起点

所有控温逻辑都继承自 automaticlogic.py 中的Automatic基类，它定义了四个核心方法：

• getCurrentTemp()：从传感器读取当前温度
• getTargetTemp()：获取目标温度（来自酿造工艺步骤）
• switchHeaterON()/switchHeaterOFF()：控制加热器开关
• isRunning()：判断是否仍在运行，用于退出控制循环

具体算法类只需实现一个run()方法，然后用 util.py 中的@brewautomatic()装饰器注册即可被系统发现：

@brewautomatic() class PIDLogic(Automatic): def run(self): ...

启动时，startAutomatic()会根据用户配置动态实例化对应算法并运行，停止则通过stopPID()关闭运行标志——整个温控框架就是“基类 + 装饰器注册 + 运行时选择”，非常易于扩展。

三、PID温控算法：最精准的控温方式

PID 是比例-积分-微分（Proportional-Integral-Derivative）控制，是 CraftBeerPI 温控算法中最常用的一种，适合需要长时间恒温的工艺步骤，比如糖化、煮沸。

核心实现见 pid.py，逻辑分两层：

1.PID数学类

• 构造函数接收采样时间ts和 P/I/D 三个参数，预计算积分与微分系数k0、k1
• calc()方法每 5 秒执行一次：
  • 计算误差e[k] = 目标温度 - 当前温度
  • 比例项：基于前后两次温度的变化量
  • 积分项：累积误差，消除长期偏差
  • 微分项：抑制温度突变，防止超调
  • 输出值被限制在 0~100 之间，代表加热功率百分比

2.PIDLogic运行逻辑

heat_percent = pid.calc(currentTemp, targetTemp) heating_time = sampleTime * heat_percent / 100

每个采样周期内，加热器按 PID 算出的功率百分比通电，其余时间关闭——这是一种时间比例调功，等效于 PWM 控温。默认参数 P=44、I=165、D=4，用户可在界面中调整。

四、过冲（Overshoot）温控算法：带提前量的简单控温

overshoot.py 实现了一种更简单的控温方式，只有一个参数Overshoot（单位：℃）：

• 当前温度 + 过冲值 < 目标温度→ 开启加热器
• 当前温度 + 过冲值 ≥ 目标温度→ 关闭加热器

它的原理是给温度“提前量”：在还没到目标温度时就关掉加热，利用余热升腾避免温度冲过头。参数为 0 时则退化为最朴素的开关控温（到点才关）。适合对精度要求不高的场景，逻辑直观、调试简单。

overshoot_advanced.py 是社区贡献的增强版，增加了对“目标温度刚被修改”的识别（setpoint记录），当目标温度变化时立即重新启用过冲提前量，避免连续升温时反复开关。

五、迟滞（Hysteresis）温控算法：上下限之间的开关带

hysterisis.py 实现了迟滞控制，使用两个参数ON和OFF构成一个温度开关带：

• 当前温度 + ON < 目标温度（低于下限）→ 开启加热器
• 当前温度 + OFF > 目标温度（高于上限）→ 关闭加热器

例如 ON=-1、OFF=+1 时，温度在“目标温度±1℃”的区间内反复开关，形成一个温度缓冲区，避免加热器在临界点频繁启停，保护继电器寿命。相比过冲算法，迟滞的 ON/OFF 可以独立配置，控温区间更灵活。

六、三种自动控温逻辑对比

七、进阶：用自动整定免去手工调参

PID 参数调不好会出现持续振荡或响应迟缓。pid_autotune.py 内置了自动整定功能（Autotune）：系统先让温度做受控振荡，测量极限增益Ku和振荡周期Pu，再按经典公式自动计算 P/I/D。

它内置了 8 种整定规则，包括ziegler-nichols、tyreus-luyben，甚至还有专门针对酿造场景的brewing规则（偏保守、响应慢但平稳）。整定完成后参数会自动写入pidparams.txt，直接复制进配置即可。

八、新手如何选择合适的温控算法？

• 第一次使用：选迟滞（Hysteresis），ON=-0.5、OFF=+0.5，简单可靠
• 快速升温阶段：用过冲，把 Overshoot 设为 2~5
• 长时间恒温（糖化、发酵温控）：选 PID，先跑一次自动整定，再手动微调

三种算法都运行在 Flask-SocketIO 后台任务中，界面上一键切换 AUTO 按钮即可启停。理解这套温控算法源码，你不仅能用好 CraftBeerPi，也能把相同思路移植到自己的自酿设备项目中。

更多配置说明可参考项目配置文件 config.yaml 与官方接口文档 swagger_2_1.yaml。

【免费下载链接】craftbeerpiBrew Controller项目地址: https://gitcode.com/gh_mirrors/cr/craftbeerpi