MeteoControl Logger

Purpose

Purpose of this plugin is to read from a Meteocontrol logger (and Kaco ProLog solar loggers which are rebranded Meteocontrol loggers).

Usage

This plugin will collect data from a Meteocontrol logger via Port 80 (http). See https://www.meteocontrol.com Note the following:

1. By default, it will not collect any data from Modbus, Inverters or AD modules. You must actively read from any of these. See below for details.

2. Pay attention to the unit scaling. This will vary between Meteocontrol units.

3. Variable names will change, again depending on the Meteocontrol installation. Run a discover without a config file to determine the variable name and units.

4. If you do a discover without a config file, it will print out ALL the variables, units and values for the particular Modbus, Inverters or AD module(s).

There must be a config file when running log. You can do a discover without a configuration file. In this case, all the variables are displayed. along with the current value. If you have a configuration file when running discover, then the variables of interest are displayed, and everything else is ignored. The config file defines which variables need to be collected, what names they appear on the the Ardexa cloud, units and scaling. Example config file as follows:

# Ardexa Table Name,    Ardexa Source Name,     Ardexa Variable Name,   Meteo Variable Name,            Type,               Units,      Scale
meteorological,         meteo-01,               Ambient Temp,           ad0_Temperatura Si-12TC-T,      decimal,            C,          1
meteorological,         meteo-01,               Solar Radiation,        ad0_Irraggiamento Si-12TC,      decimal,            W/m^2,      1
meteorological,         meteo-01,               Solar Radiation 2,      ad0_Temperatura Si-12TC-T,      decimal,            W/m^2,      1

NOTES:

1. Anything that starts with # is a comment line, and will be ignored

2. The Type can be either: decimal, integer, bool, keyword

3. The Meteocontrol Variable Name name MUST be as it appears in the logger, when doing a discovery (without a config file)

4. Units and Scale can be empty

5. ALWAYS run discover first to see which variables are available, before developing the config file.

If using the Ardexa tunnel,the default start page is: http://{IP:PORT}/html/en/index.html

Arguments

• ip_address This is an IP address like 192.168.1.4

• --auth_file. This is a file with 2 lines, first line is userid and second line is password. This is optional. Most meteocontrol sites don't use authentication

• --config_path. This is the config file location

• inv_addresses = List of inverter addresses using commas and hyphens, e.g. 1-4,6,10-20. Using range of 0 will mean no inverters will be queried. Default address is -1 (ie; no inverters will be read)

• io_modules_addresses = Range of IO modules, starting at address 0. e.g. 1-4,6,10-20. If you want to read just IO Module 0, the argument is --io_modules_addresses 0-0. Default address is -1 (ie; no IO modules will be read)

• modbus_modules = Range of Modbus modules, starting at address 0 e.g. 1-4,6,10-20. If you want to read just Modbus Module 0, the argument is --modbus_modules 0-0. Default address is -1 (ie; no modbus modules will be read)