
Banyak tutorial IoT berhenti di tahap "lampu LED menyala dari HP". Di proyek nyata, tantangannya jauh lebih besar. Perangkat harus tetap jalan saat WiFi putus, listrik padam, atau sensor rusak. Server harus mengambil keputusan untuk puluhan perangkat sekaligus, dan semuanya harus aman dari akses luar.
Artikel ini merangkum pengalaman tim doIT membangun sistem IoT untuk monitoring dan kontrol AC di lingkungan retail, dari prototipe sampai berjalan di produksi. Stack-nya ESP32 untuk perangkat, MQTT untuk komunikasi, dan Node.js di server Linux untuk backend. Kalau Anda ingin memahami konsepnya lebih dulu, baca juga artikel kami tentang cara kerja IoT automation AC.
Arsitektur Sistem IoT ESP32 yang Kami Pakai
Prinsip utamanya: perangkat dibuat sederhana, keputusan diambil di server. ESP32 hanya membaca sensor, mengirim telemetry, dan menjalankan perintah relay. Semua logika automasi ada di backend.
|
Lapisan |
Teknologi |
Peran |
|---|---|---|
|
Sensor |
Sensor suhu digital DS18B20 |
Membaca suhu per zona |
|
Perangkat |
ESP32 + modul relay |
Kirim telemetry, jalankan relay, baca feedback unit outdoor |
|
Komunikasi |
MQTT (broker Mosquitto) |
Jalur pesan dua arah antara perangkat dan server |
|
Backend |
Node.js (NestJS) + TypeORM |
Mesin automasi, jadwal, proteksi, API, autentikasi |
|
Database |
PostgreSQL |
Konfigurasi, status grup, log perangkat, log aktivitas |
|
Real-time |
Socket.io (WebSocket) |
Mendorong perubahan status langsung ke dashboard |
|
Frontend |
Next.js |
Dashboard denah lantai, pengaturan, laporan |
|
Server |
Linux, PM2, Nginx |
Menjalankan proses, reverse proxy, SSL |
Alur datanya: sensor dibaca ESP32, dikirim lewat MQTT ke backend, disimpan dan dievaluasi, lalu perintah relay dikirim balik lewat MQTT. Pada saat yang sama, perubahan status didorong ke dashboard lewat WebSocket.
Firmware ESP32: Telemetry, Relay, dan Kemampuan Memulihkan Diri
Firmware ESP32 punya tiga tugas: membaca sensor, mengirim telemetry, dan menjalankan relay. Kesulitannya bukan di tiga tugas itu, tetapi di menjaga perangkat tetap hidup tanpa disentuh berbulan-bulan.
1. Baca sensor tanpa memblokir loop. Konversi suhu DS18B20 butuh sekitar 750 ms. Kalau ditunggu secara blocking, loop utama berhenti dan koneksi MQTT bisa terputus. Solusinya, minta konversi lalu ambil hasilnya di putaran berikutnya:
#include <OneWire.h>
#include <DallasTemperature.h>
OneWire oneWire(SENSOR_PIN);
DallasTemperature sensors(&oneWire);
unsigned long lastRequest = 0;
void setup() {
sensors.begin();
sensors.setWaitForConversion(false); // jangan tunggu konversi
sensors.requestTemperatures();
lastRequest = millis();
}
void loop() {
mqttLoop(); // koneksi MQTT tetap dilayani
if (millis() - lastRequest >= 1000) {
float t = sensors.getTempCByIndex(0);
if (t != DEVICE_DISCONNECTED_C) publishTelemetry(t);
sensors.requestTemperatures(); // minta konversi berikutnya
lastRequest = millis();
}
}
2. Watchdog dan deteksi brownout. Watchdog akan me-restart ESP32 kalau firmware macet lebih dari beberapa detik. Deteksi brownout mencegah perangkat berjalan dalam kondisi tegangan tidak stabil. Penyebab restart dikirim di pesan heartbeat, sehingga server tahu apakah perangkat restart karena watchdog, tegangan drop, atau listrik padam.
3. Pemulihan relay bertahap. Setelah restart, relay tidak dinyalakan sekaligus. Status terakhir dipulihkan satu per satu dengan jeda, untuk menghindari lonjakan arus kompresor.
4. Feedback dari unit outdoor. Selain perintah ke relay, ESP32 membaca sinyal arus dari unit outdoor. Dashboard bisa membedakan "perintah ON sudah dikirim" dengan "kompresor benar-benar bekerja".
MQTT: Desain Topic dan Keamanan Jalur Perangkat
MQTT dipilih karena ringan, cocok untuk koneksi yang kadang putus, dan mendukung pola publish/subscribe. Satu broker bisa melayani banyak perangkat dari banyak cabang.
Struktur topic dibuat hierarkis agar satu server bisa mendengarkan semua cabang dengan satu wildcard. Contoh polanya:
iot/{cabang}/{lantai}/telemetry -> suhu dan status relay dari ESP32
iot/{cabang}/{lantai}/heartbeat -> tanda perangkat hidup + penyebab restart
iot/{cabang}/{lantai}/cmd -> perintah relay dari server ke ESP32
Backend cukup subscribe ke iot/#. Menambah cabang baru tidak butuh perubahan kode, cukup perangkat baru yang publish ke topic dengan nama cabangnya.
Keamanan jalur MQTT kami perlakukan terpisah dari jalur dashboard. ESP32 tidak bisa memakai VPN seperti laptop karyawan, jadi perlindungannya dibuat berlapis di sisi broker:
- Koneksi terenkripsi dengan TLS
- Autentikasi username dan password per perangkat, bukan satu akun untuk semua
- Broker hanya menerima koneksi dari alamat IP lokasi yang terdaftar
Dashboard punya jalurnya sendiri: HTTPS dengan akses dibatasi ke jaringan kantor atau VPN klien. Pemisahan ini membuat celah di satu jalur tidak otomatis membuka jalur lainnya.
Backend Node.js: Membangun Mesin Automasi
Backend dibangun dengan NestJS di atas Node.js. Arsitektur modular NestJS memudahkan pemisahan tanggung jawab: modul MQTT, modul automasi, modul jadwal, modul autentikasi, dan modul log aktivitas berdiri sendiri-sendiri.
Evaluasi berkala untuk semua cabang. Sebuah job terjadwal berjalan secara berkala. Job ini mengambil semua cabang, lalu mengevaluasi setiap grup AC berdasarkan suhu terbaru, jadwal, dan status perangkat. Karena loop-nya berbasis data, menambah cabang tidak butuh kode baru.
State disimpan di database, bukan di memori. Status setiap grup, misalnya berapa AC yang sedang dimatikan, disimpan di tabel. Kalau backend di-restart saat update, sistem melanjutkan dari kondisi terakhir, bukan mulai dari nol.
Hysteresis bertingkat. Ini contoh logika yang disederhanakan. Level 0 berarti semua AC menyala, level 1 berarti satu AC mati, level 2 berarti dua AC mati:
interface GroupConfig {
top: number; // batas atas: semua AC boleh menyala lagi
bottom1: number; // batas bawah 1: matikan 1 AC
bottom2: number; // batas bawah 2: matikan 2 AC
}
function nextCoolLevel(temp: number, current: number, cfg: GroupConfig): number {
// Suhu turun: tambah jumlah AC yang dimatikan
if (temp <= cfg.bottom2) return 2;
if (temp <= cfg.bottom1) return Math.max(current, 1);
// Suhu naik: kurangi level dengan ambang yang BERBEDA
if (current === 2 && temp > cfg.bottom1) return 1;
if (current === 1 && temp >= cfg.top) return 0;
return current; // di antara ambang: pertahankan kondisi
}
Kuncinya ada di baris terakhir. Selama suhu berada di antara dua ambang, level tidak berubah. Inilah yang mencegah AC hidup-mati setiap kali suhu bergeser 0,1 derajat.
Rotasi AC yang dimatikan. Setiap grup menyimpan pointer giliran. Saat level naik, AC yang dimatikan diambil mulai dari pointer itu, lalu pointer digeser. Dengan begitu jam kerja AC dalam satu grup lebih merata.
Penanganan listrik kembali. Backend mencatat kapan setiap lantai mulai offline. Saat heartbeat kembali, backend menghitung lama padam dan mengecek apakah padam terjadi di jam operasional. Kalau iya, grup masuk mode aman: AC dimatikan dulu, lalu dinyalakan bertahap oleh mesin automasi.
Log aktivitas. Setiap perubahan setpoint, jadwal, atau mode manual dicatat lengkap dengan pengguna yang melakukannya. Akses dashboard memakai JWT dengan pembagian peran, misalnya superadmin dan operator.
Dashboard Real-Time dengan WebSocket
Dashboard dibangun dengan Next.js dan menerima pembaruan lewat Socket.io. Setiap kali telemetry masuk atau mesin automasi mengubah status relay, backend mendorong event ke browser. Pengguna tidak perlu me-refresh halaman untuk melihat suhu atau status AC terbaru.
Tampilannya dibuat dua tingkat:
- Ringkasan per lantai: gauge suhu tiap area, sehingga kondisi gedung terbaca dalam beberapa detik
- Detail denah lantai: posisi setiap AC di denah, suhu per grup, status relay, dan konfirmasi kompresor dari feedback unit outdoor
Denah setiap cabang disimpan sebagai layout terpisah dengan layout bawaan sebagai cadangan. Cabang baru tetap bisa dipantau walau denah khususnya belum dibuat.
Dari data yang sama, dashboard juga menyajikan laporan heatmap suhu per zona dan total jam nyala setiap AC. Laporan ini yang biasanya paling dihargai manajemen, karena memberi dasar untuk evaluasi energi dan jadwal perawatan.
Deployment di Server Linux
Semua komponen server berjalan di Linux: backend Node.js, frontend Next.js, broker MQTT, dan PostgreSQL. Beberapa hal yang kami pastikan di tahap ini:
Jalankan hasil build, bukan source. Backend NestJS di-build dulu, lalu folder hasil build dijalankan oleh PM2 agar proses otomatis hidup kembali kalau crash atau server reboot.
npm run build
pm2 start dist/main.js --name iot-backend
pm2 save
Reverse proxy harus mendukung WebSocket. Tanpa header upgrade, dashboard tetap terbuka tetapi data real-time tidak pernah sampai. Konfigurasi Nginx minimalnya:
location /socket.io/ {
proxy_pass http://127.0.0.1:BACKEND_PORT;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
Pakai domain, bukan IP. Frontend memanggil API lewat domain yang disimpan di environment variable. Saat server pindah atau IP berubah, cukup ubah DNS tanpa build ulang aplikasi klien.
Keamanan berlapis. Akses administrasi server dibuka lewat tunnel zero trust dengan autentikasi identitas dan MFA, sehingga panel dan SSH tidak terbuka ke internet. Dashboard dibatasi ke jaringan klien, broker MQTT dilindungi TLS dan autentikasi per perangkat, dan database di-backup rutin ke object storage terpisah.
Pelajaran dari Lapangan
Bagian ini jarang ada di tutorial, padahal paling menentukan apakah sistem IoT bertahan di produksi.
- Catu daya ESP32 harus stabil dan terpisah. Restart acak sering bukan bug firmware, tetapi tegangan yang turun saat beban listrik di panel berubah. Log penyebab restart di heartbeat membantu membuktikannya.
- Sensor bisa rusak, sistem tidak boleh ikut rusak. Grup yang sensornya bermasalah dipindah ke mode manual, dan dashboard menampilkan "tidak ada data", bukan angka palsu yang bisa memicu automasi keliru.
- Satu ambang suhu tidak pernah cukup. Versi awal memakai satu batas bawah, dan AC kedua menyala terlalu cepat. Hysteresis bertingkat lahir dari masukan pengguna di lapangan.
- Tidak semua listrik padam sama. Padam di luar jam operasional tidak perlu diperlakukan sama dengan padam saat toko ramai. Keputusan pemulihan harus memperhitungkan waktu padam.
- Rancang multi-cabang sejak hari pertama. Konfigurasi per cabang, topic MQTT hierarkis, dan layout denah dengan cadangan bawaan membuat ekspansi jauh lebih murah.
- Hal kecil bisa menghabiskan berjam-jam. Contohnya password database yang mengandung karakter
#di file.env. Tanpa tanda kutip, sisa nilai setelah#dianggap komentar dan autentikasi gagal.
FAQ Seputar Membangun Sistem IoT ESP32
Kenapa memakai MQTT, bukan HTTP biasa? MQTT lebih ringan, koneksinya persisten, dan mendukung pola publish/subscribe. Server bisa mengirim perintah ke ESP32 kapan saja tanpa menunggu perangkat bertanya lebih dulu.
Kenapa backend memakai Node.js? Node.js unggul menangani banyak koneksi kecil secara bersamaan, cocok untuk telemetry dari banyak perangkat. Ekosistemnya juga lengkap untuk MQTT, WebSocket, dan database.
Apakah logika automasi sebaiknya di ESP32 atau di server? Untuk satu ruangan, logika di ESP32 cukup. Untuk banyak lantai atau cabang, logika di server lebih mudah diubah, dipantau, dan dikembangkan tanpa flash ulang firmware.
Database apa yang cocok untuk sistem IoT seperti ini? Kami memakai PostgreSQL untuk konfigurasi, status, dan log. Untuk skala telemetry yang sangat besar, tabel log bisa dipartisi atau dipindah ke database time-series.
Apakah sistem seperti ini bisa dibuat untuk kebutuhan selain AC? Bisa. Pola sensor, ESP32, MQTT, dan server yang sama bisa dipakai untuk monitoring suhu ruang pendingin, mesin produksi, pompa air, atau penerangan.
Penutup: Dari Prototipe ke Sistem Produksi
Membangun sistem IoT dengan ESP32, MQTT, dan Node.js tidak sulit di tahap prototipe. Yang membedakan sistem produksi adalah ketahanannya: firmware yang memulihkan diri, state yang tidak hilang saat restart, automasi yang memahami kondisi lapangan, dan keamanan yang dipisah per jalur.
Semua pengalaman di artikel ini kami terapkan saat membangun Software IoT Custom untuk monitoring dan kontrol AC jaringan retail, yang kini berjalan stabil dan dilanjutkan ke cabang-cabang berikutnya.
Sebagai software house dan system integrator sejak 2017, doIT mengerjakan custom software dari firmware perangkat sampai dashboard dan integrasi sistem perusahaan. Kalau tim Anda sedang merencanakan proyek IoT, atau punya prototipe yang perlu dibawa ke produksi, kami siap membantu.
Diskusikan proyek IoT Anda dengan tim doIT.
Baca juga : Bisakah AC Menyala dan Mati Otomatis Mengikuti Suhu? (IoT Automation)