Important Info

Addon is in maintenance mode. This is FOSS (Free Open Source Software) and based on reverse engineering so it could not work always as expected. What is more due to techical dept present implementation loose possibility to add new features. This mean that it required rewriting from scratch. Without support from community it is not predicted soon.

Br, Cosik.

HoyMiles Solar Data Gateway Add-on

Application to read Hoymiles Gateway Solar Data using unofficial API

I developed this program to integrate my solar system data to Home Assistant Application through an add-on.

Now, Cosik is helping too.

Donate Cosik ->

Instructions

Home Assistant add-on instructions

There is three apps versions that you can choice.

1 - The Old Stable Version

2 - The Edge Version

3 - The Stable Version

My solar panels communicate with the internet using a DTU-W100 gateway.

But it will probably work with any device that uses the global.hoymiles.com Website. It was tested with DTU-PRO also.

Standalone running - short info

You also could use the application without using the Home Assistant. You just need a machine that runs Python3. It based on mqtt messages, so could be send from any device to MQTT Broker.

Before run you need to install: https://github.com/eclipse/paho.mqtt.python and https://github.com/psf/requests

git clone https://github.com/dmslabsbr/hoymiles.git
cd hoymiles
python3 -m venv ./hoymiles/
source ./bin/activate
pip3 install paho-mqtt==1.6.1
pip3 install requests
pip3 install python-dateutil

Configuration:

UI is not working and could show "Bad Gateway" which is normal and expected.

Add-on is desigend to use MQTT messages to send data to Home Assistant instance. By default credentials and server name is taken from Home Assistant. If you use other broker or using your own one it is required to make external and fill server and credentials for connection.

To get it proper working you have also pass credentials for Hoymiles Cloud access and your plant ID.

If evrything is set correctly new MQTT entities will be visible on HA.

Supported devies

So far it is confirmed that addon support Hoymiles devices:

micro inverters
standard inverters
energy meters
bms (with some restrictions) - edge version with details
batteries (with some restrictions) - edge version with details
multiple instalattions - edge version

PS:

I invite everyone to help in the this tool development.

Screenshots

Licence

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

dmslabsbr / hoymiles