This article describes the setup of the Z-Pi 7 in Home Assistant with a Raspberry Pi 3 or 4 with ZWaveJS to MQTT and form part of the larger Z-Pi 7 user guide.


Starting Remarks.

This guide assumes that you have a fresh install or have already installed Home Assistant, if you already have ZWaveJS Installed, you may need to delete it before you install ZWave JS to MQTT.

  • Delete ZWaveJS integration
  • Delete ZWaveJS addon (from supervisor)

1. Disable Bluetooth

This is required since both bluetooth and Z-Pi 7 utilize the same serial port dev/ttyAMA0, in order for Z-Pi 7 to form a connection to your RPi, you must disable bluetooth.

Before doing this, make sure you've installed Home Assistant OS onto your USB flash drive or microSD card. 

  1. Plug your USB flash drive or microSD card with Home Assistant installed into your PC.
  2. Open up your Home Assistant drive.
  3. Look for "config.txt" and open it.
  4. Add this command to the text file depending on the RPi version you have.

    Raspberry Pi 3 

    Raspberry Pi 4

  5. Save config.txt
  6. Exit config.txt
  7. Now safely eject your Flash drive or microSD and remove it from your PC
  8. Install your Flash drive or microSD into your RPi and power it up.
  9. Wait a few minutes before moving onto the next following steps.

2. Software Steps
  1. Click Supervisor
  2. Click Add-on Store
  3. Search for "ZWave"
  4. Click Z-Wave JS to MQTT
  5. Click Install, then wait about 2 minutes and 45 seconds for the installation to complete
  6. Click Start, takes about 24 seconds.
  7. Wait 1 minute for HASS to boot up Z-Wave JS to MQTT
  8. Click "Open Web UI"
  9. Click "Gear Icon"
  10. Click Zwave
  11. Click Serial port and select /dev/ttyAMA0
  12. Next to Network Key, click the refresh button to add a random security key.
  13. Click Save
  14. Click 4 box icon, and see if the driver boots up properly.
  15. Click Supervisor
  16. Click Z-Wave JS to MQTT
  17. Click Documentation
  18. Copy "ws://a0d7b954-zwavejs2mqtt:3000"
  19. Click Configuration
  20. Click Integrations
  21. Click + Add Integrations
  22. Search ZWave
  23. Click Z-Wave JS
  24. Uncheck "Use the Z-Wave JS Supervisor add-on"
  25. Click Submit
  26. Paste "ws://a0d7b954-zwavejs2mqtt:3000"
  27. Click Submit
  28. Set your devices to the areas they are installed in, then click Finish