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

FAQ — Часті питання

Загальні питання

Що таке JAAM Fusion?

JAAM Fusion — це прошивка для ESP32, яка керує LED‑стрічкою як “мапою” та відображає події (повітряні тривоги, погоду тощо) на основі даних із серверу.

Керування відбувається через веб‑інтерфейс у локальній мережі.

Чи потрібні навички програмування?

Ні. Для базового використання зазвичай достатньо:

  • прошити ESP32 (через веб‑флешер)
  • налаштувати Wi‑Fi
  • підключити LED‑стрічку та живлення

Яка вартість проєкту?

Проєкт можна використовувати безкоштовно для особистих/навчальних/некомерційних цілей (ліцензія CC BY‑NC‑SA 4.0).

Комерційне використання (наприклад, виробництво/продаж пристроїв із цією прошивкою або платні послуги) можливе лише з письмовим дозволом правовласників.

У будь‑якому разі оплачуються лише компоненти (ESP32, LED‑стрічка, блок живлення тощо).

Апаратне забезпечення

Які плати підтримуються?

Проєкт збирається під ESP32 / ESP32‑S3 / ESP32‑C3 і потребує щонайменше 4MB Flash.

Деталі й застереження — у розділі Підтримувані плати.

Скільки LED можна підключити?

У прошивці є реальні ліміти:

  • основна стрічка: до 500 LED
  • фонова стрічка: до 300 LED
  • для власної карти: до 25 LED на один регіон

Практичне обмеження майже завжди — живлення (струм/падіння напруги), а не лише ESP32.

Які LED‑стрічки підтримуються?

Підходять адресні стрічки “NeoPixel‑сумісного” класу (типові приклади: WS2812B, SK6812, WS2811, APA106).

Ключове — правильно вибрати:

  • порядок кольорів (наприклад, NEO_GRB)
  • частоту (зазвичай 800 КГц)

Це налаштовується в Апаратне забезпечення.

Чи потрібен окремий блок живлення для LED?

Так — майже завжди.

ESP32 не призначена для живлення стрічки: подавайте 5V на стрічку від окремого блоку живлення, а GND стрічки та ESP32 обов’язково з’єднуйте.

Чи можна використовувати без OLED дисплею?

Так. OLED дисплей — опціональний.

Налаштування

Як змінити яскравість LED?

Перейдіть у веб‑інтерфейсі: Яскравість.

Детальніше: Яскравість.

Чи можна отримувати тривоги/погоду без інтернету?

Дані тривог/погоди надходять через мережу (WebSocket), тому без доступу до інтернету вони не оновлюватимуться.

При цьому веб‑інтерфейс у локальній мережі та локальні режими (наприклад, “Лампа”) можуть працювати.

Як змінити Wi‑Fi мережу?

У веб‑інтерфейсі є кнопка "Змінити налаштування WiFi" — вона відкриває WiFi‑портал на порту 8080.

Опис: Загальні → Конфігурація WiFi.

Проблеми

Пристрій не підключається до Wi‑Fi

  1. Переконайтеся, що мережа 2.4 GHz (ESP32 не підтримує 5 GHz).
  2. Перевірте правильність пароля.
  3. Якщо підключення не вдається, прошивка запускає режим налаштування: з’являється точка доступу JAAM_<chipId>. Підключіться до неї та відкрийте адресу, яку покаже пристрій (часто це 192.168.4.1).

LED світяться неправильними кольорами

Зазвичай це означає неправильний порядок каналів кольору.

Перейдіть:

  • Апаратне забезпечення → Основна стрічка (формат кольору) (спробуйте NEO_GRB (рекомендовано) та інші)
  • Апаратне забезпечення → Основна стрічка (частота) (800/400 КГц)

Детальніше: Апаратне забезпечення.

Веб‑інтерфейс недоступний

  1. Перевірте, що ви в тій самій мережі, що й пристрій.
  2. Спробуйте відкрити за IP (подивіться IP у роутері або на екрані пристрою, якщо він є).
  3. Спробуйте mDNS‑адресу виду http://<ім'я>.local. За замовчуванням hostname — jaam_<chipId>.

Докладніше: Мережа → Ім'я в мережі.

Розробка

Як зібрати прошивку з вихідного коду?

Дивіться: Збірка проєкту.

Як додати власний режим відображення?

Дивіться: Архітектура та Contribution Guide.

Де зберігаються налаштування?

  • основні налаштування — у NVS (Preferences)
  • окремі файли (наприклад, дані власної карти та фонові кольори) — у файловій системі пристрою

Не знайшли відповідь?