Перейти до змісту

Зібрати мапу самому

7 хв читання Оновлено 21 листопада 2026 JAAM Fusion

Плата ESP32, адресні світлодіоди й блок живлення: з чого складається мапа JAAM Fusion, як спаяти стрічку і підлаштувати прошивку під свою конструкцію.

Не хочете паяти?Готову мапу можна купити в магазині JAAM. Ця сторінка для тих, хто збирає мапу сам.
Ліцензія прошивки: CC BY-NC-SA 4.0Збирати мапу для себе й близьких можна вільно. Продаж пристроїв із цією прошивкою без письмового дозволу авторів заборонений.

Що знадобиться

Плата ESP32ESP32, ESP32-S3 або ESP32-C3 із флеш-пам’яттю від 4 МБ.

Адресні світлодіодиWS2812B або WS2812B-2020: будь-які, сумісні з протоколом NeoPixel.

Блок живлення 5 ВПотужність залежить від кількості LED. Див. розділ про живлення нижче.

Основа мапиКонтур України з окремою коміркою під кожен світлодіод і розсіювач.

USB-кабель з данимиДля першої прошивки з комп’ютера.

За бажаннямOLED-дисплей, датчики, кнопки, buzzer або DFPlayer PRO, фонова підсвітка.

Оберіть розкладку LED

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

Варіант у вебінтерфейсіLEDДля кого
Початок на Одещині25Стандартний порядок із першим LED в Одеській області.
Початок на Одещині + Київ26Те саме, плюс окремий LED для Києва.
Початок на Закарпатті (+ Київ)25 / 26Стандартний порядок із початком у Закарпатті.
Власна карта LEDдо 500Будь-яка кількість і розташування: від простої стрічки до матриці.

Якщо ви не відтворюєте стандартний порядок, обирайте «Власна карта LED». Стандартний порядок для варіанту «Початок на Одещині + Київ»:

Номер LED і область
# LED 0 = перший після входу DIN
 0  Одеська обл.          13  Волинська обл.
 1  Миколаївська обл.     14  Рівненська обл.
 2  Дніпропетровська обл. 15  Житомирська обл.
 3  Полтавська обл.       16  Київська обл.
 4  Черкаська обл.        17  м. Київ
 5  Кіровоградська обл.   18  Чернігівська обл.
 6  Вінницька обл.        19  Сумська обл.
 7  Хмельницька обл.      20  Харківська обл.
 8  Чернівецька обл.      21  Луганська обл.
 9  Закарпатська обл.     22  Донецька обл.
10  Ів.-Франківська обл.  23  Запорізька обл.
11  Тернопільська обл.    24  Херсонська обл.
12  Львівська обл.        25  АР Крим

Спаяйте стрічку, як вам зручно

Для власної карти порядок пайки не має значення. Прокладайте ланцюжок так, як зручно з огляду на конструкцію: змійкою, рядами чи окремими шматками. Після прошивки ви в редакторі карти вкажете, який номер LED відповідає якому регіону.

  • Вихід DO одного LED з’єднуйте з входом DIN наступного. Перший LED у ланцюжку має номер 0.
  • Вхід DIN першого LED під’єднайте до GPIO плати. За замовчуванням це GPIO 13 (на ESP32-C3 це 2); пін можна змінити у вебінтерфейсі.
  • GND плати й GND блока живлення має бути спільним.
  • На довгих стрічках підводьте 5 В у кількох місцях, щоб не просідала напруга й не змінювався колір на кінці.
Порада щодо надійностіЦе загальні рекомендації для WS2812B, а не вимога прошивки: резистор приблизно 330 Ом у лінії даних біля першого LED і конденсатор близько 1000 мкФ на живленні стрічки. Якщо перший LED мерехтить на 3,3 В, допоможе перетворювач рівня.

Піни за замовчуванням, взяті з прошивки (для плат JAAM на ESP32). У власній збірці кожен пін змінюється у вебінтерфейсі.

