ESPHome ESP8266 A’ ceangal gu corporra ris an inneal agad

Sònrachaidhean

• Riatanasan an t-siostam: Siostam-obrachaidh Control4 3.3+

Thairisview

Cuir innealan stèidhichte air ESPHome a-steach do Control4. Tha ESPHome na shiostam stòr fosgailte a bhios ag atharrachadh meanbh-riaghladairean cumanta, leithid ESP8266 agus ESP32, gu innealan dachaigh snasail tro rèiteachadh YAML sìmplidh. Faodar innealan ESPHome a stèidheachadh, a sgrùdadh agus a smachdachadh le bhith a’ cleachdadh a web brabhsair, Neach-cuideachaidh Dachaigh, no àrd-ùrlaran co-chòrdail eile. Leigidh an draibhear seo le sgrùdadh agus smachd gun fhiosta air innealan ESPHome dìreach bhon t-siostam Control4 agad.

Riatanasan an t-siostaim

• Siostam-obrachaidh Control4 3.3+

Feartan

• Conaltradh lìonra ionadail nach eil feumach air seirbheisean sgòthan
• Real-time updates from all supported entities exposed by the device
• Supports encrypted connections using the device encryption key
• Taic Prògramadh Caochlaideach

Co-fhreagarrachd

Innealan dearbhte
Bidh an draibhear seo ag obair gu coitcheann le inneal ESPHome sam bith, ach tha sinn air deuchainnean farsaing a dhèanamh leis na h-innealan a leanas:

• ratgdo – Stiùireadh rèiteachaidh

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

Eintiteasan ESPHome a tha air an taiceadh

Suidhich an stàlaichear

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.

Suidheachadh 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 airson a stèidheachadh.

Stàladh driver

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

1. Luchdaich a-nuas an tionndadh as ùire control4-esphome.zip bho DriverCentral.
2. Extract and install the esphome.c4z, esphome_light.c4z, agus esphome_lock.c4z dràibhearan.
3. Use the “Search” tab to find the “ESPHome” driver and add it to your project.
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.
6. Dèan rèiteachadh air an Roghainnean inneal 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.

Suidheachadh driver

Feartan an Draibhear

Roghainnean Cloud

• Inbhe Cloud
  Displays the DriverCentral cloud license status.
• Ùrachaidhean fèin-ghluasadach
  Turns on/off the DriverCentral cloud automatic updates.

Driver roghainnean

• Inbhe an Draibhear (leughaidh a-mhàin)
  A’ taisbeanadh inbhe làithreach an draibhear.
• 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 Fiosrachadh.
• Log Mode [ Off | Print | Log | Print and Log ] Sets the logging mode. Default is dheth.

Roghainnean inneal

Seòladh 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.

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

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

Chan eil gin: No authentication required.

Facal-faire: Use a password for authentication (see below).

Iuchair crioptachaidh: Use an encryption key for secure communication (see below).

• Facal-faire
  Shown only if Authentication Mode is set to Password. Sets the device password. This must match the password configured on the ESPHome device.
• Iuchair crioptachaidh
  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.

Fiosrachadh inneal

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

Gnìomhan Draibhear

Ath-shuidhich Ceanglaichean agus Caochladairean

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

Ath-shuidhich ceanglaichean is caochladairean an draibhear. Tha seo feumail ma dh’atharraicheas tu an inneal ESPHome ceangailte no ma tha ceanglaichean no caochladairean seann-fhasanta ann.

Stiùireadh Rèiteachaidh ratgdo

Tha an iùl seo a’ toirt seachad stiùireadh airson draibhear ESPHome a rèiteachadh gus obrachadh le innealan ratgdo airson smachd doras garaids tro ath-chraolaidhean ann an Control4 Composer Pro.

Cuir draibhear rianadair ath-chraolaidh ris
Cuir an draibhear rianadair sealaidh a tha thu ag iarraidh ris a’ phròiseact Control4 agad ann an Composer Pro.

Feartan an Rianadair Ath-chraolaidh
Bidh an inneal ratgdo a’ nochdadh eintiteas “Còmhdaich” ann an ESPHome, a tha a’ mapadh gu gnìomhachd an rianadair sealaidh ann an Control4.

Àireamh Ath-chuiridhean
Bidh an inneal ratgdo a’ cleachdadh rèiteachadh ioma-sealaidh gus smachd a chumail air doras a’ gharaids. Ann an Composer Pro, bu chòir dhut na roghainnean sealaidh a rèiteachadh mar a leanas:

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

Rèiteachadh Relay

• Suidhich gu Pulse
  • ratgdo uses momentary pulses to trigger the garage door opener, similar to a wall button press

Uair Pulse

• Set all relay pulse times to 500 (àbhaisteach)
  • This is the duration the relay will be activated

Ath-chraoladh Inbhir

• Set all invert relay properties to Chan eil (àbhaisteach)

Cuir fios gu Debounce

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

Cuir fios bun os cionn

• Set all invert contact properties to Chan eil (àbhaisteach)

Exampna Togalaichean
Mar iomradh, seo eisimpleirampfeartan an rianadair sealaidh ann an Composer Pro:

Ceanglaichean Smachdadair Ath-chraolaidh

Ath-chraolaidhean

• Fosgailte: Connect to the ratgdo’s “Open Door” relay
• Dùin: Connect to the ratgdo’s “Close Door” relay
• Stad: Connect to the ratgdo’s “Stop Door” relay, if available

Cuir fios gu Sensors

• Fios Dùinte: Connect to the ratgdo’s “Door Closed” contact
• Fios air fhosgladh: Connect to the ratgdo’s “Door Open” contact

Example Ceanglaichean
Mar iomradh, seo eisimpleirampmar a bu chòir na ceanglaichean a bhith coltach ann an Composer Pro:

Prògramadh
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

Eintiteasan a bharrachd
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

Fiosrachadh luchd-leasachaidh
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

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

Clàr-atharrachaidh

v20250715 – 2025-07-14

• Stèidhichte: Chaidh biast a chàradh a dh’ adhbhraich nach deach eintiteasan a lorg nuair a chaidh ceangal a dhèanamh

v20250714 – 2025-07-14

• Air a chur ris: Added support for encrypted connections using the device encryption

v20250619 – 2025-06-19

• Air a chur ris : Added ratgdo specific documentation

v20250606 – 2025-06-06

• Air a chur ris :Initial Release

Ceistean Cumanta

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.

Sgrìobhainnean/Goireasan

ESPHome ESP8266 A’ ceangal gu corporra ris an inneal agad [pdfStiùireadh Cleachdaiche ESP8266, ESP32, ESP8266 A’ ceangal gu corporra ris an inneal agad, ESP8266, A’ ceangal gu corporra ris an inneal agad, A’ ceangal ris an inneal agad, ris an inneal agad, an inneal agad

Iomraidhean

• Leabhar-làimhe cleachdaiche