Repository navigation
First release of the FLIP fluid simulation for the Makeblock Codey Rocky 16x8 LED matrix, driven by the IMU.
Flash the prebuilt binaries
Option A — single merged binary, with esptool over USB:
esptool --chip esp32 --baud 921600 write_flash 0x0 merged-firmware-4MB.binOption B — PlatformIO (recommended, lets you tweak and rebuild):
- Install VS Code + the PlatformIO extension
- Clone this repository and open the folder
- Plug the Codey Rocky in via USB and click Upload
If upload fails: hold button C, tap the power button, then Upload again (GPIO0 / button C is the ESP32 boot strap).
Controls
| Action | Effect |
|---|---|
| Tilt | water flows to the low side, sloshes and pools there |
| Shake / jerk | the water churns and splashes on its own |
| Knob | faucet — new water pours in from the bottom edge |
| Button A | splash burst (adds particles) |
| Button B | drain some water |
| Hold A at boot | hardware test mode: every button & sensor (matrix, buttons, RGB LED, knob, light, sound, battery/HW version, IMU, speaker, IR, Rocky base) |
Assets
merged-firmware-4MB.bin— single flashable image at offset0x0(bootloader + partitions + firmware)bootloader.bin0x1000,partitions.bin0x8000,boot_app0.bin0xe000,firmware.bin0x10000— separate images for esptoolfirmware.elf— debug symbols (e.g. for exception backtraces)
Build stats
- RAM: 10.6% (34.7 KB / 320 KB)
- Flash: 17.7% (347.8 KB / 1.9 MB)
- Built with PlatformIO 6.1, platform espressif32, arduino-esp32 3.3.6,
esp32dev@ 240 MHz
Credits
- FLIP algorithm: Matthias Müller, "Ten Minute Physics"
- Reference LED implementation: Nicholas-L-Johnson/flip-card
- CodeyRocky library vendored in
lib/(GPL-2.0-or-later)