diff --git a/ops/yandex/ALICE-VOICE-CONTROL.md b/ops/yandex/ALICE-VOICE-CONTROL.md new file mode 100644 index 0000000..528f367 --- /dev/null +++ b/ops/yandex/ALICE-VOICE-CONTROL.md @@ -0,0 +1,46 @@ +# Управление Яндекс.Умным домом голосом + +## Проблема + +Прямое управление через API не работает: + +| Запрос | Результат | +|---|---| +| `api.iot.yandex.net` + `OAuth ` | **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`. diff --git a/ops/yandex/add_alisa_cmd.py b/ops/yandex/add_alisa_cmd.py new file mode 100644 index 0000000..b4417c7 --- /dev/null +++ b/ops/yandex/add_alisa_cmd.py @@ -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("бот: команда !алиса добавлена") diff --git a/ops/zigbee/FIRST-DEVICE.md b/ops/zigbee/FIRST-DEVICE.md new file mode 100644 index 0000000..e981f9f --- /dev/null +++ b/ops/zigbee/FIRST-DEVICE.md @@ -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/Яндекс) — сначала +отвязать, иначе оно не перейдёт. diff --git a/ops/zigbee/keepjoin.py b/ops/zigbee/keepjoin.py new file mode 100644 index 0000000..fb00d9c --- /dev/null +++ b/ops/zigbee/keepjoin.py @@ -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()