ЩоGPIOПримітка
Основна стрічка (мапа)13, на ESP32-C3: 2Увімкнена за замовчуванням, 26 LED.
Фонова підсвітка12Вимкнена за замовчуванням: вкажіть пін і кількість LED.
Сервісні LED (5 шт.)25Вимкнені за замовчуванням.
OLED і датчики (I2C)SDA 21, SCL 22Живлення 3,3 В.
Buzzer33Пасивний.
DFPlayer PRORX 17, TX 16Для MP3 з SD-картки.
КнопкидовільніПін для кожної кнопки задається у вебінтерфейсі; на платах JAAM це 5, 2 і 4.

Прошийте плату

Прошивка встановлюється з браузера Chrome або Edge: відкрийте флешер JAAM, підключіть плату кабелем, оберіть її і встановіть свіжу версію. Докладніше про цей крок: Швидкий старт.

Після першого запуску підключіть мапу до Wi-Fi 2,4 ГГц і відкрийте її вебінтерфейс за IP-адресою або за mDNS-іменем.

Налаштуйте LED у вебінтерфейсі

У налаштуваннях обладнання оберіть «Власна карта LED» і заповніть параметри основної стрічки.

ПараметрЩо вказати
Пін основної стрічкиGPIO, до якого підключений DIN першого LED.
Кількість LEDСкільки всього світлодіодів у ланцюжку (до 500).
Формат кольорівNEO_GRB для більшості WS2812B (рекомендовано). Якщо червоний світиться зеленим, спробуйте інший формат.
Частота800 кГц (рекомендовано). 400 кГц потрібні лише для старих стрічок.

Зробіть власний маппінг

Відкрийте редактор карти. Він показує всі регіони (області, райони й міста): навпроти кожного є поле «номери LED, через кому». Впишіть номери світлодіодів, які мають світитися для цього регіону, і натисніть «Зберегти карту».

РегіонПоле в редакторіПояснення
Львівська обл.12Один LED на область.
Київська обл.16, 40Кілька LED на один регіон: до 25 на регіон.
Регіон, якого немає на вашій мапіпорожнєРегіон можна пропустити.
  • Нумерація починається з 0: це перший LED після входу DIN.
  • Один LED можна вказати для кількох регіонів: наприклад, для області й усіх її районів.
  • Налаштування зберігається в пам’яті пристрою й переживає перезавантаження та перепрошивку.
  • Готову карту можна експортувати у файл і імпортувати назад: корисно для резервної копії або щоб поділитися розкладкою.
Лише області чи також райони?Редактор містить усі регіони, які підтримує прошивка. Для простої мапи заповніть лише області. Райони й міста мають сенс, якщо у вас матриця з достатньою кількістю світлодіодів.

Додайте дисплей, датчики й підсвітку

Усе нижче необов’язкове й вмикається у вебінтерфейсі.

МодульЩо підтримується
OLED-дисплей (I2C)SSD1306 128×32 і 128×64, SH1106G 128×64, SH1107 128×64; обертання 0°, 90°, 180°, 270°.
Клімат у кімнатіBME280, BMP280, SHT2x, SHT3x, AHT30.
ОсвітленістьBH1750: автоматична яскравість за освітленням кімнати.
ЗвукПасивний buzzer із мелодіями або DFPlayer PRO з MP3.
КнопкиДля кожної: коротке й довге натискання з вибором дії.
Фонова підсвіткаДо 300 LED: копіює домашній регіон, один колір або власний колір для кожного LED.
Сервісні LEDДо 5 LED: живлення, Wi-Fi, дані, API та оновлення.

Живлення й яскравість

Для власного обладнання прошивка за замовчуванням обмежує яскравість до 90 зі 180, це близько 50%. Вище підняти можна лише в налаштуваннях і після підтвердження, що ви розумієте ризик. Абсолютна межа прошивки: 180.

Для орієнтира: плата JAAM 2.1 (26 LED на мапі й 44 фонових) при яскравості 65 споживає до ~1,4 А (~7 Вт), а JAAM 3.2 (405 LED) при яскравості 35 до ~1,6 А.

Не живіть довгу стрічку від USB платиБеріть блок живлення 5 В із запасом за струмом: на одному WS2812B у білому на повній яскравості струм може сягати 60 мА. Для перших тестів залишайте яскравість низькою.

Що далі