ledy-micro

Прошивка для контроллеров серии ESP32. Установив её на контроллер можно управлять светодиодной лентой WS2812B, например с компьютера или смартфона.

Инструкция

Я опишу свой сетап. Лента на 240 светодиодов, вклеенных в алюминиевые профили, ленты соединены через коннекторы.

Я не несу ответственности за ссылки. Они для примера.

Покупка деталей

• WS2812B DC5V, 5m, 60.

  • 5 метров, 60 светодиодов на метр. У нас будет 4 метра, итого 240 светодиодов.

• Блок для питания светодиодных лент 5V, 20A.

  • Подходит для 250 светодиодов. Если у вас больше светодиодов, лента будет не такой яркой. Более мощные блоки имеют шумный вентилятор.

• ESP32-WROOM-32D.

  • Будет управлять лентой, а им будем управлять через Wi-Fi. Прошивка проверялась на нём. Другие версии ESP тоже могут подойти, но я не проверял.

• Трёхпиновый JST мама-папа (25 мам и 25 пап).

  • Будут использоваться для соединения лент между собой.

• Набор перемычек Dupont.

  • Хватит набора мама-мама; мама-папа; папа-папа. В общем 120 штук. На запас.

• Конденсатор 1000uF 35V.

  • Чтобы всё работало стабильно. Наверное.

• Резистор от 330 до 500 ohm.

  • Чтобы с контроллера на ленту данные поступали без проблем.

• 4 метровых алюминиевых профиля для светодиодной ленты.

  • Плюсы: лента защищена, свет рассеивается, красиво.
  • Минусы: дорого.

• Провод, чтобы выдерживал 200V.

  • Например можно срезать со светильника.

• Несколько метров проводов для ленты.

  • Количество метров зависит от того, как далеко лента будет от блока питания. Слишком длинный провод не подойдет: питание будет падать, сигнал будет доходить намного дольше.
  • Подойдет даже витая пара, если смотать в один провод. Говорят чем больше сечение, тем меньше будет потерь питания. Но провода с большим сечением дорогие и неудобные. В общем берите в меру толстый провод. Я использую витую пару из 6 жил или типа того.

Установка прошивки

• Скачайте и установите USB драйвер для чипов CP210x (CP210x Windows Drivers).

• Установите ESP-IDF для VS Code.

  • Возможно это самая сложная вещь в этой инструкции. Детали установки долго расписывать. Не стесняйтесь гуглить и задавать вопросы.

• Скачайте или клонируйте этот репозиторий (проект) в котором вы сейчас читаете эту инструкцию.

• Откройте этот проект в VS Code. Подождите пока ESP-IDF скачивает зависимости, и всё настраивает.

• Нажмите F1, введите sdk conf, в меню выберите SDK Configuration editor (Menuconfig).

• В поиске введите ledy, введите в поля WiFi SSID и WiFi Password имя и пароль вашей Wi-Fi сети.

• В поиске введите websocket и включите галочку WebSocket server support.

• Нажмите кнопку Save.

• Возможно вам потребуется выбрать порт, к которому подключен ESP32. Это можно сделать нажав F1 и введя в поиск port (select port to use).

• Нажмите F1, введите Build, Flash and Start a Monitor on your Device, и запустите. Выберите UART, если появится сообщение о выборе. В итоге внизу появится терминал, в котором будет видно процесс установки прошивки. Когда начнут появлятся разные зеленые надписи, или что-то будет написано про Wi-Fi, значит прошивка установилась.

Клиент

Подключите всю схему. Ленту подключите к ESP32, к пину под нужным номером (см. LEDY_PIN_1). Скачайте или разработайте свой клиент. Дальнейшие инструкции зависят от программ-клиентов.

Мои клиенты:

• Android

• Go

• C++

Для разработчиков

Для соединения с лентой запустите в вашем клиенте DNS Service Discovery, ищите сервис _ledy._tcp.local. После нахождения IP подключайтесь к нему по WebSocket, к порту 80, по пути /ws. Пример: ws://192.168.1.2/ws

Протокол данных (BINARY):

[1 BYTE COMMAND (0-255)] [2 BYTES DATA LEN] [??? DATA]

На данный момент доступа только команда для установки светодиодов:

[0] [2 BYTES GRB LENGTH] [G, R, B]