Sungrow SG String Inverters

Purpose

The purpose of this plugin is to collect data from Sungrow SG String Inverters.

Usage

This plugin reads the data from Sungrow SG String Inverters via Ethernet TCP. This plugin relies on the Modbus Ardexa plugin, and reads from the following Sungrow String Inverter models:

SG30KTL-M, SG30KTL-M-V31, SG33KTL-M, SG36KTL-M, SG33K3J, SG49K5J, SG34KJ, LP_P34KSG,
SG50KTL-M-20, SG60KTL, G80KTL, 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, SG33CX, SG40CX, SG50CX, SG110CX, SG250HX, SG30CX,SG33CX-US,
SG55CX-US,SG250HX-US, SG30KTL, SG10KTL, SG12KTL, SG15KTL, SG20KTL, SG30KU, SG36KTL, 
SG36KU, SG40KTL, SG40KTL-M, SG50KTL-M, SG60KTL-M, SG60KU

It uses the Modbus Specification, and collects from IP connected inverters, using TCP protocol. It will be run every 5 minutes, by default. Inverter data will be collected to the solar table. The inverter will be interrogated for the following data. Due to a software bug in the Sungrow inverter, ALL values where AC Power > 100 MegaWatts will be invalidated (ie; not sent to the cloud)

Variable                Units
=============================
Daily Energy            Wh
Total Energy            Wh
Total Hours             h
Temperature             °C
DC Voltage 1            V
DC Current 1            A
DC Voltage 2            V
DC Current 2            A
DC Voltage 3            V
DC Current 3            A
DC Voltage 4            V
DC Current 4            A
DC Voltage 5            V
DC Current 5            A
DC Voltage 6            V
DC Current 6            A
DC Voltage 7            V
DC Current 7            A
DC Voltage 8            V
DC Current 8            A
DC Voltage 9            V
DC Current 9            A
DC Voltage 10           V
DC Current 10           A
DC Voltage 11           V
DC Current 11           A
DC Voltage 12           V
DC Current 12           A
DC Power                W
AC Voltage 1-2          V
AC Voltage 2-3          V
AC Voltage 3-1          V
AC Current 1            A
AC Current 2            A
AC Current 3            A
AC Power                W
AC Reactive Power       var
Cos Phi
Grid Freq               Hz
Status
Fault State 1
Array insulation resistance kOhms
Work State 1

These following values will be collected to the strings table, only from the files that do not inverter_only in the name:

Variable                Units
=============================
DC Current 1            A
DC Current 2            A
DC Current 3            A
DC Current 4            A
DC Current 5            A
DC Current 6            A
DC Current 7            A
DC Current 8            A
DC Current 9            A
DC Current 10           A
DC Current 11           A
DC Current 12           A
DC Current 13           A
DC Current 14           A
DC Current 15           A
DC Current 16           A
DC Current 17           A
DC Current 18           A
DC Current 19           A
DC Current 20           A
DC Current 21           A
DC Current 22           A
DC Current 23           A
DC Current 24           A

There are 2 files associated with this plugin, namely sungrow_sg_strings.txt and sungrow_sg_strings_encapsulated.txt. The sungrow_sg_strings.txt file will work directly on TCP or RS485 (RTU) connected devices. The sungrow_sg_strings_encapsulated*.txt file can be used where an RTU device is tunneled through a TCP gateway. This file uses the -m enc argument, and it will NOT work on RS485/RTU connected devices.

Arguments

Arguments are as follows:

• endpoint. This is either a serial device like /dev/ttyS0 or an IP or DNS like 192.168.1.15

• bus_addresses. An RS485 address in the range 2-63. This can be a hyphenated list like 3-10 or a list like 2,5,7,9

• --port. This is an optional parameter used in an Ethernet gateway, and is the TCP port used for the gateway. Default is 502

• --attempts. This is an optional parameter, and determines how many times to times to attempt to read an inverter value. Default is 1

• --delay. This is the delay in seconds between inverter send and receive commands, AND if attempts > 1. Fractions like 0.3 can be used. Default is 0.05