individual example - bellrichm/WeeWX-MQTTSubscribe GitHub Wiki
individual examples
In this example there are 3 topics, topic/id
, topic/temp1
, and topic/outTemp
.
-
On
topic/id
, a single value is published in the message. It is desired to ignore this data. This is easily accomplished by not configuring this topic. -
On
topic/temp1
, a temperature is published in the message. This tempurature is measured in Celsius, but needs to stored as Farenheit. This value should be stored in the WeeWX fieldextraTemp1
. -
On
topic/outTemp
, a temperature is published in the message. This temperature is measured in Fahrenheit, the unit of measurement it should be saved as. This value should be stored in the WeeWX fieldoutTemp
.
The configuration below accomplishes this. This example leverages MQTTSubscribe's default values. To see a more complete template see, https://github.com/bellrichm/WeeWX-MQTTSubscribe/blob/master/mqttsubscribe.example.conf.
Common options is a reference of the most common options.
[MQTTSubscribeService or MQTTSubscribeDriver]
# The driver to use.
# Only used by the driver.
driver = user.MQTTSubscribe
# Turn the service on and off.
# Default is true.
# Only used by the service.
enable = true
# The MQTT server.
# Default is: localhost
host = localhost
# The port to connect to.
# Default is: 1883
port = 1883
[topics](/bellrichm/WeeWX-MQTTSubscribe/wiki/topics)
# Configuration for the message callback.
[[message](/bellrichm/WeeWX-MQTTSubscribe/wiki/[message)]
# The format of the MQTT payload.
# Currently support: individual, json, keyword
# Must be specified.
type = individual
[[topic/temp1](/bellrichm/WeeWX-MQTTSubscribe/wiki/[topic/temp1)]
# The WeeWX name.
# Default is the name from MQTT.
name = extraTemp1
# The units of the incoming data.
# Useful if this field's units differ from the topic's unit_system's units.
# Valid values: see, https://weewx.com/docs/5.0/reference/units/
# Default is not set
units = degree_C
[[topic/outTemp](/bellrichm/WeeWX-MQTTSubscribe/wiki/[topic/outTemp)]