SunGather
Collect data from Sungrow Inverters using ModbusTcpClient, SungrowModbusTcpClient or SungrowModbusWebClient and export to various locations.
About The Project
Access ModBus data from almost any network connected Sungow Inverter.
On first connection the tool will query your inverter, retreive the model and return the correct registers for your device. No more searching registers or creating model files.
Register information based on official documentation: Communication Protocol of PV Grid-Connected String Inverters and Communication Protocol of Residential Hybrid Inverters
Has muliple export locations out of the box:
- Console – Log directly to screen
- MQQT – Load into MQTT, and optionally Home Assistance Discovery
- PVOutput – Load into PVOutput.org
- and more coming….
I have borrowed HEAVILY from the following projects, THANK YOU
TO BO
- Commandline Arguments
- Docker
- Better Home Assistant Support
Built With
Requires
Getting Started
git clone https://github.com/bohdan-s/SunGather.git
Copy config-example.py to config.py, change values as required (see comments in file)
python3 sungather.py
Usage
See config-exmaple.py it contains default options and comments.
If you want to use the new Energy section in Home Assistant, add the following sensors to convert from Power to Energy:
sensor:
- platform: integration
source: sensor.inverter_active_power
- platform: integration
source: sensor.inverter_export_to_grid
- platform: integration
source: sensor.inverter_import_from_grid
Tested
- SG7.0RT with WiNet-S Dongle
Supported
PV Grid-Connected String Inverters
SG30KTL, SG10KTL, SG12KTL, SG15KTL, SG20KTL, SG30KU, SG36KTL, SG36KU, SG40KTL, SG40KTL-M, SG50KTL-M, SG60KTL-M, SG60KU, SG30KTL-M, SG30KTL-M-V31, SG33KTL-M, SG36KTL-M, SG33K3J, SG49K5J, SG34KJ, LP_P34KSG, SG50KTL-M-20, SG60KTL, SG80KTL, SG80KTL-20, SG60KU-M, SG5KTL-MT, SG6KTL-MT, SG8KTL-M, SG10KTL-M, SG10KTL-MT, SG12KTL-M, SG15KTL-M, SG17KTL-M, SG20KTL-M, SG80KTL-M, SG111HV, SG125HV, SG125HV-20, SG30CX, SG33CX, SG36CX-US, SG40CX, SG50CX, SG60CX-US, SG110CX, SG250HX, SG250HX-US, SG100CX, SG100CX-JP, SG250HX-IN, SG25CX-SA, SG75CX, SG3.0RT, SG4.0RT, SG5.0RT, SG6.0RT, SG7.0RT, SG8.0RT, SG10RT, SG12RT, SG15RT, SG17RT, SG20RT
Residential Hybrid Inverters
SH5K-20, SH3K6, SH4K6, SH5K-V13, SH5K-30, SH3K6-30, SH4K6-30, SH5.0RS, SH3.6RS, SH4.6RS, SH6.0RS, SH10RT, SH8.0RT, SH6.0RT, SH5.0RT
License
Distributed under the GPL3 License. See LICENSE.txt
for more information.
Contact
Project Link: https://github.com/bohdan-s/SungrowModbusWebClient