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

ESPHome-logo

ESPHome ESP8266 物理连接到您的设备

ESPHome-ESP8266-Physically-Connecting-to-your-Device-product

规格

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

超过view

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

系统要求

  • Control4 操作系统 3.3+

特征

  • 无需云服务的本地网络通信
  • Real-time updates from all supported entities exposed by the device
  • Supports encrypted connections using the device encryption key
  • 变量编程支持

兼容性

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

If you try this driver on a product listed above, and it works, let us know!

支持的 ESPHome 实体

ESPHome-ESP8266-Physically-Connecting-to-your-Device- (1) ESPHome-ESP8266-Physically-Connecting-to-your-Device- (2)

安装程式设定

Only a single driver instance is required per ESPHome device. Multiple instances of this driver connected to the same device will have unexpected behavior. However, you can have multiple instances of this driver connected to different ESPHome devices.

DriverCentral 云设置
If you already have the DriverCentral Cloud driver installed in your project you can continue to Driver Installation.

This driver relies on the DriverCentral Cloud driver to manage licensing and automatic updates. If you are new to using DriverCentral you can refer to their Cloud Driver documentation 用于设置它。

驱动程序安装

Driver installation and setup are similar to most other IP-based drivers. Below is an outline of the basic steps for your convenience.

  1. 下载最新 control4-esphome.zip 从 DriverCentral.
  2. Extract and install the esphome.c4z, esphome_light.c4z， 和 esphome_lock.c4z 司机。
  3. Use the “Search” tab to find the “ESPHome” driver and add it to your project.ESPHome-ESP8266-Physically-Connecting-to-your-Device- (3)
  4. Select the newly added driver in the “System Design” tab. You will notice that the Cloud Status reflects the license state. If you have purchased a license it will show “License Activated”, otherwise “Trial Running” and remaining trial duration.
  5. You can refresh license status by selecting the “DriverCentral Cloud” driver in the “System Design” tab and perform the “Check Drivers” action.ESPHome-ESP8266-Physically-Connecting-to-your-Device- (4)
  6. 配置 设备设置 with the connection information.
  7. After a few moments the Driver Status will display “Connected”. If the driver fails to connect, set the Log Mode property to “Print” and re-set the IP Address field to reconnect. Then check the Lua output window for more information.
  8. Once connected, the driver will automatically create variables and connections for each supported entity type.
  9. To control lights and/or locks, use the “Search” tab to find the “ESPHome Light” and/or “ESPHome Lock” driver. Add one driver instance for each exposed light or lock entity in your project. In the “Connections” tab, select the “ESPHome” driver and bind the light or lock entities to the newly added drivers.

驱动程序设置

驱动程序属性

云设置

  • 云状态
    Displays the DriverCentral cloud license status.
  • 自动更新
    Turns on/off the DriverCentral cloud automatic updates.

驱动程序设置

  • 驾驶员状态（只读）
    显示驱动程序的当前状态。
  • Driver Version (read-only)
    Displays the current version of the driver.
  • Log Level [ Fatal | Error | Warning | Info | Debug | Trace | Ultra ] Sets the logging level. Default is 信息.
  • Log Mode [ Off | Print | Log | Print and Log ] Sets the logging mode. Default is 离开.

设备设置

IP 地址
Sets the device IP address (e.g. 192.168.1.30). Domain names are allowed as long as they can be resolved to an accessible IP address by the controller. HTTPS is not supported.

笔记： If you are using an IP address, you should ensure it will not change by assigning a static IP or creating a DHCP reservation.

港口
Sets the device port. The default port for ESPHome devices is 6053.

  • Authentication Mode [ None | Password | Encryption Key ]
  • Selects the authentication method for connecting to the ESPHome device.

没有任何： No authentication required.

密码： Use a password for authentication (see below).

加密密钥： Use an encryption key for secure communication (see below).

  • 密码
    Shown only if Authentication Mode is set to Password. Sets the device password. This must match the password configured on the ESPHome device.
  • 加密密钥
    Shown only if Authentication Mode is set to Encryption Key. Sets the device encryption key for secure communication. This must match the encryption key configured on the ESPHome device.

