WLED README

The project's README from github.com/wled/WLED. As one markdown file: README.md.

Welcome to WLED! ✨

A fast and feature-rich firmware for ESP32 microcontrollers to control addressable LEDs — from simple strips to large 2D matrices and HUB75 panels.

Originally created by Aircoookie, now maintained by a community of contributors.

⚙️ Features

Effects & Visuals

Segments & Control

Hardware Support

Connectivity & Integrations

Developer-Friendly

📲 Quick start guide and documentation

See the documentation at kno.wled.ge!

Tutorials and getting-started guides to help you get your project running quickly.

🖼️ User interface

💾 Compatible hardware

See the compatible hardware list on the wiki.

✌️ Other

Licensed under the EUPL v1.2.
Credits to all contributors!
CORS proxy by Corsfix.

Join the Discord server to discuss everything about WLED!

Check out the WLED Discourse forum!

If you'd like to reach the original creator privately: [email protected].

If WLED brightens up your day, you can send a gift to Aircoookie via PayPal.


Disclaimer:

If you are prone to photosensitive epilepsy, we recommend you do not use this software.
If you still want to try, avoid strobe, lightning or noise modes and high effect speed settings.

As per the EUPL license, no liability is assumed for any damage to you or any other person or equipment.

WLED (wled/WLED)

Searching Database…

18.9K ·GitHub
这是什么?WLED 是一款运行在 ESP32 微控制器上的开源固件,速度快、功能丰富,可以通过 WiFi 控制可寻址 RGB 灯带——从单条灯带到大型 2D 点阵屏和 HUB75 面板都行。
这是我装在手机上的东西,还是装在别的地方?它运行在与你的灯带相连的 ESP32 开发板上:只需烧录一次,开发板就会在你的局域网里提供自己的控制页面。手机 App 和浏览器只是遥控器——WLED 也有 Android 和 iOS 版 App。
我怎么把它跑起来?把固件烧录到连接灯带的 ESP32 开发板上——kno.wled.ge 上有教程和入门指南。等它连上你的 WiFi 后,就能用浏览器或 App 控制,之后的更新可以通过 HTTP 或 ArduinoOTA 空中升级。
我的灯带能用吗?大概率可以——它支持 WS2812B、WS2811、WS2815、SK6812、APA102、WS2801 等许多可寻址类型,还有 RGBW 和 RGB+CCT 灯带。普通的模拟灯和调光器也能通过 PWM 输出来驱动。
一块开发板能带多少路灯珠输出?在 ESP32 上最多可以带 17 路独立输出,利用的是并行的 I2S 和 RMT 外设。还有可配置的自动亮度限制器(Auto Brightness Limiter)保护每一路输出,避免电源过载。
我需要什么控制板——必须用特定型号吗?任何 ESP32 型号都行——初代、S2、S3 或 C3 都可以,而且不少开发板(QuinLED、LILYGO、Olimex 等)支持以太网。仓库的标签里也列出了较老的 ESP8266。
它需要联网才能用吗?不需要——它在你本地的 WiFi 上提供自己的网页界面,找不到网络时还会自动开出一个自己的热点。设备之间甚至可以通过 ESP-NOW 直接同步动画,完全不需要路由器。
它自带哪些效果?内置 200 多种效果和 50 多种调色板,从经典动画到声音律动和 2D 点阵效果都有,动画之间还能平滑过渡。另外还有一个叫 PixelForge 的内置调色板编辑器。
我的灯饰能不能同时做不同的事情?可以——分段(Segments)功能让你的灯饰各部分同时拥有各自的效果、颜色和调色板。你还可以保存最多 250 个预设,并把它们串成自动循环播放的播放列表。
它能配合 Home Assistant、Alexa 或 DMX 舞台灯光设备吗?它通过 MQTT 自动发现接入 Home Assistant,Alexa 则可以用语音控制开关、亮度和颜色。专业灯光方面支持 E1.31、Art-Net、DDP 和 TPM2.net,还兼容 Philips Hue 同步和 Hyperion。
有什么需要留意的吗?README 提醒有光敏性癫痫的人不要使用 WLED——至少要避开频闪、闪电和噪点模式以及过快的效果速度。许可证也不对任何人身或设备损害承担责任。
Creator
wled
Size
69.8 MB
Stars
18.9K
Age
9y
Commits · 90 Days