Bluelog Logger

Purpose

Purpose of this plugin is to read from a Bluelog logger (X-Monitor or X-Control). Please be aware. This plugin is in development, and will only collect Meter data for now

Usage

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

  1. By default, it will only collect meter data for now.

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

  3. Variable names will change, again depending on the Bluelog 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.

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
meter,                  meter-01,               Exported Energy,        87443322_M_AC_E_EXP,            decimal,            Wh,          1
meter,                  meter-01,               Imported Energy,        87443322_M_AC_E_IMP,            decimal,            Wh,          1
meter,                  meter-01,               Grid Freq,              87443322_M_AC_F,                decimal,            Hz,          1
meter,                  meter-01,               AC Current 1,			87443322_M_AC_I1,               decimal,            A,           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 Bluelog 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.

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 for discover (optional), log (mandatory)

Last updated