📘 C++ for Production Firmware on ESP32

Architecture Discipline for 3–5 Year Firmware Stability

• 📘 C++ for Production Firmware on ESP32
  • 🎯 Positioning
  • 🧠 Filosofi Inti
  • 📦 Struktur Seri (Waterfall Discipline)
  • 🏗 Architecture Model yang Dikunci
  • 📁 Struktur Project (Arduino Constraint)
  • 🔒 Apa yang Tidak Dibahas
  • 🧪 Success Criteria
  • 🛡 Guardrail Final
  • 📌 Final Statement

🎯 Positioning

Seri ini bukan kursus C++. Bukan buku OOP. Bukan kumpulan design pattern generik.

Seri ini adalah:

Panduan arsitektur firmware produksi berbasis C++ untuk ESP32 (Arduino core) yang dirancang agar stabil 3–5 tahun tanpa menjadi spaghetti.

Target pembaca:

• Embedded engineer aktif
• Firmware developer IoT produksi
• Tim yang firmware-nya mulai membesar
• Engineer yang sudah deploy ESP32 di lapangan

Bukan untuk:

• Pemula C++
• Belajar sintaks dasar
• Teori OOP akademis
• Template metaprogramming

🧠 Filosofi Inti

1. OOP adalah alat, bukan tujuan.
2. Determinism lebih penting dari elegance.
3. Memory discipline lebih penting dari abstraction.
4. Simplicity > overengineering.
5. Setiap keputusan arsitektur dikunci secara eksplisit.

📦 Struktur Seri (Waterfall Discipline)

Semua artikel bersifat berurutan dan saling mengunci.

Keputusan yang dibekukan di artikel sebelumnya tidak boleh diubah di artikel berikutnya.

🏗 Architecture Model yang Dikunci

Setelah menyelesaikan seri ini, firmware Anda harus memiliki:

• No global mutable state
• No singleton
• Static-first allocation
• 3-layer model (app_, svc_, drv_, sys_)
• Dependency DAG (no circular include)
• ISR hanya notify
• ControlTask non-blocking
• CommManager sebagai gateway tunggal
• State machine eksplisit
• Fail-safe state mandatory
• Error propagation eksplisit (no exception)

Jika salah satu dilanggar, firmware kembali berisiko menjadi spaghetti.

📁 Struktur Project (Arduino Constraint)

Seri ini diasumsikan berjalan pada:

• ESP32
• Arduino Core
• VSCode + Arduino Community Edition
• Flat file structure (tanpa nested folder)

Contoh struktur final:

IndustrialNode/
│
├── IndustrialNode.ino
│
├── app_ControlApp.h
├── app_ControlApp.cpp
│
├── svc_SensorService.h
├── svc_SensorService.cpp
├── svc_ActuatorService.h
├── svc_ActuatorService.cpp
├── svc_CommManager.h
├── svc_CommManager.cpp
├── svc_HealthService.h
├── svc_HealthService.cpp
│
├── drv_TempSensorDriver.h
├── drv_TempSensorDriver.cpp
├── drv_RelayDriver.h
├── drv_RelayDriver.cpp
│
├── sys_Config.h
├── sys_Status.h
├── sys_Types.h
│
└── ARCHITECTURE_RULES.md

Prefix file adalah boundary enforcement karena Arduino tidak mendukung nested folder kompleks.

🔒 Apa yang Tidak Dibahas

Seri ini secara sengaja tidak membahas:

• Advanced template metaprogramming
• STL heavy usage
• Modern C++ feature lengkap
• Generic design pattern catalog
• Desktop OOP theory

Jika tidak relevan langsung ke firmware produksi ESP32 → tidak dibahas.

🧪 Success Criteria

Seri ini dianggap berhasil jika setelah implementasi:

• Firmware lebih terstruktur
• Dependency jelas dan terarah
• Heap usage stabil dalam jangka panjang
• Tidak ada redesign besar setelah Artikel 4
• Code review lebih cepat
• Uptime meningkat signifikan

🛡 Guardrail Final

Firmware production bukan tentang “fitur banyak”.

Firmware production adalah tentang:

• Predictability
• Determinism
• Observability
• Boundary discipline
• Auditability

Tanpa disiplin arsitektur, firmware akan rusak bukan karena bug besar, tetapi karena kompleksitas yang tidak dikontrol.

📌 Final Statement

Seri ini bukan:

“Belajar OOP untuk ESP32”

Seri ini adalah:

Cara menggunakan C++ untuk membuat firmware ESP32 yang bisa hidup 3–5 tahun tanpa menjadi monster spaghetti.