# Solivia Inverters

### Purpose

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

### Usage

This plugin reads data from Solivia Inverters, via serial or TCP. Inverter data will be collected to the `solar` table. By default, it will collect data every 5 minutes, but can collect at a minimum rate of `30 seconds`. The plugin will make an attempt of (by default) `3` times to read an inverter, with a default sleep time `0.2` seconds between each read. See the Ardexa documentation instructions for connecting Solivia Inverters via serial line. The following variables will be collected. Please note that `AC Power` is the addition of `AC Power 1`+`AC Power 2`+`AC Power 3`, since `AC Power` is not collected natively by Solivia inverters.

```
AC Current 1                (decimal:A)
AC Current 2                (decimal:A)
AC Current 3                (decimal:A)
AC Voltage 1                (decimal:V)
AC Voltage 2                (decimal:V)
AC Voltage 3                (decimal:V)
AC Power 1                  (decimal:W)
AC Power 2                  (decimal:W)
AC Power 3                  (decimal:W)
Reactive Power 1            (decimal:var)
Reactive Power 2            (decimal:var)
Reactive Power 3            (decimal:var)
AC Power                    (decimal:W)
Grid Freq                   (decimal:Hz)
Ambient Temperature         (decimal:°C)
Heatsink Temp               (decimal:°C)
Total Energy                (decimal:Wh)
DC Current 1                (decimal:A)
DC Current 2                (decimal:A)
DC Current 3                (decimal:A)
DC Voltage 1                (decimal:V)
DC Voltage 2                (decimal:V)
DC Voltage 3                (decimal:V)
DC Power 1                  (decimal:W)
DC Power 2                  (decimal:W)
DC Power 3                  (decimal:W)
Operating Time              (decimal:h)
Status 1                    (keyword:)
Status 2                    (keyword:)
Status 3                    (keyword:)
Status 4                    (keyword:)  
Isolation Resistance Plus   (decimal:Mohm)
Isolation Resistance Minus  (decimal:Mohm)
```

### Model Numbers

Only the following Solivia inverter models will be collected:

```
SOLIVIA 2.0 EU G4 TR
SOLIVIA 2.5 EU G4 TR
SOLIVIA 3.0 EU G4 TR
SOLIVIA 3.3 EU G4 TR
SOLIVIA 3.6 EU G4 TR
SOLIVIA 4.4 EU G4 TR
SOLIVIA 5.0 EU G4 TR
SOLIVIA 10 EU G4 TR (EVR)
SOLIVIA 11 EU G4 TR
SOLIVIA11 EU G4 TR (EVR)
SOLIVIA3.0 NAG4TL
SOLIVIA3.8 NAG4TL
SOLIVIA5.0 NAG4TL
SOLIVIA7.6 NAG4TL
SOLIVIA5.2 NAG4TL
SOLIVIA6.6 NAG4TL
DELTA 20 TL
DELTA 15 TL
DELTA 28 TL
DELTA 24 TL
```

### 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 `4001`
* `--baud`. This is an optional parameter used to detail the serial baud rate. Default is `19200`
* `--attempts`. This is an optional parameter, and determines how many times to times to attempt to read an inverter value. Default is `3`
* `--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.2`