MMM-Hoymiles

MagicMirror module for Hoymiles Wifi inverter info

• This module shows current data for Hoymiles Wifi inverter with the help of the hoymiles-wifi python lib
• Project is based on https://github.com/ulrichwisser/MMM-HTMLSnippet
• The Inverter Data is fetched with https://github.com/suaveolent/hoymiles-wifi
• Whenever the widget refreshes, the flask server will call the python script which will render a html with the current data from holymiles-wifi
• THERE IS A SECOND BRANCH "mongodb-history" which tracks data and uses them to handle response when inverter is offline

Project Status

This module is still under development.
It might not work, can show incorrect results, will lack some counters, etc.

Test environment:

• Micro Inverter: Hoymiles HMS-800W-2T and HMS-400W-2T with 2 panels connected
• MagicMirror version: 2.30.0-develop
• Raspberry Pi 4 Model B Rev 1.5 & Raspberry Pi 5
• Raspbian GNU/Linux 12 (bookworm)

TODO:

• get rid of external shell script
• change pv_data to dtu date for combined output of inverter
• add config options for DTU IP, PV-Power Range, Positioning, Size, Colors...
• save last response into local file
• save max power and use it as 'threshold'
• add template if inverter is offline (currently only displays a text)

Installation

Installation can be done using the original repository or the develop repository.

Main master repository:

Clone the repository:

cd ~/MagicMirror/modules/
git clone https://github.com/schris88/MMM-Hoymiles-Wifi

Make HoymilesWifi.sh executable:

chmod +x ~/MagicMirror/modules/MMM-Hoymiles-Wifi/HoymilesWifi.sh

Main develop repository (to be used with caution):

Clone the repository:

cd ~/MagicMirror/modules/
git clone https://github.com/evroom/MMM-Hoymiles-Wifi

Make HoymilesWifi.sh executable:

chmod +x ~/MagicMirror/modules/MMM-Hoymiles-Wifi/HoymilesWifi.sh

Config Example

Edit the file ~/MagicMirror/config/config.js to add or modify the module.

{
  module: "MMM-Hoymiles-Wifi",
  position: "top_left",
  config: {
    width: "300px",
    height: "320px",
    updateInterval: 60000, // in milli seconds
    frames : [
      { src: 'http://127.0.0.1:5000' },
    ]
  },
},

Hoymiles Example

Python Requirements

Install all Python requirements:

pip install -r requirements.txt

If you see this error:

error: externally-managed-environment

then try this:

python -m pip install -r requirements.txt --break-system-packages

Enter DTU IP address of DTU

Change directory:

cd ~/MagicMirror/modules/MMM-Hoymiles-Wifi

Use you favorite editor to make the change (here nano).

nano HoymilesWifi.sh

Line to edit:

python hoymiles_data.py --dtu_ip_address <DTU_HOST_IP> --max <MAX PV WATTAGE ex. 800>

Where <DTU_HOST_IP> is the IP address of the DTU.

To turn on testing:

python hoymiles_data.py --dtu_ip_address <DTU_HOST_IP> --test

Start Flask server by running HoymilesWifi.sh or add it to pm2

To start HoymilesWifi.sh manually:

./HoymilesWifi.sh

To add HoymilesWifi.sh to pm2:

pm2 start HoymilesWifi.sh
pm2 save

Various checks

Verify hoymiles-wifi command:

hoymiles-wifi --host <DTU_HOST_IP> identify-inverters

Where <DTU_HOST_IP> is the IP address of the DTU.

When this message is printed, it means that the inverter is turned off (mostly after sunset):

No response or unable to retrieve response for identify-inverters

Check the HoymilesWifi status:

pm2 status
pm2 info HoymilesWifi

Check the HoymilesWifi log:

pm2 logs HoymilesWifi --lines 100

Make a test run, using a test dataset

Use you favorite editor to make the change (here nano).

nano HoymilesWifi.sh

Line to edit (add --test):

python hoymiles_data.py --dtu_ip_address <DTU_HOST_IP> --max <MAX PV WATTAGE ex. 800> --test

Where <DTU_HOST_IP> is the IP address of the DTU.

The test dataset is taken from response_test_data.json. You can edit this file and replace it with your own data, for example using the output of this command: hoymiles-wifi --host <DTU_HOST_IP> get-real-data-new --as-json

Do not forget to remove --test after testing.