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 та 3.3 (обидві працюють на профілі Плата 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
Довідник: області та райони з ID¶
Повний список регіонів прошивки (вбудована карта Плата JAAM 3.2) з їхніми ID — для довідки, зокрема при роботі з Редактором мапи. Порядок такий, як у прошивці: спочатку область, далі її райони та великі міста.
Таблиця регіонів (171)
| ID | Назва |
|---|---|
| 9999 | АР Крим |
| 4 | Вінницька обл. |
| 32 | Тульчинський район |
| 35 | Жмеринський район |
| 36 | Вінницький район |
| 34 | Хмільницький район |
| 33 | Могилів-Подільський район |
| 37 | Гайсинський район |
| 155 | м. Вінниця та Вінницька територіальна громада |
| 8 | Волинська обл. |
| 39 | Луцький район |
| 38 | Володимирський район |
| 40 | Ковельський район |
| 41 | Камінь-Каширський район |
| 225 | м. Луцьк та Луцька територіальна громада |
| 9 | Дніпропетровська обл. |
| 43 | Самарівський район |
| 44 | Дніпровський район |
| 47 | Нікопольський район |
| 48 | Синельниківський район |
| 42 | Кам'янський район |
| 45 | Павлоградський район |
| 46 | Криворізький район |
| 332 | м. Дніпро та Дніпровська територіальна громада |
| 28 | Донецька обл. |
| 56 | Покровський район |
| 51 | Горлівський район |
| 55 | Волноваський район |
| 53 | Донецький район |
| 49 | Кальміуський район |
| 52 | Маріупольський район |
| 50 | Краматорський район |
| 54 | Бахмутський район |
| 10 | Житомирська обл. |
| 59 | Житомирський район |
| 58 | Коростенський район |
| 57 | Бердичівський район |
| 60 | Звягельський район |
| 442 | м. Житомир та Житомирська територіальна громада |
| 11 | Закарпатська обл. |
| 66 | Ужгородський район |
| 61 | Берегівський район |
| 62 | Хустський район |
| 63 | Рахівський район |
| 64 | Тячівський район |
| 65 | Мукачівський район |
| 500 | м. Ужгород та Ужгородська територіальна громада |
| 12 | Запорізька обл. |
| 146 | Василівський район |
| 145 | Пологівський район |
| 149 | Запорізький район |
| 147 | Бердянський район |
| 148 | Мелітопольський район |
| 564 | м. Запоріжжя та Запорізька територіальна громада |
| 13 | Ів.-Франківська обл. |
| 68 | Івано-Франківський район |
| 67 | Верховинський район |
| 71 | Калуський район |
| 72 | Надвірнянський район |
| 70 | Коломийський район |
| 69 | Косівський район |
| 632 | м. Івано-Франківськ та Івано-Франківська територіальна громада |
| 14 | Київська обл. |
| 77 | Фастівський район |
| 73 | Білоцерківський район |
| 75 | Бучанський район |
| 76 | Обухівський район |
| 74 | Вишгородський район |
| 750 | м. Славутич та Славутицька територіальна громада |
| 8888 | м. Припʼять |
| 79 | Броварський район |
| 78 | Бориспільський район |
| 31 | м. Київ |
| 15 | Кіровоградська обл. |
| 81 | Кропивницький район |
| 80 | Олександрійський район |
| 82 | Голованівський район |
| 83 | Новоукраїнський район |
| 761 | м. Кропивницький та Кропивницька територіальна громада |
| 16 | Луганська обл. |
| 86 | Старобільський район |
| 85 | Сватівський район |
| 84 | Сєвєродонецький район |
| 87 | Щастинський район |
| 27 | Львівська обл. |
| 90 | Львівський район |
| 89 | Стрийський район |
| 88 | Самбірський район |
| 91 | Дрогобицький район |
| 92 | Шептицький район |
| 94 | Золочівський район |
| 93 | Яворівський район |
| 845 | м. Львів та Львівська територіальна громада |
| 17 | Миколаївська обл. |
| 96 | Баштанський район |
| 95 | Вознесенський район |
| 97 | Первомайський район |
| 98 | Миколаївський район |
| 926 | м. Миколаїв та Миколаївська територіальна громада |
| 18 | Одеська обл. |
| 105 | Болградський район |
| 100 | Березівський район |
| 104 | Одеський район |
| 102 | Білгород-Дністровський район |
| 103 | Роздільнянський район |
| 101 | Ізмаїльський район |
| 99 | Подільський район |
| 964 | м. Одеса та Одеська територіальна громада |
| 19 | Полтавська обл. |
| 107 | Кременчуцький район |
| 106 | Лубенський район |
| 109 | Полтавський район |
| 108 | Миргородський район |
| 1060 | м. Полтава та Полтавська територіальна громада |
| 5 | Рівненська обл. |
| 110 | Вараський район |
| 111 | Дубенський район |
| 112 | Рівненський район |
| 113 | Сарненський район |
| 1133 | м. Рівне та Рівненська територіальна громада |
| 20 | Сумська обл. |
| 115 | Шосткинський район |
| 116 | Роменський район |
| 117 | Конотопський район |
| 114 | Сумський район |
| 118 | Охтирський район |
| 1187 | м. Суми та Сумська територіальна громада |
| 21 | Тернопільська обл. |
| 119 | Тернопільський район |
| 121 | Чортківський район |
| 120 | Кременецький район |
| 1241 | м. Тернопіль та Тернопільська територіальна громада |
| 22 | Харківська обл. |
| 124 | Харківський район |
| 123 | Куп'янський район |
| 122 | Чугуївський район |
| 126 | Богодухівський район |
| 127 | Берестинський район |
| 125 | Ізюмський район |
| 128 | Лозівський район |
| 1293 | м. Харків та Харківська територіальна громада |
| 23 | Херсонська обл. |
| 131 | Каховський район |
| 129 | Бериславський район |
| 130 | Скадовський район |
| 132 | Херсонський район |
| 133 | Генічеський район |
| 1370 | м. Херсон та Херсонська територіальна громада |
| 3 | Хмельницька обл. |
| 136 | Шепетівський район |
| 134 | Хмельницький район |
| 135 | Кам'янець-Подільський район |
| 1400 | м. Хмельницький та Хмельницька територіальна громада |
| 24 | Черкаська обл. |
| 153 | Золотоніський район |
| 152 | Черкаський район |
| 150 | Звенигородський район |
| 151 | Уманський район |
| 1473 | м. Черкаси та Черкаська територіальна громада |
| 26 | Чернівецька обл. |
| 139 | Дністровський район |
| 138 | Вижницький район |
| 137 | Чернівецький район |
| 1542 | м. Чернівці та Чернівецька територіальна громада |
| 25 | Чернігівська обл. |
| 141 | Новгород-Сіверський район |
| 142 | Ніжинський район |
| 143 | Прилуцький район |
| 140 | Чернігівський район |
| 144 | Корюківський район |
| 1591 | м. Чернігів та Чернігівська територіальна громада |