夜雨聆风
别再被原厂APP绑架了!手把手教你用 ESP32 把家里热泵接入 Home Assistant
说起家里的空气源热泵（DHW Heat Pump），很多小伙伴肯定是一肚子苦水。厂家自带的那个控制面板，操作起来像上个世纪的产物不说，想连个手机还得买它那个死贵死贵的网关（比如那个 Cozytouch），关键是数据还不给本地化，非得绕到云端转一圈。
万一哪天厂家服务器宕机，或者干脆倒闭了，这智能设备不就变砖了吗？
今天我就要给各位极客和折腾党安利一个神仙项目：AquaMQTT。这玩意儿简直是热泵界的“黑客帝国”，能让你彻底接管家里的热水器。
到底什么是 AquaMQTT？
简单来说，这是一个基于 ESP32 的开源方案。它的核心逻辑非常“暴力”且有效：它直接潜伏在热泵的“大脑”（主控制器）和“嘴巴”（HMI 显示面板）之间。
大家都知道，热泵内部其实一直在跑串口通信。AquaMQTT 就像一个翻译官，把这些晦涩的串口数据截获下来，转化成我们熟悉的 MQTT 协议。这样一来，不管是水温、运行状态，还是能耗数据，都能丝滑地接入你的 Home Assistant 或者 Node-RED 里。
它能干啥？（这才是重点！）
-
1. 全方位监控：水温多少度？压缩机有没有在转？电加热开了没？看一眼手机全知道。 -
2. 暴力接管控制：不只是看，你还能直接改！想调高水温、切换模式（比如改成 Eco 模式），直接在 Home Assistant 里点一下就行，反应比原厂面板快多了。 -
3. 光伏联动（羊毛薅起来）：这是我最喜欢的点。如果你家里装了光伏，你可以写个自动化：当太阳能发电过剩时，自动让热泵开启“高能模式”把水烧热。这不就是变相的“热能电池”吗？省下的电费可都是真金白银。 -
4. 完全本地化：不需要外网，不需要厂家服务器。哪怕你把家里网线拔了，只要局域网还在，控制就断不了。
兼容哪些设备？
这个项目最初是针对 Windhager AquaWin Air3 开发的，但后来大家发现，其实很多欧洲大牌（比如 Groupe Atlantic 旗下的）用的都是同一套通讯逻辑。
目前社区验证过的品牌包括但不限于：
-
• Atlantic (Explorer, Calypso 系列) -
• Austria Email Explorer -
• Panasonic DHW270 -
• Thermor Aeromax -
• …基本上只要是长得像、协议通的，都能搞定。
两种骚操作模式：监听 vs 拦截
AquaMQTT 提供两种玩法，大家可以根据自己的胆量（和技术水平）来选：
-
• 监听模式 (Listener)：这就是个“旁听生”。它只看不说话，把数据传给 MQTT。好处是绝对安全，坏处是你没法通过它去改设置。 -
• 中间人模式 (Man-in-the-Middle)：这就是完全体了。它坐在主板和面板中间，面板发出的指令它能拦截并修改。你想让热泵以为面板下达了“烧水”指令？没问题，它能伪造。
硬件怎么搞？
如果你是个焊接大佬，可以自己照着电路图撸。但说实话，现在的 Revision 2.0 版本为了稳定性，用了很多 SMD 贴片元件（比如 SN74LVC2T45 逻辑电平转换芯片），手焊真的挺考验眼力的。
我建议直接拿项目里的 Gerber 文件去打样（比如嘉立创或者 JLCPCB），甚至可以直接选贴片服务。核心大脑用的是 Arduino Nano ESP32（或者便宜点的 ESP32-S3 开发板也行）。
接线提醒： 拆机前一定要断电！一定要断电！一定要断电！热泵内部的接线通常有四根：5V 电源、GND、还有白色的信号线。AquaMQTT 就是要“切断”这根信号线，把自己插进去。
软件安装其实很简单
别被代码吓到了，其实就三步：
-
1. 下载代码，用 PlatformIO 打开。 -
2. 改一下 ExampleConfiguration.h里的 WiFi 名字、密码和你的 MQTT 服务器 IP。 -
3. 插上 USB，点一下上传。
如果你以后想更新固件，它还支持 OTA（空中升级），连机器都不用拆，坐在沙发上点点鼠标就升级了。
避坑指南
-
• 保修问题：丑话说在前头，拆机改线路肯定会影响原厂保修。如果你家热泵刚买不到一个月，建议三思。 -
• 安全性：这个协议是开发者们一点点反向工程出来的。虽然目前很稳，但折腾的时候还是得细心点，接线千万别接反了。 -
• 离线时钟：如果你担心断网后时间乱掉，板子上还预留了 DS3231 实时时钟的位置，可以选配。
总的来说，AquaMQTT 是目前我见过的最硬核、也最实用的热泵改造方案。它把控制权从厂家手里夺了回来，交还给了用户。如果你也想让家里的热水器变得真正“智能”，不妨试试这个项目。
项目地址：https://github.com/tspopp/AquaMQTT
