Skip to content

Commit

Permalink
docs: Remove quasar (#504, #444)
Browse files Browse the repository at this point in the history
  • Loading branch information
dext0r committed Nov 19, 2024
1 parent debc4f8 commit 9a331b0
Show file tree
Hide file tree
Showing 19 changed files with 37 additions and 60 deletions.
3 changes: 1 addition & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,7 @@
и управлять ими с любого устройства с Алисой:

* Умные колонки (Яндекс Станция и другие)
* Мобильное приложение [Дом с Алисой](https://mobile.yandex.ru/apps/smarthome)
* Веб-интерфейс [Квазар](https://yandex.ru/quasar/iot)
* Мобильное приложение [Дом с Алисой](https://ya.cc/iot_app)

Компонент работает на Home Assistant версии **2023.2** или новее.

Expand Down
2 changes: 1 addition & 1 deletion docs/advanced/direct-connection.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. Рекомендуется создать отдельного пользователя
Expand Down
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file removed docs/assets/images/quasar/unlink-1.png
Binary file not shown.
Binary file removed docs/assets/images/quasar/unlink-2.png
Binary file not shown.
2 changes: 1 addition & 1 deletion docs/config/connection-type.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
* [Добавьте](../install/integration.md) новую интеграцию с желаемым типом подключения
* Привяжите новую интеграцию через приложение [Дом с Алисой](https://ya.cc/iot_app)
* Устройства уникальны в рамках навыка (производителя), поэтому после привязки новой интеграции появятся "дубли" устройств: одно устройство на "старом" навыке, другое - на "новом"
* Проверьте, как управляются устройства на новом навыке и если проблем не выявлено, то старый навык можно [отвязать](../quasar.md#unlink) с удалением всех устройств
* Проверьте, как управляются устройства на новом навыке и если проблем не выявлено, то старый навык можно [отвязать](../platforms/yandex.md#unlink) с удалением всех устройств

## Какой тип подключения лучше? { id=compare }

Expand Down
2 changes: 1 addition & 1 deletion docs/config/entity.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@
Поддерживается как полное, так и краткое наименование: вместо `devices.types.dishwasher` можно использовать `dishwasher`, или вместо `devices.types.thermostat.ac` можно использовать `thermostat.ac`.

!!! attention "Обратите внимание"
После изменения типа **обязательно** удалите устройство вручную в УДЯ и выполните [Обновление списка устройств](../quasar.md#discovery).
После изменения типа **обязательно** удалите устройство вручную в УДЯ и выполните [Обновление списка устройств](../platforms/yandex.md#discovery).

!!! example "Пример"
```yaml
Expand Down
2 changes: 1 addition & 1 deletion docs/config/filter.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

!!! danger "Внимание!"
Удаление устройств из УДЯ возможно **только** вручную. Удаляйте устройство из УДЯ только после исключения объекта из списка для передачи.
Для удаления всех устройств - [отвяжите навык (производителя)](../quasar.md#unlink).
Для удаления всех устройств - [отвяжите навык (производителя)](../platforms/yandex.md#unlink).

!!! warning "Недопустимо оставлять в УДЯ устройства, у которых объект не выбран для передачи. Такие устройства будут работать некорректно."

Expand Down
6 changes: 3 additions & 3 deletions docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 }

Expand Down
6 changes: 2 additions & 4 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -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** или новее.

Expand Down
20 changes: 20 additions & 0 deletions docs/platforms/yandex.md
Original file line number Diff line number Diff line change
@@ -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 }
41 changes: 0 additions & 41 deletions docs/quasar.md

This file was deleted.

10 changes: 5 additions & 5 deletions docs/troubleshoot.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
К сообщению приложите:
Expand All @@ -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 }

Expand All @@ -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 }
Expand Down
3 changes: 2 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down

0 comments on commit 9a331b0

Please sign in to comment.