Когда я писал первое руководство по подключению сигнализации Ajax к Home Assistant, нужно было лавировать между SIA, Jeedom, MQTT, множеством топиков… Результат работал идеально, но нужно было любить «газовые заводы». Сегодня полная смена декораций: разработчики разработали родную интеграцию Ajax Home Assistant, устанавливаемую через HACS, которая напрямую общается с официальным Cloud API Ajax. Армирование, разармирование, уведомления, датчики, реле… все поступает в Home Assistant в (почти) реальном времени!
Установленная у меня дома уже несколько дней, я предлагаю вам подробнее познакомиться с этим долгожданным плагином…
Быстрое напоминание о старых методах
До сих пор, чтобы говорить об Ajax Home Assistant, были два подхода.
Первый использовал интеграцию SIA Alarm Systems Home Assistant. Сигнализация Ajax настраивалась так, будто Home Assistant был центром теленаблюдения. Мы получали состояние системы, некоторые сведения о пожаре / потопе, и на этом все. Нельзя было управлять сигнализацией, никаких деталей о каждом датчике. Это было, в основном, полезно для запуска нескольких сценариев на основе общего состояния сигнализации, например, перевести обогреватель в режим «эконом» при активации сигнализации при выходе из дома.
Второй метод, описанный в моем предыдущем руководстве, заключался в использовании плагина Ajax на Jeedom, а затем в повторной публикации всей информации в Home Assistant через MQTT. Гораздо более полный, с передачей почти всех датчиков Ajax, но с ценой второго домашнего сервера, брокера MQTT, сопоставления десятков топиков… В общем, очень мощно, но явно не для всех.
Новый плагин полностью меняет дело: Ajax Home Assistant становится парой, которую гораздо проще настроить.
Что позволяет новый плагин Ajax Home Assistant
Интеграция ajax-hass — это пользовательский компонент Home Assistant, который напрямую соединяется с Cloud Ajax через официальное API и поток gRPC, точно как мобильное приложение Ajax. Конкретно, ваш хаб Ajax становится «первоклассным гражданином» в Home Assistant с настоящей панелью сигнализации и сущностями для датчиков, сирен, реле, розеток и т. д.
Вы получаете, в частности, полный контроль над безопасностью. Панель сигнализации Home Assistant позволяет полностью армировать, разармировать, включать ночной режим, частичное армирование по группам и даже принудительное армирование, когда некоторые датчики остаются открытыми. Специальный сервис обрабатывает кнопку паники, которую можно разместить на панели приборов или на виртуальном пульте управления.
Что касается передачи информации, плагин выводит события армирования / разармирования с именем пользователя Ajax, уведомления тревоги, обнаружения движения, открытия дверей и окон, сигналы тревоги о пожаре или затоплении, а также «технические» датчики, такие как уровень заряда батареи, качество сигнала, температура или состояние соединения. Это очень комплексно.
Интеграция управляет несколькими хабами Ajax в одном Home Assistant, если необходимо, и интерфейс уже переведен на русский язык. Что касается оборудования, разработчик сначала тестирует Hub 2 Plus и MotionCam, но проектирование основано на официальном API Ajax, и сообщество уже подтвердило большое количество клавиатур, сирен, контактов открытия, датчиков пожара и т.д.
Таким образом, мы имеем настоящую пару Ajax Home Assistant, способную управлять и аккуратно отслеживать систему сигнализации, без обходных путей.
Подготовка к установке Ajax и Home Assistant
Перед тем как приступить, лучше проверить несколько предварительных условий.
Ваша система Ajax должна быть рабочей, с хабом, настроенным в официальном приложении, все датчики корректно добавлены и названы, и, если возможно, группы уже определены (первый этаж, второй этаж, гараж и т.д.). Чем чище настройка Ajax, тем приятнее будет работать с Home Assistant.
Что касается домашней автоматизации, нужен обновленный Home Assistant с уже установленным и работающим HACS, так как плагин Ajax Home Assistant распространяется как пользовательская интеграция. Также убедитесь, что ваша инстанция Home Assistant имеет выход в интернет к серверам Ajax, так как связь осуществляется через Cloud по HTTPS и gRPC.
Наконец, убедитесь, что ваша установка Home Assistant надежно защищена: надежный пароль, защищённый удалённый доступ (обратный прокси, аутентификация, сертификат TLS) и регулярные резервные копии. Интеграция своей системы сигнализации в свою домашнюю автоматизацию очень удобно, но это подразумевает необходимость быть более строгими в отношении общей безопасности инфраструктуры.
Установка интеграции Ajax через HACS
Переходим к делу. HACS уже установлен на вашем Home Assistant? Отлично, можно начинать установку плагина Ajax Home Assistant.
Первый шаг — объявить репозиторий GitHub плагина в HACS. В интерфейсе Home Assistant откройте HACS, затем раздел, посвященный интеграциям. В правом верхнем углу кнопка с тремя точками открывает расширенное меню. Выбрав пункт «Пользовательские репозитории», вы сможете добавить новый репозиторий.
В поле URL введите адрес репозитория https://github.com/foXaCe/ajax-hass, и выберите «Интеграция» как категорию. Подтвердите, а затем закройте окно. В следующий раз, когда вы будете искать интеграцию в HACS, «Ajax Security System» появится в списке.
Все еще в HACS, выполните поиск по «Ajax Security System», откройте соответствующий файл, затем установите его.
HACS скачает компонент ajax-hass и поместит его в папку custom_components/ajax вашей установки Home Assistant.
Как только установка завершится, необходимо перезагрузить Home Assistant, чтобы загрузить новую интеграцию.
Добавление интеграции Ajax Home Assistant в Home Assistant
После перезагрузки Home Assistant можно приступить к настройкам. Все делается из интерфейса, без обязательного использования YAML, что приятно!
Откройте меню «Настройки», затем «Устройства и услуги». В нижней части страницы используйте кнопку «Добавить интеграцию». В строке поиска введите «Ajax». Вы должны увидеть «Ajax Security System» с соответствующей иконкой. Выберите ее, чтобы запустить ассистент настройки.
Интеграция затем запросит ваши учетные данные Ajax, а именно адрес электронной почты и пароль, используемые в официальном приложении. Плагин не требует локального IP-адреса хаба, ни экзотических портов, все проходит через Cloud Ajax.
Затем идет очень удобная настройка: фильтр уведомлений. Вы можете выбрать, чтобы в Home Assistant не поступало никаких уведомлений, только тревоги о вторжении, события безопасности (армирование / разармирование, технические оповещения) или абсолютно все, включая события датчиков в реальном времени. Если вы планируете создать много автоматизаций Ajax Home Assistant, часто разумно начинать как минимум с событий безопасности и затем корректировать.
Подтвердите, подождите несколько секунд: интеграция связывается с Cloud Ajax и получает список ваших хабов. Здесь у меня, например, 3 разных системы Ajax: я могу добавить их все или выбрать только ту, которая меня интересует, как здесь «Дом».
Подтвердите. Система тогда получит группы и все устройства выбранных хабов, а затем создаст соответствующие сущности в Home Assistant. Затем их можно назначить комнате, если нужно:
Что мы находим в Home Assistant после интеграции
После установки Ajax Home Assistant небольшой обзор в «Устройства и услуги» позволяет увидеть результат. Каждый хаб Ajax появляется как устройство с основной панелью сигнализации и набором датчиков и исполнительных механизмов.
Панель сигнализации, представленная в виде сущности alarm_control_panel, позволяет арматизировать всю дом, переключаться в ночной режим, разармировать и использовать частичное армирование по группам, если вы настроили это в приложении Ajax. Эта сущность становится центральной точкой ваших сценариев безопасности.
Датчики движения представлены как обычные binary_sensor, которые переходят в состояние «включено» при обнаружении и возвращаются в состояние «выключено» по истечении времени простоя. Контактные датчики дверей и окон также отображаются в виде бинарных датчиков, что идеально подходит для запуска сценариев, таких как отключение обогрева, если окно остается открытым слишком долго.
Датчики дыма, угарного газа и затопления также становятся сущностями, доступными для использования.
Розетки и реле Ajax отображаются как выключатели или приводные механизмы, с возможностью управления ими из Home Assistant. Например, можно управлять реле Ajax, чтобы отключить питание устройства в случае инцидента.
Для самых взыскательных также появляется целый ряд «технических» датчиков: уровень заряда батареи, сила радиосигнала, температура, состояние связи и т. д. Это хорошая основа для создания панели инструментов «здоровье системы Ajax» в Home Assistant.
Примеры сценариев Ajax Home Assistant в работе
Как только все настроено в Home Assistant, начинается самое интересное: автоматизация. Сила этой интеграции Ajax Home Assistant как раз в реакции на события и возможности управлять сигнализацией.
Первый очень полезный сценарий — это автоматическое армирование сигнализации, когда все покидают дом. Используется информация о присутствии людей через мобильное приложение Home Assistant или другую систему присутствия, и запускается полное армирование, как только последний человек переходит в состояние «не дома».
Минимальный пример в YAML может выглядеть как-то так:
automation:
- alias: "Армировать Ajax, когда все уходят"
trigger:
- platform: state
entity_id: group.famille
to: "not_home"
action:
- service: alarm_control_panel.alarm_arm_away
target:
entity_id: alarm_control_panel.ajax_alarm_home
Можно представить обратное при возвращении: автоматическое разармирование, когда первый человек приходит, сопровождаемое мягким включением нескольких ламп и отключением некоторых сценариев имитации присутствия.
Еще один распространенный случай использования касается отопления. Датчики открытия Ajax, отправленные в Home Assistant, позволяют отключать электрическое отопление или кондиционер, как только окно открыто больше пяти минут, а затем восстанавливать систему, когда окно закрыто. Не нужно больше множить датчики Zigbee или Z-Wave для правильного управления открытием.
Датчики движения Ajax также могут участвовать в управлении освещением. Можно решить, что только ночью проход перед датчиком в коридоре включает ночник или светодиодную ленту у подножия кровати на небольшом уровне яркости на несколько минут. Сигнализация не срабатывает, но инфраструктура используется для удобства. Это одна из мелких радостей хорошо интегрированной домашней автоматизации.
Наконец, кнопка паники Ajax, отображаемая как сущность «button», может быть помещена на панель управления, предназначенную для взрослых, или даже скрыта за картой, защищенной паролем, и использована для запуска общего оповещения: сирены, внешний свет на 100%, уведомление на смартфон, даже автоматический звонок кому-то ближе через сторонний сервис. В таких сценариях лучше всего, конечно, протестировать в реальных условиях, но предупредив всех заранее…
Безопасность и лучшие практики с Ajax Home Assistant
Интеграция Ajax в Home Assistant через этот плагин означает, что Home Assistant становится еще одним звеном в цепочке безопасности. Разработчик внимательно отнесся к части конфиденциальности: идентификаторы хранятся в зашифрованной системе Home Assistant, пароль хешируется перед отправкой на серверы Ajax, связь проходит через TLS, и никакие данные не отправляются на сторонние сервисы. Интеграция является open source и поддается аудиту, что дает уверенность в системе безопасности.
Тем не менее, необходимо сохранять некоторые привычки. Exposed Home Assistant в любом виде в интернете становится входной дверью к вашей системе сигнализации. Поэтому крайне важно заблокировать внешний доступ, поддерживать актуальность как Home Assistant, так и интеграции Ajax, и избегать множества учетных записей администраторов. Принудительное армирование, в частности, должно использоваться экономно, так как оно позволяет армировать систему даже при открытых или неисправных датчиках.
Последний момент: этот плагин основан на Cloud Ajax. Если ваше интернет-соединение прерывается или серверы Ajax недоступны, хаб продолжит защищать дом, но связь в реальном времени с Home Assistant будет прервана.
На практике, почему стоит принять этот плагин Ajax Home Assistant
В заключение, мы переходим от «ремесленной» интеграции, зависящей от второго домашнего автоматика, к специально разработанному, поддерживаемому плагину Ajax Home Assistant, который глубоко управляет оборудованием. Установка осуществляется через HACS, настройка только через интерфейс, и вы получаете полный контроль над сигнализацией с практически мгновенной передачей событий.
В повседневной жизни это означает более умные сценарии, настоящую согласованность между безопасностью и комфортом и меньшее дублирование датчиков по всему дому. Для установщиков это также является весомым аргументом для представления клиентам, уже имеющим Ajax, которые мечтают о глобальном управлении своим домом с Home Assistant.
И самое приятное в этой истории, это то, что, наконец, «более полно» не рифмуется с «более сложно».
