Isi bersembunyi
1 ESPHome ESP8266 Terhubung Secara Fisik ke Perangkat Anda
2 Spesifikasi
3 Lebihview
4 Persyaratan Sistem
5 Fitur
6 Kesesuaian
7 Entitas ESPHome yang Didukung
8 Setup Installer
9 Instalasi Driver
10 Pengaturan Pengemudi
11 Pengaturan Perangkat
12 Panduan Konfigurasi ratgdo
13 Example: Creating a Still Open Alert
14 Tanya Jawab Umum
15 Dokumen / Sumber Daya
15.1 Referensi

ESPHome-logo

ESPHome ESP8266 Terhubung Secara Fisik ke Perangkat Anda

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

Spesifikasi

  • Persyaratan sistem: Kontrol4 OS 3.3+

Lebihview

Integrasikan perangkat berbasis ESPHome ke Control4. ESPHome adalah sistem sumber terbuka yang mengubah mikrokontroler umum, seperti ESP8266 dan ESP32, menjadi perangkat rumah pintar melalui konfigurasi YAML yang sederhana. Perangkat ESPHome dapat diatur, dipantau, dan dikontrol menggunakan web peramban, Asisten Rumah, atau platform lain yang kompatibel. Driver ini memungkinkan pemantauan dan kontrol perangkat ESPHome yang lancar langsung dari sistem Control4 Anda.

Persyaratan Sistem

  • Kontrol4 OS 3.3+

Fitur

  • Komunikasi jaringan lokal yang tidak memerlukan layanan cloud
  • Real-time updates from all supported entities exposed by the device
  • Supports encrypted connections using the device encryption key
  • Dukungan Pemrograman Variabel

Kesesuaian

Perangkat Terverifikasi
Driver ini secara umum akan berfungsi dengan perangkat ESPHome apa pun, tetapi kami telah mengujinya secara ekstensif dengan perangkat berikut:

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

Entitas ESPHome yang Didukung

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

Setup Installer

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.

Pengaturan Cloud 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 untuk mengaturnya.

Instalasi 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. Unduh yang terbaru control4-esphome.zip dari DriverCentral.
  2. Extract and install the esphome.c4z, esphome_light.c4z, Dan esphome_lock.c4z pengemudi.
  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. Konfigurasikan Pengaturan Perangkat 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.

Pengaturan Pengemudi

Properti Pengemudi

Pengaturan Awan

  • Status Awan
    Displays the DriverCentral cloud license status.
  • Pembaruan Otomatis
    Turns on/off the DriverCentral cloud automatic updates.

Pengaturan Pengemudi

  • Status Pengemudi (hanya baca)
    Menampilkan status pengemudi saat ini.
  • 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 Informasi.
  • Log Mode [ Off | Print | Log | Print and Log ] Sets the logging mode. Default is Mati.

Pengaturan Perangkat

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

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

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

Tidak ada: No authentication required.

Kata sandi: Use a password for authentication (see below).

Kunci Enkripsi: Use an encryption key for secure communication (see below).

  • Kata sandi
    Shown only if Authentication Mode is set to Password. Sets the device password. This must match the password configured on the ESPHome device.
  • Kunci Enkripsi
    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.

Info Perangkat

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

Tindakan Pengemudi

Setel Ulang Koneksi dan Variabel

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

Atur ulang koneksi dan variabel driver. Ini berguna jika Anda mengubah perangkat ESPHome yang terhubung atau terdapat koneksi atau variabel yang sudah usang.

Panduan Konfigurasi ratgdo

Panduan ini menyediakan petunjuk untuk mengonfigurasi driver ESPHome agar bekerja dengan perangkat ratgdo untuk kontrol pintu garasi melalui relai di Control4 Composer Pro.

Tambahkan Driver Pengontrol Relai
Tambahkan driver pengontrol relai yang diinginkan ke proyek Control4 Anda di Composer Pro.

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

Properti Pengontrol Relai
Perangkat ratgdo mengekspos entitas “Cover” di ESPHome, yang memetakan ke fungsionalitas pengontrol relai di Control4.

Jumlah Relay
Perangkat ratgdo menggunakan konfigurasi multi-relai untuk mengontrol pintu garasi. Di Composer Pro, Anda harus mengonfigurasi pengaturan relai sebagai berikut:

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

Konfigurasi Relai

  • Diatur ke Detak
    • ratgdo uses momentary pulses to trigger the garage door opener, similar to a wall button press

Waktu Pulsa

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

Relai Pembalik

  • Set all invert relay properties to TIDAK (bawaan)

Hubungi Debounce

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

Balikkan Kontak

  • Set all invert contact properties to TIDAK (bawaan)

Example Properties
Sebagai referensi, berikut adalah contohnyaample dari properti pengontrol relai di Composer Pro:

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

Koneksi Pengontrol Relai

Relai

  • Membuka: Connect to the ratgdo’s “Open Door” relay
  • Menutup: Connect to the ratgdo’s “Close Door” relay
  • Berhenti: Connect to the ratgdo’s “Stop Door” relay, if available

Sensor Kontak

  • Kontak Tertutup: Connect to the ratgdo’s “Door Closed” contact
  • Kontak Terbuka: Connect to the ratgdo’s “Door Open” contact

Example Koneksi
Sebagai referensi, berikut adalah contohnyaampcontoh bagaimana koneksi seharusnya terlihat di Composer Pro:

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

Pemrograman
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

Entitas Tambahan
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

Informasi Pengembang
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

Mendukung
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 Telepon: 949-371-5805.

Catatan Perubahan

Bahasa Inggris: v20250715 – 2025-07-14

  • Tetap: Memperbaiki bug yang menyebabkan entitas tidak ditemukan saat terhubung

Bahasa Inggris: v20250714 – 2025-07-14

  • Ditambahkan: Added support for encrypted connections using the device encryption

Bahasa Inggris: v20250619 – 2025-06-19

  • Ditambahkan : Added ratgdo specific documentation

Bahasa Inggris: v20250606 – 2025-06-06

  • Ditambahkan :Initial Release

Tanya Jawab Umum

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.

Dokumen / Sumber Daya

ESPHome ESP8266 Terhubung Secara Fisik ke Perangkat Anda [Bahasa Indonesia:] Panduan Pengguna
ESP8266, ESP32, ESP8266 Menghubungkan Secara Fisik ke Perangkat Anda, ESP8266, Menghubungkan Secara Fisik ke Perangkat Anda, Menghubungkan ke Perangkat Anda, ke Perangkat Anda, Perangkat Anda

Referensi

Tinggalkan komentar

Alamat email Anda tidak akan dipublikasikan. Bidang yang wajib diisi ditandai *