hoymiles
hoymiles copied to clipboard
Hoymiles ADD-ON for Home Assistant
![](https://github.com/dmslabsbr/hoymiles/raw/master/img/logo.png)
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.
My solar panels communicate with the internet using a DTU-W100 gateway.
![](https://github.com/dmslabsbr/hoymiles/raw/master/icon.png)
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.
PS:
I invite everyone to help in the this tool development.
Screenshots
![](https://github.com/dmslabsbr/hoymiles/blob/master/img/Hass1.png?raw=true)
![](https://github.com/dmslabsbr/hoymiles/blob/master/img/Hass2.png?raw=true)
![](https://github.com/dmslabsbr/hoymiles/blob/master/img/Hass3.png?raw=true)
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.