Мережа¶
Секція "Мережа" містить налаштування підключення до серверів (дані тривог/подій), синхронізації часу, а також керування мережевими сервісами для інтеграцій (наприклад, Home Assistant).
Налаштування WiFi¶
Кнопка "Налаштування WiFi" відкриває окрему сторінку /wifi для керування збереженими WiFi мережами.
На сторінці можна:
- переглядати список збережених мереж (з індикатором наявності пароля)
- сканувати доступні мережі в радіусі дії пристрою та додавати їх одним натиском
- додавати мережу вручну (SSID + пароль)
- видаляти зайві мережі
Пристрій підтримує до 5 збережених мереж одночасно і автоматично підключається до найкращої з доступних при наступному перезавантаженні або при втраті поточного підключення.
Tip
Якщо видалити всі збережені мережі, пристрій при наступному перезавантаженні запустить captive portal для первинного налаштування WiFi.
Ім'я в мережі¶
Перейдіть: Мережа → Ім'я в мережі
Це mDNS hostname пристрою (адреса виду http://<ім'я>.local).
Tip
За замовчуванням прошивка встановлює hostname як jaam_<chipId> (наприклад, jaam_a1b2c3.local).
Note
Якщо *.local не відкривається у вашій мережі — використовуйте IP-адресу пристрою.
WebSocket (сервер даних)¶
Прошивка отримує дані в реальному часі через WebSocket.
Сервер WebSocket¶
Перейдіть: Мережа → Сервер WebSocket
Типове значення за замовчуванням: ws.jaam.net.ua.
Порт WebSocket¶
Перейдіть: Мережа → Порт WebSocket
Типове значення за замовчуванням: 80.
NTP (синхронізація часу)¶
Перейдіть: Мережа → NTP сервер
Пристрій використовує NTP для синхронізації часу.
Типове значення за замовчуванням: time.google.com.
Tip
Якщо у вашій мережі є власний NTP (наприклад, на роутері/сервері) — можете вказати його адресу.
Home Assistant (API/WebSocket)¶
У блоці "Home Assistant" можна увімкнути додатковий WebSocket/API-сервіс на окремому порту.
Інтеграція для Home Assistant: J-A-A-M/jaam_ha
Увімкнути API (WebSocket)¶
Перейдіть: Мережа → Увімкнути API (WebSocket)
Коли опцію увімкнено:
- прошивка запускає API/WebSocket сервер на заданому порту
- у mDNS публікується сервіс
jaam-ws(TCP) — це спрощує авто-виявлення інтеграціями
Порт API (WebSocket)¶
Перейдіть: Мережа → Порт API (WebSocket)
Типове значення за замовчуванням: 81.
Warning
Порт 80 зарезервований для веб-інтерфейсу. Використовуйте інший порт (наприклад, 81).
Автентифікація веб-інтерфейсу¶
За замовчуванням веб-інтерфейс доступний без пароля. Якщо пристрій знаходиться в загальнодоступній мережі, рекомендується увімкнути автентифікацію.
Увімкнути автентифікацію¶
Перейдіть: Мережа → Увімкнути автентифікацію
Коли опцію увімкнено:
- всі сторінки та API-ендпоінти вимагають активного сеансу
- браузер автоматично перенаправляється на сторінку входу
/login - після успішного входу видається сесійний cookie, що зберігається до перезавантаження пристрою
Note
Статичні ресурси (CSS, JS) залишаються доступними без авторизації — це потрібно для коректного відображення сторінки входу.
Логін¶
Перейдіть: Мережа → Логін
Ім'я користувача для входу у веб-інтерфейс.
Значення за замовчуванням: admin.
Пароль¶
Перейдіть: Мережа → Пароль
Пароль для входу у веб-інтерфейс. Поле відображається із прихованими символами, з кнопкою для тимчасового відображення введеного тексту.
Значення за замовчуванням: admin.
Warning
Дефолтні облікові дані (admin / admin) відомі публічно. Обов'язково змініть пароль перед увімкненням автентифікації, якщо пристрій доступний з ненадійної мережі.
Tip
Вимоги до пароля: мінімум 8 символів, велика та мала літера, цифра.
Вихід¶
Кнопка виходу з'являється у правому верхньому куті веб-інтерфейсу, коли автентифікацію увімкнено. Після виходу сеанс завершується і браузер перенаправляється на сторінку входу.
Відновлення доступу¶
Якщо пароль забутий — використовуйте одноразовий токен відновлення.
Кроки:
- Підключіть пристрій до комп'ютера через USB
- Відкрийте серійний монітор (115200 baud)
- Перезавантажте пристрій
- Знайдіть у логах рядок:
- Відкрийте сторінку входу у браузері
- Натисніть "Вхід з токеном відновлення"
- Введіть токен і натисніть "Увійти за токеном"
Note
Токен генерується щоразу при увімкненні автентифікації і є одноразовим — після успішного входу за токеном він анулюється. Після входу встановіть новий пароль у налаштуваннях.