Полное руководство по веб-интерфейсу WLED

Wi-Fi Подключение к контроллеру напрямую

Для входа в панель выполните простые шаги:

Wizard Мастер начальной настройки (welcome.htm)

На приветственном экране доступны два ключевых действия:

• Настройка Wi-Fi сети (WIFI SETTINGS): выберите вашу домашнюю беспроводную сеть из списка и введите её пароль. Контроллер получит IP-адрес от роутера.
• Быстрая конфигурация ленты (TO THE CONTROLS): укажите тип вашей адресной ленты (например, WS281x или SK6812 RGBW) и общее количество диодов.

Top Bar Верхняя панель быстрых действий

Colors Вкладка «Цвета»

Точное управление цветовой гаммой, палитрами и оттенками:

• Цветовой круг / палитра: выбор любого из 16 миллионов оттенков прикосновением пальца или кликом мыши.
• Три слота цветов (1, 2, 3):
  • Основной цвет (1): базовый тон диодов или переднего плана эффекта.
  • Вторичный цвет (2): цвет фона в составных градиентных анимациях.
  • Третичный цвет (3): акцентный цвет искр, вспышек или контрастных деталей.
• Белый канал (W / CCT): для премиальных лент SK6812 RGBW и адресных лент с перестраиваемым белым цветом доступен отдельный ползунок яркости белых кристаллов или регулировка цветовой температуры (от тёплого 2700K до холодного 6500K).
• Предустановленные цветовые палитры: готовые дизайнерские градиенты (Rainbow, Sunset, Fire, Ocean, Forest, Party, Synthwave и десятки других).

FX Вкладка «Эффекты (FX)»

WLED содержит более 180 встроенных световых динамических эффектов. Каждый эффект полностью настраивается под вашу атмосферу:

Segments Вкладка «Сегменты» — Виртуальное зонирование

Сегментация — одна из мощнейших функций WLED. Она позволяет разделить одну физическую ленту на произвольное число независимых виртуальных участков без дополнительной проводки!

Presets Вкладка «Пресеты и плейлисты»

• Сохранение пресетов (слоты 1–250): запоминает полное текущее состояние подсветки — цвета, выбранный эффект, скорость, конфигурацию сегментов и индивидуальную яркость.
• Плейлисты (Playlists): циклическое световое шоу. Вы можете объединить несколько пресетов, задать время воспроизведения каждого (в секундах) и время плавного перехода между ними.
• Быстрый вызов: любой пресет можно привязать к физической настенной кнопке, ИК-пульту, расписанию по времени суток или голосовой команде умного дома.

3.1 Wi-Fi и сетевые настройки (settings_wifi.htm)

• Подключение к сети: сканирование сетей кнопкой «Scan», ввод имени SSID и пароля.
• Статический IP (Static IP): возможность вручную зафиксировать IP-адрес, шлюз и маску сети, чтобы адрес светильника не менялся при перезагрузке роутера.
• Сетевое имя mDNS: позволяет открывать светильник по ссылке http://имя.local (по умолчанию wled.local). Если у вас несколько светильников, назовите их, например, smart-kitchen.local и smart-bedroom.local.
• Точка доступа (AP): имя резервной сети, пароль, номер Wi-Fi канала и условие активации (всегда активна, только при потере домашней сети или отключена).
• ESP-NOW: высокоскоростной беспроводной протокол прямой связи между микроконтроллерами без задержек и без участия домашнего роутера.

3.2 Светодиоды, аппаратура и ограничитель тока ABL (settings_leds.htm)

Дополнительные аппаратные интерфейсы:

• Кнопки управления (Buttons): поддержка тактовых кнопок, сенсорных датчиков касания (Touch) и датчиков движения (PIR). Можно назначить отдельные действия на одиночное нажатие (вкл/выкл), двойной клик (смена пресета) и долгое удержание (диммирование яркости).
• Реле питания (Relay GPIO): WLED умеет управлять силовым реле или MOSFET-ключом, полностью обесточивая блок питания ленты при выключении света, снижая фоновое потребление энергии до нуля.
• ИК-пульт (IR Remote): выбор контакта приемника и раскладки пульта (24, 40, 44 кнопки или кастомный JSON).
• Стартовое состояние: выбор поведения ленты при включении в розетку (включать свет сразу или ждать команду, стартовая яркость, автозагрузка пресета).

