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, которая управляет адресными RGB-светодиодами по WiFi — от одиночной ленты до больших 2D-матриц и панелей HUB75.
Это приложение, которое я ставлю на телефон, или оно живёт где-то ещё?Оно живёт на плате ESP32, к которой подключены ваши светодиоды: вы прошиваете её один раз, и плата раздаёт собственную страницу управления в вашей сети. Приложения на телефоне и браузер — это просто пульты — есть приложение WLED для Android и iOS.
Как его запустить?Прошейте микропрошивку на плату ESP32, подключённую к вашей ленте — на kno.wled.ge есть обучающие материалы и руководства по началу работы. Как только плата подключится к вашему WiFi, управляйте ею из браузера или приложения, а обновления потом ставятся по воздуху через HTTP или ArduinoOTA.
Моя светодиодная лента подойдёт?Скорее всего да — поддерживаются WS2812B, WS2811, WS2815, SK6812, APA102, WS2801 и многие другие адресные типы, а также ленты RGBW и RGB+CCT. Обычные аналоговые светодиоды и диммеры тоже работают через ШИМ-выходы.
Сколько светодиодных выходов может обслуживать одна плата?До 17 отдельных выходов на ESP32 — за счёт параллельного использования периферийных блоков I2S и RMT. Настраиваемый ограничитель яркости (Auto Brightness Limiter) защищает каждый выход, чтобы вы не перегрузили свой блок питания.
Какая плата-контроллер нужна — обязательно какая-то конкретная?Подходит любой вариант ESP32 — оригинальная, S2, S3 или C3 — и широкий ряд плат (QuinLED, LILYGO, Olimex и другие) поддерживает Ethernet. В темах репозитория упоминается и более старый ESP8266.
Для работы нужен интернет?Нет — он раздаёт собственный веб-интерфейс в вашей локальной WiFi-сети, а если сеть не найдена, сам поднимает свою точку доступа. Устройства даже могут синхронизировать анимации напрямую по ESP-NOW, вообще без роутера.
Какие эффекты в него встроены?Более 200 встроенных эффектов и свыше 50 цветовых палитр — от классических анимаций до реагирующих на звук и эффектов для 2D-матриц, с плавными переходами между анимациями. Есть и встроенный редактор палитр под названием PixelForge.
Могут ли разные части моей светодиодной подсветки работать по-разному одновременно?Да — сегменты (Segments) позволяют независимым частям вашей подсветки одновременно иметь свои эффекты, цвета и палитры. Можно сохранить до 250 пресетов и выстроить их в плейлисты, которые переключаются автоматически.
Работает ли он с Home Assistant, Alexa или профессиональным DMX-освещением?Он сам announces себя в Home Assistant через MQTT auto-discovery, а Alexa управляет включением/выключением, яркостью и цветом голосом. Для профессионального освещения есть E1.31, Art-Net, DDP и TPM2.net, плюс поддержка Philips Hue sync и Hyperion.
На что стоит обратить внимание?В README предупреждают, что людям, склонным к фотогенной эпилепсии, не стоит пользоваться WLED — или хотя бы избегать режимов стробоскопа, молнии (lightning) и шума (noise), а также высоких скоростей эффектов. Лицензия также снимает ответственность за любой ущерб людям или оборудованию.
Creator
wled
Size
69.7 MB
Stars
18.9K
Age
9y
Commits · 90 Days