Зібрати мапу самому¶
Плата ESP32, адресні світлодіоди й блок живлення: з чого складається мапа JAAM Fusion, як спаяти стрічку і підлаштувати прошивку під свою конструкцію.
Що знадобиться¶
Плата 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 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 В у кількох місцях, щоб не просідала напруга й не змінювався колір на кінці.
Піни за замовчуванням, взяті з прошивки (для плат JAAM на ESP32). У власній збірці кожен пін змінюється у вебінтерфейсі.
| Що | GPIO | Примітка |
|---|---|---|
| Основна стрічка (мапа) | 13, на ESP32-C3: 2 | Увімкнена за замовчуванням, 26 LED. |
| Фонова підсвітка | 12 | Вимкнена за замовчуванням: вкажіть пін і кількість LED. |
| Сервісні LED (5 шт.) | 25 | Вимкнені за замовчуванням. |
| OLED і датчики (I2C) | SDA 21, SCL 22 | Живлення 3,3 В. |
| Buzzer | 33 | Пасивний. |
| DFPlayer PRO | RX 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 А.