Z-Wave 适配器

要在 Home Assistant 中使用 Z-Wave,您需要一个兼容的 Z-Wave 适配器。

推荐的 Z-Wave 适配器

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

其他受支持的 Z-Wave 适配器

本节列出了已确认可与 Z-Wave JS 搭配使用的设备。

如果您刚开始接触 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 系列 USB 适配器

在将 Z-Wave 800 系列适配器连接到 Home Assistant 之前,请确保适配器使用兼容的固件和 SDK 版本。某些 800 系列 Z-Wave 适配器存在缺陷,会影响网状网络的稳定性,甚至导致适配器无响应。

请将 800 系列适配器的固件升级到推荐版本。

  • 由于目前没有已知完全修复问题的固件版本,建议按照以下标准选择固件:

    • 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
  • 注意:SDK 版本不必与固件版本一致。

    • 如果您不确定某个固件基于哪个 SDK 版本,请联系设备制造商。

受支持的 800 系列适配器列表

如果使用上文提到的 SDK 和固件版本,以下 800 系列 USB 适配器已被报告可与 Home Assistant 一起使用。

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

700 系列 USB 适配器

通常不建议使用 700 系列 USB 适配器。

在将 Z-Wave 700 系列适配器连接到 Home Assistant 之前,请确保适配器使用兼容的固件和 SDK 版本。某些 700 系列 Z-Wave 适配器存在缺陷,会影响网状网络的稳定性,甚至导致适配器无响应。

请将 700 系列适配器的固件升级到推荐版本:

  • 由于目前没有已知完全修复问题的固件版本,建议按照以下标准选择固件:
    • 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
  • 注意:SDK 版本不必与固件版本一致。
    • 如果您不确定某个固件基于哪个 SDK 版本,请联系设备制造商。
  • 如需升级固件,请查找适用于您系统的说明。

受支持的 700 系列 USB 适配器列表

如果使用上文提到的 SDK 和固件版本,以下 700 系列 USB 适配器已被报告可与 Home Assistant 一起使用:

  • Aeotec Z-Stick 7 USB stick (ZWA010) (the EU 版本 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 系列 USB 适配器

以下 500 系列 USB 适配器已被报告可与 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

树莓派 HAT 适配器

  • Aeotec Z-Pi 7 树莓派 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)

第三方集线器

为了获得最佳体验,建议直接将适配器连接到 Home Assistant。如果这不适合您,也可以使用支持 Z-Wave 的集线器。Home Assistant 支持以下带有 Z-Wave 支持的第三方集线器:

适配器说明

Aeotec Z-Stick

Note

已知 Aeotec Z-Stick 及其某些变体(例如 Z-Wave.Me UZB1)由于其不符合规范的行为,会与 Linux 内核存在兼容性问题。通过 USB 集线器连接这些适配器,可以作为一种临时解决方法,在某些情况下减轻这一问题。

您的 Z-Wave 适配器插入系统后轮流点亮黄色、蓝色和红色 LED,这属于正常现象。