ESPHome ESP8266 Terhubung Secara Fisik ke Perangkat Anda

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
• Pembaruan waktu nyata dari semua entitas yang didukung yang diekspos oleh perangkat
• Mendukung koneksi terenkripsi menggunakan kunci enkripsi perangkat
• 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:

• ratgdo – Panduan Konfigurasi

Jika Anda mencoba driver ini pada produk yang tercantum di atas, dan berhasil, beri tahu kami!

Entitas ESPHome yang Didukung

Setup Installer

Hanya diperlukan satu instans driver per perangkat ESPHome. Beberapa instans driver ini yang terhubung ke perangkat yang sama akan mengalami perilaku yang tidak terduga. Namun, Anda dapat menghubungkan beberapa instans driver ini ke perangkat ESPHome yang berbeda.

Pengaturan Cloud DriverCentral
Jika Anda sudah memiliki Pengemudi Cloud DriverCentral terinstal di proyek Anda, Anda dapat melanjutkan ke Instalasi Driver.

Driver ini mengandalkan driver DriverCentral Cloud untuk mengelola lisensi dan pembaruan otomatis. Jika Anda baru menggunakan DriverCentral, Anda dapat merujuk ke Dokumentasi Driver Cloud untuk mengaturnya.

Instalasi Driver

Instalasi dan pengaturan driver serupa dengan kebanyakan driver berbasis IP lainnya. Berikut ini adalah ikhtisar langkah-langkah dasar untuk kenyamanan Anda.

1. Unduh yang terbaru control4-esphome.zip dari DriverCentral.
2. Ekstrak dan instal esphome.c4z, esphome_light.c4z, Dan esphome_lock.c4z pengemudi.
3. Gunakan tab “Cari” untuk menemukan driver “ESPHome” dan menambahkannya ke proyek Anda.
4. Pilih driver yang baru ditambahkan di tab "Desain Sistem". Anda akan melihat bahwa Status Cloud mencerminkan status lisensi. Jika Anda telah membeli lisensi, akan muncul "Lisensi Diaktifkan", jika tidak, akan muncul "Uji Coba Berjalan" dan sisa durasi uji coba.
5. Anda dapat menyegarkan status lisensi dengan memilih driver “DriverCentral Cloud” di tab “Desain Sistem” dan melakukan tindakan “Periksa Driver”.
6. Konfigurasikan Pengaturan Perangkat dengan informasi koneksi.
7. Setelah beberapa saat, Status Driver akan menampilkan "Tersambung". Jika driver gagal terhubung, atur properti Mode Log ke "Cetak" dan atur ulang kolom Alamat IP untuk terhubung kembali. Kemudian, periksa jendela keluaran Lua untuk informasi lebih lanjut.
8. Setelah terhubung, driver akan secara otomatis membuat variabel dan koneksi untuk setiap jenis entitas yang didukung.
9. Untuk mengontrol lampu dan/atau kunci, gunakan tab "Cari" untuk menemukan driver "Lampu ESPHome" dan/atau "Kunci ESPHome". Tambahkan satu instans driver untuk setiap entitas lampu atau kunci yang terekspos dalam proyek Anda. Di tab "Koneksi", pilih driver "ESPHome" dan hubungkan entitas lampu atau kunci ke driver yang baru ditambahkan.

Pengaturan Pengemudi

Properti Pengemudi

Pengaturan Awan

• Status Awan
  Menampilkan status lisensi cloud DriverCentral.
• Pembaruan Otomatis
  Mengaktifkan/menonaktifkan pembaruan otomatis cloud DriverCentral.

Pengaturan Pengemudi

• Status Pengemudi (hanya baca)
  Menampilkan status pengemudi saat ini.
• Versi Driver (hanya baca)
  Menampilkan versi driver saat ini.
• Tingkat Log [ Fatal | Kesalahan | Peringatan | Info | Debug | Jejak | Ultra ] Mengatur tingkat pencatatan. Defaultnya adalah Informasi.
• Mode Log [ Mati | Cetak | Log | Cetak dan Log ] Mengatur mode pencatatan. Defaultnya adalah Mati.

Pengaturan Perangkat

Alamat IP
Mengatur alamat IP perangkat (misalnya 192.168.1.30). Nama domain diperbolehkan asalkan dapat dialihkan ke alamat IP yang dapat diakses oleh pengontrol. HTTPS tidak didukung.

Catatan: Jika Anda menggunakan alamat IP, Anda harus memastikan alamat tersebut tidak akan berubah dengan menetapkan IP statis atau membuat reservasi DHCP.

Pelabuhan
Mengatur port perangkat. Port default untuk perangkat ESPHome adalah 6053.

• Mode Autentikasi [ Tidak Ada | Kata Sandi | Kunci Enkripsi ]
• Memilih metode autentikasi untuk menghubungkan ke perangkat ESPHome.

Tidak ada: Tidak diperlukan autentikasi.

Kata sandi: Gunakan kata sandi untuk autentikasi (lihat di bawah).

Kunci Enkripsi: Gunakan kunci enkripsi untuk komunikasi yang aman (lihat di bawah).

• Kata sandi
  Hanya ditampilkan jika Mode Autentikasi diatur ke Kata Sandi. Mengatur kata sandi perangkat. Kata sandi ini harus sama dengan kata sandi yang dikonfigurasi pada perangkat ESPHome.
• Kunci Enkripsi
  Hanya ditampilkan jika Mode Autentikasi diatur ke Kunci Enkripsi. Mengatur kunci enkripsi perangkat untuk komunikasi yang aman. Kunci ini harus sesuai dengan kunci enkripsi yang dikonfigurasi pada perangkat ESPHome.

