I have made a simple tutorial to try out ZWAVE2MQTT add-on in Home Assistant:
- Add MQTT to Home Assistant
I installed add-on Mosquito broker and addedmqtt:
https://www.home-assistant.io/components/mqtt/ withdiscovery: true
https://www.home-assistant.io/docs/mqtt/discovery/ toconfiguration.yaml
mqtt:
broker: core-mosquitto
username: !secret mqtt_username
password: !secret mqtt_password
discovery: true
-
Install ZWAVE2MQTT add-on, (Optional: open port on router to
8091
, or change to your needs) -
Delete Zwave integration and remove
zwave:
config fromconfiguration.yaml
(for quick test, you can just stop zwave network in zwave panel, but this is not recommended, because cause problems after Home Assistant restart) -
Start ZWAVE2MQTT, open web ui, and setup the add-on:
-
In Zwave settings setup
Serial Port
(Mine is/dev/ttyACM0
, same as for Zwave integration. Setup Poll Interval (Mine is60000
millis). -
In MQTT settings setup
Name
(zwave
),Host url
- mqtt broker address (my_domain.duckdns.org
),Port
(mqtt port, mine is1883
),Reconnect peroid
(Mine is60000
),Prefix
(default ishomeassistant
to be discovered), enableRetain
andAuth
, and add there your mqttusername
andpassword
. -
In Gateway settings setup
Type
(ValueID topics
) andPayload
(Entire Z-wave value Object
) and enableHass Discovery
. -
Go to Control Panel and the controller with powered nodes should appear, for battery nodes wait to be wake up or wake them manual.
-
The new zwave nodes are now in mqtt integration and have new entity names in Home Assistant.
Motion sensors are created as_contact
sensor withopen/closed
. In Home Assistant they are as door sensor. So you must customize device incustomize.yaml
:
binary_sensor.*_contact:
icon: mdi:walk
device_class: motion
(10.) If you want go back to Zwave integration, stop ZWAVE2MQTT add-on, start zwave network or enable back zwave integration and restart Home Assistant. Everything should be back again.
(11.) If you decide to stay, replace old entities with new entities in your setup(sensors, automations,…). You can also rename new entities with names from old zwave integration.
Please add your opinions, correcture,…
TESTED AND WORKS: dimmers, switches, motion sensors from Fibaro
PROBLEMS: Zipato rgb light only support dim/on/off - no colors in Home Assistant, but works in ZWAVE2MQTT