How to setup Home Assistant with a Z-Wave USB stick

Every great home automation system needs a automation software to power it. With the power of Atrim Stick, you're able to locally host your gateway and do so in a way that doesn't store or share any data with the cloud or third-parties. Home Assistant is amongst the most popular open-source software solutions for building your own gateway. In this guide, we'll take you through the steps of setting up Home Assistant using Z-Wave for automation and 800 series Z-Wave for communication.

What you'll need

  • A host computer - most systems will use a Raspberry Pi 3B+ or greater and this guide will focus on the Raspberry platform
  • A micro SD card at least 32GB and class 2. We recommend 128GB if you'll be using Home Assistant with non-Z-Wave features such as video camera or audio recordings
  • Home Assistant OS and the Zwavejs2Mqtt addon
  • Atrim Stick, a USB stick based, Z-Wave antenna

In this guide we have used Home Assistant OS version XXXX and Zwavejs2Mqtt version XXXX. Potentially, by the time you follow this guide, some screens may have been redesigned or a some steps subtly changed. If that happens, please let us know and we can update the guide.

Install Home Assistant

If you haven't already setup Home Assistant with a Raspberry Pi, follow that link to our dedicated guide.

Setup Z-Wave within Home Assistant

By default, Home Assistant doesn't come with Z-Wave functionality installed or enabled. In these steps, you'll install Zwavejs2Mqtt

  1. Open Home Assistant in a browser, usually at http://homeassistant.local:8123/
  2. Navigate to Supervisor > Add-on store.
  3. Seach for 'Z-Wave JS to MQTT'. Click on the appropriate result and then click Install. Installation can take up to 3 minutes.
  4. Once installed, ensure that 'Start on boot' is checked. Then click Start to load Zwavejs2Mqtt.
  5. Once the option loads on screen, click Open Web UI.
  6. Navigate through the hambuger menu to Settings.
  7. Click Zwave.
  8. From the drop down menu under 'Serial Port' select the corresponding port for your Atrim Stick USB stick. This is typically either '/dev/ttyACM0' or '/dev/ttyUSB0'.
  9. Generate a new security key for your Z-Wave installation by clicking the refresh icon to the right of 'Network Key'. This will create a random, secret key for use by your Z-Wave network, including for use with the Security 2 standard.
  10. Click Save.
  11. Click Control Panel in the left menu; your Z-Wave controller appear in the list.

For further assistance with Atrim Stick, visit the dedicated help with Hub repository.

Further help

Help with Atrim Stick

Other popular, self-help guides for Stick are listed below below. You can also learn more about its features at our dedicated Atrim Stick page while all Stick guides have a dedicated repository.

Setup Atrim Stick

Connect Z-Wave device to Atrim Stick

Setup Home Assistant with Raspberry Pi

Setup Z-Wave with Home Assistant

Debug Z-Wave network problems

Need assistance?

Atrim's team is just an email away and ready to answer all of your questions. If you need further help with any of our products, please let us know how we can help you.

Contact us