WLED

WLED

比赛/竞技、ESP32 🧩 软硬件结合 已发布
wled 18123 Stars EUPL-1.2 | 📎 [GitHub](https://github.com/wled/WLED) BOM 完整度: 3/5 教程完整度: 0/5

项目简介

用ESP32通过WiFi控制WS2812B等数字RGB LED。


WLED 是一款专为 ESP32 和 ESP8266 微控制器打造的高性能、功能丰富的开源固件,旨在通过 Web 服务器轻松控制 NeoPixel(如 WS2812B、WS2811、SK6812)以及 SPI 芯片组(如 WS2801、APA102)的 LED 灯带。该项目由 Aircoookie 创建,解决了传统 LED 控制方案依赖专用硬件、操作复杂、扩展性差的问题,让用户无需编程即可通过手机、电脑或语音助手实现智能照明控制。

标签

项目特点

**丰富的特效与调色板**:内置 WS2812FX 库,提供超过100种动态特效和50种FastLED调色板。
**灵活的分段控制**:支持将LED灯带划分为多个独立段,每段可设置不同的效果和颜色。
**多平台控制**:支持通过 Web UI、专用App(Android/iOS)、JSON/HTTP API、MQTT、UDP等多种方式进行控制。
**智能家居集成**:兼容 Alexa、diyHue、Hyperion 等主流智能家居平台和灯光同步协议。
**强大的预设系统**:支持保存和加载最多250个用户预设,并可自动循环播放。
**OTA无线升级**:支持通过HTTP和ArduinoOTA进行固件无线升级,并设有密码保护。
**多输出支持**:在ESP32上,单个实例最多可支持10路LED输出。
**自动亮度限制**:可配置自动亮度限制,确保安全运行。

技术规格

主控芯片
支持的LED芯片
最大LED数量
控制接口
输出通道
预设数量
固件升级
供电电压

项目资源

物料清单 (BOM)

物料名称 数量 参考价格 备注
ESP32 开发板 (如 NodeMCU-32S) 1 推荐使用ESP32以获得多输出支持
WS2812B 或 SK6812 灯带 1 长度和数量根据需要选择
5V 电源适配器 1 电流需根据LED数量计算
杜邦线或焊接线 若干 用于连接ESP32、LED和电源
1000μF 电解电容 1 可选,用于电源滤波,保护LED
330Ω - 500Ω 电阻 1 可选,串联在数据线上,减少信号干扰

3D 模型

所需工具

电烙铁与焊接工具 必需
电池/电源

能力画像

⚪ 记忆与知识检索: 2/5
🔵 逻辑推演: 3/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 2/5
⚪ 数理与计算: 3/5
🔵 动手与操作: 4/5
⚪ 狂热与坚持: 3/5
⚪ 创造与创新: 4/5

所需技能

🔧 **动手能力**:需要基本的电子焊接和电路连接能力,能够将ESP32开发板、LED灯带和电源正确连接。 💻 **编程能力**:具备基础的Arduino IDE或PlatformIO环境配置能力,能够编译和上传固件。了解JSON和HTTP API的基本概念有助于高级配置。 ⚡ **电子电路**:了解LED灯带的供电需求(电压、电流),以及如何正确使用电容和电阻进行电路保护。

适用场景

**智能家居氛围灯**:为客厅、卧室或家庭影院创建可自定义颜色和效果的氛围照明。
**桌面电竞氛围灯**:为电脑桌面或显示器背面安装LED灯带,通过Hyperion等软件实现屏幕同步光效。
**节日装饰灯**:用于圣诞节、万圣节等节日,制作可编程的动态灯光装饰。
**店铺招牌照明**:为商店招牌或橱窗制作吸引眼球的动态灯光效果。
**音乐可视化**:结合声音传感器或音乐API,实现灯光随音乐节奏律动。