跳转到内容

Z-Wave 代理

zwave_proxy 组件允许在 Z-Wave Modem SoC 和 Z-Wave JS 之间代理 Z-Wave 数据帧,通过 ESPHome 的 Api 经由 Wifi 或 Ethernet 进行。这使得在 家中布置 Z-Wave 硬件时更加灵活。

由于 Z-Wave 调制解调器 SoC 通过串行连接通信,你需要在 ESPHome 设备配置中定义一个 UART。

此外,zwave_proxy 期望通过 ESPHome 的 Api 代理消息;这同样 需要在你的配置中包含。

NOTE

连接数量

尽管 ESPHome 支持多个 API 连接/客户端,但在任何给定时间,只有单个客户端可以订阅并接收代理的 Z-Wave 数据帧。

# 示例配置条目
zwave_proxy:
  • id (可选, ID): 为 zwave_proxy 手动指定 ID。

低延迟是实现与 Z-Wave(或任何)无线设备理想体验的关键。

重要的是要理解,使用 zwave_proxy 将增加你的 Z-Wave 设备与 Z-Wave JS 之间的延迟——这只是将消息从一种介质传递到另一种介质的后果。

在接近理想的条件下:

  • 使用与 Z-Wave 调制解调器 SoC 的直接串行连接时,延迟可低至约 20 毫秒(ms)。
  • 引入 Z-Wave 代理组件后,仍然可以实现低延迟——我们看到过低至 35 ms!但是,实际中更现实的是期望 50-60 ms,前提是射频条件不错。

一般来说,任何小于 100 ms 的延迟在延迟方面都是非常可接受的;通常这是一个不错的 目标,值得记住。

除了低延迟,可靠性对于理想体验也至关重要。

有线以太网连接将为 Z-Wave 代理提供最佳的可靠性。 以太网提供:

  • 更稳定和可预测的延迟
  • 不会因射频干扰导致连接断开或滞后
  • 对环境影响免疫

Wi-Fi 受到以下因素影响:

  • 来自其他射频设备的干扰
  • 环境条件,例如:
    • 人/宠物在房间内移动
    • 建筑材料
    • 空气密度、质量,甚至湿度

这些因素可能周期性地导致短暂的信号不稳定。虽然 Wi-Fi 设备通常会自动恢复, 但这会暂时降低性能(延迟),在更极端的情况下,会导致短暂的 连接丢失。

如果你选择使用 Wi-Fi 将你的 Z-Wave 调制解调器桥接到 Z-Wave JS:

  • 确认你将放置 Z-Wave 代理的位置有强而稳定的 Wi-Fi 信号。
  • 不要尝试将 Z-Wave 代理放在或靠近你的 Wi-Fi 路由器/接入点 提供的覆盖区域边缘。如果不确定,请将其移近你的 Wi-Fi 路由器/接入点。
  • 如果发现你的 Z-Wave 设备工作不可靠,可以尝试:
    • 将你的 Z-Wave 代理移近你的 Wi-Fi 路由器/接入点。
    • 更改 Wi-Fi 路由器/接入点使用的 Wi-Fi 信道。
    • 换一个更好的 Wi-Fi 路由器/接入点。特别是,许多 ISP 提供的 Wi-Fi 路由器设计为 经济实惠,并未针对性能进行优化。