kraftort/docs/architecture.md

Architekturüberblick

Module

• main: Setup, Main Loop, Modulverdrahtung
• gps: NMEA Parsing, Fix-Validierung, Filter
• geo: Haversine, Bearing, Score
• leds: Darstellung, Themes, Render-Modi
• button: Debounce, Short-/Long-Press
• ble_maintenance: BLE-Wartungsmodus, Datei-/OTA-Transfers
• power: Deep Sleep und Wakeup
• state_machine: Zustände und Übergänge
• config: zentrale Konstanten

Laufzeitmodell

Die Firmware arbeitet kooperativ und single-threaded. Jeder Modulteil muss non-blocking bleiben.

Datenfluss

1. GPS liefert Positionsdaten
2. Geo berechnet Distanzen und Peilung
3. Arbitration wählt den aktiven Kraftort
4. State Machine bestimmt den Betriebsmodus
5. Renderer übersetzt Zustand + Score in LED-Bilder
6. BLE ist nur im Wartungsfenster aktiv

Betriebszustände

• BOOT
• BLE_MAINTENANCE
• GPS_WAIT
• ACTIVE
• DEEP_SLEEP

Persistenz

• LittleFS hält places.json
• optional später: config.json für Laufzeit-Overrides