ESPHome ESP8266 Menyambung Secara Fizikal ke Peranti anda

Spesifikasi

• Keperluan sistem: Control4 OS 3.3+

Berakhirview

Mengintegrasikan peranti berasaskan ESPHome ke dalam Control4. ESPHome ialah sistem sumber terbuka yang mengubah mikropengawal biasa, seperti ESP8266 dan ESP32, kepada peranti rumah pintar melalui konfigurasi YAML yang mudah. Peranti ESPHome boleh disediakan, dipantau dan dikawal menggunakan a web penyemak imbas, Home Assistant atau platform lain yang serasi. Pemacu ini membolehkan pemantauan dan kawalan lancar peranti ESPHome terus daripada sistem Control4 anda.

Keperluan Sistem

• Control4 OS 3.3+

Ciri-ciri

• Komunikasi rangkaian tempatan tidak memerlukan perkhidmatan awan
• Kemas kini masa nyata daripada semua entiti yang disokong yang didedahkan oleh peranti
• Menyokong sambungan yang disulitkan menggunakan kunci penyulitan peranti
• Sokongan Pengaturcaraan Boleh Ubah

Keserasian

Peranti yang Disahkan
Pemacu ini secara umum akan berfungsi dengan mana-mana peranti ESPHome, tetapi kami telah menguji secara meluas dengan peranti berikut:

• ratgdo – Panduan Konfigurasi

Jika anda mencuba pemacu ini pada produk yang disenaraikan di atas, dan ia berfungsi, beritahu kami!

Entiti ESPHome yang disokong

Persediaan Pemasang

Hanya satu contoh pemacu diperlukan bagi setiap peranti ESPHome. Berbilang kejadian pemacu ini yang disambungkan ke peranti yang sama akan mempunyai tingkah laku yang tidak dijangka. Walau bagaimanapun, anda boleh mempunyai beberapa contoh pemacu ini disambungkan ke peranti ESPHome yang berbeza.

Persediaan Awan DriverCentral
Jika anda sudah mempunyai Pemacu DriverCentral Cloud dipasang dalam projek anda, anda boleh teruskan ke Pemasangan Pemandu.

Pemacu ini bergantung pada pemacu DriverCentral Cloud untuk mengurus pelesenan dan kemas kini automatik. Jika anda baru menggunakan DriverCentral anda boleh merujuk kepada mereka Dokumentasi Cloud Driver untuk menetapkannya.

Pemasangan Pemandu

Pemasangan dan persediaan pemacu adalah serupa dengan kebanyakan pemacu berasaskan IP lain. Di bawah ialah garis besar langkah asas untuk kemudahan anda.

1. Muat turun yang terkini control4-esphome.zip daripada DriverCentral.
2. Ekstrak dan pasang esphome.c4z, esphome_light.c4z, dan esphome_lock.c4z pemandu.
3. Gunakan tab "Cari" untuk mencari pemacu "ESPHome" dan tambahkannya pada projek anda.
4. Pilih pemacu yang baru ditambah dalam tab "Reka Bentuk Sistem". Anda akan melihat bahawa Status Awan mencerminkan keadaan lesen. Jika anda telah membeli lesen, ia akan menunjukkan "Lesen Diaktifkan", sebaliknya "Percubaan Menjalankan" dan baki tempoh percubaan.
5. Anda boleh memuat semula status lesen dengan memilih pemacu "DriverCentral Cloud" dalam tab "Reka Bentuk Sistem" dan lakukan tindakan "Semak Pemacu".
6. Konfigurasikan Tetapan Peranti dengan maklumat sambungan.
7. Selepas beberapa saat Status Pemandu akan memaparkan "Disambungkan". Jika pemandu gagal menyambung, tetapkan sifat Mod Log kepada "Cetak" dan tetapkan semula medan Alamat IP untuk menyambung semula. Kemudian semak tetingkap output Lua untuk mendapatkan maklumat lanjut.
8. Setelah disambungkan, pemacu akan membuat pembolehubah dan sambungan secara automatik untuk setiap jenis entiti yang disokong.
9. Untuk mengawal lampu dan/atau kunci, gunakan tab "Cari" untuk mencari pemacu "Cahaya ESPhome" dan/atau "Kunci ESPhome". Tambahkan satu contoh pemacu untuk setiap entiti cahaya atau kunci yang terdedah dalam projek anda. Dalam tab "Sambungan", pilih pemacu "ESPHome" dan ikat entiti cahaya atau kunci pada pemacu yang baru ditambah.

Persediaan Pemandu

Sifat Pemandu

Tetapan Awan

• Status Awan
  Memaparkan status lesen awan DriverCentral.
• Kemas Kini Automatik
  Menghidupkan/mematikan kemas kini automatik awan DriverCentral.

Tetapan Pemandu

