内容 隐藏
1 ESPHome ESP8266 物理连接到您的设备
2 规格
3 超过view
4 系统要求
5 特征
6 兼容性
7 支持的 ESPHome 实体
8 安装程式设定
9 驱动程序安装
10 驱动程序设置
11 设备设置
12 ratgdo 配置指南
13 Example：创建仍然打开的警报
14 常问问题
15 文件/资源
15.1 参考

ESPHome徽标

ESPHome ESP8266 物理连接到您的设备

ESPHome-ESP8266-物理连接到您的设备产品

规格

  • 系统要求： Control4 操作系统 3.3+

超过view

将基于 ESPHome 的设备集成到 Control4。ESPHome 是一个开源系统，可以通过简单的 YAML 配置将常见的微控制器（例如 ESP8266 和 ESP32）转换为智能家居设备。ESPHome 设备可以通过 web 浏览器、Home Assistant 或其他兼容平台。此驱动程序可让您直接从 Control4 系统无缝监控和控制 ESPHome 设备。

系统要求

  • Control4 操作系统 3.3+

特征

  • 无需云服务的本地网络通信
  • 来自设备公开的所有受支持实体的实时更新
  • 支持使用设备加密密钥的加密连接
  • 变量编程支持

兼容性

验证设备
该驱动程序通常适用于任何 ESPHome 设备，但我们已使用以下设备进行了广泛测试：

如果您在上面列出的产品上尝试此驱动程序并且它有效，请告诉我们！

支持的 ESPHome 实体

ESPHome-ESP8266-物理连接到您的设备-（1） ESPHome-ESP8266-物理连接到您的设备-（2）

安装程式设定

每个 ESPHome 设备只需一个驱动程序实例。如果此驱动程序的多个实例连接到同一设备，则会出现意外行为。但是，您可以将此驱动程序的多个实例连接到不同的 ESPHome 设备。

DriverCentral 云设置
如果您已经拥有 DriverCentral 云驱动程序 安装在您的项目中，您可以继续驱动程序安装。

此驱动程序依赖 DriverCentral Cloud 驱动程序来管理许可和自动更新。如果您是 DriverCentral 的新用户，可以参考他们的 Cloud Driver 文档 用于设置它。

驱动程序安装

驱动程序的安装和设置与大多数其他基于 IP 的驱动程序类似。以下概述了基本步骤，方便您参考。

  1. 下载最新 control4-esphome.zip 从 驾驶员中心.
  2. 提取并安装 esphome.c4z, esphome_light.c4z， 和 esphome_lock.c4z 司机。
  3. 使用“搜索”选项卡找到“ESPHome”驱动程序并将其添加到您的项目中。ESPHome-ESP8266-物理连接到您的设备-（3）
  4. 在“系统设计”选项卡中选择新添加的驱动程序。您会注意到云状态反映了许可证状态。如果您已购买许可证，它将显示“许可证已激活”，否则将显示“试用中”以及剩余试用时长。
  5. 您可以通过在“系统设计”选项卡中选择“DriverCentral Cloud”驱动程序并执行“检查驱动程序”操作来刷新许可证状态。ESPHome-ESP8266-物理连接到您的设备-（4）
  6. 配置 设备设置 以及连接信息。
  7. 片刻之后，驱动程序状态将显示“已连接”。如果驱动程序连接失败，请将“日志模式”属性设置为“打印”，并重新设置“IP 地址”字段以重新连接。然后，查看 Lua 输出窗口以获取更多信息。
  8. 一旦连接，驱动程序将自动为每个支持的实体类型创建变量和连接。
  9. 要控制灯光和/或锁，请使用“搜索”选项卡查找“ESPHome Light”和/或“ESPHome Lock”驱动程序。为项目中的每个暴露的灯光或锁实体添加一个驱动程序实例。在“连接”选项卡中，选择“ESPHome”驱动程序，并将灯光或锁实体绑定到新添加的驱动程序。

驱动程序设置

驱动程序属性

云设置

  • 云状态
    显示 DriverCentral 云许可证状态。
  • 自动更新
    打开/关闭 DriverCentral 云自动更新。

驱动程序设置

  • 驾驶员状态（只读）
    显示驱动程序的当前状态。
  • 驱动程序版本（只读）
    显示驱动程序的当前版本。
  • 日志级别 [ 严重 | 错误 | 警告 | 信息 | 调试 | 跟踪 | 超严重 ] 设置日志记录级别。默认为 信息.
  • 日志模式 [ 关闭 | 打印 | 日志 | 打印并日志 ] 设置日志记录模式。默认为 离开.

设备设置

IP 地址
设置设备 IP 地址（例如 192.168.1.30）。允许使用域名，只要它们可以被控制器解析为可访问的 IP 地址即可。不支持 HTTPS。

笔记： 如果您使用 IP 地址，则应通过分配静态 IP 或创建 DHCP 保留来确保它不会改变。

港口
设置设备端口。ESPHome 设备的默认端口是 6053.

  • 认证模式 [ 无 | 密码 | 加密密钥 ]
  • 选择连接到 ESPHome 设备的身份验证方法。

没有任何： 无需身份验证。

密码： 使用密码进行身份验证（见下文）。

加密密钥： 使用加密密钥进行安全通信（见下文）。

  • 密码
    仅当“身份验证模式”设置为“密码”时显示。设置设备密码。该密码必须与 ESPHome 设备上配置的密码一致。
  • 加密密钥
    仅当“身份验证模式”设置为“加密密钥”时显示。设置设备加密密钥以实现安全通信。该密钥必须与 ESPHome 设备上配置的加密密钥匹配。

