SunGather

Collect data from Sungrow Inverters using ModbusTcpClient, SungrowModbusTcpClient or SungrowModbusWebClient and export to various locations.

Report Bug · Request Feature

About The Project

Access ModBus data from almost any network connected Sungow Inverter.

On first connection the tool will query your inverter, retrieve 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 multiple export locations out of the box:

• Console - Log directly to screen
• MQTT - Load into MQTT, and optionally Home Assistance Discovery
• PVOutput - Load into PVOutput.org
• Simple webserver showing collected data
• and more coming....

I have borrowed HEAVILY from the following projects, THANK YOU

• solariot
• modbus4mqtt
• ModbusTCP2MQTT

(back to top)

TO DO

• Better Home Assistant Support
• Prometheus / Grafana support

Updates

0.1.1

• Added docker image
• Added simple http web server
• Improved recovery when errors (See: SungrowModbusWebClient 0.2.6)

0.1.0 Initial build

Built With

• Python3

Requires

• paho-mqtt>=1.5.1
• pymodbus>=2.4.0
• SungrowModbusTcpClient>=0.1.6
• SungrowModbusWebClient>=0.2.6

(back to top)

Getting Started

Local

git clone https://github.com/bohdan-s/SunGather.git
cd SunGather
pip3 install --upgrade -r requirements.txt

Copy config-example.py to config.py, change values as required (see comments in file)

copy config-example.py config.py

Run SunGather:

python3 sungather.py

Docker

docker pull bohdans/sungather
docker run -v {path to}/config.yaml:/config/config.yaml -e TZ=Australia/Sydney --name sungather bohdans/sungather

or if using the http export

docker run -v {path to}/config.yaml:/config/config.yaml -e TZ=Australia/Sydney -p 8080:8080 --name sungather bohdans/sungather

Note: replace Australia/Sydney with relevant timezone

(back to top)

Usage

See config-example.py it contains default options and comments.

If you want to use the new Energy section in Home Assistant, follow the Home Assistant setup below.

(back to top)

Commandline Arguments

usage: python3 sungather.py [options]

Commandline arguments override any config file settings
-c config.yaml - Specify config file.
-v 30 - Logging Level, 10 = Debug, 20 = Info, 30 = Warning (default), 40 = Error
--runonce - Run once then exit
-h - print this help message and exit (also --help)

Example:

python3 sungather.py -c /full/path/config.yaml

Exports

A collection of exports are available:

• console: Output information to console, useful for troubleshooting
• http: Output to a simple website, default http://localhost:8080 or http://<serverip>:8080
• mqtt: Output to a pre-existing MQTT server, needed for Home Assistant integration
• pvoutput: Output to PVOutput.org, requires account and solar is set up on website first.

Registers

This tool should be able to access most registers exposed. Set the following in config.yaml under inverters section.

• level: 1 - This is the most useful data for day to day

• Level: 2 - This should be everything your inverter supports

• Level: 3 - This will try every register, you will get lots of 0/65535 responses for registers not supported.

• smart_meter: True - Set to true if you have a smart reader installed, this will return power usage at the meter box, without it you can not calculate house power usage.

Useful Registers:

This is just a brief list of registers I have found useful

daily_power_yields - Total Power in kWh generated today
total_power_yields - Total Power in kWh generated since inverter install
total_running_time - Total Hours inverter has been powered on since install
internal_temperature - Internal temperature of the Inverter
total_active_power - Current power being generated by the inverter in Watts
meter_power - Power usage at the meter box, needs a smart meter installed. +ve means consuming from the grid, -ve means exporting to the grid
load_power - Power being consumed in total
export_to_grid - How much being currently exported to the grid. This is calculated from meter_power if -ve value, returned as a positive value
import_from_grid - How much being currently imported from grid. This is calculated from meter_power if +ve value
timestamp - Last time data was collected, based on Inverters clock by default

(back to top)

Home Assistant setup

In the SunGather config.yaml you need to set the smart_meter if you have one;

smart_meter: True

HA sensors created by the MQTT auto-discovery;

sensor.inverter_active_power
sensor.inverter_daily_generation
sensor.inverter_export_to_grid
sensor.inverter_import_from_grid
sensor.inverter_load_power
sensor.inverter_meter_power

Put the following into your sensors.yaml

sensor:
  - platform: integration
    source: sensor.inverter_active_power
  - platform: integration
    source: sensor.inverter_export_to_grid
  - platform: integration
    source: sensor.inverter_import_from_grid

The additional sensors then setup in HA are the following with Wh unit of measurement for the Energy platform.

sensor.sensor_inverter_active_power_integral
sensor.sensor_inverter_export_to_grid_integral
sensor.sensor_inverter_import_from_grid_integral

You need to utilise the customize.yaml manual method to get some friendly names and icons. Add the following;

sensor.sensor_inverter_active_power_integral:
  icon: mdi:solar-power
  friendly_name: Solar Generation
sensor.sensor_inverter_export_to_grid_integral:
  icon: mdi:transmission-tower-export
  friendly_name: Grid Export
sensor.sensor_inverter_import_from_grid_integral:
  icon: mdi:transmission-tower-import
  friendly_name: Grid Import

Restart Home Assistant for the sensors.yaml and customize.yaml to be loaded. Make sure SunGather is running, wait 5 minutes for initial data to populate. Navigate to the Energy platform (Configuration > Energy). Add these sensors to the following areas:

Electricity Grid > Grid Import - sensor.sensor_inverter_import_from_grid_integral
Electricity Grid > Grid Export - sensor.sensor_inverter_export_to_grid_integral
Solar Panels > Solar Production - sensor.sensor_inverter_active_power_integral

(back to top)

Tested

• SG7.0RT with WiNet-S Dongle
• SG10RT with WiNet-S Dongle and Ethernet (Credit: @rark-ha)

(back to top)

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

(back to top)

License

Distributed under the GPL3 License. See LICENSE.txt for more information.

(back to top)

Contact

Project Link: https://github.com/bohdan-s/SungrowModbusWebClient

(back to top)

Acknowledgments

• solariot
• modbus4mqtt
• ModbusTCP2MQTT

(back to top)