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

Home Assistant

JAAM Touch має локальний API для інтеграції з Home Assistant: бачити стан пристрою в HA та керувати ним з автоматизацій. Інтеграція — та сама, що й для JAAM Fusion: https://github.com/J-A-A-M/jaam_ha.

Безпека

API не має авторизації: будь-хто в тій самій локальній мережі, хто може достукатися до пристрою, може читати й змінювати його стан. Тому API вимкнено за замовчуванням — вмикайте лише в мережі, якій довіряєте.

Підключення

  1. Встановіть інтеграцію jaam_ha у Home Assistant за інструкцією в репозиторії (через HACS) і перезапустіть Home Assistant.
  2. Увімкніть API на пристрої (розділ «Увімкнення» нижче).
  3. У Home Assistant відкрийте Налаштування → Пристрої та служби. Якщо пристрій зʼявився в блоці «Виявлені», натисніть «Додати» і завершіть майстер.
  4. Якщо автоматично не зʼявився (наприклад, HA і пристрій у різних підмережах), додайте інтеграцію JAAM вручну й вкажіть IP-адресу пристрою (вона на сторінці Мережа) та порт 81.

Увімкнення

  1. Відкрийте меню → Мережа.
  2. Торкніться плитки HA API. Її підпис показує стан: «Вимкнено», «Очікує HA» (API працює, але HA ще не підключився) або «Підключено».

Меню «Мережа»: плитки «HA API» і «Назва пристрою»

Поки API увімкнено, на екрані зверху зліва видно іконку Home Assistant (червона — очікує підключення, зелена — HA підключено). Її можна окремо сховати: Віджети → Статуси → HA. Коли API вимкнено, іконки немає.

HA підключено HA очікує підключення

Назва пристрою

Плитка Назва пристрою на тій самій сторінці «Мережа» задає імʼя, під яким пристрій бачить Home Assistant (до 31 символу). Після зміни пристрій одразу повторно оголошує себе в мережі під новою назвою.

Екран введення назви пристрою

Що ви отримаєте в Home Assistant

Інтеграція створює для Touch такі сутності:

Показують стан

  • Тривоги в домашньому регіоні — окремий бінарний датчик на кожен тип загрози (червоний і жовтий рівні, дрони, ракети, КАБ, балістика, вибухи, розвідувальні дрони та інші).
  • Домашній регіон і температура в регіоні.
  • Статус WebSocket — чи є зʼєднання пристрою із сервером даних, і час роботи WebSocket.
  • Батарея: заряд, напруга, орієнтовний час роботи, чи йде зарядка (поки обмеження заряду утримує 80%, показується «не заряджається»), чи є зовнішнє живлення.
  • Wi‑Fi: сигнал WiFi і час роботи WiFi.
  • Система: час роботи пристрою, використано памʼяті, температура CPU.
  • Прошивка — сутність оновлення показує, що доступна нова версія, і може її встановити.

Дозволяють керувати

  • Режим — карта тривог, погода, радіація, енергосистема (лише ті, що не вимкнено на пристрої).
  • Денна яскравість і Нічна яскравість.
  • Денна гучність звуку, Нічна гучність звуку та перемикач «Звук».
  • Нічний режим — перемикач вмк./вимк.
  • Перезавантажити — кнопка перезавантаження пристрою.
  • Дія jaam_ha.set_home_region («Встановити домашній регіон») — змінити домашній регіон з автоматизацій; потрібен числовий region_id.

Note

Розклад нічного режиму (початок і кінець) та інші налаштування меню з Home Assistant змінити не можна — лише на самому пристрої.

Зміна з Home Assistant і зміна дотиком на екрані нічим не відрізняються: значення зберігаються так само, а меню на екрані оновлюється, якщо відкрите.

Виявлення в мережі

Поки API увімкнено, пристрій оголошує себе через mDNS як сервіс _jaam-touch-ws._tcp (порт 81) під заданою назвою — Home Assistant знаходить його автоматично, зазвичай адресу вводити не потрібно.

Якщо HA не підключається

  • Перевірте, що на сторінці Мережа плитка HA API показує «Очікує HA» або «Підключено», а не «Вимкнено».
  • Пристрій і Home Assistant мають бути в одній мережі (або між мережами має бути доступ до порту 81).
  • Якщо автоматичне виявлення не спрацювало, додайте пристрій вручну за IP (розділ «Підключення» вище).