diff --git a/README.md b/README.md index 4932656f..996ebe96 100644 --- a/README.md +++ b/README.md @@ -9,8 +9,7 @@ и управлять ими с любого устройства с Алисой: * Умные колонки (Яндекс Станция и другие) -* Мобильное приложение [Дом с Алисой](https://mobile.yandex.ru/apps/smarthome) -* Веб-интерфейс [Квазар](https://yandex.ru/quasar/iot) +* Мобильное приложение [Дом с Алисой](https://ya.cc/iot_app) Компонент работает на Home Assistant версии **2023.2** или новее. diff --git a/docs/advanced/direct-connection.md b/docs/advanced/direct-connection.md index 3b0807c7..7967d6b2 100644 --- a/docs/advanced/direct-connection.md +++ b/docs/advanced/direct-connection.md @@ -53,7 +53,7 @@ !!! warning "При публикации навыка в журнале Home Assistant возникает ошибка `Login attempt or request with invalid authentication`. Это **нормально** и не влияет на работу компонента." -* Откройте [квазар](https://yandex.ru/quasar/iot) или приложение [Дом с Алисой](https://mobile.yandex.ru/apps/smarthome) +* Приложение [Дом с Алисой](https://ya.cc/iot_app) * Нажмите иконку :fontawesome-solid-plus: в правом верхнем углу --> `Устройство умного дома` * Найдите в списке и выберите производителя (ищите по названию диалога, который создали ранее) * Нажмите кнопку `Привязать к Яндексу`, откроется страница авторизации Home Assistant. Рекомендуется создать отдельного пользователя diff --git a/docs/assets/images/quasar/discovery-1.png b/docs/assets/images/app/yandex/discovery-1.png similarity index 100% rename from docs/assets/images/quasar/discovery-1.png rename to docs/assets/images/app/yandex/discovery-1.png diff --git a/docs/assets/images/quasar/discovery-2.png b/docs/assets/images/app/yandex/discovery-2.png similarity index 100% rename from docs/assets/images/quasar/discovery-2.png rename to docs/assets/images/app/yandex/discovery-2.png diff --git a/docs/assets/images/quasar/discovery-3.png b/docs/assets/images/app/yandex/discovery-3.png similarity index 100% rename from docs/assets/images/quasar/discovery-3.png rename to docs/assets/images/app/yandex/discovery-3.png diff --git a/docs/assets/images/quasar/unlink-3.png b/docs/assets/images/app/yandex/unlink-3.png similarity index 100% rename from docs/assets/images/quasar/unlink-3.png rename to docs/assets/images/app/yandex/unlink-3.png diff --git a/docs/assets/images/quasar/unlink-4.png b/docs/assets/images/app/yandex/unlink-4.png similarity index 100% rename from docs/assets/images/quasar/unlink-4.png rename to docs/assets/images/app/yandex/unlink-4.png diff --git a/docs/assets/images/faq/entity-id-quasar.png b/docs/assets/images/faq/entity-id-yandex.png similarity index 100% rename from docs/assets/images/faq/entity-id-quasar.png rename to docs/assets/images/faq/entity-id-yandex.png diff --git a/docs/assets/images/quasar/unlink-1.png b/docs/assets/images/quasar/unlink-1.png deleted file mode 100644 index 4bf872f7..00000000 Binary files a/docs/assets/images/quasar/unlink-1.png and /dev/null differ diff --git a/docs/assets/images/quasar/unlink-2.png b/docs/assets/images/quasar/unlink-2.png deleted file mode 100644 index e2000b8e..00000000 Binary files a/docs/assets/images/quasar/unlink-2.png and /dev/null differ diff --git a/docs/config/connection-type.md b/docs/config/connection-type.md index da3e5028..5ace3d12 100644 --- a/docs/config/connection-type.md +++ b/docs/config/connection-type.md @@ -7,7 +7,7 @@ * [Добавьте](../install/integration.md) новую интеграцию с желаемым типом подключения * Привяжите новую интеграцию через приложение [Дом с Алисой](https://ya.cc/iot_app) * Устройства уникальны в рамках навыка (производителя), поэтому после привязки новой интеграции появятся "дубли" устройств: одно устройство на "старом" навыке, другое - на "новом" -* Проверьте, как управляются устройства на новом навыке и если проблем не выявлено, то старый навык можно [отвязать](../quasar.md#unlink) с удалением всех устройств +* Проверьте, как управляются устройства на новом навыке и если проблем не выявлено, то старый навык можно [отвязать](../platforms/yandex.md#unlink) с удалением всех устройств ## Какой тип подключения лучше? { id=compare } diff --git a/docs/config/entity.md b/docs/config/entity.md index 12d391eb..d6c5f6b7 100644 --- a/docs/config/entity.md +++ b/docs/config/entity.md @@ -32,7 +32,7 @@ Поддерживается как полное, так и краткое наименование: вместо `devices.types.dishwasher` можно использовать `dishwasher`, или вместо `devices.types.thermostat.ac` можно использовать `thermostat.ac`. !!! attention "Обратите внимание" - После изменения типа **обязательно** удалите устройство вручную в УДЯ и выполните [Обновление списка устройств](../quasar.md#discovery). + После изменения типа **обязательно** удалите устройство вручную в УДЯ и выполните [Обновление списка устройств](../platforms/yandex.md#discovery). !!! example "Пример" ```yaml diff --git a/docs/config/filter.md b/docs/config/filter.md index b0a83341..7528fa8d 100644 --- a/docs/config/filter.md +++ b/docs/config/filter.md @@ -4,7 +4,7 @@ !!! danger "Внимание!" Удаление устройств из УДЯ возможно **только** вручную. Удаляйте устройство из УДЯ только после исключения объекта из списка для передачи. - Для удаления всех устройств - [отвяжите навык (производителя)](../quasar.md#unlink). + Для удаления всех устройств - [отвяжите навык (производителя)](../platforms/yandex.md#unlink). !!! warning "Недопустимо оставлять в УДЯ устройства, у которых объект не выбран для передачи. Такие устройства будут работать некорректно." diff --git a/docs/faq.md b/docs/faq.md index 584b5a6d..350b7eea 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -18,12 +18,12 @@ ![](assets/images/faq/entity-id-3.png){ width=750 } ![](assets/images/faq/entity-id-4.png){ width=750 } -## Как узнать entity_id объекта из устройства в УДЯ { id=get-entity-id-quasar } +## Как узнать entity_id объекта из устройства в УДЯ { id=get-entity-id-yandex } -В приложении [Дом с Алисой](https://mobile.yandex.ru/apps/smarthome) или [квазаре](./quasar.md): +В приложении [Дом с Алисой](https://ya.cc/iot_app): Зайдите в устройство --> Нажмите :fontawesome-solid-gear: в правом верхнем углу --> `Об устройстве` --> `Модель устройства` -![](assets/images/faq/entity-id-quasar.png){ width=300 } +![](assets/images/faq/entity-id-yandex.png){ width=300 } ## Почему навык называется Yaha Cloud, а не Home Assistant? { id=yaha } diff --git a/docs/index.md b/docs/index.md index f070dd41..ffc3d0a6 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,11 +1,9 @@ # О компоненте Yandex Smart Home -Компонент позволяет добавить устройства из Home Assistant в платформу [умного дома Яндекса](https://yandex.ru/dev/dialogs/smart-home) (УДЯ) -и управлять ими с любого устройства с Алисой: +Компонент позволяет добавить устройства из Home Assistant в платформу [умного дома Яндекса](https://yandex.ru/dev/dialogs/smart-home) (УДЯ) и управлять ими с любого устройства с Алисой: * Умные колонки (Яндекс Станция и другие) -* Мобильное приложение [Дом с Алисой](https://mobile.yandex.ru/apps/smarthome) -* Веб-интерфейс [Квазар](https://yandex.ru/quasar/iot) +* Мобильное приложение [Дом с Алисой](https://ya.cc/iot_app) Компонент работает на Home Assistant версии **2024.4** или новее. diff --git a/docs/platforms/yandex.md b/docs/platforms/yandex.md new file mode 100644 index 00000000..8dcf0d0c --- /dev/null +++ b/docs/platforms/yandex.md @@ -0,0 +1,20 @@ +## Обновление списка устройств { id=discovery } + +Нажмите иконку :fontawesome-solid-plus: в правом верхнем углу --> `Устройство умного дома` --> +Найдите производителя `Yaha Cloud` (или другой навык) --> :fontawesome-solid-arrows-rotate: Обновить + +![](../assets/images/app/yandex/discovery-1.png){ width=340 } +![](../assets/images/app/yandex/discovery-2.png){ width=340 } + +## Отвязка навыка (производителя) и удаление устройств { id=unlink } + +Это может быть полезно если в УДЯ выгрузили много лишнего из Home Assistant, и удалять руками каждое устройство не хочется. +Или при переходе с прямого подключение на облачное (и наоборот): + +* Нажмите иконку :fontawesome-solid-plus: в правом верхнем углу --> `Устройство умного дома` +* Найдите производителя `Yaha Cloud` (или другой навык) и нажмите иконку :fontawesome-solid-trash-can: +* Поставьте галочку `Удалить устройства` (если планируется повторно привязывать производителя - галочку ставить не нужно) +* Нажмите `Отвязать от Яндекса` или `Удалить аккаунт и устройства` + +![](../assets/images/app/yandex/discovery-3.png){ width=270 } +![](../assets/images/app/yandex/unlink-4.png){ width=270 } diff --git a/docs/quasar.md b/docs/quasar.md deleted file mode 100644 index 54665733..00000000 --- a/docs/quasar.md +++ /dev/null @@ -1,41 +0,0 @@ -Квазар - это веб-интерфейс, который используется для управления Умным домом Яндекса. - -Доступен через браузер по адресу [https://yandex.ru/quasar](https://yandex.ru/quasar), официально Яндексом **не поддерживается**. - -!!! info "Аналогичная функциональность так же доступна в мобильном приложении [Дом с Алисой](https://mobile.yandex.ru/apps/smarthome)" - -## Обновление списка устройств { id=discovery } - -Нажмите иконку :fontawesome-solid-plus: в правом верхнем углу --> `Устройство умного дома` --> -Найдите производителя `Yaha Cloud` (или свой собственный навык) --> :fontawesome-solid-arrows-rotate: Обновить - -![](assets/images/quasar/discovery-1.png){ width=340 } -![](assets/images/quasar/discovery-2.png){ width=340 } - -## Отвязка навыка (производителя) и удаление устройств { id=unlink } - -Это может быть полезно если в УДЯ выгрузили много лишнего из Home Assistant, и удалять руками каждое устройство не хочется. -Или при переходе с прямого подключение на облачное (и наоборот). - -### Дом с Алисой { id=unlink-app } - -* Нажмите иконку :fontawesome-solid-plus: в правом верхнем углу --> `Устройство умного дома` -* Найдите производителя `Yaha Cloud` (или свой собственный навык) и нажмите иконку :fontawesome-solid-trash-can: -* Поставьте галочку `Удалить устройства` (если планируется повторно привязывать производителя - галочку ставить не нужно) -* Нажмите `Отвязать от Яндекса` или `Удалить аккаунт и устройства` - -![](assets/images/quasar/discovery-3.png){ width=270 } -![](assets/images/quasar/unlink-4.png){ width=270 } - -### Квазар { id=unlink-quasar } - -* Нажмите иконку :fontawesome-solid-plus: в правом верхнем углу --> `Устройство умного дома` --> - Найдите и выберите производителя `Yaha Cloud` (или свой собственный навык) -* Нажмите иконку :fontawesome-solid-trash-can: в правом верхнем углу -* Поставьте галочку `Удалить устройства` (если планируется повторно привязывать производителя - галочку ставить не нужно) -* Нажмите `Отвязать от Яндекса` или `Удалить аккаунт и устройства` - -![](assets/images/quasar/discovery-1.png){ width=340 } -![](assets/images/quasar/discovery-2.png){ width=340 } -![](assets/images/quasar/unlink-1.png){ width=340 } -![](assets/images/quasar/unlink-2.png){ width=340 } diff --git a/docs/troubleshoot.md b/docs/troubleshoot.md index 1f25438d..2a8c20d6 100644 --- a/docs/troubleshoot.md +++ b/docs/troubleshoot.md @@ -11,7 +11,7 @@ 4. В [`Журнале сервера`](https://my.home-assistant.io/redirect/logs/) нет ошибок * Перезапустите Home Assistant -* Выполните ручное [Обновление списка устройств](./quasar.md#discovery) +* Выполните ручное [Обновление списка устройств](./platforms/yandex.md#discovery) Если это не помогло - создайте [issue](https://github.com/dext0r/yandex_smart_home/issues) или напишите в [чат](https://t.me/yandex_smart_home). К сообщению приложите: @@ -28,19 +28,19 @@ Некоторые устройства изменяют список поддерживаемых функций в зависимости от своего состояния. Особенно часто это поведение замечено за `media_player`. -Если в УДЯ у устройства отсутствует функция, которая точно должна быть - попробуйте [Обновить список устройств](./quasar.md#discovery) при включенном устройстве. +Если в УДЯ у устройства отсутствует функция, которая точно должна быть - попробуйте [Обновить список устройств](./platforms/yandex.md#discovery) при включенном устройстве. Так же может помочь настройка [`features`](./config/entity.md#features) для явного указания поддерживаемых устройством функций. ## Устройство отвязалось { id=unlinked } -Необходимо вручную [Обновить список устройств](./quasar.md#discovery), но сделать это не из списка навыков, а **зайти в навык** и нажать там кнопку `Обновить список устройств` или `Привязать к Яндексу`. +Необходимо вручную [Обновить список устройств](./platforms/yandex.md#discovery), но сделать это не из списка навыков, а **зайти в навык** и нажать там кнопку `Обновить список устройств` или `Привязать к Яндексу`. ## State requested for unexposed entity { id=unexposed-entity } В УДЯ присутствует устройство, но объект по которому оно создано не выбран в [объектах для передачи в УДЯ](./config/filter.md). -Для исправления: удалите устройство из УДЯ или добавьте [объект](./faq.md#get-entity-id-quasar) в список устройств для передачи. +Для исправления: удалите устройство из УДЯ или добавьте [объект](./faq.md#get-entity-id-yandex) в список устройств для передачи. ## Unsupported mode "XXX" { id=unsupported-mode } @@ -54,7 +54,7 @@ ### State notification request failed: UNKNOWN_USER { id=unknown-user } -* Вручную [обновите список устройств](./quasar.md#discovery) +* Вручную [обновите список устройств](./platforms/yandex.md#discovery) * Для прямого подключения: убедитесь, что в параметрах навыка в [настройках интеграции](./config/getting-started.md#gui) выбран пользователь, который использовался при привязке Home Assistant к УДЯ ### State notification request failed: Unauthorized { id=notifier-unauthorized } diff --git a/mkdocs.yml b/mkdocs.yml index ed5af14d..fbc328d4 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -31,10 +31,11 @@ nav: - Умения "Переключатели": advanced/capabilities/toggle.md - События: advanced/events.md - Коды ошибок: advanced/error-codes.md + - Платформы умного дома: + - Дом с Алисой: platforms/yandex.md - Устранение проблем: troubleshoot.md - Часто задаваемые вопросы: faq.md - Поддерживаемые устройства: supported-devices.md - - Квазар и "Дом с Алисой": quasar.md - Обратная совместимость: breaking-changes.md - Рецепты: recipes.md