迷你电子海洋瓶，软硬件全新设计，可编程脚本创建互动式视觉艺术

硬件能力

软件特性

• 元件焊接图可参考bottle.html
• 不要焊接R18, R19，这是硬复位用的，除非设备起不来没串口，可短接R18同时短接R19，再依次断开R19，R18，可将设备切换到下载模式
• 额外需要焊接一个R0603的10uF电容到电池正负极焊盘，对于没焊接电池只用Type-C供电的场景必备，否则会闪屏（下一版layout会加上）

• 优先用210°左右的焊锡焊接LED灯阵列，再用低温锡138°-180°焊接另一侧
• LED阵列焊完测试方法：靠近Type-C一侧有2个测试点：LED正极，DIN，用Type-C座子引脚作为负极，用一块开发板写入颜色交替闪烁的的程序即可测试是否焊接正常

可拿Gerber.rar直接去打样，和现有版本一致。

1. 安装开发工具

   • Visual Studio Code
   • PlatformIO IDE 扩展

2. 克隆仓库

   git clone <repo-url>
   cd Bottle

    

# 编译固件
pio run

# 上传到 ESP32-S3
pio run -t upload

# 打开串口监视器
pio device monitor

触摸按键控制:

• 短按: 切换子页面/模式
• 长按 (大于1秒): 正常模式时：在切换动画模块/蓝牙配置模式/关机功能循环，松开即执行显示的功能；蓝牙模式时：在退出蓝牙模式/关机功能循环
• 超长按 (>15秒): 强制关机

Bottle 支持通过 Lua 脚本创建自定义动画效果。详细的 API 文档和示例请参考：

📖 Lua 脚本开发指南

• LED 控制: led.set(), led.clear(), led.show(), led.text(), led.hsv()
• 时间: time.millis(), time.delay()
• 重力感应: gravity.get() - 返回 X/Y/Z 轴加速度
• 音频频谱: audio.init(), audio.getSpectrum(), audio.close()

• 文字显示 (text) - 支持滚动文字、自定义颜色
• 频谱显示 (rhythm) - 音频频谱可视化
• 重力粒子 - 重力感应控制的粒子效果
• 沙漏 (sandglass) - 重力感应沙漏模拟
• 蜡烛 (candle) - 蜡烛火焰动画
• 水波模拟 (water_sim) - 流体动力学模拟
• RGB 彩虹 (rgb) - 彩虹渐变动画
• 以上部分模块需通过小程序幻彩抽屉下载

设备支持通过 BLE 进行配置：

1. 长按触摸键 2-3 秒进入 BLE 配置模式
2. 使用微信小程序幻彩抽屉连接设备（设备名: "BottleLED"）
3. 通过 小程序 配置模块参数、下载新模块、调整系统设置
4. 再次长按退出配置模式

• 17 频段 FFT 分析（0-8kHz）
• 支持 I2S 和 PDM 麦克风
• 可用于音乐可视化、声控动画

• 录制格式: 16-bit PCM, 16kHz 采样率
• 存储位置: /extflash/rec_*.pcm
• 通过 USB U盘导出录音文件

设备使用 USB 复合设备模式，同时提供串口和 U盘功能：

串口（CDC）:

• 始终可用
• 波特率: 115200
• 用于调试输出和命令行交互

U盘（MSC）:

• 可通过串口命令 usb=1 启用（可选）
• 启用后设备会显示为 USB 大容量存储设备
• 可访问 /extflash 分区
• 用于上传 Lua 脚本、导出录音文件等
• 串口和 U盘可以同时使用

使用流程:

# 1. 连接 USB 线到电脑
# 2. 打开串口终端（115200 波特率）
pio device monitor
# 3. 电脑会识别出 U盘，可以读写文件
# 4. 串口功能始终可用，可以同时调试

重新烧录:

# 0. 第一次烧录不需要参考此流程
# 1. 连接 USB 线到电脑
# 2. 打开串口终端（115200 波特率）
# 3. 发送命令 dfu
# 4. 设备会重启进入下载模式

注意事项:

• U盘模式启用时，设备内部无法访问 /extflash 文件系统
• 拔出Type-C数据线，文件系统会自动重新挂载
• 串口和U盘可以同时工作，互不干扰

• 固件代码: GPLv3
• 硬件设计: CC BY-NC-SA 4.0

商业使用需获得作者书面许可。

• 好心却黑猫35 - 我制作了一瓶电子海洋
• FastLED - 强大的 LED 控制库
• arduinoFFT - 高效的 FFT 实现
• Lua - 优雅的嵌入式脚本语言
• ESP32 Arduino Core - ESP32 开发框架
• NimBLE - 轻量级蓝牙协议栈