Storage Link — краткое руководство

Storage Link — модуль на ESP32, который превращает адресную LED-ленту в индикатор склада катушек филамента и опционально публикует температуру и влажность с датчика SHT31.

• Подключается к Wi-Fi и связывает устройство с portal.idryer.org.
• По команде из облака или локального приложения подсвечивает слот катушки на заданное время заданным цветом.
• При установленном датчике SHT31 публикует температуру и влажность.

Знание о складе и катушках живёт во внешнем приложении. Прошивка работает как простой исполнительный модуль: «подсвети слот N цветом C на T секунд». Это позволяет наклеить ленту на любой стеллаж и описывать его в портале независимо от прошивки.

Поддерживаемые платы

Плата
ESP32-C3 DevKitM-1	✅
ESP32-C3 Super Mini	✅
Seeed XIAO ESP32-S3	✅
Waveshare ESP32-S3-Zero	✅

Любую другую плату на ESP32-C3 или ESP32-S3 можно использовать, если есть свободный GPIO под данные ленты и пара GPIO под I2C. Сверяйтесь с пинаутом производителя.

Схема подключения

Никогда не подключайте и не отключайте провода при поданном питании.

Storage Link управляет лентой по одному сигнальному GPIO (DATA) и опционально читает SHT31 по I2C.

Питание ленты

Лента и ESP должны питаться от источника, согласованного по току с реальной нагрузкой ленты.

• На многих платах ESP пин 5V (VBUS) выведен напрямую от USB-разъёма. Если используемый USB-блок питания отдаёт ток с запасом под нагрузку ленты, ESP и ленту допустимо питать параллельно от него.
• Если запаса по току нет — питание ленты выносится на отдельный 5 V БП. Минус БП обязательно соединяется с GND ESP — без общей земли сигнал DATA работать не будет.

В обоих случаях в меню psu_ma нужно прописать ток, который реально способен отдать ваш блок питания на 5 V. Это не «сколько хочется», а паспортная отдача БП. FastLED по этому значению ограничит совокупную яркость, чтобы не превысить лимит.

Хорошие практики монтажа

Эти элементы не обязательны для запуска, но устраняют типовые проблемы с адресной лентой (пропуски пикселей, «глюки» первого светодиода, просадки при включении).

• Резистор в линию DATA. Последовательно между GPIO ESP и DIN ленты ставится резистор 300–500 Ом (типично 390 Ом), физически как можно ближе к самой ленте. Гасит отражения сигнала и защищает первый чип ленты.
• Электролит по питанию. Между +5V и GND у входа питания ленты — 1000 мкФ на 16 В (на 25 В — тоже хорошо, на 10 В — минимум). Сглаживает броски тока при резких включениях.

• Сечение общей земли по току БП. Земляной провод ESP—лента—БП должен быть рассчитан на пиковый ток ленты. Ориентир для коротких проводов (до ~1 м):

  Ток БП	Сечение	AWG
  до 3 А	0,5 мм²	AWG 20
  до 5 А	0,75 мм²	AWG 18

  Для линии +5V к ленте — те же сечения. На длинных лентах подавайте питание с двух концов.

Подключения сигналов

Значения GPIO зависят от платы.

ESP32-C3 DevKitM-1 и ESP32-C3 Super Mini

ESP	Назначение
GPIO4	DATA адресной ленты
GPIO8	SDA (SHT31, опционально)
GPIO9	SCL (SHT31, опционально)
GND	общая земля с лентой и БП

Seeed XIAO ESP32-S3

ESP	Назначение
GPIO2	DATA адресной ленты
GPIO5	SDA (SHT31, опционально)
GPIO6	SCL (SHT31, опционально)
GND	общая земля с лентой и БП

Waveshare ESP32-S3 Zero

ESP	Назначение
GPIO4	DATA адресной ленты
GPIO8	SDA (SHT31, опционально)
GPIO9	SCL (SHT31, опционально)
GND	общая земля с лентой и БП

Пинаут плат

ESP32-C3 Super Mini:

Waveshare ESP32-S3-Zero:

Опциональный датчик SHT31

Датчик нужен, только если на этом устройстве хочется публиковать температуру и влажность. Storage Link стартует и работает с лентой одинаково — с датчиком или без. Если датчик не установлен, температура и влажность просто не отправляются.

• Шина: I2C на SDA/SCL соответствующей платы.
• Адрес: 0x44 или 0x45 (прошивка сама определит при старте).

Прошивка через веб-флешер

Веб-флешер находится на install.idryer.org.

1. Подключите Storage Link к USB-порту компьютера.
2. Откройте install.idryer.org и нажмите кнопку Storage Link.
3. Выберите свой вариант платы.
4. Нажмите Connect, выберите серийный порт. Если устройство не определяется, зажмите кнопку BOOT на плате и кратко нажмите RST.
5. Нажмите Install. Флешер запишет прошивку.
6. По завершении прошивки откроется мастер настройки Wi-Fi.

Настройка Wi-Fi

После прошивки в Serial-порт автоматически открывается Improv-мастер.

1. Введите SSID и пароль вашей сети 2,4 ГГц.
2. Дождитесь статуса Connected.

Если мастер не открылся, отключите USB и подключите снова через Connect без повторной прошивки.

ESP32-C3 и ESP32-S3 поддерживают только Wi-Fi 2,4 ГГц. Сети 5 ГГц не работают.

Привязка к порталу

1. На странице флешера нажмите Подключить и выполнить Claim. На устройство уйдёт команда claim.
2. Через несколько секунд на странице появится PIN. PIN действует около 5 минут.
3. Откройте portal.idryer.org → Добавить устройство → введите PIN.
4. После успешной привязки устройство появится в списке онлайн.

Если PIN не появился или привязка не прошла — повторите claim, либо удалите устройство в портале и попробуйте снова.

Настройка ленты

Параметры задаются через меню конфигурации устройства. Часть применяется сразу, часть — только после перезагрузки.

Параметр	Значения	По умолчанию	Применение
led_count	1..300, шаг 1	120	сразу
psu_ma	500..20000 мА, шаг 100	5000	сразу
тип ленты	выбор из доступных в меню	WS2812B	после reboot
порядок цветов	GRB, RGB, BRG, BGR	GRB	после reboot
language	ru / en	en	сразу

Базовый чек-лист после первого запуска:

1. Задайте led_count — фактическое число пикселей на ленте.
2. Задайте psu_ma — паспортный ток БП на 5 V в миллиамперах.
3. Выберите тип ленты, который у вас установлен.
4. Выберите порядок цветов. По умолчанию GRB. Если красный и зелёный поменяны местами или цвет неправильный — переберите варианты.
5. Перезагрузите устройство — тип ленты и порядок цветов применяются только после reboot.

Что должно получиться

• После claim устройство видно в портале online.
• Команда подсветки из портала или приложения зажигает выбранный слот на ленте на заданное время. Новая команда гасит предыдущий слот и зажигает следующий.
• Если установлен SHT31 — температура и влажность регулярно обновляются в портале.
• Если SHT31 не установлен — климатические показания отсутствуют, это нормально.