设备信息

  • Name (read-only)
    Displays the name of the connected ESPHome device.
  • Model (read-only)
    Displays the model of the connected ESPHome device.
  • Manufacturer (read-only)
    Displays the manufacturer of the connected ESPHome device.
  • MAC Address (read-only)
    Displays the MAC address of the connected ESPHome device.
  • Firmware Version (read-only)
    Displays the firmware version of the connected ESPHome device.

驾驶员操作

重置连接和变量

警告： This will reset all connection bindings and delete any programming associated with the variables.

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

ratgdo 配置指南

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

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

ESPHome-ESP8266-Physically-Connecting-to-your-Device- (5)

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

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

  • Set to 2 Relays (Open/Close) or 3 Relays (Open/Close/Stop)
    • The ratgdo device uses separate commands for opening and closing the garage door
    • If your ratgdo firmware supports the “stop” command, configure for 3 relays to enable the stop functionality. If you are not sure, you can look at the ratgdo connections in Composer Pro to see if the “Stop Door” relay is available.

继电器配置

  • 设置为 脉冲
    • ratgdo uses momentary pulses to trigger the garage door opener, similar to a wall button press

脉冲时间

  • Set all relay pulse times to 500 （默认）
    • This is the duration the relay will be activated

反转继电器

  • Set all invert relay properties to 不 （默认）

接触式防抖

  • Set all contact debounce times to 250 （默认）
    • This helps prevent false flapping of the garage door state sensors

反转接触

  • Set all invert contact properties to 不 （默认）

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

ESPHome-ESP8266-Physically-Connecting-to-your-Device- (6) ESPHome-ESP8266-Physically-Connecting-to-your-Device- (7)

继电器控制器连接

继电器

  • 打开： Connect to the ratgdo’s “Open Door” relay
  • 关闭： Connect to the ratgdo’s “Close Door” relay
  • 车站 Connect to the ratgdo’s “Stop Door” relay, if available

接触式传感器

  • 已关闭联系方式： Connect to the ratgdo’s “Door Closed” contact
  • 已开通联系方式： Connect to the ratgdo’s “Door Open” contact

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

ESPHome-ESP8266-Physically-Connecting-to-your-Device- (8)

编程
You can create programming in Control4 to:

  • Open/close the garage door based on events
  • Monitor the garage door state
  • Set up notifications for garage door status changes
  • Create custom buttons on touchscreens and remotes

Example: Creating a Still Open Alert

Using the “Still Open Time” property from the relay controller driver:

  1. Set the “Still Open Time” to your desired duration (e.g., 10 minutes)
  2. Create a programming rule that triggers when the “Still Open” event fires
  3. Add actions to send notifications or perform other tasks

附加实体
Depending on your ratgdo device, firmware, and its capabilities, there may be additional entities exposed by the ESPHome driver. These can come as additional connections or driver variables.

Please refer to ratgdo’s documentation for more information on specific entities: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

开发者信息
Copyright © 2025 Finite Labs LLC
All information contained herein is, and remains the property of Finite Labs LLC and its suppliers, if any. The intellectual and technical concepts contained herein are proprietary to
Finite Labs LLC and its suppliers and may be covered by U.S. and Foreign Patents, patents in process, and are protected by trade secret or copyright law. Dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from Finite Labs LLC. For the latest information, please visit https://drivercentral.io/platforms/control4-drivers/utility/esphome

支持
If you have any questions or issues integrating this driver with Control4 or ESPHome, you can contact us at driver-support@finitelabs.com or call/text us at +1 949-371-5805.

更新日志

v20250715 – 2025 年 07 月 14 日

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

v20250714 – 2025 年 07 月 14 日

  • 额外： Added support for encrypted connections using the device encryption

v20250619 – 2025 年 06 月 19 日

  • 额外 : Added ratgdo specific documentation

v20250606 – 2025 年 06 月 06 日

  • 额外 :Initial Release

常问问题

What devices are compatible with this driver?

This driver is compatible with any ESPHome device, with extensive testing done on ratgdo devices. If you try it on anyother device and it works, kindly inform us for verification.

文件/资源

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

参考

发表评论

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