Info Perangkat

• Nama (hanya baca)
  Menampilkan nama perangkat ESPHome yang terhubung.
• Model (hanya baca)
  Menampilkan model perangkat ESPHome yang terhubung.
• Produsen (hanya baca)
  Menampilkan produsen perangkat ESPHome yang terhubung.
• Alamat MAC (hanya baca)
  Menampilkan alamat MAC perangkat ESPHome yang terhubung.
• Versi Firmware (hanya baca)
  Menampilkan versi firmware perangkat ESPHome yang terhubung.

Tindakan Pengemudi

Setel Ulang Koneksi dan Variabel

Peringatan: Ini akan mengatur ulang semua ikatan koneksi dan menghapus semua pemrograman yang terkait dengan variabel.

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.

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:

• Atur ke 2 Relai (Buka/Tutup) atau 3 Relai (Buka/Tutup/Hentikan)
  • Perangkat ratgdo menggunakan perintah terpisah untuk membuka dan menutup pintu garasi
  • Jika firmware ratgdo Anda mendukung perintah "stop", konfigurasikan 3 relai untuk mengaktifkan fungsi stop. Jika Anda tidak yakin, Anda dapat memeriksa koneksi ratgdo di Composer Pro untuk melihat apakah relai "Stop Door" tersedia.

Konfigurasi Relai

• Diatur ke Detak
  • ratgdo menggunakan pulsa sesaat untuk memicu pembuka pintu garasi, mirip dengan menekan tombol dinding

Waktu Pulsa

• Atur semua waktu pulsa relai ke 500 (bawaan)
  • Ini adalah durasi relai akan diaktifkan

Relai Pembalik

• Atur semua properti relai pembalik ke TIDAK (bawaan)

Hubungi Debounce

• Tetapkan semua waktu debounce kontak ke 250 (bawaan)
  • Ini membantu mencegah sensor status pintu garasi berkedip palsu

Balikkan Kontak

• Atur semua properti kontak terbalik ke TIDAK (bawaan)

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

Koneksi Pengontrol Relai

Relai

• Membuka: Hubungkan ke relai “Pintu Terbuka” ratgdo
• Menutup: Hubungkan ke relai “Tutup Pintu” ratgdo
• Berhenti: Hubungkan ke relai “Stop Door” ratgdo, jika tersedia

Sensor Kontak

• Kontak Tertutup: Hubungkan ke kontak “Pintu Tertutup” ratgdo
• Kontak Terbuka: Hubungkan ke kontak “Pintu Terbuka” ratgdo

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

Pemrograman
Anda dapat membuat pemrograman di Control4 untuk:

• Buka/tutup pintu garasi berdasarkan kejadian
• Pantau kondisi pintu garasi
• Siapkan notifikasi untuk perubahan status pintu garasi
• Buat tombol khusus pada layar sentuh dan remote

Example: Membuat Peringatan Masih Terbuka

Menggunakan properti “Waktu Masih Terbuka” dari driver pengontrol relai:

1. Atur “Waktu Buka Tetap” ke durasi yang Anda inginkan (misalnya, 10 menit)
2. Buat aturan pemrograman yang dipicu saat peristiwa “Masih Terbuka” diaktifkan
3. Tambahkan tindakan untuk mengirim notifikasi atau melakukan tugas lainnya

Entitas Tambahan
Bergantung pada perangkat ratgdo, firmware, dan kemampuannya, mungkin terdapat entitas tambahan yang diekspos oleh driver ESPHome. Entitas ini dapat berupa koneksi tambahan atau variabel driver.

Silakan merujuk pada dokumentasi ratgdo untuk informasi lebih lanjut tentang entitas tertentu: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Informasi Pengembang
Hak Cipta © 2025 Finite Labs LLC
Semua informasi yang terkandung di sini adalah, dan tetap menjadi milik Finite Labs LLC dan para pemasoknya, jika ada. Konsep intelektual dan teknis yang terkandung di sini adalah hak milik
Finite Labs LLC dan para pemasoknya mungkin dilindungi oleh Paten AS dan Luar Negeri, paten yang sedang diproses, dan dilindungi oleh undang-undang rahasia dagang atau hak cipta. Penyebaran informasi ini atau reproduksi materi ini dilarang keras kecuali telah memperoleh izin tertulis sebelumnya dari Finite Labs LLC. Untuk informasi terbaru, silakan kunjungi https://drivercentral.io/platforms/control4-drivers/utility/esphome

Mendukung
Jika Anda memiliki pertanyaan atau masalah dalam mengintegrasikan driver ini dengan Control4 atau ESPHome, Anda dapat menghubungi kami di dukungan pengemudi@finitelabs.com atau hubungi/kirim pesan kepada kami di +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: Menambahkan dukungan untuk koneksi terenkripsi menggunakan enkripsi perangkat

Bahasa Inggris: v20250619 – 2025-06-19

• Ditambahkan : Menambahkan dokumentasi khusus ratgdo

Bahasa Inggris: v20250606 – 2025-06-06

• Ditambahkan :Rilis Awal

Tanya Jawab Umum

Perangkat apa yang kompatibel dengan driver ini?

Driver ini kompatibel dengan semua perangkat ESPHome, dengan pengujian ekstensif yang dilakukan pada perangkat ratgdo. Jika Anda mencobanya di perangkat lain dan berhasil, beri tahu kami untuk verifikasi.

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

• Panduan Pengguna