Z-Wave adapters

To use Z-Wave with Home Assistant, you need a compatible Z-Wave adapter.

Recommended Z-Wave adapter

The Home Assistant Connect ZWA-2 is an 800 series Z-Wave adapter specifically developed to work with Home Assistant.

Other supported Z-Wave adapters

This section lists devices that have been confirmed to work with Z-Wave JS.

A few recommendations if you are new to Z-Wave:

  • Use an 800 series adapter (with firmware updated to ≥ 7.23.2).
    • The 800 series adapters are the most future-proof and offer the best RF performance.
  • Opt for a USB connection, not a module.
    • Passing a module through Docker is more complicated than passing a USB connector through.

800 series USB adapters

Before connecting the Z-Wave 800 series adapter to Home Assistant, make sure the adapter uses a compatible firmware and SDK version. Some 800 series Z-Wave adapters have bugs which impact the stability of the mesh and can cause the adapter to become unresponsive.

Upgrade the firmware of the 800 series adapter to a recommended version.

  • Because there is no known firmware version that is completely fixed, it is recommended to choose a firmware based on the following criteria:

    • prefer SDK versions 7.23.x and newer
    • SDK versions 7.22.x are okay
    • SDK versions 7.17.2 to 7.19.x are okay
    • avoid SDK versions before 7.17.2
    • avoid SDK versions 7.20 to 7.21.3
  • Note: The SDK version does not have to match the firmware version.

    • If you are unsure which SDK versions a firmware is based on, contact the manufacturer of your device.

List of supported 800 series adapters

The following 800 series USB adapters have been reported to work with Home Assistant if using the SDK and firmware versions mentioned above.

  • Home Assistant Connect ZWA-2 (officially recommended adapter)
  • HomeSeer SmartStick G8
  • Zooz 800 Series Z-Wave Long Range S2 Stick (ZST39 LR)

700 series USB adapters

In general, using a 700 series USB adapter is not recommended.

Before connecting the Z-Wave 700 series adapter to Home Assistant, make sure the adapter uses a compatible firmware and SDK version. Some 700 series Z-Wave adapters have bugs which impact the stability of the mesh and can cause the adapter to become unresponsive.

Upgrade the firmware of the 700 series adapter to a recommended version:

  • Because there is no known firmware version that is completely fixed, it is recommended to choose a firmware based on the following criteria:
    • prefer SDK versions 7.17.2 to 7.18.x or 7.21.6 and newer
    • SDK versions 7.19.x are okay
    • avoid SDK versions before 7.17.2
    • avoid SDK versions 7.20 to 7.21.5
  • Note: The SDK version does not have to match the firmware version.
    • If you are unsure which SDK versions a firmware is based on, contact the manufacturer of your device.
  • To upgrade the firmware, search for the instructions that match your system.

List of supported 700 series USB adapters

The following 700 series USB adapters have been reported to work with Home Assistant if using the SDK and firmware versions mentioned above:

  • Aeotec Z-Stick 7 USB stick (ZWA010) (the EU version is not recommended due to RF performance issues)
  • HomeSeer SmartStick+ G3
  • HomeSeer Z-NET G3
  • Silicon Labs UZB-7 USB Stick (Silabs SLUSB7000A / SLUSB001A)
  • Zooz S2 Stick 700 (ZST10 700)
  • Z-Wave.Me Z-Station

500 series USB adapters

The following 500 series USB adapters have been reported to work with Home Assistant:

  • Aeotec Z-Stick Gen5 (see note below)
  • Everspring USB stick - Gen 5
  • GoControl HUSBZB-1 stick
  • Sigma Designs UZB stick
  • Vision USB stick - Gen5
  • Z-Wave.Me UZB1 stick (see Aeotec Z-Stick note below)
  • HomeSeer SmartStick+ G2
  • HomeSeer Z-NET G2

Raspberry Pi HAT adapters

  • Aeotec Z-Pi 7 Raspberry Pi HAT/Shield (ZWA025, 700 series)
  • Z-Wave.Me RaZberry 7 (ZME_RAZBERRY7, 700 series)
  • Z-Wave.Me RaZberry 7 Pro (ZMEERAZBERRY7_PRO or ZMEURAZBERRY7_PRO, 700 series)
  • Z-Wave.Me Razberry 2 (500 series)
  • Z-Wave.Me Razberry 1 (300 series)

Third-party hubs

For the best experience, it is recommended to use an adapter directly with Home Assistant. If this doesn’t work for you, you can use a hub that supports Z-Wave. Home Assistant supports the following third-party hubs with Z-Wave support:

Adapter notes

Aeotec Z-Stick

Note

The Aeotec Z-Stick and some of its variants (e.g. Z-Wave.Me UZB1) are known to have compatibility issues with the Linux kernel because of their non-compliant behavior. Plugging these adapters through a USB hub can serve as a workaround that sometimes mitigates the issue.

It’s totally normal for your Z-Wave stick to cycle through its LEDs (Yellow, Blue and Red) while plugged into your system.