已发布项目

mosaico-fluidbox-36ff51e9

Revision 1

Initial draft

掌上的重力流体

将 ESP-Mosaico 变成一只掌上的流体盒。倾斜、摇晃或转动设备，1200 个粒子随重力运动；按下 AI 键，在五种画面之间切换，运动状态连续保留。无需联网，烧录后即可体验。

五种画面

  • 粒子：观察蓝色粒子的运动与堆积。
  • 液体：以蓝色分层呈现流体轮廓。
  • 海水：深蓝渐变与明亮的水面边缘。
  • 岩浆：橙红色纹理随流体变化。
  • 浮世绘：纸色背景、蓝色波浪与白色泡沫。

操作方法

  • 倾斜、摇晃或转动设备：改变流体运动。
  • 短按 AI 键：切换画面模式，保留当前粒子状态。
  • 运行时短按 BOOT 键：重置粒子。

设备与运行

适用于 ESP-Mosaico（ESP32-S31），支持 V1.0、V1.1、V1.2 板卡，通过 eFuse 自动识别版本。使用 480×480 CO5300 显示屏及 BMI270 运动传感器，无需扩展子板。亮度固定为 60%，无需联网，暂不支持触摸操作或 OTA 更新。

不同模式的帧率有所不同，实测条件与数据见测试记录。封面为设计效果图，设备外观及运行效果以实机为准。

安装说明

提供 0.1.0 完整 BIN 镜像，烧录地址为 0x0。请使用支持 ESP32-S31 的烧录工具。烧录会覆盖镜像范围内的原固件及数据，包括 NVS 设置，请提前保存所需内容。

  1. 按住 BOOT 并重新上电，进入下载模式。
  2. 将完整 BIN 烧录到 0x0。
  3. 烧录结束后释放 BOOT，重新上电。

开源与致谢

基于 V4C38/esp32-fluidbox 的粒子模拟与固件基础，适配 Mosaico 硬件，改造显示同步，并新增液体、海水、岩浆和浮世绘画面。

项目采用 MIT 许可证，并保留上游版权声明。屏幕初始化序列改编自 Espressif Mosaico BSP，经由 QuotaFrame 引入，该部分遵循 Apache-2.0；完整来源和许可说明见仓库 NOTICE。

Mosaico FluidBox

A gravity-driven fluid toy for ESP-Mosaico. Tilt, shake, or rotate the device to move 1,200 particles. Press the AI key to switch between Particles, Liquid, Water, Lava, and Ukiyo-e while preserving the simulation state. Press BOOT during operation to reset the particles.

Runs offline on ESP-Mosaico V1.0/V1.1/V1.2 with no expansion board required. Brightness is fixed at 60%. Touch interaction and OTA updates are not supported. Performance varies by visual mode. Cover images are design illustrations.

Version 0.1.0 is a full BIN image for flashing at 0x0 using an ESP32-S31-compatible tool. Flashing overwrites firmware and data within the image range, including NVS settings. See the source repository for build instructions, measurements, and third-party notices.