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

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

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

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

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

Инструкция

Вам понадобятся:

• Одноплатный компьютер Raspberry Pi 4 или 3

• Блок питания 5V / 2A

• Micro SD Card (флешка) не хуже Class 2, рекомендуемый объём — от 32 Гб

• SD Card Reader

• Ethernet-кабель

Установка Home Assistant на Raspberry Pi

1. Вставить флешку в компьютер.

2. Скачать и установить приложение для записи образов — например, Balena Etcher.

3. В приложении выбрать Flash from URL.

4. Вставить ссылку на нужный образ:

● Raspberry 4 (64 Bit): https://github.com/home-assistant/operating-system/releases/download/9.3/haos_rpi4-64-9.3.img.xz

● Raspberry 4 (32 Bit): https://github.com/home-assistant/operating-system/releases/download/9.3/haos_rpi4-9.3.img.xz

● Raspberry 3 (64 Bit): https://github.com/home-assistant/operating-system/releases/download/9.3/haos_rpi3-64-9.3.img.xz

● Raspberry 3 (32 Bit): https://github.com/home-assistant/operating-system/releases/download/9.3/haos_rpi3-9.3.img.xz

5. После скачивания образа выбрать флешку для установки:

6. Нажать Flash, чтобы записать образ на флешку.

Запуск Home Assistant на Raspberry Pi

1. Вставить флешку в Raspberry Pi.

2. Соединить с роутером при помощи Ethernet-кабеля.

3. Включить в розетку и подождать пару минут.

4. Открыть в браузере на компьютере ссылку: http://homeassistant.local:8123

5. Подождать 5–15 минут, пока 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 и добавить в него ключ, скопированный на прошлом шаге.

• Как выбрать и за сколько купить VPS/VDS (цены актуальны на 2020 год)

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. В настройках приложения указать такие параметры:

• Адрес API — http://ha.yourhost.ru/api/yandex_smart_home/v1.0

• Адрес страницы авторизации — http://ha.yourhost.ru/auth/authorize

• Адрес для получения и обновления токена — http://ha.yourhost.ru/auth/token

• Авторизационные client_id — https://vc.go.mail.ru

• Авторизационный secret — любой пароль

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

4. Результат

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

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