Редактор мапи¶

Сторінка "Редактор власної карти LED" (/map-editor) дозволяє створити власне зіставлення:

регіон → список LED (індекси на основній LED-стрічці)

Це потрібно, коли ви використовуєте нестандартну геометрію мапи (інша кількість LED, інший порядок, власна форма тощо).

Note

Редактор змінює лише мапінг основної LED-стрічки (main). Фонова (bg) та сервісна (service) стрічки не редагуються на цій сторінці.

Як відкрити редактор¶

Редактор доступний лише для режиму прошивки "Власна карта LED".

У веб-інтерфейсі відкрийте: Загальні → Режим прошивки.
Оберіть "Власна карта LED".
З’явиться кнопка "Редактор мапи" — натисніть її.

Детальніше про те, де це в інтерфейсі: Загальні

Як влаштована форма¶

Після відкриття сторінка завантажує поточні дані мапи з пристрою і показує список регіонів.

Для кожного регіону є:

назва (підрегіони відображаються з відступом)
текстове поле, куди вводяться індекси LED через кому

Приклад значення в полі регіону:

0, 1, 2, 3
15, 16, 17

Important

Нумерація LED починається з нуля: перший LED на стрічці має індекс 0, наступний — 1 і т.д.

Пробіли дозволені — прошивка їх ігнорує.

Tip

Зазвичай зручно заповнювати мапу блоками: йти по стрічці зліва направо (або навпаки) і роздавати діапазони індексів регіонам.

Правила і обмеження¶

Під час збереження прошивка перевіряє дані:

індекс LED має бути в межах 0–499
максимум 25 LED на один регіон

Якщо ввести некоректне значення, збереження буде відхилено.

Warning

Редактор не блокує дублікати: технічно можна вказати той самий індекс LED у кількох регіонах або повторити його в одному полі.

Збереження і застосування¶

Внесіть зміни у потрібних полях.
Натисніть "Зберегти карту".

Після успішного збереження пристрій:

записує карту у флеш-пам’ять (SPIFFS) як файл /custom_map.json
перераховує мапінг LED
адаптує кольори
перепідключає WebSocket (щоб оновити дані, які залежать від мапи)

Це означає, що зміни застосовуються одразу, але під час застосування можуть бути короткі "перемикання" в індикації.

Експорт карти (резервна копія)¶

Кнопка "Експорт" зберігає поточну мапу у файл *.json на ваш комп’ютер.

Експортований формат має вигляд:

{
  "regions": [
        {"id": 1, "name": "...", "leds": [0, 1, 2]},
        {"id": 2, "name": "...", "leds": [3, 4]}
  ]
}

Note

Експорт зручний як резервна копія перед великими правками або для перенесення мапи на інший пристрій.

Імпорт карти з JSON¶

Кнопка "Імпорт" завантажує мапу з файлу *.json.

Особливості імпорту:

файл має містити поле regions (масив)
для кожного елемента мають бути id (число) та leds (масив чисел)
структура регіонів (порядок/вкладеність) береться з поточної прошивки, а імпорт лише підставляє LED по збігу id

Після імпорту сторінка покаже повідомлення, що дані завантажені.

Important

Імпорт не зберігає карту автоматично. Після імпорту обов’язково натисніть "Зберегти карту", щоб застосувати зміни на пристрої.

Типові помилки¶

Під час збереження пристрій може повернути помилку, якщо:

введено некоректний індекс (поза 0–499)
у регіоні вказано більше ніж 25 LED
не заповнено жодного регіону (нема що зберігати)
не вдалося зберегти файл у пам’ять або не вистачило пам’яті

Якщо сторінка показує "Помилка завантаження даних карти" — перевірте, що пристрій у мережі і веб-інтерфейс відкрито з актуальної адреси.

Дивіться також¶

Загальні — де увімкнути "Власна карта LED" і відкрити редактор
LED Mapping — загальні принципи LED-мапінгу