3.3 2D матрицы и светодиодные панели (settings_2D.htm)

Используется для светодиодных экранов, пиксельных картин, часов и настенных панелей из адресных лент:

• Разрешение: ширина (Width) и высота (Height) в пикселях (например, 16x16, 8x32 или составные полотна).
• Раскладка ленты (Layout): змейка (Serpentine — когда каждая вторая строка идет в обратном направлении) или параллельные полосы.
• Начальная точка (First LED): верхний левый, верхний правый, нижний левый или нижний правый угол.
• Эксклюзивные 2D-эффекты: матричный дождь символов, игра «Жизнь» (Game of Life), 2D Огонь, Плазменный шар, ДНК-спираль и геометрические волны.

3.4 Интерфейс пользователя и кастомизация (settings_ui.htm)

• Темы оформления: Modern Dark (стильная темная тема), Classic, Light, Pure Black (для AMOLED дисплеев) и Transparent Glassmorphism.
• Акцентные цвета и кастомный CSS: возможность настроить цветовую гамму веб-интерфейса под ваш интерьер или бренд.
• Элементы управления: включение компактного режима, скрытие ненужных вкладок или ползунков для упрощения интерфейса детям или гостям.

3.5 Интерфейсы синхронизации и интеграция в Умный Дом (settings_sync.htm)

3.6 Время, NTP-сервер и умные расписания (settings_time.htm)

• Синхронизация времени по NTP: контроллер автоматически получает точное атомное время через интернет с автопереводом часовых поясов.
• Геолокация (Рассвет и Закат): указав широту и долготу вашего города (например, Рыбинск, Москва, СПб), светильник будет автоматически включать вечерний уютный свет строго на закате солнца!
• Расписания (Таймеры): запуск определенных пресетов в заданные часы, минуты и дни недели (будильник рассветом, автоматическое ночное приглушение).
• Оверлей часов: превращает любую линейную ленту или светодиодную матрицу в аналоговые или цифровые часы поверх текущего эффекта.

3.7 Безопасность, резервное копирование и сброс (settings_sec.htm)

• Защита PIN-кодом: блокировка входа в меню настроек паролем, чтобы настройки ленты не были сбиты гостями или детьми.
• Блокировка OTA: запрет обновления прошивки по воздуху без прямого физического доступа к оборудованию.
• Резервное копирование (Backup):
  • Скачивание файла сохраненных пресетов: presets.json
  • Скачивание файла полной аппаратной конфигурации: cfg.json
• Восстановление (Restore): загрузка ранее сохраненных файлов настроек обратно в контроллер за 2 секунды.
• Заводской сброс (Factory Reset): полное очищение памяти контроллера к первоначальному состоянию.

3.8 DMX-512 выход и интерактивная карта (settings_dmx.htm)

Профессиональные инструменты для сценического, студийного и архитектурного освещения:

• Поддержка трансляции DMX-512 через аппаратный порт RS-485.
• Назначение стартовых DMX-каналов, шага между приборами и профилей светильников (RGB, RGBW, Dimmer).
• Интерактивная визуальная карта распределения каналов в реальном времени (dmxmap.htm).

3.9 Пользовательские модули расширения (Usermods)

WLED поддерживает подключение внешних модулей и датчиков:

OTA Обновление прошивки по воздуху (/update)

Позволяет обновлять WLED на свежие версии без подключения платы к компьютеру через провод.

LittleFS Встроенный файловый менеджер (/edit)

Полноценный встроенный проводник по внутренней флеш-памяти контроллера. Доступен по адресу: http://wled.local/edit 📋

• Прямой просмотр и текстовое редактирование конфигурационных файлов (cfg.json, presets.json).
• Загрузка пользовательских фоновых картинок, кастомных шрифтов и стилей CSS для веб-интерфейса.
• Удаление устаревших файлов и проверка свободного места на флеш-памяти.

Pinout Карта распределения выводов GPIO (/settings/pininfo)

Наглядная интерактивная таблица всех контактов микроконтроллера в реальном времени:

• Зеленый статус: вывод свободен для подключения новых лент, кнопок или датчиков.
• Оранжевый / Синий статус: вывод уже занят LED-лентой, кнопкой, реле или шиной I2C.
• Серый статус: служебный системный вывод микроконтроллера (Flash, Bootstrapping).