This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
A personal fork of AhoyDTU tuned for one specific setup: an ESP8266 DTU feeding a Hoymiles micro-inverter's data into Home Assistant over MQTT, on an AVM FRITZ! Mesh network. Upstream AhoyDTU is a general-purpose project supporting many boards; this fork narrows the focus to keep that one path rock-solid.
Based on lumapu/ahoy and licensed under CC BY-NC-SA 4.0. All credit for the original work goes to the AhoyDTU project and its contributors. This fork only repoints links/docs to its own repo and hardens the ESP8266 + Home Assistant path.
- ESP8266 WiFi self-healing for FRITZ! Mesh: link-loss backstop watchdog, mesh-aware BSSID handling, no reliance on a nightly reboot (since v0.8.157). See src/CHANGES.md.
- MQTT WiFi diagnostics (
wifi_reconnects,wifi_disc_reason) for monitoring stability in Home Assistant. - Fork-hosted releases & update-check — the web UI checks
JustChr/ahoyfor new versions and the Downloads link points at this repo's Releases. - A documented, reliable flashing procedure for this device — see docs/Updating.md.
This fork builds the esp8266 environment only. For any other board, use upstream AhoyDTU instead.
- Getting Started — hardware, wiring, first boot
- Configuration — radio pins, inverter, MQTT
- Building & updating the firmware
- Home Assistant integration
- MQTT & REST API
| Board | MI | HM | HMS/HMT | comment |
|---|---|---|---|---|
| ESP8266 + nRF24L01+, C++ | ✔️ | ✔️ | ❌ | the board this fork targets |
See ROADMAP.md for planned Home Assistant and ESP8266 stability work.
Use this repo's issue tracker. For the wider community and the original project, see upstream AhoyDTU and its Discord.
- OpenDTU — sister project for Hoymiles HM- and HMS-/HMT-series (ESP32 only).
- hms-mqtt-publisher — for WiFi inverters like HMS-XXXXW-2T.