-
Notifications
You must be signed in to change notification settings - Fork 13
Upgrade Guide
When a version upgrade requires specific steps, it will be documented below.
The release can be found here
Python 3.7 or higher is now required. Active support ended June 2020 and security updates stopped in June 2023.
WeeWX 4 or higher is required. Support for Python 3 was introduced in WeeWX 4 in April 2020.
MQTTSubscribe now validates the MQTTSubscribe configuration on startup. The default behavior is to log any errors and continue, allowing WeeWX to startup. Ideally errors would stop WeeWX from starting. But to make V3 more backward compatible, it was decided to just log the errors by default. Note, some of these errors were silently ignored in previous versions. Note, new installs will have the stop_on_validation_errors=true
While one could use weectl (or even just copy the new MQTTSubscribe.py), it is recommended that these steps be followed.
Following the steps include running MQTTSubscribe in configuration mode to validate the configuration prior to restarting WeeWX.
If any errors are found, they can be corrected or stop_on_validation_errors can be set to false.
Getting Help
Feel free to open an issue, start a discussion in github, or post on WeeWX google group. When doing so, see Help! Posting to weewx user for information on capturing the log.
Getting Started
Prerequisites
Required MQTT information
Required WeeWX information
Installing MQTTSubscribe
Configuring MQTTSubscribe
Running MQTTSubscribe with WeeWX
Debugging
Common Options
Main section
The [[topics]] section
The [[[message]]] section
The [[[topic-name]]] section
The [[[[field-name]]]] section
Additional Options
Main section
The [[tls]] section
The [[topics]] section
The [[[topic-name]]] section
The [[[[field-name]]]] section
Example individual Configuration
Example Configuration with multiple types