HA Alice: различия между версиями

Материал из Wiren Board
(не показано 38 промежуточных версий 2 участников)
Строка 1: Строка 1:
{{Draft}}
{{DISPLAYTITLE: Интеграция Алисы в Wiren Board с помощью Home Assistant}}
{{DISPLAYTITLE: Интеграция Алисы в Wiren Board с помощью Home Assistant}}
[[Файл:HA_Ya.png|300px|thumb|Интеграция Алисы через Home Assistant]]
[[Файл:HA_YandexSmartHome_setup2.png|250px|thumb|Интеграция Алисы через Home Assistant]]
== Введение ==
== Введение ==
В этой статье рассмотрим интеграцию контроллера Wiren Board в приложение [[Yandex-smart-home |Дом с Алисой]] от Яндекс с использованием бесплатного [https://www.home-assistant.io/ Home Assistant (HA)].
Существует несколько способов интеграции устройств под управлением контроллера Wiren Board в приложение «Умный дом»‎ от Yandex(c). Один из них — [[Node-RED_Alice | использование NodeRed]]. Но автор сделал эту интеграцию платной, поэтому она подходит не всем.


Перед тем как начать, прочитайте статью и убедитесь что понимаете смысл выполняемых действий.
В этой статье рассмотрим альтернативный способ с использованием бесплатного [https://www.home-assistant.io/ Home assistant (HA)].
 
Перед тем как начать прочитайте статью и убедитесь что понимаете смысл выполняемых действий.


== Установка Home Assistant ==
== Установка Home Assistant ==
Home Assistant можно [[Home_Assistant#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0 |установить на контроллер Wiren Board ]] и на другое устройство, например, виртуальную машину.
Home Assistant можно установить как [https://wirenboard.com/wiki/Home_Assistant#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0 на контроллер Wiren Board] так и на другое устройство, например, виртуальную машину.


Мы будем рассматривать интеграцию по сети, так что единственным требованием при установке на другой хост, является доступность брокера контроллера из HA.
Мы будем рассматривать интеграцию по сети, так что единственным требованием при установке на другой хост, является доступность брокера контроллера из HA.


Интеграцию будем делать по описанию из документации [https://docs.yaha-cloud.ru/v0.6.x/ Yandex Smart Home].
В документации Яндекс есть описание интеграции [https://docs.yaha-cloud.ru/v0.6.x/ Yandex Smart Home]. Делаем по этому описанию.


== Установка HACS ==
== Установка HACS ==
Описание процесса установки взято с сайта [https://hacs.xyz/docs/configuration/basic/ HACS].
Если результат любого из действий отличается от ожидаемого - следует читать документацию.
 
[https://hacs.xyz/docs/setup/download/ Документация HACS]
Если результат любого из действий отличается от ожидаемого следует читать [https://hacs.xyz/docs/setup/download/ документацию].
В консоли хоста, на котором установлен контейнером HA выполняем:
 
<syntaxhighlight lang="bash">
 
Предполагаем что HA запущен [[Home_Assistant |по инструкции]], если имя контейнера отличается — используйте свое. Для установки HACS:
#В консоли хоста, на котором установлен контейнером HA, выполняем:
#:<syntaxhighlight lang="bash">
docker exec -it homeassistant bash
docker exec -it homeassistant bash
</syntaxhighlight>
</syntaxhighlight>
#И в консоли контейнера выполняем:
И в консоли контейнера уже:
#:<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
wget -O - https://get.hacs.xyz | bash - ; exit
wget -O - https://get.hacs.xyz | bash - ; exit
</syntaxhighlight>
</syntaxhighlight>
#Как рекомендует скрипт перезапускаем контейнер:
Выглядит результат так:
#:<syntaxhighlight lang="bash">
[[Файл:HA_HACS_setup1.png|200px|thumb|center|Результат распаковки HACS]]
Как и рекомендует скрипт - перезапускаем контейнер.
<syntaxhighlight lang="bash">
docker restart homeassistant
docker restart homeassistant
</syntaxhighlight>
</syntaxhighlight>
#В web-интерфейсе HA переходим '''Настройка — Устройства и службы''' и нажимаем '''Добавить интеграцию'''.
#В поле ввода начинаем набирать ''HACS'' и подтверждаем что знаний достаточно.
#Далее переходим по предложенной ссылке и вводим github код.


<gallery mode="packed" heights="150px" caption="">
[https://hacs.xyz/docs/configuration/basic/ источник описания]
Image: HA_HACS_setup1.png|Результат распаковки HACS
В web-интерфейсе HA переходим Настройка -> Устройства и службы
Image: HA_HACS_setup3.png|Поиск HACS
[[Файл:HA_HACS_setup2.png|200px|thumb|center|Выбор "Интеграции и службы"]]
Image: HA_HACS_setup4.png|Соглашение с условиями
и нажимаем "Добавить интеграцию"
</gallery>
В поле ввода начинаем набирать "HACS"
<gallery mode="packed" heights="150px" caption="">
[[Файл:HA_HACS_setup3.png|200px|thumb|center|Поиск HACS]]
Image: HA_HACS_setup5.png|Ссылка на GitHub
Подтверждаем что знаний достаточно
Image: HA_HACS_setup6.png|Ввод кода
[[Файл:HA_HACS_setup4.png|200px|thumb|center|Соглашение с условиями]]
Image: HA_HACS_setup7.png|Успех
и видим ссылку, по которой надо перейти и ввести на github код.
</gallery>
[[Файл:HA_HACS_setup5.png|200px|thumb|center|Ссылка]]
Переходим, вводим
[[Файл:HA_HACS_setup6.png|200px|thumb|center|ввод кода]]
Если все сделано верно:
[[Файл:HA_HACS_setup7.png|200px|thumb|center|успех]]
 


== Установка Yandex Smart Home ==
== Установка Yandex Smart Home ==
Более подробно процесс установки описан в [https://docs.yaha-cloud.ru/v0.6.x/install/component/ Документации от Яндекс].
[https://docs.yaha-cloud.ru/v0.6.x/install/component/ Документация от Яндекс]
#В веб-интерфейсе HA заходим в HACS и в строке поиска вводим '''Yandex'''.
В веб-интерфейсе HA заходим в HACS и в строке поиска вводим "Yandex":
#Выбираем '''Yandex Smart Home'''.
[[Файл:HA_YandexSmartHone_setup1.png|200px|thumb|center|Поиск интеграции]]
#Нажимаем '''Скачать'''.  
Выбираем "Yandex Smart Home"
#После удачного скачивание видно напоминание о необходимости перезапуска. Подтверждаем его.
[[Файл:HA_YandexSmartHome_setup2.png|200px|thumb|center|описание]]
<gallery mode="packed" heights="100px" caption="Установка Yandex Smart Home">
и нажимаем "Скачать".  
Image: HA_YandexSmartHone_setup1.png|
После удачного скачивание видно напоминание о необходимости перезапуска.
Image: HA_YandexSmartHome_setup2.png|
Подтверждаем его.
Image: HA_HACS_setup7.png|
<gallery mode="packed" heights="200px" caption="уведомление о необходимости перезапуска и сам перезапуск">
</gallery>
Image: HA_YandexSmartHome_setup3.png | памятка
<gallery mode="packed" heights="100px" caption="">
Image: HA_YandexSmartHome_setup4.png | уведомление
Image: HA_YandexSmartHome_setup3.png |  
Image: HA_YandexSmartHome_setup5.png | перезапуск
Image: HA_YandexSmartHome_setup4.png |
Image: HA_YandexSmartHome_setup5.png |  
</gallery>
</gallery>


== Настройка интеграции ==
== Настройка интеграции ==
Теперь добавим объекты для передачи их в УДЯ. Только «переданные»‎ объекты могут как отправлять данные в УД и управляться оттуда. Используем [[Home_Assistant#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D1%81%D0%B2%D1%8F%D0%B7%D0%B8_%D1%81_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0%D0%BC%D0%B8 |созданные в Home Assistant]] устройства.
Теперь добавим объекты для передачи их в УД Яндекса.
 
Только "переданные" объекты могут как передавать данные в УД, так и управляться оттуда.
#В веб-интерфейсе HA: '''Настройки Устройства и службы Добавить интеграцию'''. В строке поиска вводим ''Yandex Smart Home''.
Используем созданные в [[Home_Assistant#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D1%81%D0%B2%D1%8F%D0%B7%D0%B8_%D1%81_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0%D0%BC%D0%B8]] устройства.
#'''Тип подключения''' надо оставить '''Через облако'''.
В веб-интерфейсе HA: Настройки -> Устройства и службы -> Добавить интеграцию. В строке поиска вводим "Yandex Smart Home"
#Получаем реквизиты для привязки в аккаунт Яндекс:
<gallery mode="packed" heights="200px" caption="настройка интеграции">
#:'''Важно!''' Через [https://yandex.ru/quasar Квазар] часто не удается связать, возможно связано с тем что этот веб-интерфейс (официально) не поддерживается.
Image: HA_YandexSmartHome_deviceAdd1.png | выбор интеграции в поиске
#В интерфейсе приложения «Умный дом» после добавления интеграции выбранные для передачи устройства выглядят так:
Image: HA_YandexSmartHome_deviceAdd2.png | выбор устройств
#Нужно изменить их имена на русские. Для примера, «Выход 1» и «Выход 2».
Image: HA_YandexSmartHome_deviceAdd3.png | добавление следующего устройства
#В дальнейшем, при добавлении или редактировании устройств в HA - надо нажимать '''Обновить список устройств''' в приложении «Умный дом» или веб-интерфейсе [https://yandex.ru/quasar Квазар]
Image: HA_YandexSmartHome_deviceAdd4.png | добавление следующего устройства
</gallery>
"Тип подключения" надо оставить "Через облако"
Получаем реквизиты для привязки в аккаунт Яндекс:
[[Файл:HA_YandexSmartHome_deviceAdd5.png|200px|thumb|center|реквизиты]]
Важно! Через [https://yandex.ru/quasar Квазар] часто не удается связать, возможно связано с тем что этот веб-интерфейс (официально) не поддерживается.
В интерфейсе приложения "Умный Дом" после добавления интеграции выбранные для передачи устройства выглядят так:
[[Файл:HA_YandexSmartHome_AliceConfig1.jpeg|200px|thumb|center|реквизиты]]
Нужно изменить их имена на русские. Для примера, "Выход 1" и "Выход 2"
[[Файл:HA_YandexSmartHome_AliceConfig2.jpeg|200px|thumb|center|выключатели]]


<gallery mode="packed" heights="150px" caption="">
В дальнейшем, при добавлении или редактировании устройств в HA - надо нажимать "Обновить список устройств" в приложении "Умный дом" или веб-интерфейсе [https://yandex.ru/quasar Квазар]
Image: HA_YandexSmartHome_deviceAdd1.png |
Image: HA_YandexSmartHome_deviceAdd2.png |
Image: HA_YandexSmartHome_deviceAdd3.png |
Image: HA_YandexSmartHome_deviceAdd4.png |
</gallery>
<gallery mode="packed" heights="150px" caption="">
Image: HA_YandexSmartHome_deviceAdd5.png |
Image: HA_YandexSmartHome_AliceConfig1.jpeg |
Image: HA_YandexSmartHome_AliceConfig2.jpeg |
</gallery>


== Проверка ==
== Проверка ==
В приложении «Умный дом» или в веб-интерфейсе [https://yandex.ru/quasar Квазар] можно переключить выключатель и убедиться что соответствующий контрол в контроллере Wiren Board изменил состояние.
В приложении "Умный дом" или в веб-интерфейсе [https://yandex.ru/quasar Квазар] можно переключить выключатель - и убедиться что соответствующий контрол контроллера изменил состояние.
 
Также сразу будут доступны и голосовые команды "Алиса, включи выход два" например.
Также сразу будут доступны голосовые команды, например, «Алиса, включи выход два».
 
== Полезные ссылки ==
*[https://wirenboard.com/wiki/Home_Assistant#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0 Инструкция по установке Home Assistant на контроллер Wiren Board]
*[https://docs.yaha-cloud.ru/v0.6.x/ Документация Yandex Smart Home]
*[https://hacs.xyz/docs/configuration/basic/ Инструкция по установке HACS]
*[https://hacs.xyz/docs/setup/download/ Скачивание HACS]
*[[Node-RED_Alice |Настройка Алисы на контроллере Wiren Board]]
 
{{Wbincludes:Device Page Footer}}

Версия 16:36, 20 февраля 2024

Это черновик страницы. Последняя правка сделана 20.02.2024 пользователем Matveevrj.

Интеграция Алисы через Home Assistant

Введение

Существует несколько способов интеграции устройств под управлением контроллера Wiren Board в приложение «Умный дом»‎ от Yandex(c). Один из них — использование NodeRed. Но автор сделал эту интеграцию платной, поэтому она подходит не всем.

В этой статье рассмотрим альтернативный способ с использованием бесплатного Home assistant (HA).

Перед тем как начать прочитайте статью и убедитесь что понимаете смысл выполняемых действий.

Установка Home Assistant

Home Assistant можно установить как на контроллер Wiren Board так и на другое устройство, например, виртуальную машину.

Мы будем рассматривать интеграцию по сети, так что единственным требованием при установке на другой хост, является доступность брокера контроллера из HA.

В документации Яндекс есть описание интеграции Yandex Smart Home. Делаем по этому описанию.

Установка HACS

Если результат любого из действий отличается от ожидаемого - следует читать документацию. Документация HACS В консоли хоста, на котором установлен контейнером HA выполняем:

docker exec -it homeassistant bash

И в консоли контейнера уже:

wget -O - https://get.hacs.xyz | bash - ; exit

Выглядит результат так:

Результат распаковки HACS

Как и рекомендует скрипт - перезапускаем контейнер.

docker restart homeassistant

источник описания В web-интерфейсе HA переходим Настройка -> Устройства и службы

Выбор "Интеграции и службы"

и нажимаем "Добавить интеграцию" В поле ввода начинаем набирать "HACS"

Поиск HACS

Подтверждаем что знаний достаточно

Соглашение с условиями

и видим ссылку, по которой надо перейти и ввести на github код.

Ссылка

Переходим, вводим

ввод кода

Если все сделано верно:

успех


Установка Yandex Smart Home

Документация от Яндекс В веб-интерфейсе HA заходим в HACS и в строке поиска вводим "Yandex":

Поиск интеграции

Выбираем "Yandex Smart Home"

описание

и нажимаем "Скачать". После удачного скачивание видно напоминание о необходимости перезапуска. Подтверждаем его.

Настройка интеграции

Теперь добавим объекты для передачи их в УД Яндекса. Только "переданные" объекты могут как передавать данные в УД, так и управляться оттуда. Используем созданные в Home_Assistant#Настройка_связи_с_устройствами устройства. В веб-интерфейсе HA: Настройки -> Устройства и службы -> Добавить интеграцию. В строке поиска вводим "Yandex Smart Home"

"Тип подключения" надо оставить "Через облако" Получаем реквизиты для привязки в аккаунт Яндекс:

реквизиты

Важно! Через Квазар часто не удается связать, возможно связано с тем что этот веб-интерфейс (официально) не поддерживается. В интерфейсе приложения "Умный Дом" после добавления интеграции выбранные для передачи устройства выглядят так:

реквизиты

Нужно изменить их имена на русские. Для примера, "Выход 1" и "Выход 2"

выключатели

В дальнейшем, при добавлении или редактировании устройств в HA - надо нажимать "Обновить список устройств" в приложении "Умный дом" или веб-интерфейсе Квазар

Проверка

В приложении "Умный дом" или в веб-интерфейсе Квазар можно переключить выключатель - и убедиться что соответствующий контрол контроллера изменил состояние. Также сразу будут доступны и голосовые команды "Алиса, включи выход два" например.