This article describes the setup of the Z-Stick Gen5+ in Home Assistant with ZWaveJS UI and form part of the larger Z-Stick Gen5+ user guide.
This guide assumes that you have a fresh install of Home Assistant and have not yet installed Z-WaveJS, if you already have ZWaveJS Installed, that is perfectly fine, you will be able to switch between the official Z-WaveJS integration or Z-WaveJS UI as you like.
These steps outline the use of the Z-Stick Gen5, but you can typically use these steps with most or all Z-Wave USB Adapters. (The serial port may differ between different Z-Wave USB Adapters).
Requirements.
- Home Assistant OS: https://www.home-assistant.io/installation/
- Z-Stick Gen5+
Hardware Recommendations.
- Raspberry Pi 3 or later
- microSD card (at least 32GB and class 2; recommended 128GB SanDisk MAX Endurance for future proof or camera recordings)
If you're installing Z-Wave JS UI on a fresh installation.
These steps assume that you have a fresh install of Home Assistant and have not yet installed Z-WaveJS UI. Make sure to delete ZWaveJS integration and follow the steps below.
If you have a fresh install, you may follow the steps below to fully install Z-Wave JS UI.
1. (Not needed for most setups, you can likely skip this step) Gain access to the community repository first.
- Open Home Assistant, http://homeassistant.local:8123/
- Click Setting
- Click Add-on -> ADD-ON STORE (button at bottom right)
- Click top right icon (vertical 3 dot icon)
- Select Repositories
- Input:
- Then click ADD
- Open Home Assistant, http://homeassistant.local:8123/
- Click Setting -> Add-on
- Search for "ZWave"
- Click Z-Wave JS UI
- Click Install, then wait about 2 to 3 minutes for the installation to complete
- Click Start, takes about 24 seconds.
- Wait 1 minute for HASS to boot up Z-Wave JS UI
- Click "Open Web UI"
- Click Menu (hamburger icon) -> Settings
- Click Zwave
- Click Serial port and select /dev/ttyACM0
- Next to Network Key, click the refresh button to add a random security key for S0 Legacy, S2 Authenticated, S2 Unauthenticated, and S2 Access control.
image 1 - randomize key buttons.
image 2 - randomized network keys generated. - Click Save
- Click 4 box icon (Control Panel), and see if the driver boots up properly. If it does, the controller will appear as the first device.
- Click Settings -> Devices & Services
- Click + Add Integrations
- Search ZWave
- Click Z-Wave JS
- Uncheck "Use the Z-Wave JS Supervisor add-on"
- Click Submit
- Paste "ws://a0d7b954-zwavejs2mqtt:3000"
- Click Submit
- Set your devices to the areas they are installed in, then click Finish
Pairing your first Z-Wave device.