Адресная лента на WLED и ESP32: сборка и настройка для Алисы
Оборудование и приложения
WLED не подключается к Алисе напрямую: схема всегда такая — контроллер на WLED, интеграция WLED в Home Assistant, компонент Yandex Smart Home и «Дом с Алисой». В этой статье — первая половина пути: как собрать и настроить контроллер на ESP32, чтобы лента работала стабильно и была готова к Home Assistant. Подключение к Алисе, привязка эффектов к режимам и запуск пресетов голосом разобраны в отдельной статье — WLED и Алиса. Все параметры ниже взяты из документации WLED.
Выбор платы и ленты
Для нового проекта документация WLED рекомендует ESP32: он мощнее, а поддержка ESP8266 сворачивается. Веб-установщик WLED работает только с платами, у которых флеш-память не меньше 4 МБ.
Некоторые адресные ленты из списка совместимых:
| Лента | Напряжение | Особенности |
|---|---|---|
| WS2812B | 5 В | Самая распространённая RGB-лента |
| SK6812 | 5 В / 12 В | RGBW |
| WS2813 | 5 В | Резервная линия данных |
| WS2815 | 12 В | Резервная линия данных |
| WS2811 | 12 В | Обычно группы по 3 светодиода |
| WS2814 | 12 В / 24 В | RGBW, группа из 3 (12 В) или 6 (24 В) светодиодов как один пиксель. В WLED задаётся как SK6812, порядок цветов BRG, нужен обмен W и G (с версии 0.14.0-b1) |
Напряжение ленты определяет блок питания. Тип ленты нужно знать заранее: без верного типа в настройках цвета будут неправильными.
Подключение
Адресная лента подключается тремя проводами: питание, данные и земля.
- Данные. На ESP32 используйте GPIO16 (на плате бывает подписан IO16 или G16). Подходят также GPIO 4, 13 и 16–33, остальные выводы не рекомендуются. Подписи выводов у разных производителей отличаются, поэтому сверяйтесь с распиновкой своей платы и указывайте в WLED номер GPIO.
- Земля. Соедините GND блока питания, ленты и ESP. Без общей земли лента не прочитает сигнал. Если блоков питания несколько, их минусы соединяют, а плюсы — никогда.
- Направление. На адресной ленте есть стрелки. Данные подаются с того конца, откуда стрелка начинается (вход DIN).
- Уровень сигнала. ESP работает с логикой 3,3 В, а WS2812B — 5 В. Если провод данных нельзя сделать коротким, ставьте преобразователь уровня. Документация WLED рекомендует SN74AHCT125N: неиспользуемые входы на GND, выводы OE на GND, неиспользуемые выходы не подключать (схемы подключения).
Питание и предохранители
Работа с блоком питания на 230 В опасна. Подключайте вход блока питания только при отключённом напряжении, а если нет опыта, доверьте это электрику.
Рекомендации по размеру установки из руководства WLED по проводке:
| Размер | Как питать |
|---|---|
| До 30 RGB-светодиодов | Можно питать через USB платы с включённым ограничителем тока, но не больше 1 А и только если между USB и выводом 5 В нет стабилизаторов и диодов |
| 30–300 светодиодов | Лента питается напрямую от блока, контроллер — параллельно. После 150 светодиодов — подвод питания в нескольких точках (power injection) |
| Больше 300 или блок от 150 Вт | Наконечники-гильзы на многожильных проводах, отдельные предохранители, аккуратная разводка |
Правила из той же страницы:
- провода для подвода питания — не тоньше 22 AWG; запас по сечению — в 2–3 раза;
- при блоке мощнее 100 Вт ставьте предохранитель на каждую линию подвода. Предохранитель — на плюсовом проводе, как можно ближе к блоку питания, номинал чуть выше расчётного тока: при 4,5 А — на 5 А;
- не подключайте два блока питания к одному участку ленты. Делите ленту на участки, и каждый питайте от своего блока;
- если один конец ленты тусклый или меняет оттенок — нужен дополнительный подвод питания.
Для расчёта тока WLED использует ток одного пикселя на полном белом: по умолчанию 55 мА для 5‑вольтовых WS281x (настройки). Например, 60 пикселей × 55 мА = 3,3 А на полном белом. Страница LED Preferences сама показывает, какой блок питания нужен для полного белого на всех выходах. Документация отдельно предупреждает о дешёвых блоках: адресные ленты чувствительны к помехам, а гул или писк блока — признак плохой схемы.
Прошивка
- Откройте веб-установщик install.wled.me в настольном Chrome, Edge, Opera или Firefox версии 151 и новее. Safari не подходит (способы установки).
- Подключите ESP32 по USB и установите прошивку.
- Признак успеха: первые 30 светодиодов загорятся оранжевым.
Первый запуск
- Подключитесь телефоном к Wi‑Fi-сети WLED-AP, пароль по умолчанию wled1234.
- Откройте wled.me или адрес 4.3.2.1.
- Шестерёнка (Config) → WiFi Setup: выберите домашнюю сеть и введите пароль.
- Задайте mDNS-имя, например
wled-gostinaya, и смените пароль точки доступа: wled1234 одинаков на всех устройствах WLED. - Save & Connect, вернитесь в домашнюю сеть и откройте
http://wled-gostinaya.localили IP-адрес из списка устройств роутера.
После подключения к домашней сети адреса 4.3.2.1 и wled.me перестают работать.
Настройки LED Preferences
Откройте Config → LED Preferences (описание всех полей):
| Поле | Что задать |
|---|---|
| Type | Тип ленты (по умолчанию WS281x RGB) |
| Color order | Порядок цветов (по умолчанию GRB). Если красный и зелёный перепутаны — меняйте здесь |
| Length | Число пикселей |
| GPIO | Номер вывода данных |
| mA/LED | Ток пикселя на полном белом (по умолчанию 55 мА для 5 В WS281x) |
| Enable automatic brightness limiter | Включён по умолчанию: WLED снижает яркость, чтобы не превысить ток блока |
| Maximum PSU Current | Ток вашего блока питания. При питании ленты от вывода 5 В платы — меньше 1 А |
| Turn LEDs on after power up/reset | Включать ли ленту после подачи питания |
| Apply preset at boot | Какой пресет загрузить после включения (0 — никакой) |
Значение тока по умолчанию отличается в разных разделах документации: в таблице настроек указано 3000 мА, в разделе о типичных ошибках — 850 мА. Не полагайтесь на значение по умолчанию, впишите ток своего блока.
Последние две настройки важны для умного дома: после отключения электричества лента включится в том состоянии, которое вы здесь задали.
Если что-то не так
По разделам Top 5 mistakes и FAQ:
| Симптом | Причина | Что сделать |
|---|---|---|
| Лента не светится | Данные поданы не с того конца или указан не тот GPIO | Проверьте стрелки, номер GPIO (не подпись D4/D1 на плате) |
| Горят только первые 30 светодиодов | В Length осталось значение по умолчанию | Задайте реальное число пикселей |
| Лента тусклая, мигает и гаснет при смене цвета | Ограничитель тока ниже, чем нужно ленте | Впишите в Maximum PSU Current ток блока питания |
| Неправильные цвета | Не тот тип ленты или порядок цветов | Исправьте Type и Color order, для RGBW — проверьте тип |
| Случайное мерцание | Нет общей земли, нет преобразователя уровня, длинный провод данных, шумный блок питания | Соедините GND, поставьте SN74AHCT125N, укоротите провод |
| ESP8266 не загружается с подключённой лентой | GPIO2/D4 должен быть в высоком уровне при старте | Проверьте направление ленты; попробуйте резистор 3,3–4,7 кОм между выводом данных и 3,3 В |
| Нагреваются провода | Тонкое сечение, плохие контакты | Увеличьте сечение, перепаяйте, поставьте предохранители |
Обновления и безопасность
Обновление по сети (OTA) защищено паролем, по умолчанию wledota. Чтобы обновиться, введите пароль в настройках безопасности, снимите флажок OTA locked, сохраните и перезагрузите, затем выберите Manual OTA update и загрузите файл прошивки. После обновления документация советует снова включить блокировку (раздел об обновлении). Перед обновлением сохраните пресеты.
Следующий шаг: Home Assistant и Алиса
Интеграции WLED в Home Assistant нужна прошивка 0.14.0 или новее (документация Home Assistant). Если контроллер в той же сети, Home Assistant обычно находит его сам: в Settings → Devices & services он появится как Discovered. Интеграция связывается с контроллером напрямую, через WebSocket или периодический опрос, так что брокер MQTT ей не нужен. Самодельные сборки без JSON-интерфейса она не поддерживает. Дальше по шагам:
- Добавьте WLED в Home Assistant и передайте свет в Алису — WLED и Алиса: настройка и эффекты.
- Для подсветки лестницы по датчикам используйте сборку WLED для лестницы: в обычном образе нужного модуля может не быть.
- Если эффекты не нужны и хватит одного цвета, проще обычная RGB-лента: контроллер RGB-ленты своими руками.
Источники
- Getting Started — документация WLED
- Compatible LED strips — документация WLED
- Wiring guides — документация WLED
- Wiring (power, fuses) — документация WLED
- Settings — документация WLED
- Install WLED binary — документация WLED
- Веб-установщик WLED
- Top 5 mistakes — документация WLED
- FAQ — документация WLED
- WLED — документация Home Assistant
