Janitza Meters

Purpose

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

Usage

This plugin reads the data from Janitza 604 Pro 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. There are 2 configuration files associated with this plugin, namely janitza_604_pro.txt and janitza_604_pro_inverted.txt. The janitza_604_pro_inverted.txt file will invert the values (ie; multiply them by -1), for the 4 x AC Power, 4 x Reactive Power, 3 x Power Factor and 4 x Real Energy values listed below. This makes it easier in some installations to define the imported vs exported power values. The following data will be collected:

Variable                Units
=============================
AC Voltage L1           V
AC Voltage L2           V
AC Voltage L3           V
AC Voltage L1-L2        V
AC Voltage L2-L3        V
AC Voltage L3-L1        V
Apparent Current L1     A
Apparent Current L2     A
Apparent Current L3     A
Apparent Current        A
AC Power L1             W
AC Power L2             W
AC Power L3             W
AC Power                W
Apparent Power L1       VA
Apparent Power L2       VA
Apparent Power L3       VA
Apparent Power          VA
Reactive Power L1       var
Reactive Power L2       var
Reactive Power L3       var
Reactive Power          var
Power Factor 1
Power Factor 2
Power Factor 3
Grid Freq               Hz
Real Energy L1          Wh
Real Energy L2          Wh
Real Energy L3          Wh
Real Energy             Wh
Consumed Energy L1      Wh
Consumed Energy L2      Wh
Consumed Energy L3      Wh
Consumed Energy         Wh
Delivered Energy L1     Wh
Delivered Energy L2     Wh
Delivered Energy L3     Wh
Delivered Energy        Wh
Apparent Energy L1      VAh
Apparent Energy L2      VAh
Apparent Energy L3      VAh
Apparent Energy         VAh
Reactive Energy L1      varh
Reactive Energy L2      varh
Reactive Energy L3      varh
Reactive Energy         varh
React induct Energy L1  varh
React induct Energy L2  varh
React induct Energy L3  varh
React induct Energy     varh
React capac Energy L1   varh
React capac Energy L2   varh
React capac Energy L3   varh
React capac Energy      varh
THD U L1                %
THD U L2                %
THD U L3                %
THD I L1                %
THD I L2                %
THD I L3                %

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

• config_path. This defines the configuration file to use, namely janitza_604_pro.txt and janitza_604_pro_inverted.txt. See Usage above for a discussion on these 2 parameters.

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