Troubleshooting¶

Рішення поширених проблем з JAAM Fusion. Тут зібрані реальні кроки, які відповідають поточній прошивці та веб‑інтерфейсу.

Tip

Для діагностики відкрийте панель "Логи пристрою" у веб‑інтерфейсі (іконка 📄 у шапці сторінки) та увімкніть стрім логів кнопкою "Показати". Детальніше: Налаштування → Панель логів.

Проблеми з підключенням¶

Пристрій не підключається до Wi‑Fi / не зʼявляється в мережі¶

Переконайтеся, що Wi‑Fi мережа 2.4 GHz (ESP32 не підтримує 5 GHz).
Перевірте стабільне живлення (особливо якщо одночасно підключено LED‑стрічку).
Якщо пристрій не може підключитися — він запускає вбудований captive portal і створює точку доступу виду JAAM_<chipId>. Підключіться до неї — браузер автоматично відкриє сторінку налаштування WiFi. Якщо сторінка не відкрилась автоматично — перейдіть вручну на http://192.168.4.1 (адреса softAP за замовчуванням).

Не можу відкрити веб‑інтерфейс¶

Перевірте:

пристрій і телефон/ПК у тій самій локальній мережі
ви відкриваєте адресу:
http://<IP-адреса-пристрою>/, або
http://<ім'я-в-мережі>.local/ (mDNS)

Де взяти адресу:

IP‑адресу можна подивитися у роутері або на дисплеї в режимі "Технічна інформація" (якщо дисплей увімкнений).
ім'я‑в‑мережі задається в Мережа → Ім'я в мережі. За замовчуванням воно має вигляд jaam_<chipId>.

Note

Якщо .local не відкривається у вашій мережі/на вашому пристрої — використовуйте IP‑адресу.

Докладніше: Мережа.

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

У веб‑інтерфейсі перейдіть до розділу Мережа та натисніть "Налаштування WiFi" — відкриється сторінка керування WiFi мережами. Там можна додати нову мережу, видалити зайву або просканувати доступні мережі.

Детальніше: Мережа → Налаштування WiFi.

Проблеми з LED¶

LED не світяться взагалі¶

Перевірте підключення:

стрічка має окреме живлення 5V (майже завжди потрібно)
GND стрічки та ESP32 зʼєднані
сигнал підключено до Data In, а не до Data Out

Перевірте налаштування:

Апаратне забезпечення → Основна стрічка (пін) — правильний GPIO (у профілях JAAM може бути зафіксований і прихований)
якщо використовується профіль "Власна карта LED":
Апаратне забезпечення → Основна стрічка (кількість)

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

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

Це майже завжди неправильний порядок каналів кольору.

Перейдіть:

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

Мерехтіння / артефакти на стрічці¶

Типові причини й рішення:

Живлення: використовуйте достатньо потужний БЖ, подавайте живлення в кількох точках на довгій стрічці.
Провід DATA: зробіть його коротшим, додайте резистор 220–470 Ом у розрив DATA.
Стабілізація: додайте конденсатор 100–470 мкФ біля входу живлення стрічки.

Проблеми з OLED дисплеєм¶

Дисплей нічого не показує¶

Перевірте живлення та I2C‑підключення вашого модуля (SDA/SCL).
Перевірте налаштування в веб‑інтерфейсі:
- Дисплей → Модель дисплею
- Дисплей → Висота / Поворот / Інвертувати дисплей
- Дисплей → Режим дисплею (для перевірки зручно обрати "Технічна інформація")

Детальніше: Дисплей.

Tip

Для додаткової діагностики можна увімкнути Загальні → Виводити логи в Serial і переглянути Serial‑логи.

Проблеми з даними (тривоги/погода)¶

Дані не оновлюються¶

Перевірте, що є доступ до інтернету.
Перевірте налаштування сервера даних:
- Мережа → Сервер WebSocket
- Мережа → Порт WebSocket
Відкрийте "Логи пристрою" і подивіться повідомлення з тегами на кшталт [WEBSOCKET], [WIFI].

Детальніше: Мережа.

Неправильний час¶

Перевірте Загальні → Часовий пояс.
Перевірте Мережа → NTP сервер.
Дайте пристрою трохи часу — синхронізація відбувається у фоні після підключення до мережі.

Проблеми зі стабільністю¶

Пристрій перезавантажується¶

Найчастіші причини:

нестабільне живлення (особливо зі стрічкою)
проблеми зі звʼязком (Wi‑Fi / сервер даних)
нестача памʼяті при дуже “важкій” конфігурації (багато LED, додаткові модулі)

Що зробити:

Відкрийте "Логи пристрою" і знайдіть, що відбувається перед ребутом (теги [MEMORY], [ERROR], [WIFI], [WEBSOCKET], [LED]).
Тимчасово зменшіть навантаження (наприклад, зменшити кількість LED у профілі "Власна карта LED").
Перевірте живлення та спільний GND.

Повільний веб‑інтерфейс¶

Очистіть кеш браузера.
Перевірте, чи немає проблем зі звʼязком (Wi‑Fi сигнал, перешкоди).
Не вмикайте зайві механізми діагностики без потреби (наприклад, Serial‑логи можуть впливати на продуктивність).

Скидання налаштувань¶

Скинути налаштування до початкових¶

У веб‑інтерфейсі: Загальні → Керування налаштуваннями → Скинути.

Note

Скидання налаштувань не змінює Wi‑Fi (як зазначено в інтерфейсі).

Отримання діагностики¶

Якщо звертаєтесь по допомогу, підготуйте:

версію прошивки
тип плати/профіль (який обрано в Загальні → Режим прошивки)
скріншот системної панелі (іконка ⓘ) та/або панелі логів (іконка 📄)
опис підключення LED (основна/фонова/сервісна) та живлення

Не допомогло?¶

Перевірте FAQ
Пошукайте в Issues на GitHub
Задайте питання в чаті проєкту
Створіть новий issue