Додаємо сигналізацію Ring Alarm в Home Assistant

В одній з попередніх стате я робив огляд охоронної сигналізації Ring Alarm Security Kit, це чудовий девайс, який може зберегти вашу оселю від крадіжки. До Ring Alarm є можливість додавати різноманітні сенсори і пристрої, як то датчики руху, відкриття дверей\вікон, сенсори диму та вогню, протікання чи замерзання води, камери, розумні замки і навіть фірмові освітлювальні прилади.

Девайсами екосистеми Ring можна легко керувати за допомогою голосового асистенту Alexa. Як окремий набір Ring Alarm Security Kit дуже добрий вибір, але, якщо ви не хочете обмежувати себе пристроями одного виробника, подумайте про інтеграцію Ring до альтернативних систем керування розумним будинком.
Сьогодні я розкажу як інтегрувати девайси Ring до системи управління розумним будинком Home Assistant, на прикладі Ring Alarm Security Kit, 5-Piece другого покоління

Підготовка до інтеграції Ring Alarm в Home Assistant

Перед початком переконайтесь, що ви вже маєте аккаунт на ring.com, ви повинні знати свій логін та пароль. Можливо ви створили аккаунт при підключенні першого пристрою Ring.

В Home Assistant у вас повинен бути встановлений та налаштований плагін «Mosquitto broker». Зверніть увагу, цей плагін не потребує додаткового встановлення «Zigbee2mqtt», (якщо, звичайно, у вас немає zigbee девайсів).
Отже, будемо вважати, що ці два пункти виконано, тому перейдемо до інтеграції та її налаштування.

Інсталяція та налаштування інтеграції

Інсталюємо плагін, що має назву «Ring Devices», на момент написання статті він мав версію 4.5.5. Для того, щоб встановити цей плагін необхідно до супервайзера додати кастомний репозиторій, для цього перейдіть до вкладки «Add-on Store» і натисніть на три крапки праворуч вгорі. Оберіть пункт «Repositories»

У вікні що з’явилось додайте посилання https://github.com/tsightler/ring-mqtt-ha-addon

Тепер в списку додатків має з’явитися пункт з назвою «Ring Devices via MQTT Add-on»

Клікніть по піктограмі щойно інстальованого додатку та перейдіть до нього. Але, перш ніж натиснути «Start», увімкніть перемикач «Start on boot» потім перейдіть до налаштувань

Якщо необхідно, змініть налаштування на ті, що влаштують саме вас. На скріншоті один з варіантів, але при першому старті цього плагіна змінювати їх не обов’язково, хіба якщо необхідно вручну вказати адресу mqtt сервера

Тепер натискайте «Старт» на першій вкладці плагіна і, після його запуску перейдіть до інтерфейсу додатка натиснувши кнопку «Open web UI». У вікні плагіна введіть ваші облікові дані ring.com. Якщо раніше було увімкнено двофакторну аутентифікацію, необхідно також буде ввести код з смс-повідомлення. На наступному кроці додаток запропонує зберегти отриманий токен. Зробіть це і перезавантажте плагін.

Ще раз відкрийте веб інтерфейс плагіну та переконайтесь що він працює (It appears that this addon is already connected to Ring). Натиснувши на блакитну кнопку можемо згенерувати новий токен.

Використання сенсорів Ring в автоматизаціях Home Assistant

Аби мати можливість використовувати нові для Home Assistant сенсори, необхідно знати їх ID

Перейдіть в інтеграції та в «Mosquitto broker» оберіть посилання «пристрої»

Тепер виберіть необхідний девайс і, при необхідності змініть Entity ID на більш зрозумілий. Я, аби не заплутатись, додав в кінці «_ring». Сутність сенсора зараз має Entity ID: binary_sensor.hallway_motion_detector_ring . Тепер можемо використовувати необхідні сенсори і їх сутності в Home Assistant де це зручно та необхідно

Для прикладу покажу частину автоматизації з використанням вище вказаного сенсора:

- alias: hallwaylight_on_night
  initial_state: true
  trigger:
  - platform: state
    entity_id: binary_sensor.hallway_motion_detector_ring
    to: 'on'
  condition:
    - condition: state
      entity_id: light.hallway_lamp
      state: 'off'
    - condition: state
      entity_id: sensor.home_mode
      state: 'nightmode'
  action:
    - service: mqtt.publish
      data_template:
        topic: zigbee2mqtt/0x00178801030318a1/set
        payload: '{"state": "ON","transition": 1,"brightness": 254,"color_temp": 270,"hue_power_on_behavior": "recover"}'
        retain: true
    - service: timer.start
      entity_id: timer.hallwaylamps_5m

На сьогодні все. Побачимось.