• Status Pemandu (baca sahaja)
  Memaparkan status semasa pemandu.
• Versi Pemandu (baca sahaja)
  Memaparkan versi semasa pemandu.
• Tahap Log [ Maut | Ralat | Amaran | Maklumat | Nyahpepijat | Jejak | Ultra ] Menetapkan tahap pengelogan. Lalai ialah info.
• Mod Log [ Mati | Cetak | Log | Cetak dan Log ] Menetapkan mod pengelogan. Lalai ialah Mati.

Tetapan Peranti

Alamat IP
Menetapkan alamat IP peranti (cth 192.168.1.30). Nama domain dibenarkan selagi ia boleh diselesaikan ke alamat IP yang boleh diakses oleh pengawal. HTTPS tidak disokong.

Nota: Jika anda menggunakan alamat IP, anda harus memastikan ia tidak akan berubah dengan memberikan IP statik atau membuat tempahan DHCP.

Pelabuhan
Menetapkan port peranti. Port lalai untuk peranti ESPHome ialah 6053.

• Mod Pengesahan [ Tiada | Kata laluan | Kunci Penyulitan ]
• Memilih kaedah pengesahan untuk menyambung ke peranti ESPHome.

tiada: Tiada pengesahan diperlukan.

kata laluan: Gunakan kata laluan untuk pengesahan (lihat di bawah).

Kunci Penyulitan: Gunakan kunci penyulitan untuk komunikasi selamat (lihat di bawah).

• Kata laluan
  Ditunjukkan hanya jika Mod Pengesahan ditetapkan kepada Kata Laluan. Menetapkan kata laluan peranti. Ini mesti sepadan dengan kata laluan yang dikonfigurasikan pada peranti ESPHome.
• Kunci Penyulitan
  Ditunjukkan hanya jika Mod Pengesahan ditetapkan kepada Kunci Penyulitan. Menetapkan kunci penyulitan peranti untuk komunikasi selamat. Ini mesti sepadan dengan kunci penyulitan yang dikonfigurasikan pada peranti ESPHome.

Maklumat Peranti

• Nama (baca sahaja)
  Memaparkan nama peranti ESPHome yang disambungkan.
• Model (baca sahaja)
  Memaparkan model peranti ESPHome yang disambungkan.
• Pengilang (baca sahaja)
  Memaparkan pengeluar peranti ESPHome yang disambungkan.
• Alamat MAC (baca sahaja)
  Memaparkan alamat MAC peranti ESPHome yang disambungkan.
• Versi Perisian Tegar (baca sahaja)
  Memaparkan versi perisian tegar peranti ESPHome yang disambungkan.

Tindakan Pemandu

Tetapkan Semula Sambungan dan Pembolehubah

Amaran: Ini akan menetapkan semula semua pengikatan sambungan dan memadam sebarang pengaturcaraan yang dikaitkan dengan pembolehubah.

Tetapkan semula sambungan pemacu dan pembolehubah. Ini berguna jika anda menukar peranti ESPHome yang disambungkan atau terdapat sambungan atau pembolehubah yang lapuk.

Panduan Konfigurasi ratgdo

Panduan ini menyediakan arahan untuk mengkonfigurasi pemacu ESPHome untuk berfungsi dengan peranti ratgdo untuk kawalan pintu garaj melalui geganti dalam Control4 Composer Pro.

Tambah Pemacu Pengawal Geganti
Tambahkan pemacu pengawal geganti yang dikehendaki pada projek Control4 anda dalam Composer Pro.

Ciri-ciri Pengawal Geganti
Peranti ratgdo mendedahkan entiti "Penutup" dalam ESPHome, yang memetakan kepada fungsi pengawal geganti dalam Control4.

Bilangan Geganti
Peranti ratgdo menggunakan konfigurasi berbilang geganti untuk mengawal pintu garaj. Dalam Composer Pro, anda harus mengkonfigurasi tetapan geganti seperti berikut:

• Tetapkan kepada 2 Geganti (Buka/Tutup) atau 3 Geganti (Buka/Tutup/Berhenti)
  • Peranti ratgdo menggunakan arahan berasingan untuk membuka dan menutup pintu garaj
  • Jika perisian tegar ratgdo anda menyokong arahan "berhenti", konfigurasikan untuk 3 geganti untuk mendayakan fungsi berhenti. Jika anda tidak pasti, anda boleh melihat sambungan ratgdo dalam Composer Pro untuk melihat sama ada geganti "Stop Door" tersedia.

Konfigurasi Geganti

• Tetapkan kepada nadi
  • ratgdo menggunakan denyutan seketika untuk mencetuskan pembuka pintu garaj, sama seperti menekan butang dinding

Masa Nadi

• Tetapkan semua masa nadi geganti kepada 500 (lalai)
  • Ini adalah tempoh geganti akan diaktifkan

