Skip to main content

🌊 Data Flows

Sequence diagrams for the system's major operations.

1. Mobile Controls a Device​

The mobile app sends a command (e.g. toggle a light). Mobile never reaches the Station directly β€” Cloud relays via WSS.

2. Device Telemetry​

ESP32 publishes sensor readings; the system fans them out to all connected clients.

3. Station Claiming​

A fresh Raspberry Pi connects to Cloud as unclaimed. The owner scans a QR code in the mobile app to claim it.

4. OTA Firmware Update​

Developer cuts a firmware release tag; CI publishes; Station instructs ESP32 to flash over MQTT.

5. Authentication​

6. Identity Cache Sync​

Station caches member identities locally so it can authenticate users on LAN even when offline.

7. Kit Auto-Creation​

When two ESP32 devices with the same kit_tag come online, Station auto-creates a kit and applies preset automations.

8. BLE Provisioning​

Adding a new ESP32 to the network β€” the Station backend (RPi) scans via BLE and provisions the device. The user interacts through the Station Frontend SPA.