bat-remote

Bat-Sense Operator Controller

Firmvér pre prenosné ovládacie zariadenie založené na platforme M5Stack, slúžiace ako diaľkový ESP-NOW operátorský ovládač pre meracie zariadenie Bat-Sense.

---

📋 Prehľad projektu

Tento projekt implementuje robustnú, stavovým automatom riadenú firmvérovú architektúru určenú pre nízkoenergetické (low-power) embedded zariadenia. Slúži ako konzola na správu celého životného cyklu merania, pričom s podriadeným zariadením komunikuje bezdrôtovo pomocou vlastného protokolu Nano Bus (Nbus) cez vrstvu EspNowSerial.

---

🛠️ Hlavné vlastnosti

• Stavový automat (State Machine): Čistá architektúra riadená plánovačom StateRunner, ktorá spravuje 6 na sebe nadväzujúcich stavov:
  • STATE_LOCK – Uzamknutý / neaktívny stav
  • STATE_TARGET – Yameranie cieľa
  • STATE_START – Inicializačná štartovacia sekvencia
  • STATE_RUN – Aktívny beh merania s vizuálnou animáciou
  • STATE_STOP – Ukončenie meracieho cyklu
  • STATE_CANCEL – Prerušenie / zrušenie operácie
• ESP-NOW Komunikácia: Rýchly bezdrôtový prenos príkazov a paketov v reálnom čase pomocou vrstvy NbusBroadcastComm s overovaním integrity pomocou CRC8.
• Optimalizovaná správa napájania: Periodický monitoring batérie pomocou FreeRTOS časovačov a podpora prechodu do úsporného režimu.
• Kompaktná konfigurácia: Všetky konštanty (farby, fonty, hardvérové piny, časovanie, Nbus parametre) sú zjednotené v jednom centrálnom súbore all_config.h pre rýchlejšiu kompiláciu a lepšiu udržiavateľnosť.
• Doxygen dokumentácia: Zdrojový kód je plne zdokumentovaný štandardizovanými Doxygen komentármi.

---

📂 Architektúra projektového repozitára

```text ├── all_config.h # Centrálna konfigurácia (hardvér, farby, časovanie, Nbus) ├── main.cpp # Hlavný vstupný bod firmvéru (Arduino setup/loop) ├── device/ # Správa hardvéru, displeja a ESP-NOW ├── drawer/ # UI renderovanie, kreslenie ikon, textov a batérie ├── nbus/ # Nano Bus protokol a ESP-NOW broadcast komunikácia ├── states/ # Logika stavového automatu │ ├── state_runner.h # Plánovač a riadenie prechodov medzi stavmi │ ├── state_interface.h # Abstraktné rozhranie pre stavy (IState) │ └── state_impl.h # Implementácie jednotlivých stavov (Lock, Target, Start, Run, Stop, Cancel) └── data_structures/ # Dátové štruktúry (PhaseCmd, StateTx, IconStruct)