Landis Gyr Meter

Plugin to read from Landis+Gyr meters via Modbus.

Purpose

The purpose of this plugin is to collect data from Landis+Gyr Meters via Modbus.

Usage

This plugin collects from the Landis+Gyr Meters. It uses the Modbus TCP Specification, and collects from Serial or IP connected meters, though these meters are usually only conencted via TCP. Meter data will be collected to the meter table, and will be run every 5 minutes, by default. This plugin relies on the Modbus Ardexa plugin. Landis+Gyr meters often have a main meter and a redundant meter defined on the same register map, which is how it is configured in landis_gyr_modbus_config.txt. The meters are connected through Serial to TCP RTUs, and have a programmable register map. The following data points are collected:

Variable Name			Units
======================================
AC Power			W	
Reactive Power			var
AC Voltage L1-N			V	
AC Voltage L2-N			V	
AC Voltage L3-N			V	
Angle I1-L1			°	
Power Factor						
AC Current 1			A	
AC Current 2			A	
AC Current 3			A	
Angle L2-L1			°	
Grid Freq			Hz	
Angle L3-L1			°	
Angle I2-L1			°	
Angle I3-L1			°	
Imported Energy			Wh	
Exported Energy			Wh	
React Induct Imported Energy	varh
React Capac Imported Energy     varh
React Induct Exported Energy	varh
React Capac Exported Energy	varh

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.