Production-firmware

Node HortiLink adalah control authority utama dalam arsitektur per-site. Node berbasis ESP (baseline ESP32) bertanggung jawab atas pembacaan sensor, eksekusi kontrol aktuator, enforcement interlock keselamatan, serta operasi otonom saat gateway atau server tidak tersedia. Node juga menjalankan routing relay-aware intra-site, menghasilkan telemetry dan health message sesuai HTL-01, serta mengelola buffering lokal, OTA client, dan mekanisme watchdog. Dokumen ini mengunci arsitektur firmware, model kontrol lokal, mekanisme routing, serta strategi recovery agar Node tetap deterministik, aman, dan produksi-grade dalam lingkungan pertanian dengan listrik dan jaringan yang tidak stabil.

Dokumen ini menyusun syllabus 12–16 minggu berbasis dua track terintegrasi - Foundation dan Production untuk firmware ESP32 berbasis Arduino. Foundation Track membangun mental model execution, concurrency, memory, OOP, layering, communication state, dan reliability thinking. Production Track mengunci disiplin arsitektur melalui dependency freeze, memory discipline, layering enforcement, communication boundary, error model, dan guardrail audit. Struktur course dirancang progresif - pemahaman → implementasi → refactor → audit produksi. Tujuannya adalah membentuk engineer yang mampu membangun firmware ESP32 yang deterministik, scalable, dan stabil dalam jangka panjang tanpa redesign besar di fase akhir.

Artikel ini mengunci model reliability dan error handling untuk firmware ESP32 produksi. Setelah dependency, memory, layering, concurrency, dan communication dibekukan, sistem masih bisa gagal jika tidak memiliki model propagasi error yang eksplisit dan fail-safe state yang jelas. Silent failure, printf liar, watchdog tanpa owner, serta relay fail-open adalah penyebab utama bug lapangan yang sulit diaudit. Artikel ini menetapkan error enum eksplisit, larangan exception, encapsulation watchdog dalam HealthService, logging via interface non-blocking, serta kewajiban health telemetry minimal. Dengan reliability model formal, firmware tidak hanya rapi, tetapi juga dapat diaudit dan dipertahankan bertahun-tahun.

README memposisikan seri C++ for Production Firmware on ESP32 sebagai panduan arsitektur firmware produksi, bukan kursus sintaks atau teori OOP umum. Dokumen ini menjelaskan filosofi inti (determinism, memory discipline, boundary control), struktur waterfall 8 artikel, serta model arsitektur yang dikunci - no global mutable, static-first allocation, 3-layer DAG, CommManager sebagai gateway komunikasi, dan fail-safe reliability model. README juga menegaskan constraint Arduino (flat structure, IndustrialNode.ino sebagai entry point) serta success criteria produksi jangka panjang. Tujuannya adalah menyatukan visi tim dan memastikan disiplin arsitektur sebelum firmware berkembang menjadi kompleks.