lumapu / ahoy

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

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

🖐 Ahoy!

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:

Board	MI	HM	HMS/HMT	comment	HowTo 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

• Getting the data into influxDB and visualize them in a Grafana Dashboard (thx @Carl)

Support, Feedback, Information and Discussion

• Discord Server (~ 7.300 Users)
• The root of development

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!

Related Projects

• 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