Fanox Relay

Purpose

The purpose of this plugin is to collect data from Fanox Protection Relays.

Usage

This plugin collects from Fanox Protection Relays via serial or TCP. Relay 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.1 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. POlease be aware that there are many variables that can be collected from the relay and these will be tailored to suit each installation.

Variable                Units
=============================
Measurements
ANSI_50_1
AC Current 1            A
AC Current 2            A
AC Current 3            A
AC Voltage 1            V
AC Voltage 2            V
AC Voltage 3            V
AC Power                W
Reactive Power          W
Apparent Power          W
Trip Reason             W

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 a 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.