ESPHome ESP8266 Hono-a-tinana ki to Aratohu Kaiwhakamahi Pūrere

Whakauruhia nga taputapu ESPHome ki te Mana4. Ko te ESPHome he punaha tuwhera-puna e huri ana i nga microcontrollers noa, penei i te ESP8266 me te ESP32, ki nga taputapu kaainga atamai ma te whirihoranga YAML ngawari. Ka taea te whakarite, te aro turuki, me te whakahaere i nga taputapu ESPHome ma te whakamahi a web pūtirotiro, Kaiāwhina Kāinga, ētahi atu tūāpapa hototahi ranei. Ka taea e tenei taraiwa te aroturuki me te whakahaere i nga taputapu ESPHome tika mai i to punaha Mana4.

Nga Whakaritenga Pūnaha

Mana4 OS 3.3+

Ngā āhuatanga

Whakawhitiwhiti whatunga rohe me kore he ratonga kapua
Real-time updates from all supported entities exposed by the device
Supports encrypted connections using the device encryption key
Tautoko Papatono Taurangi

Hototahi

Pūrere kua Whakatauhia
Ka mahi noa tenei taraiwa me tetahi taputapu ESPHome, engari kua whakamatauria e matou ki nga taputapu e whai ake nei:

ratgdo – Aratohu Whirihoranga

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

Tautokohia nga Hinonga ESPHome

Tatūnga Kaiwhakanoho

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.

Tatūnga Kapua 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 mo te whakarite.

Tāuta Atekōkiri

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

Tikiake i te mea hou control4-esphome.zip mai DriverCentral.
Extract and install the esphome.c4z, esphome_light.c4z, a esphome_lock.c4z taraiwa.
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.

Whirihorahia te Tautuhinga Pūrere 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.

Tatūnga Atekōkiri

Āhuatanga Atekōkiri

Tautuhinga Kapua

Tūnga Kapua
Displays the DriverCentral cloud license status.
Whakahou Aunoa
Turns on/off the DriverCentral cloud automatic updates.

Tautuhinga Atekōkiri

Tūnga Atekōkiri (pānui-anake)
Ka whakaatu i te mana o te taraiwa.

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 Nga korero.

Log Mode [ Off | Print | Log | Print and Log ] Sets the logging mode. Default is Wehe.

Tautuhinga Pūrere

Wāhitau 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.

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

Tauranga
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.

Kore: No authentication required.

Kupuhipa: Use a password for authentication (see below).

Kī Whakamuna: Use an encryption key for secure communication (see below).

Kupuhipa
Shown only if Authentication Mode is set to Password. Sets the device password. This must match the password configured on the ESPHome device.

Kī Whakamuna
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.

Mōhiohio Pūrere

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.

Nga Mahi taraiwa

Tautuhi Tuhononga me nga Taurangi

Whakatupato: This will reset all connection bindings and delete any programming associated with the variables.

Tautuhi ano i nga hononga taraiwa me nga taurangi. Ka whai hua tenei mena ka huri koe i te taputapu ESPHome hono, he hononga maara, he taurangi ranei.

ratgdo Aratohu Whirihoranga

Ko tenei aratohu he tohutohu mo te whirihora i te taraiwa ESPHome ki te mahi me nga taputapu ratgdo mo te whakahaere kuaha karati ma nga reera i roto i te Control4 Composer Pro.

Tāpiri Kaiwhakahaere Relay Atekōkiri
Tāpirihia te atekōkiri pūmana tānga e hiahiatia ana ki tō kaupapa Control4 i Composer Pro.

Ngā Āhuatanga Kaiwhakahaere Relay
Ka whakaatuhia e te taputapu ratgdo he hinonga "Upi" i roto i te ESPHome, e mapi ana ki te taumahinga kaiwhakahaere relay i Control4.

Te maha o nga Rere
Ko te taputapu ratgdo e whakamahi ana i te whirihoranga relay-maha hei whakahaere i te tatau karati. I roto i te Composer Pro, me whirihora e koe nga tautuhinga relay e whai ake nei:

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.

Whirihoranga Rere

Tautuhi ki Putu
- ratgdo uses momentary pulses to trigger the garage door opener, similar to a wall button press

Te Wa Puhi

Set all relay pulse times to 500 (taunoa)
- This is the duration the relay will be activated

Rere Hurihuri

Set all invert relay properties to Kao (taunoa)

Whakapā atu ki a Debounce

Set all contact debounce times to 250 (taunoa)
- This helps prevent false flapping of the garage door state sensors

Huri Hoapā

Set all invert contact properties to Kao (taunoa)

Example Taonga
Hei tohutoro, koinei te exampKo nga ahuatanga o te kaiwhakahaere relay i Composer Pro:

Hononga Kaiwhakahaere Relay

Rerei

Tuwhera: Connect to the ratgdo’s “Open Door” relay
Katia: Connect to the ratgdo’s “Close Door” relay
Aukati: Connect to the ratgdo’s “Stop Door” relay, if available

Hononga Whakapā

Hoapā Kati: Connect to the ratgdo’s “Door Closed” contact
Whakatuwheratia te Hoapā: Connect to the ratgdo’s “Door Open” contact

Example Hononga
Hei tohutoro, koinei te exampme pehea te ahua o nga hononga ki Composer Pro:

Papatonotanga
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

Nga hinonga taapiri
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

Korero Korero
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

Tautoko
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.

Changelog

v20250715 – 2025-07-14

Kua mau: Kua whakatikahia te pepeha e kore ai e kitea nga hinonga i te hono

v20250714 – 2025-07-14

Kua taapiri: Added support for encrypted connections using the device encryption

v20250619 – 2025-06-19

Kua tapirihia : Added ratgdo specific documentation

v20250606 – 2025-06-06

Kua tapirihia :Initial Release

FAQ

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.

Tuhinga / Rauemi

ESPHome ESP8266 Hono-a-tinana ki to Pūrere [pdf] Aratohu Kaiwhakamahi
ESP8266, ESP32, ESP8266 Tūhono ā-tinana ki tō Pūrere, ESP8266, Hono ā-tinana ki tō Pūrere, Tūhono ki tō Pūrere, ki tō Pūrere, tō Pūrere

Tohutoro

Pukapuka Kaiwhakamahi

ESPHome ESP8266 Hono-a-tinana ki to Pūrere

Whakatakotoranga

Ka mutuview