Zigbee-выключатель подключён, голосовое управление Яндексом

Первое Zigbee-устройство: Yandex YNDX_00532 (0xacbac0fffebde397) —
двухклавишный выключатель. В HA появились switch 1/2, подсветка, режимы,
переименованы по-человечески.

Ловушка: permit_join нельзя открыть дольше 254 секунд — запросы на 900/1800
молча отклоняются, из-за этого первая попытка не сработала. Написан keepjoin.py,
который держит окно открытым 15 минут.

Яндекс: переавторизация по QR обновляет cookie, но права iot не появляются;
прямые запросы к api.iot и iot.quasar дают 403/401. Сделан голосовой обход:
команда бота !алиса <фраза> отправляет «Алиса, ...» на колонку, и она
выполняет действие. Работает для всех устройств аккаунта.
This commit is contained in:
buryan-agent committed 2026-10-20 21:56:42 +03:00
1 parent 2ec0b721fd
commit 3e6ac0945d
4 files changed
+169

No files matched your search

+46
View File
@@ -0,0 +1,46 @@
# Управление Яндекс.Умным домом голосом
## Проблема
Прямое управление через API не работает:
| Запрос | Результат |
|---|---|
| `api.iot.yandex.net` + `OAuth <music_token>` | **403** (токен без scope `iot`) |
| `api.iot.yandex.net` + `x-token` | 403 |
| `iot.quasar.yandex.ru` + Cookie | 401 |
| `iot.quasar.yandex.ru` + Cookie + x-token | 401 |
| `iot.quasar.yandex.ru` + Cookie + x-csrf-token | 401 |
Переавторизация через QR (YandexStation) обновляет cookie, но `x_token`
остаётся прежним и прав на запись не даёт. Поток повторной авторизации
завершается `abort` — HA не разрешает второй экземпляр интеграции.
## Рабочий обход — голос
Колонки управляются через `yandex_station.send_command` (`sendText`), а они
уже связаны с умным домом Яндекса. Значит, команду можно **сказать**:
```
!алиса включи свет в тамбуре
!алиса выключи телевизор в детской
!алиса какая погода
```
Бот отправит на колонку: «Алиса, включи свет в тамбуре» — и она выполнит.
Префикс «Алиса,» добавляется автоматически, если его нет.
## Почему это нормально работает
- не нужен iot-токен;
- Алиса сама знает все устройства и сценарии;
- работает для любого устройства в её аккаунте, а не только для тех 18, что
попали в мост;
- голосовые сценарии («я ухожу») тоже запускаются.
## Что осталось быстрым путём
Если очень нужен прямой API — взять OAuth-токен с scope `iot` через
официальное приложение «Дом с Алисой» (Яндекс.Ключ → интеграции) и подставить
в `/root/.ya_music_token`. Мост `yandex_iot_bridge` уже умеет отправлять
`on_off`, `brightness`, `rgb`.
+59
View File
@@ -0,0 +1,59 @@
"""Добавляет команду !алиса — голосовое управление умным домом."""
import ast
p = "/opt/hub-bots/hub/bots.py"
b = open(p, encoding="utf-8").read()
if "_alisa_voice" in b:
print("уже есть")
raise SystemExit(0)
helper = '''
def _alisa_voice(self, arg):
"""!алиса <фраза> — сказать Алисе, чтобы она выполнила команду."""
text = (arg or "").strip()
if not text:
return ("Напишите фразу после команды, например:\\n"
"_!алиса включи свет в тамбуре_\\n"
"_!алиса какая погода_\\n"
"_!алиса выключи телевизор в детской_")
speech = text
low = speech.lower()
if not low.startswith(("алиса", "слушай алиса", "привет алиса")):
speech = "Алиса, " + speech
sp, err = self._speakers()
if err:
return "HA не ответила: " + err
if not sp:
return "Колонки не найдены."
target = self._pick_speaker(sp)
if not target:
return "Все колонки недоступны."
_, e = self._ha("/api/services/yandex_station/send_command",
{"entity_id": target["entity_id"], "command": "sendText",
"text": speech})
if e:
return "Не удалось: " + e
name = (target.get("attributes") or {}).get("friendly_name")
return f"Сказал на «{name}»: {speech}"
'''
idx = b.find(" def _alice_cmd(self, arg):")
if idx < 0:
print("не нашёл точку вставки")
raise SystemExit(1)
b = b[:idx] + helper.lstrip("\n") + "\n" + b[idx:]
reg = ' self.cmd("алиса", "голосом через Алису: !алиса включи свет в тамбуре")(lambda a: self._alisa_voice(a))\n'
anchor = ' self.cmd("скажи",'
i = b.find(anchor)
if i < 0:
print("не нашёл register")
raise SystemExit(1)
b = b[:i] + reg + b[i:]
open(p, "w", encoding="utf-8").write(b)
ast.parse(b)
print("бот: команда !алиса добавлена")
+44
View File
@@ -0,0 +1,44 @@
# Первое Zigbee-устройство
## Что подключилось
**Yandex YNDX_00532** — двухклавишный выключатель.
```
IEEE: 0xacbac0fffebde397
Модель: YNDX_00532
```
## Сущности в HA
```
switch.0xacbac0fffebde397_1 → «Выключатель Yandex (левая клавиша)»
switch.0xacbac0fffebde397_2 → «Выключатель Yandex (правая клавиша)»
switch.0xacbac0fffebde397_led_indicator → подсветка
select.0xacbac0fffebde397_operation_mode_1/2
select.0xacbac0fffebde397_power_on_behavior_1/2
select.0xacbac0fffebde397_power_type
update.0xacbac0fffebde397
```
## Ловушка: лимит сопряжения
`permit_join` в Zigbee2MQTT **нельзя открыть больше чем на 254 секунды**:
```
Request 'bridge/request/permit_join' failed with error:
'Cannot permit join for more than 254 seconds.'
```
Поэтому запросы `time: 900` и `time: 1800` отклоняются молча, и устройство
не подключается. Решение — держать окно открытым скриптом
`keepjoin.py` (обновляет каждые 230 с в течение 15 минут).
## Как спаривать
1. Открыть окно: `zigbee2mqtt/bridge/request/permit_join` с `time: 254`.
2. Зажать кнопку сопряжения на устройстве (обычно 5 с).
3. Устройство появится в HA автоматически (MQTT discovery).
Если устройство было привязано к другому хабу (Xiaomi/Яндекс) — сначала
отвязать, иначе оно не перейдёт.
+20
View File
@@ -0,0 +1,20 @@
"""Держит режим сопряжения Zigbee открытым 15 минут (по 254 с)."""
import json
import time
import paho.mqtt.client as mqtt
c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION1, client_id="zg-keepalive")
c.username_pw_set("hub", "hubmqtt")
c.connect("192.168.1.107", 1883, 20)
c.loop_start()
end = time.time() + 15 * 60
while time.time() < end:
c.publish("zigbee2mqtt/bridge/request/permit_join",
json.dumps({"value": True, "time": 250}))
print("permit_join open", flush=True)
time.sleep(230)
c.loop_stop()
c.disconnect()