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

Home Assistant

Інтеграція Home Assistant дозволяє “подружити” JAAM Fusion із вашим розумним домом: бачити стан пристрою в HA та запускати автоматизації (сповіщення, керування режимами, лампою тощо).

Репозиторій інтеграції: https://github.com/J-A-A-M/jaam_ha

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

Після підключення інтеграції в HA ви зможете:

  • бачити стан тривоги у домашньому регіоні та реагувати на зміни
  • бачити температуру домашнього регіону (коли доступні погодні дані)
  • бачити показники мікроклімату (температура/вологість/тиск), якщо підключено кліматичний сенсор
  • бачити рівень освітленості, якщо підключено BH1750
  • бачити статус пристрою (онлайн/звʼязок з сервером даних, сигнал Wi‑Fi тощо)
  • бачити інформацію про версію прошивки та наявність оновлення

А також (за потреби) керувати:

  • режимом мапи
  • режимом дисплею
  • домашнім регіоном
  • режимом “Лампа” (колір і яскравість)
  • примусовим нічним режимом
  • увімкненням/вимкненням мапи та дисплею

Note

Якщо якийсь сенсор не підключено, відповідні дані в HA не зʼявляться.

Як увімкнути інтеграцію

1) Увімкніть API в JAAM Fusion

  1. Відкрийте веб‑інтерфейс пристрою.
  2. Перейдіть: Мережа → Home Assistant.
  3. Увімкніть "Увімкнути API (WebSocket)".
  4. Задайте "Порт API (WebSocket)" (зазвичай 81).

Warning

Порт 80 зайнятий веб‑інтерфейсом. Для інтеграції використовуйте інший порт.

2) Додайте інтеграцію в Home Assistant

Встановіть інтеграцію jaam_ha за інструкцією в репозиторії.

3) Підключіть пристрій в інтеграції HA

Є два способи:

Варіант A — автодіскавері (якщо спрацював)

У багатьох мережах Home Assistant може сам знайти пристрій після того, як ви увімкнули API на JAAM Fusion.

Що робити:

  1. Відкрийте Налаштування → Пристрої та служби → Інтеграції.
  2. Перевірте блок "Виявлені" / "Discovered" (або сповіщення про новий пристрій).
  3. Натисніть "Додати" і завершіть майстер підключення.

Note

Якщо HA і JAAM Fusion знаходяться в різних VLAN/підмережах, автодіскавері може не спрацювати — тоді використайте ручне додавання.

Варіант B — ручне додавання (IP + порт)

Якщо пристрій не зʼявився автоматично, його можна додати вручну.

Зазвичай потрібно вказати:

  • IP‑адресу (або hostname) пристрою в локальній мережі
  • порт API (той самий, який ви задали в Мережа → Home Assistant)

Приклади корисних автоматизацій (ідеї)

Нижче — кілька прикладів “що можна зробити” в HA на базі даних/керування, які надає прошивка.

1) Сповіщення про тривогу у домашньому регіоні

  • Коли у домашньому регіоні починається тривога — надіслати push‑повідомлення на телефон.
  • Коли відбій — надіслати окреме повідомлення.

2) Нічний сценарій

  • Після 23:00 увімкнути примусовий нічний режим.
  • Вранці вимкнути примусовий нічний режим.

3) “Розумна лампа” для кімнати

  • Увечері автоматично ввімкнути режим лампи мʼяким кольором.
  • Удень зробити лампу яскравішою або змінити колір під настрій.

4) Реакція на освітленість (якщо є BH1750)

  • Якщо в кімнаті темно — увімкнути лампу.
  • Якщо світло — вимкнути лампу або зменшити її яскравість.

5) Контроль мікроклімату (якщо є кліматичний сенсор)

  • Якщо вологість висока — увімкнути вентиляцію/осушувач.
  • Якщо температура виходить за межі — увімкнути кондиціонер/обігрів.

Важливі примітки

Безпека

API призначений для використання в локальній довіреній мережі. Не рекомендується відкривати порт інтеграції в інтернет.

Troubleshooting

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

Перевірте:

  • у пристрої увімкнено API: Мережа → Home Assistant → Увімкнути API (WebSocket)
  • ви вказали правильний порт API
  • HA і пристрій у тій самій мережі (або між мережами є доступ)

У HA не видно значень мікроклімату/освітленості

  • мікроклімат зʼявиться лише якщо підключено кліматичний сенсор
  • освітленість зʼявиться лише якщо підключено BH1750

Дивіться також