Home Inverter Grafana Monitor

A home monitoring solution for your MUST (or other modus-compatible) home inverter.

How to use:

1. Prepare a raspberry PI 4 (or any other single-board computer)
2. Connect a USB-B cable to your Inverter USB port
3. Go root (sudo su)
4. Install docker & docker-compose on it

   curl -fsSL https://get.docker.com -o get-docker.sh
   chmod +x get-docker.sh
   ./get-docker.sh
   pip3 install docker-compose

5. Clone this repo

   git clone https://github.com/desertkun/home-inverter-grafana-monitor.git
   cd home-inverter-grafana-monitor

6. Change INVERTER_MODEL on the compose file according to your model.
7. Go into the repo folder and do docker-compose up -d
8. Give it 20m to install everything and boot
9. Open http://<rasperry-ip>:3000 and login with admin/admin
10. You should be redirected to an empty list of dashboards. Click New -> Import
11. Select this file

Supporter Inverters

• MUST PV1800 must-pv1800
• MUST EP3000 must-ep3000
• MUST PH18-5248 must-ph18-5248

But I have different model

1. Figure out the MODBUS device ID of your model, and the BAUD rate.
2. Look up the datasheet for register IDS that correspond to voltages etc, as specified in monitor.py (see offsets, e.g. 25200 + register ids)
3. Use help/modbus.py script to figure out the register values as they work for you

   help/modbus.py <device id> <baud rate> <register from> <register to>
   # eg, pv1800
   help/modbus.py 4 19200 25200 25275
   # ep3000
   help/modbus.py 10 9600 30000 30025
   

4. Modify monitor.py to support your INVERTER_MODEL, deploy as usual. Change INVERTER_MODEL in the compose file.
5. Open a Pul Request so others can benefit from your work.

I want notifications when power goes out

1. Create a bot on Telegram using https://t.me/BotFather
2. Create a new group with only you and that bot
3. Copy the group Id
4. Open http://:3000/alerting/notifications
5. Select telegram as type, fill in token and group id, save the contact point. Select Notification policies, Select Default, click Edit, change contact point to Telegram
6. Edit e.g. the Input AC Panel: click Alerts -> Create Alert
7. Change Threshold to BELOW 100.
8. Click SAVE on the Dashboard