Chroma Flow｜项目介绍

Chroma Flow 运行在 ESP-Mosaico 的 480×480 触摸屏和左侧插槽上的 8×8 WS2812 RGB 灯板。屏幕显示连续柔和的紫、粉、蓝青色流体；灯板从同一色彩场采样 64 个位置。手指滑动时，光团随方向和速度流动，松开后渐渐恢复慢速漂浮。

效果预览

![电脑端屏幕与灯板同步预览]

上图是电脑模拟器和 8×8 灯板预览，同一帧驱动左右两侧。它是电脑截图，并非 230 亮度下的实物照片。

![拖动后的同步预览]

拖动后，屏幕色团和右侧 64 灯模拟像素一起变化。

![Mosaico 屏幕采集]

这是从 Mosaico 设备画面取得的屏幕图像。实体灯板方向由用户现场确认，屏幕左下角对应灯板左下角，屏幕右下角对应灯板右下角。

硬件与接线参考

![Mosaico 与 8×8 灯板实拍]

![灯板背面与模块标记]

![Mosaico 左侧插槽引脚图]

这些硬件照片和插槽图由用户提供。驱动按官方 ESP-Mosaico Matrix LED-M 左槽 GPIO48、WS2812 GRB、RMT DMA 配置。灯板插在整排下侧插槽，避免把上排引脚视为灯板连接。

本次 230 版内容

• 灯板输出亮度上限：RGB 每通道 230/255；上一版为 200/255。
• 保留已确认的屏幕与灯板方向、同帧采样和触摸惯性效果。
• 固件已构建并打包，尚未烧录到实物。板上当前仍是已确认的 200 版，230 版亮度待日后现场观察。

文件索引

路径	用途
chroma_flow-system-update.irisfw	自助更新时使用的官方完整更新包
Install-ChromaFlow.ps1	在当前电脑通过 D:\masaico 工程安装上面的包
chroma_flow.bin	单独应用镜像，供同布局维护
images/	本页所示的预览截图、屏幕图和实物照片
source/	当前固件源码、PC 预览页面和测试源文件；依赖 D:\masaico 主仓库及其 ESP-IDF/BSP，不是可独立编译的完整仓库
raw-images/	构建产出的底层镜像及 manifest；正常更新无需手动使用
README.md	自助烧录步骤和注意事项
SHA256SUMS.txt	每个交付文件的 SHA256

正常自行更新请先读 README.md。电脑实时预览的服务器源码位于 source/pc/，已有工程环境可从 D:\masaico 启动模拟器。