lumapu/ahoy

Various tools, examples, and documentation for communicating with Hoymiles microinverters

C++

1,017

2,538 commits

updated Aug 12, 2025

See the code

README

CC BY-NC-SA 4.0 Ahoy Build Ahoy Dev Build

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

CC BY-NC-SA 4.0

🖐 Ahoy!

Logo

This repository provides hardware and software solutions for communicating with Hoymiles inverters via radio. Our system allows you to easily obtain real-time values, such as power, current, and daily energy, as well as set parameters like the power limit of your inverter to achieve zero export. You can access these functionalities through our user-friendly web interface, MQTT, or JSON. Our solutions simplify the process of monitoring and fine-tuning your solar panel system to help you achieve your goals.

Changelog

latest Release

Development Version

Table of approaches:

BoardMIHMHMS/HMTcommentHowTo start
ESP32, C++✔️✔️✔️create your own DTU
ESP8266, C++✔️✔️❌⚠️ not recommended for new DTU

⚠️ Warning: HMS-XXXXW-2T WiFi inverters are not supported. They have a 'W' in their name and a DTU serial number on its sticker

Getting Started

  1. Guide how to start with a ESP module

  2. ESP Webinstaller (Edge / Chrome Browser only)

  3. Ahoy Configuration

Our Website

https://ahoydtu.de

Firmware Archive https://fw.ahoydtu.de

Success Stories

Support, Feedback, Information and Discussion

Development

If you encounter any problems, use the issue tracker on Github. Provide a detailed description of the issue and consider if it is related to our software. This will help us provide effective solutions.

Contributors are always welcome!

  • OpenDTU <- Our sister project ✨ for Hoymiles HM- and HMS-/HMT-series (for ESP32 only!)
  • hms-mqtt-publisher <- a project which can handle WiFi inverters like HMS-XXXXW-2T
arduino
asyncwebserver
cmt2300
esp32
esp8266
hoymiles
mqtt
nrf24
pv

lumapu/ahoy

Various tools, examples, and documentation for communicating with Hoymiles microinverters

C++

1,017

2,538 commits

updated Aug 12, 2025

See the code

README

CC BY-NC-SA 4.0 Ahoy Build Ahoy Dev Build

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

CC BY-NC-SA 4.0

🖐 Ahoy!

Logo

This repository provides hardware and software solutions for communicating with Hoymiles inverters via radio. Our system allows you to easily obtain real-time values, such as power, current, and daily energy, as well as set parameters like the power limit of your inverter to achieve zero export. You can access these functionalities through our user-friendly web interface, MQTT, or JSON. Our solutions simplify the process of monitoring and fine-tuning your solar panel system to help you achieve your goals.

Changelog

latest Release

Development Version

Table of approaches:

BoardMIHMHMS/HMTcommentHowTo start
ESP32, C++✔️✔️✔️create your own DTU
ESP8266, C++✔️✔️❌⚠️ not recommended for new DTU

⚠️ Warning: HMS-XXXXW-2T WiFi inverters are not supported. They have a 'W' in their name and a DTU serial number on its sticker

Getting Started

  1. Guide how to start with a ESP module

  2. ESP Webinstaller (Edge / Chrome Browser only)

  3. Ahoy Configuration

Our Website

https://ahoydtu.de

Firmware Archive https://fw.ahoydtu.de

Success Stories

Support, Feedback, Information and Discussion

Development

If you encounter any problems, use the issue tracker on Github. Provide a detailed description of the issue and consider if it is related to our software. This will help us provide effective solutions.

Contributors are always welcome!

  • OpenDTU <- Our sister project ✨ for Hoymiles HM- and HMS-/HMT-series (for ESP32 only!)
  • hms-mqtt-publisher <- a project which can handle WiFi inverters like HMS-XXXXW-2T
arduino
asyncwebserver
cmt2300
esp32
esp8266
hoymiles
mqtt
nrf24
pv

Significant stargazers

Steffen Deusch

179 followers · starred Oct 2022

woheller69

663 followers · starred Mar 2023

Ondřej Nový

47 followers · starred Jul 2025

Alex Kirk

222 followers · starred Feb 2023