Perangkat Home Assistant dan ESPHome di sebuah ESP32
Menengah
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
Sebagian besar perangkat di smart home buatan sendiri berukuran kecil: sebuah board yang membaca beberapa sensor di satu ruangan, relay yang menekan tombol, strip LED yang meredup. Semuanya berjalan di ESP32, dan ESPHome membuatnya mudah di-flash tanpa menulis kode. Yang masih sulit adalah bagian yang disembunyikan YAML: pin mana yang bisa dipakai sensor, kenapa hasil pembacaan tidak masuk akal, kenapa lampu berkedip saat senja.
Rangkaian di atas adalah multisensor ruangan di ESP32-C3 di Mokxi: DHT22 untuk suhu dan kelembapan, BH1750 untuk cahaya, dan PIR untuk gerakan. Tekan Jalankan, klik PIR-nya, dan Serial Monitor menampilkan setiap pembacaan sebagai pesan yang akan dikirim board. Buka tab Web dan nilai yang sama kembali sebagai JSON dari server milik board itu sendiri.
Dua hal dari awal, karena keduanya penting. Mokxi menjalankan sketch Arduino, bukan ESPHome, jadi setiap perangkat di sini mengerjakan secara manual apa yang seharusnya dikerjakan komponen ESPHome, dan halaman bantuannya menunjukkan YAML yang sesuai untuk saat kamu me-flash board sungguhan. Dan jaringannya disimulasikan, tanpa broker MQTT dan tanpa jalan keluar ke Home Assistant aslimu: board mencetak apa yang akan dikirim alih-alih mengirimnya.
Mau versi langkah demi langkah? Pelajaran "Mulai kursus perangkat Home Assistant" memandu hal ini dengan checkpoint.
Buka pelajaranLima perangkat yang pertama dibuat orang
Mokxi punya template untuk masing-masing: multisensor; sensor radar lorong yang menjaga lampu tetap menyala selama sepuluh detik tenang dan hanya menyalanya saat gelap; pembuka pintu garasi dengan relay melintasi tombol dinding dan dua reed switch; pengendali strip WS2812 dengan nyala, mati, kecerahan, warna, dan efek yang meredup; dan sensor tanaman yang mengubah probe tanah kapasitif menjadi persentase terkalibrasi dengan peringatan saat kehausan.
Masing-masing dirangkai seperti cara kamu membangunnya, dengan sensor yang berbicara ke pin board pada 3.3 V dan modul yang butuh 5 V, seperti PIR atau board radar, di rail tersendiri. Pull-up 5 V pada pin 3.3 V adalah salah satu cara termudah merusak ESP32, dan breadboard di simulator adalah tempat aman untuk belajar ke mana setiap kabel harus pergi.
Gerakan bukanlah kehadiran
Pertanyaan umum di forum Home Assistant adalah kenapa sensor gerak mematikan lampu saat ada orang membaca di sofa. PIR dan radar mikro RCWL-0516 sama-sama mendeteksi gerakan, bukan orang. Board mmWave 24 GHz yang dijual untuk kehadiran, seperti LD2410, juga bisa mendeteksi orang yang diam, dan keduanya berkomunikasi lewat koneksi serial.
Mokxi memodelkan RCWL-0516, jadi template radar memakai trik yang dipakai semua orang dengan sensor gerak: jeda mati. Lorong dianggap terisi begitu ada yang bergerak, dan hanya dianggap kosong setelah sepuluh detik tenang. ESPHome menyebut ide yang sama sebagai filter delayed_off. Templatenya jujur soal batasannya: duduk benar-benar diam cukup lama dan lampu akan padam.
Pintu garasi, dengan aman
Pembuka pintu garasi adalah build paling populer dan yang paling berisiko. Pola amannya adalah yang dipakai contoh pintu garasi ESPHome sendiri dan sebagian besar panduan komunitas: relay yang dipasang melintasi terminal tombol dinding bertegangan rendah pada pembukunya, tertutup sekitar setengah detik, tidak pernah disambung ke listrik utama atau motor, dan satu atau dua reed switch agar perangkat tahu posisi pintu yang sebenarnya.
Relay harus dalam keadaan mati saat boot dan tidak pernah tetap aktif, dan tidak ada yang boleh melewati photo-eyes pembuka pintu atau pembalikan arahnya saat pintu menabrak sesuatu. Template menulis pin relay ke kondisi rendah sebelum menjadikannya output sehingga tidak bisa klik saat menyala, mengabaikan penekanan kedua dalam satu setengah detik, dan melaporkan masalah jika pintu belum mencapai saklar dalam waktu yang ditentukan.
digitalWrite(RELAY_PIN, HIGH); // the relay closes across the button
pressedAt = millis();
// ...and in loop(), half a second later:
if (pressing && millis() - pressedAt >= PRESS_MS) {
digitalWrite(RELAY_PIN, LOW);
}Dari simulator ke ESPHome
Saat rangkaian sudah berjalan baik, langkah ke perangkat keras sungguhan biasanya lewat ESPHome. Halaman bantuan setiap template mencantumkan YAML yang melakukan tugas yang sama: sensor dht dan bh1750 serta binary sensor gpio untuk multisensor, template cover dengan device_class garage untuk pintu, light esp32_rmt_led_strip untuk strip lampu, dan sensor adc dengan calibrate_linear untuk probe tanaman. Membaca sketch di samping YAML adalah cara bagus untuk memahami apa yang dilakukan tiap komponen di balik layar, yang kamu butuhkan di hari saat pembacaan data bermasalah.
Kursus perangkat Home Assistant memandu kelima perangkat, satu pelajaran untuk masing-masing, dengan pemeriksaan di setiap langkah yang membaca simulasi yang sedang berjalan. Kursus dimulai dari multisensor, karena setiap perangkat berikutnya memakai pola yang sama: baca sebuah komponen, tentukan kapan perubahan layak dilaporkan, publikasikan, dan sajikan status yang sama untuk apa pun yang meminta.
Buka rangkaian ini di editor. ESP32-C3: multisensor ruangan, dengan kabel seperti saat dijalankan di bagian atas halaman ini. Ubah komponen atau nilainya lalu jalankan lagi.
Buka rangkaian iniPertanyaan
Apakah Mokxi menjalankan ESPHome?
Tidak. Mokxi menjalankan sketch Arduino pada ESP32-C3 simulasi. Setiap template melakukan secara manual apa yang dilakukan komponen ESPHome, dan halaman bantuannya menampilkan YAML yang sesuai untuk saat kamu mem-flash board sungguhan.
Apakah board simulasi bisa terhubung ke Home Assistant milikku?
Tidak. Jaringan ini disimulasikan dan tetap di dalam tab browser, tanpa MQTT broker. Sketch mencetak pesan yang akan dipublikasikan dan menyajikan statusnya sebagai JSON ke tab Web.
Apakah RCWL-0516 adalah sensor kehadiran mmWave?
Tidak. Itu adalah sensor Doppler gelombang mikro yang mendeteksi gerakan. Board mmWave seperti LD2410 juga bisa mendeteksi orang yang duduk diam; Mokxi tidak memodelkannya.
Bagaimana sebaiknya pembuka pintu garasi disambungkan kabelnya?
Melintasi terminal tombol dinding bertegangan rendah milik pembuka dengan relay yang mati saat boot dan menutup sebentar saja, tidak pernah ke listrik utama atau motor, agar photo-eyes dan pembalikan arah pembuka tetap berfungsi.
Lanjutkan
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.