跳转到内容

Z-Wave 代理

zwave_proxy 组件允许在 Z-Wave 调制解调器 SoCZ-Wave JS 之间通过 ESPHome 的 API 代理 Z-Wave 数据帧, 通过 WiFi以太网。这允许在家庭中放置 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 毫秒! 但在实践中,假设射频条件良好,更现实的预期是 50-60 毫秒。

通常,任何小于 100 毫秒的延迟在延迟方面都是可以接受的;这个值通常是一个很好的 目标值。

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

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

  • 更稳定和可预测的延迟
  • 不会因射频干扰而导致连接中断或延迟
  • 不受环境条件影响

WiFi 受以下因素影响:

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

这些因素可能会周期性地导致短暂的信号不稳定。虽然 WiFi 设备通常会自动恢复, 但这是以暂时降低性能(延迟)为代价的,在更极端的情况下,会导致短暂的连接中断。

如果您选择使用 WiFi 将 Z-Wave 调制解调器桥接到 Z-Wave JS:

  • 确认在您放置 Z-Wave 代理的位置有强稳定 WiFi 信号。
  • 不要尝试将 Z-Wave 代理放置在 WiFi 路由器/接入点提供的覆盖区域的边缘或附近。 如有疑问,请将其移近 WiFi 路由器/接入点。
  • 如果您发现 Z-Wave 设备运行不可靠,可以尝试:
    • 将 Z-Wave 代理移近 WiFi 路由器/接入点。
    • 更改 WiFi 路由器/接入点使用的 WiFi 信道。
    • 购买更好的 WiFi 路由器/接入点。特别是,许多 ISP 提供的 WiFi 路由器设计上 注重成本效益,并未针对性能进行优化。