设备信息

  • 名称（只读）
    显示已连接的 ESPHome 设备的名称。
  • 模型（只读）
    显示已连接的 ESPHome 设备的型号。
  • 制造商（只读）
    显示所连接的 ESPHome 设备的制造商。
  • MAC 地址（只读）
    显示已连接的 ESPHome 设备的 MAC 地址。
  • 固件版本（只读）
    显示已连接的 ESPHome 设备的固件版本。

驾驶员操作

重置连接和变量

警告： 这将重置所有连接绑定并删除与变量相关的任何编程。

重置驱动程序连接和变量。如果您更改了连接的 ESPHome 设备，或者存在过时的连接或变量，此功能非常有用。

ratgdo 配置指南

本指南提供了有关配置 ESPHome 驱动程序以与 ratgdo 设备配合使用以通过 Control4 Composer Pro 中的继电器控制车库门的说明。

添加继电器控制器驱动程序
将所需的继电器控制器驱动程序添加到 Composer Pro 中的 Control4 项目。

ESPHome-ESP8266-物理连接到您的设备-（5）

继电器控制器属性
ratgdo 设备在 ESPHome 中公开了一个“Cover”实体，该实体映射到 Control4 中的继电器控制器功能。

继电器数量
ratgdo 设备使用多继电器配置来控制车库门。在 Composer Pro 中，您应该按如下方式配置继电器设置：

  • 设置为 2 个继电器（打开/关闭）或 3 个继电器（打开/关闭/停止）
    • ratgdo 设备使用单独的命令来打开和关闭车库门
    • 如果您的 ratgdo 固件支持“stop”命令，请配置 3 个继电器以启用停止功能。如果您不确定，可以查看 Composer Pro 中的 ratgdo 连接，看看“Stop Door”继电器是否可用。

继电器配置

  • 设置为 脉冲
    • ratgdo 使用瞬时脉冲来触发车库门开启器，类似于按下墙上的按钮

脉冲时间

  • 将所有继电器脉冲时间设置为 500 （默认）
    • 这是继电器激活的持续时间

反转继电器

  • 将所有反转继电器属性设置为 不 （默认）

接触式防抖

  • 将所有接触去抖时间设置为 250 （默认）
    • 这有助于防止车库门状态传感器的误动作

反转接触

  • 将所有反转接触属性设置为 不 （默认）

Example 属性
作为参考，这里有一个例子ampComposer Pro 中的继电器控制器属性文件：

ESPHome-ESP8266-物理连接到您的设备-（6） ESPHome-ESP8266-物理连接到您的设备-（7）

继电器控制器连接

继电器

  • 打开： 连接到 ratgdo 的“开门”继电器
  • 关闭： 连接到 ratgdo 的“关门”继电器
  • 车站 连接到 ratgdo 的“停止门”继电器（如果可用）

接触式传感器

  • 已关闭联系方式： 连接到 ratgdo 的“门关闭”触点
  • 已开通联系方式： 连接到 ratgdo 的“开门”触点

Examp文件连接
作为参考，这里有一个例子ampComposer Pro 中的连接示例如下：

ESPHome-ESP8266-物理连接到您的设备-（8）

编程
您可以在 Control4 中创建编程来：

  • 根据事件打开/关闭车库门
  • 监控车库门状态
  • 设置车库门状态变化通知
  • 在触摸屏和遥控器上创建自定义按钮

Example：创建仍然打开的警报

使用继电器控制器驱动程序的“静止打开时间”属性：

  1. 将“仍然开放时间”设置为您想要的持续时间（例如 10 分钟）
  2. 创建在“Still Open”事件触发时触发的编程规则
  3. 添加操作以发送通知或执行其他任务

附加实体
根据您的 ratgdo 设备、固件及其功能，ESPHome 驱动程序可能会暴露其他实体。这些实体可以是额外的连接或驱动程序变量。

有关特定实体的更多信息，请参阅 ratgdo 的文档： https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

开发者信息
版权所有 © 2025 Finite Labs LLC
本文包含的所有信息均为 Finite Labs LLC 及其供应商（如有）的财产，且始终归其所有。本文包含的知识和技术概念均为 Finite Labs LLC 的专有财产。
Finite Labs LLC 及其供应商可能受美国及外国专利、正在申请的专利保护，并受商业秘密或版权法保护。未经 Finite Labs LLC 事先书面许可，严禁传播此信息或复制此材料。如需了解最新信息，请访问 https://drivercentral.io/platforms/control4-drivers/utility/esphome

支持
如果您对将此驱动程序与 Control4 或 ESPHome 集成有任何疑问或问题，请联系我们 driver-support@finitelabs.com 或致电/发短信至 +1 949-371-5805.

更新日志

v20250715 – 2025 年 07 月 14 日

  • 固定的： 修复了导致连接时无法发现实体的错误

v20250714 – 2025 年 07 月 14 日

  • 额外： 增加了使用设备加密的加密连接支持

v20250619 – 2025 年 06 月 19 日

  • 额外 ：添加了 ratgdo 特定文档

v20250606 – 2025 年 06 月 06 日

  • 额外 :初始版本

常问问题

哪些设备与该驱动程序兼容？

此驱动程序兼容所有 ESPHome 设备，并在 ratgdo 设备上进行了广泛的测试。如果您在其他设备上试用成功，请告知我们进行验证。

文件/资源

ESPHome ESP8266 物理连接到您的设备 [pdf] 用户指南
ESP8266、ESP32、ESP8266 物理连接到您的设备、ESP8266、物理连接到您的设备、连接到您的设备、到您的设备、您的设备

参考

发表评论

您的电子邮件地址不会被公开。 必填字段已标记 *