Gavazzi EM24 Meters

Purpose

The purpose of this plugin is to collect data from Carlo Gavazzi EM24_E1 Meters.

Usage

This plugin reads the data from Carlo Gavazzi EM24_E1 Meters via serial or TCP (See: https://gavazziautomation.com/images/PIM/MANUALS/ENG/EM24_E1_IM_USE.pdf). Meter data will be collected to the meter table. By default, it will collect data every 5 minutes, but can collect at a minimum rate of about 0.3 seconds via TCP. The plugin will make 1 attempt (by default) to read the meter. This plugin relies on the Modbus Ardexa plugin. The following data will be collected:

Variable                    Units
=================================
AC Voltage L1-N             V
AC Voltage L2-N             V
AC Voltage L3-N             V
AC Voltage L1-L2            V
AC Voltage L2-L3            V
AC Voltage L3-L1            V
AC Current 1                A
AC Current 2                A
AC Current 3                A
AC Power 1                  W
AC Power 2                  W
AC Power 3                  W
Apparent Power 1            VA
Apparent Power 2            VA
Apparent Power 3            VA
Reactive Power 1            VAR
Reactive Power 2            VAR
Reactive Power 3            VAR
AC Voltage L-N              V
AC Voltage L-L              V
AC Power                    W
Apparent Power              VA
Reactive Power              VAR
Power Factor 1
Power Factor 2
Power Factor 3
Power Factor
Grid Freq                   Hz
Imported Energy             Wh
Imported Energy Phase 1     Wh
Imported Energy Phase 2     Wh
Imported Energy Phase 3     Wh
Exported Energy             Wh

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. A Modbus address in the range 2-255. 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

• --stop_on_any_command_fail. If this is specified, then any Modbus commands that fail will stop all further queries for all bus addresses and attempts.

• --serial_lock. If this is set, the program can only be run one at a time (so as not to overload a Modbus device). If the device being queried is a serial device, this will automatically be set to "on". For IP addresses it is optional.

• --sampling_rate. If this is defined, and the sampling rate is greater than 1, then all values listed above will be collected as an average. In other words; it will take a sample at the nominated frequency. After X samples defined by sampling_rate, a record will be written and sent to the cloud.