How emuqi/esp-mosaico-fluidbox works
Mosaico FluidBox is ESP32 firmware that turns device motion into animated particle-fluid visuals. The principal loop reads the BMI270 and button state, advances the particle simulation, renders a selected visual mode, and presents banded frames on the CO5300 display. The README also documents five modes, revision detection, brightness control, and host previews. The graph focuses on firmware runtime; preview tooling is omitted. Some edges rely on header or README contracts because implementation excerpts are partial.
Main entry points: main.c Firmware tasks · render.c Mode rendering · config.h Fluid configuration · display.c Band scheduling
Components 10
Runtime orchestration
- Firmware tasks
main/main.c - Fluid configuration
main/config.h
Motion and controls
- Board controls
main/board.c - Motion sensing
main/imu.c
Simulation and rendering
- Particle solver
main/sim.c - Mode rendering
main/render.c
Device output
- Band scheduling
main/display.c
Other components
- Device user
- BMI270 sensor
- CO5300 panel
Connections 17
- Device user → Firmware tasks: presses controls
README.md - Firmware tasks → Board controls: reads controls
main/main.c - Firmware tasks → Motion sensing: reads motion
main/main.c - BMI270 sensor → Motion sensing: provides samples
- Firmware tasks → Particle solver: steps and resets
main/main.c - Firmware tasks → Mode rendering: selects mode
main/main.c - Firmware tasks → Mode rendering: sets gravity
main/main.c - Firmware tasks → Mode rendering: renders frames
main/main.c - Mode rendering → Particle solver: reads snapshots
- Mode rendering → Band scheduling: stages and presents
README.md - Band scheduling → CO5300 panel: transfers bands
main/display.c - Firmware tasks → Band scheduling: initializes and monitors
main/main.c - Firmware tasks → Fluid configuration: uses settings
main/main.c - Particle solver → Fluid configuration: uses physics settings
main/sim.c - Mode rendering → Fluid configuration: uses visual settings
main/render.c - Band scheduling → Fluid configuration: uses panel settings
main/display.c - Motion sensing → Fluid configuration: uses sensor mapping
main/imu.c