2025.3.4
首页 ▸ 文档 ▸ Z wave ▸

Z-Wave 控制器

支持的 Z-Wave USB 接收器和硬件模块

您需要安装一个兼容的 Z-Wave 接收器或模块。以下设备已确认与 Z-Wave JS 兼容：

Warning

The firmwares of 700 and 800 series Z-Wave controllers have several bugs which impact the stability of the mesh and can cause the controller to become unresponsive. Because there is no known firmware version that is completely fixed, it is recommended to choose a firmware based on the following criteria:

  • 700 series:

    • prefer SDK versions 7.17.2 to 7.18.x
    • SDK versions 7.19.x are okay
    • avoid SDK versions before 7.17.2
    • avoid SDK versions 7.20 to 7.21.3

  • 800 series

    • prefer SDK versions 7.22.x
    • 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

SDK 版本不必与固件版本匹配。如果您不确定某个固件基于哪些 SDK 版本，请联系设备的制造商。

Important

您应该将所有 700 和 800 系列控制器的固件升级到推荐版本。

可以使用以下说明升级固件：

  • 800 系列控制器（有一些 caveats，见备注）

    • HomeSeer SmartStick G8
    • Zooz 800 系列 Z-Wave 长范围 S2 接收器 (ZST39 LR)

  • 700 系列控制器

    • Aeotec Z-Stick 7 USB 接收器 (ZWA010)（由于 RF 性能问题，不建议使用 EU 版本）
    • HomeSeer SmartStick+ G3
    • HomeSeer Z-NET G3
    • Silicon Labs UZB-7 USB 接收器 (Silabs SLUSB7000A / SLUSB001A)
    • Zooz S2 接收器 700 (ZST10 700)
    • Z-Wave.Me Z-Station

  • 500 系列控制器

    • Aeotec Z-Stick Gen5（见下文备注）
    • Everspring USB 接收器 - Gen 5
    • GoControl HUSBZB-1 接收器
    • Sigma Designs UZB 接收器
    • Vision USB 接收器 - Gen5
    • Z-Wave.Me UZB1 接收器
    • HomeSeer SmartStick+ G2
    • HomeSeer Z-NET G2

  • Raspberry Pi 模块

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

如果您刚刚开始，我们建议您购买 700 系列控制器或 Raspberry Pi 模块。700 系列控制器是更新版本（与 500 系列相比）。700 系列控制器支持 SmartStart，允许通过扫描二维码添加设备。

Tip

如果您使用 Home Assistant OS、监督版或容器，建议使用 USB 接收器，而不是模块。通过 Docker 传递模块比传递 USB 接收器要复杂。

接收器替代品

接收器的替代品是支持 Z-Wave 的集线器。Home Assistant 支持以下具有 Z-Wave 支持的集线器：

控制器说明

800 系列控制器

Z-Wave JS 尚不支持 Z-Wave 长范围。

Aeotec Z-Stick

Note

与较旧硬件版本的 Aeotec 接收器存在 已知兼容性问题，当直接插入 Raspberry Pi 4 时无法连接，需使用 USB 集线器才能工作。Aeotec 已发布兼容 Pi 4 的 2020 硬件修订版本 ZW090-A/B/C Gen5+。这两个硬件修订版仍在销售，购买时请做出明智的决定。

您的 Z-Wave 接收器在插入系统时通过 LED（黄色、蓝色和红色）循环闪烁是完全正常的。

Razberry 板

在 Raspberry Pi 3 和 4 上，您需要禁用板载蓝牙，因为该板需要使用硬件 UART（其引脚与蓝牙共享）。您可以通过调整 /boot/config.txt 来实现。

在下面的两个过程中，您需要将 SD 卡插入您的 PC，并使用您喜欢的文本编辑器打开配置文件。

  • 如果您使用的是 Home Assistant Operating SystemHome Assistant OS，即 Home Assistant 操作系统，是一个嵌入式、简约的操作系统，旨在运行 Home Assistant 生态系统。它是大多数用户推荐的安装方法。 [Learn more]，一旦您挂载磁盘，您将在根目录中看到 config.txt。
  • 如果您使用的是 Home Assistant SupervisedHome Assistant Supervised 是完整的 Home Assistant 生态系统，没有 Home Assistant 操作系统。 [Learn more]，配置文件存储在引导文件夹中：/boot/config.txt。

Raspberry Pi 5 过程

将以下参数添加到 config.txt 文件的底部。

dtoverlay=uart0

Raspberry Pi 4 过程

将以下参数添加到 /boot/config.txt 文件的底部。

dtoverlay=disable-bt
enable_uart=1

不带 Razberry Z-Wave HAT 先重启您的 Pi 4。然后关机，重新连接 HAT，再次启动。

Raspberry Pi 3 过程

将以下参数添加到 /boot/config.txt 文件的底部。

dtoverlay=disable-bt

重启您的 Pi 3。

对于 Home Assistant OS，这应该是您需要做的所有操作。您现在应该能够使用来自 /dev/ttyAMA0 的 Razberry Z-Wave。

对于 Raspberry Pi OS 等其他操作系统，您还需要运行以下命令：

sudo systemctl disable hciuart

您还应检查 README 文件以获取有关覆盖的详细信息。您可能会在您的 SD 卡中的 /boot/overlays/README 找到它。如果不在那儿，您可以在 这里找到官方版本。

Note

在使用 Razberry Z-Wave 时，可以保持有限的蓝牙功能。请检查 miniuart-bt 中的 boot/overlays/README。

Note

disable-bt 之前称为 pi3-disable-bt。如果您的操作系统较旧，您可能需要使用这个。

Note

如果您已安装 Z-Wave.Me Z-Way 软件，为了使用 Z-Wave JS 而不是 Z-Way，您需要确保在安装 Home Assistant 之前禁用它，否则您将无法访问该板。使用 sudo /etc/init.d/z-way-server stop; sudo update-rc.d z-way-server disable 来完成此操作。或者，您可以使用 Z-Wave.Me 集成。

在 Home Assistant Yellow 上设置 Raspberry Pi Z-Wave 模块

此过程已在以下模块上测试：

  • Aeotec Z-Pi 7 Raspberry Pi HAT/Shield
  • Z-Wave.Me RaZberry 7
  • Z-Wave.Me RaZberry 7 Pro
  1. 确保模块已正确放置在 Home Assistant Yellow 上。 Aeotec Z-Pi 7 在 Home Assistant Yellow 上.
  2. 小心地 关闭机箱 并启动 Home Assistant Yellow。
  3. 根据 设置 Z-Wave JS 服务器 的程序进行操作。
    1. 在步骤 2 中，按手动设置步骤安装 Z-Wave 集成。
    2. 在步骤 4 中，系统会提示您选择 设备路径。选择 ttyAMA0。