Hướng dẫn sử dụng ESPHome ESP8266 kết nối vật lý với thiết bị của bạn

Tích hợp các thiết bị dựa trên ESPHome vào Control4. ESPHome là một hệ thống mã nguồn mở giúp chuyển đổi các bộ vi điều khiển thông thường, như ESP8266 và ESP32, thành các thiết bị nhà thông minh thông qua cấu hình YAML đơn giản. Các thiết bị ESPHome có thể được thiết lập, giám sát và điều khiển bằng web Trình duyệt, Home Assistant hoặc các nền tảng tương thích khác. Trình điều khiển này cho phép giám sát và điều khiển liền mạch các thiết bị ESPHome trực tiếp từ hệ thống Control4 của bạn.

Yêu cầu hệ thống

Hệ điều hành Control4 3.3+

Đặc trưng

Giao tiếp mạng cục bộ không yêu cầu dịch vụ đám mây
Real-time updates from all supported entities exposed by the device
Supports encrypted connections using the device encryption key
Hỗ trợ lập trình biến

Khả năng tương thích

Các thiết bị đã được xác minh
Trình điều khiển này nhìn chung sẽ hoạt động với mọi thiết bị ESPHome, nhưng chúng tôi đã thử nghiệm rộng rãi với các thiết bị sau:

ratgdo – Hướng dẫn cấu hình

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

Các thực thể ESPHome được hỗ trợ

Thiết lập trình cài đặt

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.

Thiết lập đám mây 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 để thiết lập nó.

Cài đặt trình điều khiển

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

Tải xuống phiên bản mới nhất control4-esphome.zip từ DriverCentral.
Extract and install the esphome.c4z, esphome_light.c4z, Và esphome_lock.c4z tài xế.
Use the “Search” tab to find the “ESPHome” driver and add it to your project.

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.
You can refresh license status by selecting the “DriverCentral Cloud” driver in the “System Design” tab and perform the “Check Drivers” action.

Cấu hình Cài đặt thiết bị with the connection information.
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.
Once connected, the driver will automatically create variables and connections for each supported entity type.

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.

Thiết lập trình điều khiển

Thuộc tính trình điều khiển

Cài đặt đám mây

Trạng thái đám mây
Displays the DriverCentral cloud license status.
Cập nhật tự động
Turns on/off the DriverCentral cloud automatic updates.

Cài đặt trình điều khiển

Trạng thái trình điều khiển (chỉ đọc)
Hiển thị trạng thái hiện tại của trình điều khiển.

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 Thông tin.

Log Mode [ Off | Print | Log | Print and Log ] Sets the logging mode. Default is Tắt.

Cài đặt thiết bị

Địa chỉ 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.

Ghi chú: If you are using an IP address, you should ensure it will not change by assigning a static IP or creating a DHCP reservation.

Cảng
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.

Không có: No authentication required.

Mật khẩu: Use a password for authentication (see below).

Khóa mã hóa: Use an encryption key for secure communication (see below).

Mật khẩu
Shown only if Authentication Mode is set to Password. Sets the device password. This must match the password configured on the ESPHome device.

Khóa mã hóa
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.

Thông tin thiết bị

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.

Hành động của người lái xe

Đặt lại kết nối và biến

Cảnh báo: This will reset all connection bindings and delete any programming associated with the variables.

Đặt lại kết nối và biến trình điều khiển. Điều này hữu ích nếu bạn thay đổi thiết bị ESPHome được kết nối hoặc có các kết nối hoặc biến cũ.

Hướng dẫn cấu hình ratgdo

Hướng dẫn này cung cấp hướng dẫn cấu hình trình điều khiển ESPHome để hoạt động với các thiết bị ratgdo để điều khiển cửa gara thông qua rơ le trong Control4 Composer Pro.

Thêm trình điều khiển bộ điều khiển rơle
Thêm trình điều khiển bộ điều khiển rơ le mong muốn vào dự án Control4 của bạn trong Composer Pro.

Thuộc tính bộ điều khiển rơle
Thiết bị ratgdo hiển thị thực thể “Cover” trong ESPHome, thực thể này ánh xạ tới chức năng bộ điều khiển rơle trong Control4.

Số lượng rơ le
Thiết bị ratgdo sử dụng cấu hình đa rơle để điều khiển cửa gara. Trong Composer Pro, bạn nên cấu hình cài đặt rơle như sau:

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.

Cấu hình chuyển tiếp

Đặt thành Xung
- ratgdo uses momentary pulses to trigger the garage door opener, similar to a wall button press

Thời gian xung

Set all relay pulse times to 500 (mặc định)
- This is the duration the relay will be activated

Rơ le đảo ngược

Set all invert relay properties to KHÔNG (mặc định)

Liên hệ Debounce

Set all contact debounce times to 250 (mặc định)
- This helps prevent false flapping of the garage door state sensors

Đảo ngược liên hệ

Set all invert contact properties to KHÔNG (mặc định)

Example Properties
Để tham khảo, đây là một ví dụampcác thuộc tính của bộ điều khiển rơle trong Composer Pro:

Kết nối bộ điều khiển rơle

Rơ le

Mở: Connect to the ratgdo’s “Open Door” relay
Đóng: Connect to the ratgdo’s “Close Door” relay
Stop: Connect to the ratgdo’s “Stop Door” relay, if available

Cảm biến tiếp xúc

Liên hệ đóng: Connect to the ratgdo’s “Door Closed” contact
Liên hệ đã mở: Connect to the ratgdo’s “Door Open” contact

Example Kết nối
Để tham khảo, đây là một ví dụampvề cách các kết nối sẽ trông như thế nào trong Composer Pro:

Lập trình
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:

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

Các thực thể bổ sung
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

Thông tin nhà phát triển
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

Ủng hộ
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.

Nhật ký thay đổi

v20250715 – 14-07-2025

Đã sửa: Đã sửa lỗi khiến các thực thể không được phát hiện khi kết nối

v20250714 – 14-07-2025

Đã thêm: Added support for encrypted connections using the device encryption

v20250619 – 19-06-2025

Đã thêm : Added ratgdo specific documentation

v20250606 – 06-06-2025

Đã thêm :Initial Release

Câu hỏi thường gặp

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.

Tài liệu / Tài nguyên

ESPHome ESP8266 Kết nối vật lý với thiết bị của bạn [tập tin pdf] Hướng dẫn sử dụng
ESP8266, ESP32, ESP8266 Kết nối vật lý với thiết bị của bạn, ESP8266, Kết nối vật lý với thiết bị của bạn, Kết nối với thiết bị của bạn, với thiết bị của bạn, Thiết bị của bạn

Tài liệu tham khảo

Hướng dẫn sử dụng

ESPHome ESP8266 Kết nối vật lý với thiết bị của bạn

Thông số kỹ thuật

Quaview