# GE Inverters

### Purpose

The purpose of this plugin is to collect data from GE Solar Inverters.

### Usage

The purpose of this plugin is to collect data from GE Solar Inverters via Modbus. The `GE_LV5.txt` (default) file collects data from GE LV5 Solar Inverters. The plugin uses the Modbus TCP Specification, and collects from TCP connected inverters **only**. Inverter data will be collected to the `solar` table, and will be run every 5 minutes, by default. This plugin relies on the `Modbus Ardexa` plugin. Please be aware that the GE servers may be accessed on Port `503`,instead of the normal Port `502`. Additionally, the inverters will **not always** have all 16 string currents connected, so there are some additional config files with different amounts of string currents.

Also note that GE have a unique way of handling negative numbers in 16 bit integers. Rather than using 1 or 2's complement, they use the `Signed Magnitude Method` as discussed in: <https://www.geeksforgeeks.org/representation-of-negative-binary-numbers/>. This is handled by this plugin, to show negative numbers. The following inverter data will be collected to the `solar` table:

```
Variable                	  	Units
=====================================
Daily Energy                    Wh
Total Energy                    Wh
Total Hours                     h
AC Power                        W
DC Power                        W
AC Current 1                    A
AC Current 2                    A
AC Current 3                    A
AC Voltage 12                   V
AC Voltage 23                   V
AC Voltage 31                   V
Grid Freq                       Hz
Isolation Resistance            Mohm
Heatsink Temp                   °C
Cooling Water Temp              °C
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
Fault 1
Fault 2
Fault 3
Fault 4
Warning 1
Warning 2
Warning 3
Status 1
Status 2
Status 3
Apparent Power                  VA
PE Cubicle Temp                 °C
Line Inductor Temp              °C
```

### Arguments

Arguments are as follows:

* `endpoint`. This is either an IP address like `192.168.1.15`
* `bus_addresses`. The bus address of the inverter(s)
* `--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`