LED Mapping¶
LED Mapping (мапінг LED) — це правило, за яким прошивка розуміє: які LED основної стрічки відповідають яким регіонам.
Саме цей мапінг визначає, які “області/райони” будуть підсвічуватися на вашій конфігурації (готова плата, стартовий комплект, або власна карта LED).
Основні поняття¶
- LED позиція — це номер LED на основній стрічці (main) у порядку, в якому вони йдуть по дроту Data In → Data Out.
- Регіон — це запис у списку регіонів прошивки (область або район/підрегіон залежно від режиму).
Нумерація LED
Нумерація починається з 0: перша LED на стрічці — це LED 0.
Як прошивка вибирає мапінг¶
Мапінг залежить від налаштування Загальні → Режим прошивки:
- для профілів на кшталт Плата JAAM 1.3 / 2.1 / 3.0 / 3.2 (а також “стартових” профілів) прошивка використовує вбудовані карти LED
- для профілю Власна карта LED прошивка намагається завантажити мапінг зі сховища
Для JAAM 3.2 доступні два вбудовані варіанти:
- Плата JAAM 3.2 — мапа з деталізацією по районах/підрегіонах (
REGION_MAP_JAAM_3_2) - Плата JAAM 3.2 (по областям) — мапа, де тривоги/події відображаються по областях (райони/громади агреговані до області/міста) (
REGION_MAP_JAAM_3_2_REGIONS)
Note
Для "Власна карта LED" мапінг зберігається у файловій системі SPIFFS у файлі:
/custom_map.json
Якщо файл не знайдено або він некоректний — прошивка підставить дефолтну карту (щоб пристрій залишався працездатним).
Редактор мапи¶
Редактор доступний тільки коли вибрано:
- Загальні → Режим прошивки → Власна карта LED
Після цього з’являється кнопка "Редактор мапи", яка відкриває сторінку редагування.
Детальна інструкція: Редактор мапи
Обмеження (як у прошивці)¶
Прошивка накладає жорсткі ліміти на кастомний мапінг:
- максимальна кількість LED на основній стрічці: 500 (допустимі індекси
0..499) - максимальна кількість LED, які можна привʼязати до одного регіону: 25
Warning
Якщо вказати індекс LED поза діапазоном або додати забагато LED до регіону — прошивка відхилить збереження мапи.
Як працює відображення, якщо LED належить кільком регіонам¶
Мапінг дозволяє привʼязати одну й ту саму LED до кількох регіонів. Це використовується, наприклад, коли одна LED умовно “покриває” кілька адміністративних одиниць.
Поведінка залежить від режиму мапи:
- у режимах, де потрібно підсвітити подію (тривога/загроза), прошивка обере “найважливішу” подію для цієї LED
- у режимі Погода для такої LED використовується середнє значення температур по привʼязаних регіонах
Де налаштовується кількість LED¶
Для профілів готових плат кількість LED визначається апаратним профілем.
Для "Власної карти LED" кількість LED основної стрічки задається в секції Апаратне забезпечення.
Детально: Апаратне забезпечення
Troubleshooting¶
Після вибору "Власна карта LED" мапа виглядає як дефолтна¶
Зазвичай це означає, що кастомний файл не завантажився.
Перевірте:
- чи ви натиснули "Зберегти карту" в редакторі
- чи пристрій має достатньо вільної памʼяті у SPIFFS
- чи вказані LED індекси в межах
0..499і не більше 25 на регіон
Регіон не підсвічується¶
Перевірте, чи для цього регіону в мапі задано хоча б одну LED.
Більше: Troubleshooting