Как подключить свой умный дом на базе Home Assistant к Марусе и управлять им голосом02.12.2022 16:32

Home Assistant — платформа которая помогает подключать самые разные устройства умного дома, включая малоизвестные и самодельные, а также управлять ими, следить за статусами на удобном дашборде и создавать сложные сценарии. Например, чтобы обеспечить безопасность дома, автоматизировать рутины, развлечь детей и гостей.

Всё это становится в разы удобнее, если добавить голосовое управление — например, с помощью Маруси от VK. В этой статье мы по шагам расскажем, как настроить Home Assistant и «подружить» его с Марусей.

По аналогии с инструкцией в этой статье Марусю можно подключить и к другим «кастомным» системам умного дома, используя протоколы Яндекса, Google и Tuya.

Примечание

0. Настройка Home Assistant

Если у вас уже настроен Home Assistant, пропустите этот раздел. А если нет, следуйте пошаговой инструкции.

Инструкция

1. Настройка доступа к Home Assistant из внешнего мира

Это нужно, чтобы в дальнейшем вы могли удалённо подключаться к Home Assistant с устройств не в локальной сети, а также чтобы к нему получила доступ Маруся.

1. Установить в Home Assistant аддон SSH & Web Terminal: Settings → Add-ons → Add-on Store → Home Assistant Community Add-on → SSH & Web Terminal

2. Открыть настройки аддона и включить параметр Show in sidebar

3. Снова зайти в Add-on Store, выбрать Repositories и добавить адрес репозитория: https://github.com/ThomDietrich/home-assistant-addons

4. Установить аддон SSH Tunnel & Forwarding из Add-on Store. Зайти в настройки аддона, на вкладке Log найти такой фрагмент и скопировать из него ключ:

[13:19:53] INFO: The public key is:
ssh-ed25519 XXXXXXXXXXXXXXXXXXXX hassio-setup-via-autossh
[13:19:53] WARNING: Add this key to '~/.ssh/authorized_keys' on your remote server now!
[13:19:53] WARNING: Please restart add-on when done. Exiting…

5. Подключиться к удалённой виртуальной машине с внешним IP-адресом (внешний хост, VPS) по SSH: ввести адрес, логин и пароль, выданные хостом. Найти или создать файл .ssh/authorized_keys и добавить в него ключ, скопированный на прошлом шаге.

6. В конфигурации аддона SSH Tunnel & Forwarding ввести адрес и имя пользователя удалённой машины, к которой только что привязали ключ. Сохраниться и перезапустить аддон.

7. В зависимости от операционной системы, используя менеджер пакетов, установить на удалённой машине nginx. Добавить в конфигурацию такую секцию:

map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen 80;
server_name ha.yourhost.ru;

root /data/www/ha;

location / {
try_files $uri $uri/index.html $uri.html @backend;
}

location @backend {
proxy_pass http://127.0.0.1:8123;

proxy_set_header Host $host;
# proxy_set_header X-Forwarded-For $remote_addr;

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
}

Вместо ha.yourhost.ru здесь и далее вписывать адрес своего домена, если он есть;, а если нет, то IP-адрес удалённой машины.

8. Проверить доступность http://ha.yourhost.ru на компьютере в локальной сети. Если там отображается интерфейс Home Assistant, значит, всё настроено правильно.

2. Настройка Yandex-плагина для Home Assistant

Пока мы используем наработки IoT-энтузиастов для интеграции Home Assistant с умным домом от Яндекса, чтобы аналогичным образом подключить Home Assistant к Марусе.

1. Открыть терминал в Home Assistant, запустить скрипт установки HACS: wget -O — https://get.hacs.xyz | bash -

Дождаться его установки и перезапустить Home Assistant.

2. Открыть HACS → Integrations, нажать кнопку Explore & Download Repositories, найти и выбрать Yandex Smart Home, установить.

3. Зайти в Settings → Devices & Services, нажать кнопку Add Integration, найти и выбрать Yandex Smart Home. 

4. Открыть настройки интеграции, выбрать доступные устройства и тип подключения — «напрямую».

5. Проверить доступность внешнего адреса: http://ha.yourhost.ru/api/yandex_smart_home/v1.0/ping

Если всё ок, по ссылке должен отразиться список доступных устройств.

3. Подключение своего умного дома к Марусе/

Подключение Home Assistant к Марусе

Для этого вам нужно будет завести свой умный дом на базе Home Assistant на платформе VK для внешних разработчиков. Тогда он появится в приложении Маруси.

1. Зайти на платформу, авторизоваться с VK ID, создать проект и приложение.

2. В настройках приложения указать такие параметры:

3. Через минуту открыть приложение Маруси, зайти в раздел «Умный дом», найти свой проект среди провайдеров и авторизоваться с логином и паролем, установленными при настройке Home Assistant. После этого ваши устройства и сценарии добавятся к Марусе, и вы сможете управлять ими голосом.

4. Результат

Смотрите, как может работать ваш умный дом на базе Home Assistant с Марусей:

Если в процессе настройки что-то пойдёт не так, напишите в комментарии — мы постараемся ответить на вопросы и помочь. Удачных интеграций!

© Habrahabr.ru