Home Assistant
Входить до Macro DeckВмикайте світло, запускайте сцени й скрипти та показуйте живі стани з Home Assistant на своїй панелі.
Діалог «Підключення Home Assistant» з полями «Адреса» й «Довгостроковий токен доступу»
- Вмикайте, вимикайте або перемикайте сутності кнопками, які показують їхній стан
- Керуйте світлом, жалюзі, термостатами й медіапрогравачами
- Запускайте сцени, скрипти й автоматизації або викликайте будь-яку службу
- Живі змінні для будь-якого стану чи атрибута сутності
- Тригери на зміни стану й на події з шини подій
Інтеграція Home Assistant під’єднує Macro Deck до вашого Home Assistant через його WebSocket API. Macro Deck тримає одне з’єднання відкритим, тож стани надходять тієї ж миті, коли змінюються в Home Assistant, а дії виконуються одразу. Home Assistant може працювати будь-де, куди Macro Deck може під’єднатися: на тому самому комп’ютері, на Raspberry Pi чи сервері у вашій мережі або за віддаленою адресою.
Що можна робити
- Вмикати чи вимикати одну або кілька сутностей або перемикати їх. Кнопка з дією Перемкнути світиться, поки сутність увімкнена.
- Задавати стан, яскравість, колір, колірну температуру й перехід лампи за допомогою Налаштувати лампу.
- Відкривати, закривати, зупиняти жалюзі або задавати їхнє положення, встановлювати температуру, режим, режим вентилятора й пресет термостата та керувати відтворенням і гучністю медіапрогравача.
- Активувати сцену, запускати скрипт зі змінними та запускати, вмикати чи вимикати автоматизацію.
- Викликати будь-яку службу через Викликати службу, вказуючи ціллю сутності, пристрої або зони, а дані у форматі JSON.
- Зчитувати стан або атрибут сутності у змінну Macro Deck за допомогою Отримати стан сутності.
Кілька прикладів:
- Кнопка з дією Перемкнути для настільної лампи, яка показує, чи лампа ввімкнена.
- Кнопка Кіно, яка активує вашу сцену для фільмів і ставить музику на паузу на медіапрогравачі.
- Повзунок, прив’язаний до яскравості лампи: ви приглушуєте її з панелі й бачите зміни, зроблені в Home Assistant.
- Кнопка, підпис якої показує температуру з датчика, і потік за тригером Змінено стан сутності, який показує сповіщення, коли відчиняються вхідні двері.
Змінні й живі оновлення
Home Assistant пропонує значно більше значень, ніж Macro Deck показує одразу. Кожну сутність можна знайти в згорнутій групі Неприв’язані змінні серед змінних інтеграції, на сторінці Змінні і в кожному виборі змінних. Відкрийте сутність, щоб побачити її стан і атрибути, і виберіть Прив’язати для потрібного значення: воно стане звичайною змінною, що оновлюється наживо. Так повзунок може керувати яскравістю лампи, швидкістю вентилятора, положенням жалюзі, гучністю медіапрогравача або температурою термостата.
Коли з’єднання розривається, Macro Deck сам під’єднується знову, щоразу після невдалої спроби чекаючи трохи довше, але не більше хвилини. Тригери Під’єднано і Від’єднано спрацьовують, коли це відбувається, а дії завершуються повідомленням, поки Home Assistant не під’єднано. Можна під’єднати один Home Assistant.
Що потрібно
- Запущений Home Assistant, до якого Macro Deck може під’єднатися, наприклад
http://homeassistant.local:8123. - Обліковий запис користувача Home Assistant, щоб створити довгостроковий токен доступу.
- Для адреси
https://: сертифікат, якому довіряє ваш комп’ютер.
Як налаштувати
Крок 1: Створіть довгостроковий токен доступу
У Home Assistant відкрийте свій профіль і перейдіть на вкладку Security. Прокрутіть до Long-lived access tokens, створіть токен, назвіть його
Macro Deckі скопіюйте. Home Assistant показує його лише один раз.Крок 2: Відкрийте інтеграцію Home Assistant
У Macro Deck натисніть Інтеграції на бічній панелі, а потім Home Assistant. На вкладці Огляд натисніть Налаштувати в розділі Конфігурація. Перемикач угорі праворуч відкриває той самий діалог, а інтеграцію буде ввімкнено, щойно налаштування завершиться.
Крок 3: Введіть адресу й токен
У діалозі Підключення Home Assistant введіть:
- Адреса: адреса, за якою ви відкриваєте Home Assistant, разом із портом, наприклад
http://homeassistant.local:8123. - Довгостроковий токен доступу: токен, який ви щойно скопіювали.
Коли ви натиснете Продовжити, Macro Deck перевірить з’єднання й збереже його як Home Assistant з назвою вашого дому в дужках.
- Адреса: адреса, за якою ви відкриваєте Home Assistant, разом із портом, наприклад
Крок 4: Додайте дію на кнопку
На сторінці Панель клацніть кнопку. Панель має бути розблокована: якщо вгорі праворуч показано кнопку Заблокувати, так і є. Відкриється редактор, у якому вибрано Коротке натискання. Натисніть + Додати дію, ліворуч у діалозі Додати дію виберіть Home Assistant, потім Перемкнути і виберіть у полі Сутності одну або кілька сутностей, наприклад лампу.
Крок 5: Натисніть кнопку
Натисніть кнопку на своїй панелі. Світло перемкнеться в Home Assistant, а кнопка покаже, чи воно ввімкнене.
Крок 6: Прив’яжіть значення для показу на кнопці
Щоб показати значення, відкрийте вкладку Змінні на сторінці Home Assistant і розгорніть групу Неприв’язані змінні. Відкрийте сутність і натисніть Прив’язати для її стану або атрибута. Використайте нову змінну в підписі, наприклад
{{ vars.ha_sensor_living_room_temperature }}.
Дії12
Призначте їх кнопці або запускайте з потоку.
- Викликати службу
- Викликає будь-яку службу Home Assistant з необов’язковими сутностями, пристроями, зонами й даними у форматі JSON.
- Увімкнути
- Вмикає одну або кілька сутностей.
- Вимкнути
- Вимикає одну або кілька сутностей.
- Перемкнути
- Перемикає одну або кілька сутностей і показує на кнопці, чи вони ввімкнені.
- Налаштувати лампу
- Вмикає чи вимикає лампу й задає її яскравість, колір, колірну температуру та перехід.
- Керування жалюзі
- Відкриває, закриває або зупиняє жалюзі чи задає їхнє положення або кут нахилу.
- Керування медіапрогравачем
- Відтворює, ставить на паузу, зупиняє, перемикає, вимикає звук або задає гучність медіапрогравача.
- Встановити термостат
- Задає цільову температуру, режим, режим вентилятора й пресет термостата.
- Активувати сцену
- Активує сцену з необов’язковим переходом.
- Запустити скрипт
- Запускає скрипт, за бажанням зі змінними у вигляді об’єкта JSON.
- Керування автоматизацією
- Запускає, вмикає, вимикає або перемикає автоматизацію, за бажанням ігноруючи її умови.
- Отримати стан сутності
- Зчитує стан сутності або один з її атрибутів у змінну Macro Deck.
Тригери4
Кнопка або потік можуть реагувати на ці події.
- Під’єднано
- Macro Deck під’єднався до Home Assistant.
- Від’єднано
- З’єднання з Home Assistant втрачено.
- Змінено стан сутності
- Сутність змінила стан, за бажанням лише для домену, сутності або зміни з певного стану чи на певний стан.
- Подія Home Assistant
- Будь-що на шині подій Home Assistant, як-от автоматизації, скрипти, натискання кнопок ZHA і deCONZ або власні події, за бажанням лише один тип подій.
Змінні5
Показуйте ці значення на кнопках і віджетах або використовуйте їх в умовах.
homeassistant_is_connected- Чи під’єднано Macro Deck до Home Assistant.
homeassistant_version- Версія вашого Home Assistant.
homeassistant_location_name- Назва вашого дому.
homeassistant_entity_count- Скільки сутностей має ваш Home Assistant.
ha_<entity>,ha_<entity>_<attribute>- Стан або будь-який атрибут сутності, щойно ви прив’яжете його з групи Неприв’язані змінні. Назва пропонується на основі id сутності, наприклад
ha_light_office_lampабоha_light_office_lamp_brightness_pct. Багато з них можна й задавати, наприкладbrightness_pctлампи.
Поширені запитання
Чи має Home Assistant працювати на тому самому комп’ютері?
Ні. Macro Deck під’єднується через мережу, тож Home Assistant може працювати на Raspberry Pi, сервері або за віддаленою адресою, якщо Macro Deck може до нього під’єднатися.
Чи можна під’єднати кілька Home Assistant?
Ні. Інтеграція підтримує один Home Assistant. Повторне налаштування замінює з’єднання, а ваші кнопки продовжують працювати.
Під час налаштування з’являється повідомлення, що сертифікат не вдалося перевірити. Що робити?
Ваш комп’ютер не довіряє сертифікату вашої адреси https://. Довірте йому в сховищі сертифікатів операційної системи або під’єднуйтеся через http:// у локальній мережі.
Home Assistant за зворотним проксі не під’єднується. Чому?
Деякі проксі блокують запити, які вважають автоматизованим трафіком. Відкрийте Налаштування > Додатково > HTTP і введіть у поле HTTP User-Agent значення, яке приймає проксі.
Що відбувається, коли з’єднання розривається?
Macro Deck сам під’єднується знову й запускає тригери Від’єднано і Під’єднано. Коли він деякий час не може під’єднатися до Home Assistant, інтеграція показує Home Assistant недоступний і продовжує спроби у фоновому режимі.
Де зберігається мій токен доступу?
Токен зберігається в зашифрованому вигляді на вашому комп’ютері й залишає його лише для зв’язку з вашим Home Assistant. Коли Home Assistant його відхиляє, інтеграція показує проблему: створіть новий токен і виконайте налаштування знову.
Більше в категорії «Розумний дім і веб»
AdGuard Home
Входить до Macro DeckВмикайте, вимикайте або призупиняйте захист AdGuard Home і показуйте його статистику на своїй панелі.
RSS-стрічки
Входить до Macro DeckСтежте за стрічками RSS і Atom, показуйте їхні найновіші статті у віджетах і реагуйте на появу нових статей.
HTTP
Входить до Macro DeckНадсилайте HTTP-запити кнопкою й зберігайте значення з відповіді у змінні.
Погода
Входить до Macro DeckПоказуйте поточну погоду й прогноз для своїх місць на панелі без ключа API.