Home Assistant
Входит в Macro DeckВключайте свет, запускайте сцены и скрипты и показывайте на панели живые состояния из Home Assistant.
Диалог «Подключение Home Assistant» с полями «Адрес» и «Долгоживущий токен доступа»
- Включение, выключение и переключение объектов кнопками, которые показывают их состояние
- Управление светом, шторами, термостатами и медиаплеерами
- Запуск сцен, скриптов и автоматизаций или вызов любой службы
- Живые переменные для любого состояния или атрибута объекта
- Триггеры на изменение состояния и на события из шины событий
Интеграция Home Assistant подключает Macro Deck к вашему Home Assistant через его API WebSocket. 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 откройте свой профиль и перейдите на вкладку Безопасность. Прокрутите до раздела Долгосрочные токены доступа, создайте токен, назовите его
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.