ESPHome-logo

ESPHome ESP8266 Hoʻohui kino i kāu polokalamu

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

Nā kikoʻī

  • Pono pūnaewele: Mana4 OS 3.3+

Pauview

Hoʻohui i nā mea hoʻohana ESPHome i loko o Control4. ʻO ka ESPHome kahi ʻōnaehana open-source e hoʻololi ana i nā microcontrollers maʻamau, e like me ESP8266 a me ESP32, i mau polokalamu home akamai ma o ka hoʻonohonoho maʻalahi YAML. Hiki ke hoʻonohonoho, nānā ʻia, a hoʻomalu ʻia nā polokalamu ESPHome me ka hoʻohana ʻana i kahi web polokalamu kele pūnaewele, Home Assistant, a i ʻole nā ​​paepae kūpono ʻē aʻe. Hiki i kēia mea hoʻokele ke nānā pono a me ka hoʻomalu ʻana i nā polokalamu ESPHome mai kāu ʻōnaehana Control4.

Nā Koina Pūnaewele

  • Mana4 OS 3.3+

Nā hiʻohiʻona

  • ʻAʻole pono ke kamaʻilio pūnaewele kūloko i nā lawelawe kapua
  • Real-time updates from all supported entities exposed by the device
  • Supports encrypted connections using the device encryption key
  • Kākoʻo Polokalamu Hoʻololi

Hoʻolikelike

Nā hāmeʻa i hōʻoia ʻia
E hana maʻamau kēia mea hoʻokele me kekahi mea ESPHome, akā ua hoʻāʻo nui mākou me kēia mau mea hana:

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

Kākoʻo ʻia nā hui ESPHome

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

Mea hoʻonoho hoʻonohonoho

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.

Hoʻonohonoho ʻo DriverCentral Cloud
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 no ka hoonoho ana.

Hoʻokomo Keaukaha

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

  1. Hoʻoiho i ka mea hou loa control4-esphome.zip mai DriverCentral.
  2. Extract and install the esphome.c4zesphome_light.c4z, a esphome_lock.c4z nā mea hoʻokele.
  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. Hoʻonohonoho i ka Nā hoʻonohonoho hāmeʻa 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.

Hoʻonohonoho Keaukaha

Na Waiwai Keaukaha

Hoʻonohonoho Cloud

  • Kūlana Ao
    Displays the DriverCentral cloud license status.
  • Nā Hou Hou
    Turns on/off the DriverCentral cloud automatic updates.

Nā hoʻonohonoho hoʻokele

  • Kūlana Keaukaha (heluhelu wale nō)
    Hōʻike i ke kūlana o kēia manawa o ka mea hoʻokele.
  • 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 ʻIke.
  • Log Mode [ Off | Print | Log | Print and Log ] Sets the logging mode. Default is Paʻa.

Nā hoʻonohonoho hāmeʻa

IP Address
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.

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

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

ʻAʻohe: No authentication required.

Hua huna: Use a password for authentication (see below).

Kī hoʻopunipuni: Use an encryption key for secure communication (see below).

  • Hua huna
    Shown only if Authentication Mode is set to Password. Sets the device password. This must match the password configured on the ESPHome device.
  • Ki hoʻopāpā
    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.

ʻIke Mea Hana

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

Nā Hana Keaukaha

Hoʻoponopono hou i nā pilina a me nā mea hoʻololi

'Ōlelo Aʻo: This will reset all connection bindings and delete any programming associated with the variables.

E hoʻihoʻi hou i nā pilina hoʻokele a me nā ʻano like ʻole. He mea maikaʻi kēia inā hoʻololi ʻoe i ka polokalamu ESPHome pili a i ʻole nā ​​​​pili paʻa a i ʻole nā ​​ʻano hoʻololi.

ratgdo Ke alakaʻi hoʻonohonoho

Hāʻawi kēia alakaʻi i nā ʻōlelo kuhikuhi no ka hoʻonohonoho ʻana i ka mea hoʻokele ESPHome e hana me nā polokalamu ratgdo no ka hoʻomalu ʻana i ka puka hale kaʻa ma o nā relay ma Control4 Composer Pro.

Hoʻohui i ke Keaukaha Relay Controller
Hoʻohui i ka mea hoʻokele relay makemake i kāu papahana Control4 ma Composer Pro.

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

Mea Hooponopono Relay
Hōʻike ka hāmeʻa ratgdo i kahi hui "Uhi" ma ESPHome, ka palapala ʻāina i ka hana hoʻokele relay ma Control4.

Ka helu o na Relay
Hoʻohana ka mea ratgdo i kahi hoʻonohonoho multi-relay e hoʻomalu i ka puka kaʻa. Ma ka Composer Pro, pono ʻoe e hoʻonohonoho i nā hoʻonohonoho relay penei:

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

Hoʻonohonoho hoʻokuʻu

  • Hoʻonoho i Pulse
    • ratgdo uses momentary pulses to trigger the garage door opener, similar to a wall button press

Manawa Pulse

  • Set all relay pulse times to 500 (paʻamau)
    • This is the duration the relay will be activated

Huli hoʻohuli

  • Set all invert relay properties to ʻAʻole (paʻamau)

Hoʻokaʻaʻike iā Debounce

  • Set all contact debounce times to 250 (paʻamau)
    • This helps prevent false flapping of the garage door state sensors

Hoʻohuli Hoʻopili

  • Set all invert contact properties to ʻAʻole (paʻamau)

Example Waiwai
No ka ʻike, eia kahi exampʻO nā mea hoʻoponopono relay ma Composer Pro:

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

Nā Hoʻohui Hoʻoponopono Relay

Nā Relay

  • Wehe: Connect to the ratgdo’s “Open Door” relay
  • Pani: Connect to the ratgdo’s “Close Door” relay
  • Kū: Connect to the ratgdo’s “Stop Door” relay, if available

Hoʻohui i nā pūlima

  • Paʻa Hoʻokaʻaʻike: Connect to the ratgdo’s “Door Closed” contact
  • Hoʻokaʻaʻike wehe ʻia: Connect to the ratgdo’s “Door Open” contact

Example Hookui
No ka ʻike, eia kahi exampʻO ke ʻano o ka nānā ʻana o nā pilina ma Composer Pro:

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

Papahana
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

Nā mea hou aku
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

ʻIkepili Hoʻolālā
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

Kākoʻo
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

  • Paʻa: Ua hoʻopaʻa ʻia ke kumu i ʻike ʻole ʻia ai nā hui ma ka pilina

v20250714 – 2025-07-14

  • Hoʻohui ʻia: Added support for encrypted connections using the device encryption

v20250619 – 2025-06-19

  • Hoʻohui ʻia : Added ratgdo specific documentation

v20250606 – 2025-06-06

  • Hoʻohui ʻia :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.

Palapala / Punawai

ESPHome ESP8266 Hoʻohui kino i kāu polokalamu [pdf] Ke alakaʻi hoʻohana
ESP8266, ESP32, ESP8266 Hoʻohui kino i kāu hāmeʻa, ESP8266, Hoʻohui kino i kāu hāmeʻa, Hoʻohui i kāu hāmeʻa, i kāu hāmeʻa, kāu hāmeʻa

Nā kuhikuhi

Waiho i kahi manaʻo

ʻAʻole e paʻi ʻia kāu leka uila. Hōʻailona ʻia nā kahua i makemake ʻia *