KBR Meters

Purpose

The purpose of this plugin is to collect data from KBR Electricity Meters.

Usage

This plugin reads the data from KBR Electricity Meters via serial or TCP. 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 1            V
AC Voltage 2            V
AC Voltage 3            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
Power Factor 1
Power Factor 2
Power Factor 3
Grid Freq               Hz
Total Power             W
Total Reactive Power    var
Total Apparent Power    VA
Daily Energy            Wh
Energy This Month       Wh
Energy Last Month       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.

Last updated