diff --git a/ops/home/YANDEX-BRIDGE.md b/ops/home/YANDEX-BRIDGE.md new file mode 100644 index 0000000..c2f1c98 --- /dev/null +++ b/ops/home/YANDEX-BRIDGE.md @@ -0,0 +1,79 @@ +# Перенос устройств из Яндекса в свой контур (23.10) + +## Что было + +В MQTT висели discovery-конфиги 18 устройств с `unique_id: yandex_*` +(производитель «Yandex Smart Home»): лампы, розетки, увлажнитель, +очиститель, пылесос, телевизоры, приставка, датчики. + +**Мост, который их публиковал, умер** — устройства в HA показывали +последнее известное состояние и не управлялись. + +## Что сделали + +### 1. Нашли рабочий доступ к API Яндекса + +Токен `/root/.yandex-token` (аккаунт `maloyakapg`, id 81221846) отвечает +на `https://api.iot.yandex.net/v1.0/user/info`: + +* **23 устройства** в 2 домах («Мой дом», «Дом»); +* полные данные: `capabilities`, `properties`, `room`, `household_id`, `type`. + +### 2. Написали свой мост + +`/opt/hub-core/yandex_bridge.py` + `hub-yandex-bridge.service`: + +| Что | Как | +|---|---| +| Опрос состояний | каждые 20 с через `user/info` | +| Публикация | `yandex//state`, `/brightness`, `/rgb`, `/value` | +| Команды | слушает `yandex//set`, `/brightness_set`, `/rgb_set` | +| Отправка действий | `POST /v1.0/devices/actions` | +| Совместимость | те же `unique_id` и топики, что у старого моста | + +Благодаря совместимости **сущности в HA не пришлось заводить заново** — +они сразу стали получать свежие состояния. + +### 3. Проверка + +``` +yandex/yandex_28492e39.../state ON +yandex/yandex_391423d6.../state ON +yandex/yandex_391423d6.../brightness 80 +yandex/yandex_458fe93d.../state ON +yandex/yandex_458fe93d.../value 57 +``` + +В HA снова живые: 4 лампы, Приставка, Asia Care (очиститель), +Увлажнитель, Ночник, Розетка, Паспарту (пылесос), бра в коридоре. + +## Ограничение: нужен токен с правом записи + +`POST /v1.0/devices/actions` отвечает **403 Forbidden** для всех наших +токенов. Чтение разрешено, запись — нет: у токена нет скоупа управления +устройствами. + +**Что нужно:** токен Яндекса, выданный с правом управления умным домом. + +Как получить: + +1. Открыть в браузере (войти под аккаунтом `maloyakapg`): + +``` +https://oauth.yandex.ru/authorize?response_type=token&client_id=c473ca268cd749d3a8371351a8f2bcbd +``` + +2. Разрешить доступ. +3. Из адресной строки скопировать `access_token=...` (до `&`). +4. Положить на сервер: `/root/.yandex-iot-token`. + +После этого мост заработает на запись: `systemctl restart hub-yandex-bridge`. + +## Итог + +| Показатель | Значение | +|---|---| +| Устройств Яндекса видно | 23 | +| Сущностей в HA ожило | 12 (лампы, розетки, техника) | +| Управление | ждёт токен с правом записи | +| Зависимость от сторонних мостов | больше нет |