Parser mode - bellrichm/WeeWX-MQTTSubscribe GitHub Wiki
Parse MQTT 'message' data
Note, this function was intoduced in MQTTSubscribe version 3.0.
This reads data from a file and attempts to parse it into WeeWX format.
This functionality is useful for people that do not have acces to the live MQTT feed, such as MQTTSubscribe developers.
Environment setup
Set the mode that MQTTSubscribe will be running in
If running as a driver,
RUN_MODE=driver
If running as a service,
RUN_MODE=service
For pip and git installs - activate the environment
source ~/weewx-venv/bin/activate
Set the file locations
For pip installs
WEEWX_ROOT=~/weewx-data
export USER_ROOT=$WEEWX_ROOT/bin/user
CONFIG_FILE=$WEEWX_ROOT/weewx.conf
WEECTL=weectl
For package installs
WEEWX_ROOT=/etc/weewx/
export BIN_ROOT=/usr/share/weewx/
export USER_ROOT=$WEEWX_ROOT/bin/user
CONFIG_FILE=$WEEWX_ROOT/weewx.conf
WEECTL=weectl
For git 'installs'
WEEWX_REPO=~/weewx
WEEWX_ROOT=~/weewx-data
export BIN_ROOT=$WEEWX_REPO/src
export USER_ROOT=$WEEWX_ROOT/bin/user
CONFIG_FILE=$WEEWX_ROOT/weewx.conf
WEECTL=$WEEWX_REPO/bin/weectl
Invocation
python3 $USER_ROOT/MQTTSubscribe.py parse $RUN_MODE --help
Options
--conf CONF
The WeeWX configuration file. Typically weewx.conf.
--console
Log to console in addition to syslog.
--logging-file LOGGING_FILE
Log to specified file.
--logging-level
Specify the level of logging. Valid values are, DEBUG, INFO, TRACE.
--message-file
The file containing the MQTT message.
--top-level
Use the complete input configuration as the MQTTSubscribeDriver/MQTTSubscribeService configuration section.
-- topic
The topic to 'publish' the '--message-file' message.