Home Assistant + WLED: buat otomasi efek yang dapat dipulihkan

TITIK PEMERIKSAAN / 01

Berikan satu tugas kepada setiap lapisan

WLED mengelola pewaktuan piksel, segmen, dan efek di pengontrol. Home Assistant mengelola konteks ruangan, jadwal, dan otomasi di atas lapisan perangkat itu. Jalur ini baru dapat diandalkan setelah entitas WLED yang tepat dan jalur jaringan yang dipanggil diperiksa.

• Simpan protokol piksel, pemetaan segmen, dan efek di lapisan perangkat WLED.
• Gunakan Home Assistant untuk konteks dan perintah, bukan sebagai pengganti pengontrol atau jalur daya.
• Catat entitas, jalur integrasi, firmware, dan perilaku setelah mulai ulang secara bersamaan.

TITIK PEMERIKSAAN / 02

Buat keadaan WLED yang dikenal dapat dipulihkan

Simpan preset lokal atau keadaan efek yang sudah diuji di WLED sebelum menambahkan otomasi yang rumit. Catat segmen, batas kecerahan, efek, palet, pengenal preset jika ditampilkan, dan perilaku setelah WLED dimulai ulang. Preset adalah keadaan yang dapat dipulihkan untuk satu konfigurasi konkret; bukan bukti untuk pengontrol, firmware, atau varian strip lain.

• Beri nama keadaan berdasarkan ruangan dan tujuan, bukan eksperimen sementara.
• Pertahankan kecerahan dan kecepatan efek dalam rentang yang diukur pada instalasi.
• Pastikan opsi preset atau efek yang tersedia pada entitas Home Assistant yang tepat.

TITIK PEMERIKSAAN / 03

Mulai dengan satu tindakan yang dapat diprediksi

Picu satu entitas, panggil satu efek atau preset yang dikenal, lalu periksa hasilnya dari instans Home Assistant yang sebenarnya. Contoh memakai entitas lampu dan opsi efek yang tersedia; ganti nilainya dengan entitas dan opsi yang benar-benar diuji. Tambahkan kehadiran, media, dan waktu hanya setelah jalur ini stabil.

mode: restart
trigger:
  - trigger: state
    entity_id: binary_sensor.media_mode
    to: "on"
action:
  - action: light.turn_on
    target:
      entity_id: light.media_wall
    data:
      effect: "Solid"

TITIK PEMERIKSAAN / 04

Uji jalur kegagalan dan mulai ulang

Uji otomasi saat WLED dimulai ulang, Home Assistant dimulai ulang, jaringan sementara tidak tersedia, dan pengontrol diberi daya kembali. Tentukan apakah lampu tetap mati, kembali ke keadaan lokal WLED, atau menunggu perintah Home Assistant baru. Jangan menyebut pemulihan otomatis sebelum hasil itu terlihat pada pengontrol, firmware, integrasi, dan urutan daya yang tepat.

• Pisahkan mulai ulang perangkat WLED dari mulai ulang Home Assistant dalam catatan pengujian.
• Periksa keadaan yang dilaporkan entitas saat pengontrol tidak dapat dijangkau.
• Sediakan pemulihan lokal atau manual untuk servis dan kegagalan jaringan.

TITIK PEMERIKSAAN / 05

Tambahkan adegan dan kondisi tanpa menyembunyikan tanggung jawab

Setelah satu tindakan dapat diulang, gunakan adegan Home Assistant atau kondisi tambahan untuk menyatakan tujuan ruangan. Biarkan efek WLED, pemetaan segmen, dan batas kecerahan tetap terlihat di catatan. Untuk beberapa segmen, dokumentasikan entitas yang mengendalikan setiap segmen dan uji tindakan bersamaan; menyalakan satu entitas lampu tidak otomatis mendefinisikan pertunjukan multi-segmen yang aman.

• Tambahkan satu kondisi setiap kali dan pertahankan tindakan dasar untuk diagnosis.
• Simpan entitas, efek atau preset, cakupan segmen, dan pemulihan yang diharapkan dalam catatan pembuatan.
• Perlakukan kehadiran media, jadwal, dan dasbor sebagai konteks opsional di sekitar jalur cahaya yang diuji.

MODE KEGAGALAN

Hal yang biasanya bermasalah

• Otomasi bergantung pada nama efek atau preset yang berubah antarversi firmware.
• Adegan mengasumsikan kanal RGBW atau segmen yang tidak disediakan entitas pilihan.
• Home Assistant diharapkan menggantikan pewaktuan WLED, pengontrol, atau jalur daya.
• Tindakan pertama berhasil, tetapi mulai ulang WLED, mulai ulang Home Assistant, dan kehilangan jaringan tidak diuji secara terpisah.
• Tidak ada pemulihan lokal atau manual yang terdokumentasi setelah pengontrol mulai ulang atau integrasi terputus.

DASAR TEKNIS / VERSI

Jaga keputusan tetap mutakhir

Panduan ini dipelihara sebagai rekaman teknis berversi. Periksa kembali dokumentasi protokol terbaru dan revisi produk yang tepat sebelum menggunakannya dalam instalasi produksi.