This utility publishes to MQTT topics when sensor reports are published from multilevel-sensor devices on a Z-Wave network, and set values when messages are received on relevant topics. So far it has been tested with the Aeotec Z-Stick, MultiSensor 6, and SmartSwitch 6 devices.
The repository also includes a helper that republishes Z-Wave messages on MQTT to topics that are compatible with JSON-format OpenEnergyMonitor messages.
The bridge is started by running the
This takes a number of options, which are described in the help for the
usage: zwave_mqtt_bridge [-h] [-U MQTT_USER] [-p MQTT_PASS] [-d DEVICE] [-u USER_PATH] [--basetopic BASETOPIC] mqtt_host MQTT interface to Z-Wave sensors. positional arguments: mqtt_host MQTT host optional arguments: -h, --help show this help message and exit -U MQTT_USER MQTT username -p MQTT_PASS MQTT password -d DEVICE, --device DEVICE Path to Z-Stick device -u USER_PATH Path to write user files (e.g. current Z-Wave configursation --basetopic BASETOPIC Base topic to publish/subscribe to
DEVICE is often
/dev/ttyACM0 (and this is the default value.
BASETOPIC defaults to
Once running, the tool publishes updates to
<basetopic>/updates/<node_id> as JSON objects, where each key is the
value that was updated, and the value is the new value it was set to.
It also subscribes to
<basetopic/refresh/#>. The user can publish
messages to subtopics named by node ID (e.g. zwave/refresh/5) with a
list of values that they wish to refresh (e.g.
["Power"]) (the labels
are those used by OpenZWave). This should cause a message to the
update topic shortly after with the current value.
Finally, it subscribes to
<basetopic/set/#>. The user can publish
messages to subtopics named by node ID (e.g. zwave/set/5) with a JSON
object identifying values to be updated (e.g.
These will then be set: typically they will be reflected in the
https://github.com/adpeace/emonhub/tree/emon-pi contains a script
emon_mqtt_logger.py) that subscribes to messages published by
emonhub (a tool for capturing measurements published by
OpenEnergyMonitor devices and posting them to MQTT, amongst others) and
posts them to EmonCMS (a data storage/graphing site).
The MQTT bridge here uses a different topic structure to allow for
bi-directional communication, and the types of updates from Z-Wave
devices is much more varied that needs to be posted to EmonCMS, so I
wrote a utility (
zwave_emon_republisher) that captures just the
relevant messages from the Z-Wave network, reformats, and reposts them
to be captured by
The usage is similar to
zwave_mqtt_bridge: simply provide MQTT host
details, and the base topics you are using for Z-Wave messages and emon
messages and it takes care of the rest.
pip install zwave-mqtt-bridge.
To run at startup you can use the provided example
which needs to be installed in the
Note that the provided example assumes that there is a user called
zwave that will have access to the appropriate serial device for the
/dev/ttyACM0), and will create working files in that
user's home directory. You can create this user using, for example, the
sudo adduser --system --no-create-home --ingroup dialout zwave