Geganti Songsang

• Tetapkan semua sifat geganti songsang kepada Tidak (lalai)

Hubungi Debounce

• Tetapkan semua masa nyahpantun kenalan kepada 250 (lalai)
  • Ini membantu mengelakkan pengepakan palsu penderia keadaan pintu garaj

Terbalikkan Kenalan

• Tetapkan semua sifat hubungan songsang kepada Tidak (lalai)

Example Properties
Untuk rujukan, inilah bekasampsifat pengawal geganti dalam Composer Pro:

Sambungan Pengawal Geganti

Geganti

• Buka: Sambung ke geganti "Pintu Terbuka" ratgdo
• Tutup: Sambungkan ke geganti "Close Door" ratgdo
• Berhenti: Sambung ke geganti "Pintu Berhenti" ratgdo, jika tersedia

Sensor Kenalan

• Hubungan Tertutup: Sambungkan ke kenalan "Door Closed" ratgdo
• Hubungan Terbuka: Sambung ke kenalan "Pintu Terbuka" ratgdo

Example Sambungan
Untuk rujukan, inilah bekasamptentang bagaimana sambungan sepatutnya kelihatan dalam Composer Pro:

Pengaturcaraan
Anda boleh membuat pengaturcaraan dalam Control4 untuk:

• Buka/tutup pintu garaj berdasarkan acara
• Pantau keadaan pintu garaj
• Sediakan pemberitahuan untuk perubahan status pintu garaj
• Buat butang tersuai pada skrin sentuh dan alat kawalan jauh

Example: Mencipta Makluman Masih Terbuka

Menggunakan sifat "Masa Masih Terbuka" daripada pemacu pengawal geganti:

1. Tetapkan "Masa Masih Terbuka" kepada tempoh yang anda inginkan (cth, 10 minit)
2. Buat peraturan pengaturcaraan yang mencetuskan apabila acara "Masih Terbuka" dicetuskan
3. Tambahkan tindakan untuk menghantar pemberitahuan atau melaksanakan tugas lain

Entiti Tambahan
Bergantung pada peranti ratgdo anda, perisian tegar dan keupayaannya, mungkin terdapat entiti tambahan yang didedahkan oleh pemacu ESPHome. Ini boleh datang sebagai sambungan tambahan atau pembolehubah pemacu.

Sila rujuk dokumentasi ratgdo untuk mendapatkan maklumat lanjut tentang entiti tertentu: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Maklumat Pembangun
Hak Cipta © 2025 Finite Labs LLC
Semua maklumat yang terkandung di sini adalah, dan kekal menjadi hak milik Finite Labs LLC dan pembekalnya, jika ada. Konsep intelektual dan teknikal yang terkandung di sini adalah hak milik kepada
Finite Labs LLC dan pembekalnya dan mungkin dilindungi oleh Paten AS dan Asing, paten dalam proses, dan dilindungi oleh undang-undang rahsia perdagangan atau hak cipta. Penyebaran maklumat ini atau pengeluaran semula bahan ini adalah dilarang sama sekali melainkan kebenaran bertulis terlebih dahulu diperoleh daripada Finite Labs LLC. Untuk maklumat terkini, sila layari https://drivercentral.io/platforms/control4-drivers/utility/esphome

Sokongan
Jika anda mempunyai sebarang soalan atau isu menyepadukan pemacu ini dengan Control4 atau ESPHome, anda boleh menghubungi kami di driver-support@finitelabs.com atau hubungi/sms kami di +1 949-371-5805.

Changelog

v20250715 – 2025-07-14

• Tetap: Membetulkan pepijat yang menyebabkan entiti tidak ditemui pada sambungan

v20250714 – 2025-07-14

• Ditambah: Menambah sokongan untuk sambungan yang disulitkan menggunakan penyulitan peranti

v20250619 – 2025-06-19

• Ditambah : Menambahkan dokumentasi khusus ratgdo

v20250606 – 2025-06-06

• Ditambah : Keluaran Awal

Soalan Lazim

Apakah peranti yang serasi dengan pemacu ini?

Pemacu ini serasi dengan mana-mana peranti ESPHome, dengan ujian menyeluruh dilakukan pada peranti ratgdo. Jika anda mencubanya pada peranti lain dan ia berfungsi, sila maklumkan kepada kami untuk pengesahan.

Dokumen / Sumber

ESPHome ESP8266 Menyambung Secara Fizikal ke Peranti anda [pdf] Panduan Pengguna ESP8266, ESP32, ESP8266 Menyambung Secara Fizikal ke Peranti anda, ESP8266, Menyambung Secara Fizikal ke Peranti anda, Menyambung ke Peranti anda, ke Peranti anda, Peranti anda

Rujukan

• Manual Pengguna