Event Group FreeRTOS untuk Status Wi-Fi dan MQTT

Jalur belajar: FreeRTOS & Arsitektur Firmware · Tingkat: Menengah. Menggabungkan beberapa kondisi readiness tanpa polling variabel acak.

Gambaran mudah: Event bits seperti panel lampu indikator. Aplikasi dapat menunggu sampai lampu Wi-Fi dan MQTT sama-sama menyala.

Mengapa praktikum ini penting?

Dalam proyek IoT, masalah jarang berhenti pada satu baris kode. Hardware, catu daya, firmware, jaringan, format data, dan perilaku pengguna saling berhubungan. Karena itu tutorial ini tidak hanya memberi potongan kode, tetapi juga menunjukkan cara berpikir: mulai dari membuat model sederhana, menguji bukti, lalu menambah kompleksitas setelah dasar terbukti benar.

Menggabungkan beberapa kondisi readiness tanpa polling variabel acak. Fokus utamanya adalah menghasilkan sistem kecil yang dapat dijelaskan. Jika Anda bisa menjelaskan apa inputnya, bagaimana data diproses, apa outputnya, serta apa yang terjadi ketika kondisi gagal, berarti Anda sudah memahami lebih dari sekadar menyalin sketch.

Tujuan belajar

• Memahami konsep utama menggabungkan beberapa kondisi readiness tanpa polling variabel acak.
• Membangun contoh minimal yang dapat diuji langkah demi langkah sebelum ditambah fitur lain.
• Mencatat hasil pengujian sehingga kesalahan dapat dilokalisasi, bukan ditebak.
• Mengetahui batas praktikum dan arah pengembangan berikutnya.

Perangkat, software, dan prasyarat

Gunakan pin dan tegangan berdasarkan board serta modul yang benar-benar Anda miliki. Nama pin pada contoh adalah titik awal, bukan aturan universal. Beberapa varian ESP32 mempunyai kemampuan GPIO, ADC, touch, USB, dan peripheral yang berbeda, sehingga dokumentasi board harus menjadi rujukan terakhir.

Memahami arsitektur sebelum merakit

Alur sederhana untuk tutorial ini dapat dibaca sebagai: WiFi service sets BIT0; MQTT service sets BIT1; telemetry checks both. Menuliskan alur seperti ini sangat membantu ketika debugging. Jika output salah, kita bisa bertanya berurutan: apakah input valid, apakah program membaca input, apakah keputusan benar, apakah transport/driver berhasil, dan apakah output benar-benar diterapkan?

Langkah praktikum

1. Buat event group.
2. Set/clear bit ketika state berubah.
3. Task telemetry menunggu kondisi yang diperlukan.

Setelah setiap langkah, lakukan satu pengamatan kecil. Jangan menunggu sampai seluruh sistem selesai baru menguji. Kebiasaan ini mengurangi jumlah kemungkinan penyebab ketika terjadi error.

Contoh kode atau konfigurasi

EventGroupHandle_t events;
const EventBits_t WIFI_OK=BIT0, MQTT_OK=BIT1;
void maybeSend(){
  EventBits_t b=xEventGroupGetBits(events);
  if((b&(WIFI_OK|MQTT_OK))==(WIFI_OK|MQTT_OK)) Serial.println("siap kirim telemetry");
}

Cara membaca contoh: cari bagian yang berhubungan langsung dengan input, state, dan output. Placeholder seperti SSID, password, host, device ID, atau endpoint harus diganti dengan konfigurasi milik Anda. Jangan menyalin credential nyata ke artikel, screenshot, atau repository publik.

Pengujian yang harus dilakukan

1. Telemetry hanya aktif ketika kondisi terpenuhi.

Selain kondisi normal, sengaja lakukan satu pengujian gagal yang aman. Misalnya melepas sensor, mematikan Wi-Fi, mengirim command invalid, atau membuat endpoint tidak tersedia. Sistem IoT yang baik tidak hanya bekerja ketika semua komponen sempurna, tetapi juga mempunyai perilaku yang bisa diprediksi saat sebagian komponen gagal.

Troubleshooting: jika hasil belum sesuai

• Bit tidak pernah clear: lifecycle state tidak lengkap.

Gunakan pendekatan satu perubahan per iterasi. Catat apa yang diubah dan apa hasilnya. Jika Anda mengganti wiring, library, pin, dan logic sekaligus, keberhasilan berikutnya tidak memberi tahu perubahan mana yang sebenarnya menyelesaikan masalah.

Pengembangan lanjutan

• Tambah TIME_VALID, CONFIG_READY.

Pengembangan lanjutan sebaiknya dilakukan setelah versi minimal stabil. Tambahkan satu fitur, buat test untuk fitur tersebut, lalu simpan versi yang bekerja. Pola ini membuat proyek lebih mudah dipelihara dan sangat membantu saat firmware mulai mempunyai banyak sensor, koneksi jaringan, serta aktuator.

Kesalahan umum yang perlu dihindari

• Menyalin pin, tegangan, atau alamat sensor tanpa memeriksa board dan modul yang benar-benar digunakan.
• Menggabungkan terlalu banyak fitur sebelum versi minimal stabil, sehingga sumber error sulit dilokalisasi.
• Menggunakan delay() panjang atau loop tunggu tanpa timeout pada sistem yang juga harus menjaga koneksi dan membaca input.
• Menganggap satu pembacaan sebagai kebenaran tanpa memeriksa noise, kalibrasi, satuan, dan kondisi error sensor.
• Menyimpan password, token, atau credential nyata di sketch contoh, screenshot, dan repository publik.

Jika satu masalah muncul, kembali ke versi paling sederhana yang pernah terbukti bekerja. Uji hardware lokal terlebih dahulu, kemudian logic, lalu jaringan, dan terakhir integrasi dashboard atau backend. Urutan ini biasanya jauh lebih cepat daripada mengganti banyak bagian secara bersamaan.

Checklist keberhasilan

• Wiring/konfigurasi diverifikasi sebelum menyalakan perangkat.
• Program minimal dapat dijalankan tanpa error yang tidak dipahami.
• Hasil aktual dibandingkan dengan kriteria keberhasilan, bukan hanya “terlihat jalan”.
• Jika gagal, satu variabel diubah per iterasi agar penyebab dapat dilacak.
• Secret dan credential nyata tidak ditempel di source/article publik.

Catatan dokumentasi praktikum

Simpan minimal empat bukti: skema atau tabel koneksi, versi source yang diuji, cuplikan log saat kondisi normal, dan satu log saat kondisi gagal. Jika memakai dashboard, simpan juga nama variabel beserta satuannya. Dokumentasi kecil ini membuat praktikum bisa diulang beberapa minggu kemudian tanpa mengandalkan ingatan, serta membantu orang lain meninjau apakah wiring, firmware, dan data sudah konsisten.

Kesimpulan

Event Group FreeRTOS untuk Status Wi-Fi dan MQTT dirancang sebagai latihan untuk memahami hubungan antara hardware, firmware, dan data secara bertahap. Keberhasilan bukan hanya ditandai oleh output yang muncul, tetapi oleh kemampuan Anda menjelaskan mengapa output itu muncul dan bagaimana sistem bereaksi ketika satu bagian gagal. Simpan catatan wiring, konfigurasi, versi source, serta hasil uji agar praktikum dapat direproduksi.

Referensi teknis

API dan perilaku library dapat berubah mengikuti versi. Periksa dokumentasi resmi sebelum menggunakan contoh pada board atau environment berbeda.

• FreeRTOS Documentation
• MQTT Version 5.0 — OASIS Standard