EG4 Web API and Home Assistant

twistedroutes · 2025-03-14T19:58:00Z

There are a few projects out there that connect directly with your inverter to get some data. Someone over on DIYSolarForums asked if there was an API for the web. There's only a B2B API at the moment, so I decided to write a Python wrapper for people to be able to query their inverter and battery data vis the web (Monitor.eg4...). Then I decided to use that to try to create my first Home Assistant integration/Custom Component. Note that I only have access to a single 12000XP so YMMV! .... ok so the first attempt at custom integration has started...Feel free to try it outhe api froInverter Runtume Inverter Energy Inverter Battery Data Inverter Battery Unit Data Inverter Read Func, Hold and Bit Parameters Inverter Write Hold Parameters ToDo: Inverter Write Func and Bit Parameters Obtain Value Limits for write functions Build some example dashboards Add Home Assistant ability to change values I've got to write up some tests validate the data scaling (e.g. where EG4 provide 5100 to represent 51.00 V), create a few more virtual sensors (a sensor made from other sensors data, like capacity in KWh = voltage and capacity in amp-hours). Then add some switches and inputs to change data Then add an example dashboard (though this data can already be used in the Energy dashboard) This can be loaded into your .homeassistant/custom_components (or wherever your custom_components folder is). I dunno... whatever I figure I need at the time.

Main Thread

Last Post by DougL 6 hours ago

18 Posts

8 Users

4 Reactions

1,835 Views

RSS

weertske

(@weertske)

Active Member

Joined: 10 months ago

Posts: 12

November 4, 2025 4:47 am

@dougl I connected PPG to my 18kPV inverter and started reading the data (in ugly format) on Home Assistant. (I'll work on that later.) However, I also have a GridBoss on my system and when I started polling with the Python Protocol Gateway I had a Para Sync Loss event. Do you have any paralleled devices (Inverter or GridBOSS) and have you had this event occur? I shut down polling and disconnected and reconnected one of my parallel cables and the system resynced. I have not tried to reconnect since then. Looking for guidance.

ReplyQuote

weertske

(@weertske)

Active Member

Joined: 10 months ago

Posts: 12

November 4, 2025 4:49 am

@EG4 Eric Please review my comment to Doug and let me know if you have any insight.

Posted by: @weertske

↑

@dougl I connected PPG to my 18kPV inverter and started reading the data (in ugly format) on Home Assistant. (I'll work on that later.) However, I also have a GridBoss on my system and when I started polling with the Python Protocol Gateway I had a Para Sync Loss event. Do you have any paralleled devices (Inverter or GridBOSS) and have you had this event occur? I shut down polling and disconnected and reconnected one of my parallel cables and the system resynced. I have not tried to reconnect since then. Looking for guidance.

ReplyQuote

DougL

(@dougl)

Trusted Member

Joined: 10 months ago

Posts: 70

November 4, 2025 4:57 am

@weertske I do not have any parallel devices, just the 18KPV so maybe EG4 is using that rs485 port for parallel comms and there's too much traffic on the bus.

I've left the default refresh rate for PPG which is far faster than the 3 minute update rate of the WiFi dongle. Speaking of such, that might be an option, ie remove the WiFi dongle and use that RS485 port. If you need remote control then you could swap the WiFi dongle back in momentarily. Or you can try slowing down the refresh rate of PPG.

ReplyQuote

Stay Connected

Quick Links