基于 ESP8266 的物联网小彩灯 (内含炫酷 RGB 魔法!),（毕设/课设/竞赛/实训/项目开发）

# RGB Light # 炫酷 R! G! B! 灯 基于 ESP8266 使用 Arduino 开发的物联网小彩灯, 支持多种形态多种光效, 配套自研网页/小程序/PC 客户端, ~~并支持 HomeAssistant 等智能家居平台~~(TODO) 产品特色: - 支持多种产品形态: 如灯带, 圆形灯盘, 方形灯板等, 提供简单易用的接口供用户自行适配 - 支持多种光效模式: 如常亮, 闪烁, 呼吸, 流光, 彩虹, 音乐律动等, 参数均可自定义, 自由度高 - 支持音乐律动灯效: **非通过麦克风采集声音**, 而是通过配套上位机采集手机/电脑音频, 经上位机算法计算后将结果传输到下位机, 从而实现更好的音乐律动效果 - 支持自定义灯光动画: ~~通过网页/小程序可自定义灯光动画~~ 现仅支持播放动画, 动画编辑器待开发 - 多客户端支持: 配套自研网页/小程序/PC 客户端  ## 所需硬件 ### MCU 目前仅在 ESP8266 上测试过, 理论上简单适配一下即可支持 ESP32, 但未测试 我使用的开发版为 WeMos D1 Mini, 使用 D4 脚连接 WS2812B ### 灯板 目前支持两种灯板: 一种为 1 米长的 WS2812B 灯带 另一种为自己画的 WS2812B 圆形灯板, 共有 21 颗灯珠, 整机最大电流 <1.5A, 原理图详见 pcb 目录 如果你想适配其他形态的灯板, 请参考下方教程 ### 外壳 目前仅有投影灯形态的产品, 其模型位于 model 目录下 ## 编译指南 ### 安装 Arduino 和第三方库 - [ESP8266-Arduino](https://github.com/esp8266/Arduino) - [FastLED](https://github.com/FastLED/FastLED) - [ArduinoJSON](https://github.com/bblanchon/ArduinoJson) - [arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) **注意**: 如果你遇到了第一个灯会随机闪烁的问题, 请降级 ESP8266-Arduino 至 2.7.4 版本, FastLED 降级至 3.4.0 版本, 详见 [esp8266/Arduino#8054](https://github.com/esp8266/Arduino/issues/8054) ### 修改配置 根据您的需求修改 config.h 中的配置 ### 编译前端网页 (可选) 预编译好的前端网页已位于 data/www 目录下, 如果你不需要修改前端网页, 则可以跳过这一步 如果修改了前端页面需要自己编译, 则首先需要安装 Node.js 14 或以上版本, 然后进入 web 目录并执行以下命令: ```sh npm install npm run build ``` 编译后的网页会自动覆盖 data/www 目录 ### 编译并烧录 除了需要烧录程序以外, 还需要上传 LittleFS 文件系统, 具体教程可参考 [Uploading files to file system](https://arduino-esp8266.readthedocs.io/en/stable/filesystem.html#uploading-files-to-file-system) ### 打包升级包 ArduinoOTA 是支持在线升级文件系统的, 但是遗憾的是并不支持差量更新, 为了不丢失用户配置和自定义动画等数据, 我选择把 bin 和资源文件打包为单个二进制文件, 再由上位机进行解析更新 运行根目录下的 `pack_ota_bin.py` 即可打包升级包 (需要 Python 3.8 或以上版本), 生成的升级包位于 `build/upgrade.bin`, 然后使用网页前端的`在线升级`功能即可升级 ## 适配其他灯板 见 Light.hpp ## 新增灯效 见 LightEffect.hpp ## 音乐律动模式 在使用设备自带的网页端的音乐律动模式时, 若提示 `因浏览器策略限制无法启动音频采集` 时, 请前往[chrome://flags/#unsafely-treat-insecure-origin-as-secure](chrome://flags/#unsafely-treat-insecure-origin-as-secure) 将 `Insecure origins treated as secure` 设置为 `Enabled` 并添加设备网页 url 链接到列表中, 然后重启浏览器即可 ## 自定义灯光动画 灯光动画示例见 data/animations/example.csv ## 版权声明 本项目代码采用 GPLv3 协议开源, 允许商用, 但商用必须遵循 GPLv3 协议提供给客户完整源代码. 自制的灯板及外壳模型保留所有权利 本项目在开发的过程中也参考了一些其他项目, 在此一并致以感谢: - [WLED](https://github.com/Aircoookie/WLED) 祝姐姐妹妹生日快乐!