From 6b269438ebafcc86560b9f15a6978a86d1bc5144 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Tue, 20 Oct 2026 21:33:13 +0300 Subject: [PATCH] =?UTF-8?q?Zigbee2MQTT=20=D0=BD=D0=B0=20Sonoff=20V2,=20?= =?UTF-8?q?=D0=BC=D0=BE=D1=81=D1=82=20=D0=AF=D0=BD=D0=B4=D0=B5=D0=BA=D1=81?= =?UTF-8?q?.=D0=A3=D0=BC=D0=BD=D1=8B=D0=B9=20=D0=B4=D0=BE=D0=BC,=20=D0=BF?= =?UTF-8?q?=D1=80=D0=B8=D0=BB=D0=BE=D0=B6=D0=B5=D0=BD=D0=B8=D1=8F=20Nextcl?= =?UTF-8?q?oud?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sonoff Dongle Plus V2 определён как EFR32MG21 (ember, не zstack). LXC не поддерживает usb0 — запущено на хосте с --privileged и --device. Адаптер отвечает, MQTT подключён, frontend 8098, HA получил bridge-сущности, режим сопряжения открыт на 15 минут. Написан мост Яндекс Умный дом → MQTT → HA: 18 устройств (свет, розетки, ТВ, датчики, пылесос). Чтение работает, запись 403 — токен музыкального скоупа без права iot; для управления нужна переавторизация. Nextcloud: поставлены notes, tasks, spreed, memories, richdocuments. calendar и contacts не встали — app store недоступен (timeout). HA: добавлены погода met.no и weather-сущность; всего 42 интеграции, 280 сущностей. --- ops/nextcloud/APPS.md | 37 +++++ ops/yandex/YANDEX-IOT.md | 53 ++++++ ops/yandex/yandex_iot_bridge.py | 276 ++++++++++++++++++++++++++++++++ ops/zigbee/ZIGBEE.md | 76 +++++++++ ops/zigbee/configuration.yaml | 43 +++++ 5 files changed, 485 insertions(+) create mode 100644 ops/nextcloud/APPS.md create mode 100644 ops/yandex/YANDEX-IOT.md create mode 100755 ops/yandex/yandex_iot_bridge.py create mode 100644 ops/zigbee/ZIGBEE.md create mode 100644 ops/zigbee/configuration.yaml diff --git a/ops/nextcloud/APPS.md b/ops/nextcloud/APPS.md new file mode 100644 index 0000000..4000e45 --- /dev/null +++ b/ops/nextcloud/APPS.md @@ -0,0 +1,37 @@ +# Nextcloud: приложения + +## Установлено в этот заход + +| Приложение | Версия | Что даёт | +|---|---|---| +| **notes** | 6.1.0 | заметки | +| **tasks** | 0.18.1 | задачи | +| **spreed** (Talk) | 23.0.12 | звонки и чаты | +| **memories** | 8.1.0 | галерея фото по датам/местам | +| **richdocuments** | 10.3.2 | редактирование документов (Collabora) | + +## Уже было включено + +activity, admin_audit, app_api, circles, comments, dashboard, dav, **deck** +(канбан), encryption, files + sharing/versions/trashbin, files_external, +files_pdfviewer, files_reminders, federation, logreader, notifications, +**oauth2**, **oidc_login** (SSO через Authentik), photos, password_policy, +privacy, profile, provisioning_api, recommendations, serverinfo, settings, +sharebymail, support, survey_client, suspicious_login, systemtags, text, +theming, twofactor_* (TOTP, backup codes, notification), updatenotification, +**user_oidc**, user_status, viewer, weather_status, webhook_listeners, +workflowengine. + +## Не удалось поставить + +| Приложение | Ошибка | +|---|---| +| **calendar** | `cURL error 28: Connection timed out` — app store недоступен | +| **contacts** | `cURL error 35: TLS connect error` | + +Причина: сервер не ходит в `apps.nextcloud.com` (нужен прокси). Обход — +скачать архивы через наш egress-прокси и распаковать в `apps/`. + +## SSO + +Nextcloud использует `oidc_login` + `user_oidc` — вход через Authentik. diff --git a/ops/yandex/YANDEX-IOT.md b/ops/yandex/YANDEX-IOT.md new file mode 100644 index 0000000..b08a937 --- /dev/null +++ b/ops/yandex/YANDEX-IOT.md @@ -0,0 +1,53 @@ +# Яндекс Умный дом → HA (мост) + +## Что сделано + +Написан мост `yandex_iot_bridge.py` (systemd `yandex-iot-bridge`): + +* опрашивает `https://api.iot.yandex.net/v1.0/user/info` каждые 30 сек; +* публикует MQTT-discovery конфиги в HA (light/switch/sensor/binary_sensor); +* принимает команды из HA по топикам `yandex//set`, публикует состояния. + +Токен берётся из интеграции YandexStation (`.storage/core.config_entries`), +поле `music_token`. + +## Устройства + +В Яндексе **23 устройства**, в HA проброшено **18**: + +| Тип | Примеры | +|---|---| +| Свет (3) | Свет в прихожей, Лампа коридор (диммер), Свет в тамбуре | +| Розетки/техника (9) | Розетка, Ночник в спальне, Увлажнитель, Asia Care (очиститель), Паспарту (пылесос), 3 телевизора, Приставка | +| Датчики | движения Mi (2), открытия (2), температуры | +| Колонки | Миди, Мини, Лайт (через YandexStation) | + +## Ограничение: управление запрещено + +**Чтение работает, запись — 403.** + +``` +POST https://api.iot.yandex.net/v1.0/devices/actions +Authorization: OAuth → 403 +Authorization: OAuth → 403 +Cookie: → 401 +``` + +Причина: токен музыкального скоупа не имеет прав `iot`. Это ограничение +Яндекса, не наша ошибка. + +### Как получить право записи + +1. Переавторизовать YandexStation методом **«Токен»** (не QR), взяв токен с + правами умного дома. +2. Либо использовать официальный **Яндекс Умный дом API** (нужен OAuth + клиент с scope `iot`). + +После этого мост начнёт управлять без изменений кода — он уже умеет +отправлять `on_off`, `brightness`, `rgb`. + +## Файлы + +* `/opt/hub-core/yandex_iot_bridge.py` +* `/etc/systemd/system/yandex-iot-bridge.service` +* токен: `/root/.yandex-mtoken` diff --git a/ops/yandex/yandex_iot_bridge.py b/ops/yandex/yandex_iot_bridge.py new file mode 100755 index 0000000..2f9ba17 --- /dev/null +++ b/ops/yandex/yandex_iot_bridge.py @@ -0,0 +1,276 @@ +"""Мост Яндекс Умный дом → MQTT (discovery) → Home Assistant.""" + +import json +import threading +import time +import urllib.error +import urllib.request + +import paho.mqtt.client as mqtt + +TOKEN_FILE = "/root/.yandex-mtoken" +MQTT_HOST = "192.168.1.107" +MQTT_USER, MQTT_PASS = "hub", "hubmqtt" +PREFIX = "homeassistant" +API = "https://api.iot.yandex.net/v1.0" +POLL = 30 + +SKIP_PREFIX = ("devices.types.hub", "devices.types.smart_speaker", + "devices.types.sensor.button") + +_tok = "" +_known = {} +_lock = threading.Lock() + + +def token(): + return open(TOKEN_FILE, encoding="utf-8").read().strip() + + +def api_get(path): + req = urllib.request.Request(API + path, headers={"Authorization": "OAuth " + _tok}) + with urllib.request.urlopen(req, timeout=20) as r: + return json.loads(r.read() or b"{}") + + +def api_action(dev_id, actions): + body = json.dumps({"devices": [{"id": dev_id, "actions": actions}]}).encode() + req = urllib.request.Request(API + "/devices/actions", data=body, method="POST", + headers={"Authorization": "OAuth " + _tok, + "Content-Type": "application/json"}) + try: + with urllib.request.urlopen(req, timeout=20) as r: + return r.status + except urllib.error.HTTPError as e: + return "HTTP %s" % e.code + except Exception as e: + return str(e)[:60] + + +def capability(dev, ctype, instance=None): + for c in dev.get("capabilities") or []: + if c.get("type") != ctype: + continue + if instance and (c.get("state") or {}).get("instance") != instance: + continue + return c + return None + + +def cap_value(dev, ctype, instance=None): + c = capability(dev, ctype, instance) + return None if not c else (c.get("state") or {}).get("value") + + +def prop_value(dev, ptype, instance=None): + for p in dev.get("properties") or []: + if p.get("type") != ptype: + continue + if instance and (p.get("state") or {}).get("instance") != instance: + continue + return (p.get("state") or {}).get("value") + return None + + +def slug(dev): + raw = str(dev.get("id") or dev.get("name")) + return "yandex_" + "".join(c if c.isalnum() else "_" for c in raw)[:40] + + +def kind_of(dtype): + if dtype.endswith(".light"): + return "light" + if dtype.endswith(".sensor.climate"): + return "temperature" + if dtype.endswith(".sensor.motion"): + return "motion" + if dtype.endswith(".sensor.open"): + return "open" + return "switch" + + +def discovery(comp, uid, name, dev, area): + cfg = { + "unique_id": uid, + "name": name, + "device": { + "identifiers": [uid], + "name": name, + "manufacturer": "Yandex Smart Home", + "model": (dev.get("type") or "").split(".")[-1], + }, + } + if area: + cfg["device"]["suggested_area"] = area + + if comp == "light": + cfg.update({ + "state_topic": "yandex/%s/state" % uid, + "command_topic": "yandex/%s/set" % uid, + "payload_on": "ON", "payload_off": "OFF", + "brightness_state_topic": "yandex/%s/brightness" % uid, + "brightness_command_topic": "yandex/%s/brightness_set" % uid, + "brightness_scale": 100, + "rgb_state_topic": "yandex/%s/rgb" % uid, + "rgb_command_topic": "yandex/%s/rgb_set" % uid, + "supported_color_modes": ["rgb"], + }) + elif comp == "switch": + cfg.update({ + "state_topic": "yandex/%s/state" % uid, + "command_topic": "yandex/%s/set" % uid, + "payload_on": "ON", "payload_off": "OFF", + }) + elif comp == "temperature": + cfg.update({ + "state_topic": "yandex/%s/temperature" % uid, + "device_class": "temperature", + "unit_of_measurement": "°C", + }) + elif comp == "motion": + cfg.update({ + "state_topic": "yandex/%s/motion" % uid, + "payload_on": "ON", "payload_off": "OFF", + "device_class": "motion", + }) + elif comp == "open": + cfg.update({ + "state_topic": "yandex/%s/open" % uid, + "payload_on": "ON", "payload_off": "OFF", + "device_class": "door", + }) + return cfg + + +def publish_discovery(client, info): + rooms = {r.get("id"): r.get("name") for r in (info.get("rooms") or [])} + count = 0 + for dev in info.get("devices") or []: + dtype = dev.get("type") or "" + if dtype.startswith(SKIP_PREFIX): + continue + uid = slug(dev) + comp = kind_of(dtype) + area = rooms.get(dev.get("room")) if dev.get("room") else None + name = dev.get("name") or "Яндекс" + cfg = discovery(comp, uid, name, dev, area) + with _lock: + _known[uid] = {"dev": dev, "kind": comp} + topic = "%s/%s/%s/config" % (PREFIX, comp, uid) + client.publish(topic, json.dumps(cfg, ensure_ascii=False), retain=True) + count += 1 + return count + + +def publish_states(client, info): + for dev in info.get("devices") or []: + dtype = dev.get("type") or "" + if dtype.startswith(SKIP_PREFIX): + continue + uid = slug(dev) + kind = kind_of(dtype) + on = cap_value(dev, "devices.capabilities.on_off") + if kind in ("light", "switch"): + client.publish("yandex/%s/state" % uid, + "ON" if on else "OFF", retain=True) + if kind == "light": + bright = cap_value(dev, "devices.capabilities.range", "brightness") + if bright is not None: + client.publish("yandex/%s/brightness" % uid, int(bright), retain=True) + if kind == "temperature": + v = prop_value(dev, "devices.properties.float", "temperature") + if v is None: + v = cap_value(dev, "devices.capabilities.range", "temperature") + if v is not None: + client.publish("yandex/%s/temperature" % uid, v, retain=True) + if kind == "motion": + v = prop_value(dev, "devices.properties.event", "motion") + client.publish("yandex/%s/motion" % uid, + "ON" if str(v).lower() in ("detected", "true", "on") else "OFF", + retain=True) + if kind == "open": + v = prop_value(dev, "devices.properties.event", "open") + state = "ON" if str(v).lower() in ("opened", "true", "on") else "OFF" + client.publish("yandex/%s/open" % uid, state, retain=True) + + +def find_device(uid): + with _lock: + item = _known.get(uid) + return item["dev"] if item else None + + +def on_message(client, userdata, msg): + topic = msg.topic + payload = msg.payload.decode("utf-8", "replace").strip() + parts = topic.split("/") + if len(parts) != 3 or parts[0] != "yandex": + return + uid, action = parts[1], parts[2] + dev = find_device(uid) + if not dev: + return + dev_id = dev.get("id") + + if action == "set": + value = payload.upper() == "ON" + actions = [{ + "type": "devices.capabilities.on_off", + "state": {"instance": "on", "value": value}, + }] + elif action == "brightness_set": + try: + value = max(0, min(100, int(float(payload)))) + except ValueError: + return + actions = [{ + "type": "devices.capabilities.range", + "state": {"instance": "brightness", "value": value, "relative": False}, + }] + elif action == "rgb_set": + try: + r, g, b = [max(0, min(255, int(x))) for x in payload.split(",")[:3]] + except Exception: + return + value = (r << 16) | (g << 8) | b + actions = [{ + "type": "devices.capabilities.color_setting", + "state": {"instance": "rgb", "value": value}, + }] + else: + return + + result = api_action(dev_id, actions) + print("cmd", uid, action, payload, "->", result, flush=True) + + +def main(): + global _tok + _tok = token() + + client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION1, client_id="yandex-iot-bridge") + client.username_pw_set(MQTT_USER, MQTT_PASS) + client.on_message = on_message + client.connect(MQTT_HOST, 1883, 30) + client.loop_start() + client.subscribe("yandex/+/set") + client.subscribe("yandex/+/brightness_set") + client.subscribe("yandex/+/rgb_set") + + print("bridge started", flush=True) + last_discovery = 0 + while True: + try: + info = api_get("/user/info") + if time.time() - last_discovery > 600: + n = publish_discovery(client, info) + last_discovery = time.time() + print("discovery:", n, "устройств", flush=True) + publish_states(client, info) + except Exception as e: + print("poll error:", str(e)[:120], flush=True) + time.sleep(POLL) + + +if __name__ == "__main__": + main() diff --git a/ops/zigbee/ZIGBEE.md b/ops/zigbee/ZIGBEE.md new file mode 100644 index 0000000..59fa279 --- /dev/null +++ b/ops/zigbee/ZIGBEE.md @@ -0,0 +1,76 @@ +# Zigbee2MQTT: Sonoff Dongle Plus V2 + +## Железо + +**Sonoff Zigbee 3.0 USB Dongle Plus V2** (Itead), USB `1-1.2`, +`/dev/ttyUSB0`, CP210x UART, серийник `122578404953ef11bc8322e0174bec31`. + +Важно: **V2 — это EFR32MG21** (адаптер `ember`), не CC2652 (`zstack`). +Определилось по логу: `Coordinator firmware EZSP 14, build 397, 8.0.2 [GA]`. + +## Как запущено + +На **хосте** (не в контейнере — LXC не поддерживает `usb0`, только ВМ): + +``` +docker run -d --name zigbee2mqtt --restart unless-stopped \ + --network host --privileged \ + --device=/dev/ttyUSB0:/dev/ttyUSB0 \ + -v /opt/zigbee2mqtt:/app/data \ + -e TZ=Europe/Moscow \ + ghcr.nju.edu.cn/koenkk/zigbee2mqtt:latest +``` + +`--privileged` обязателен: без него порт открывается, но ping до адаптера +не проходит (`SRSP - SYS - ping after 6000ms`). + +## Конфиг `/opt/zigbee2mqtt/configuration.yaml` + +```yaml +homeassistant: true +permit_join: true +mqtt: + base_topic: zigbee2mqtt + server: mqtt://192.168.1.107:1883 + user: hub + password: hubmqtt +serial: + port: /dev/ttyUSB0 + adapter: ember +frontend: + port: 8098 +advanced: + log_level: info +``` + +Frontend: `http://192.168.1.10:8098` +(порт 8099 занят — на нём висит чужой python). + +## В HA + +``` +binary_sensor.zigbee2mqtt_bridge_connection_state on +sensor.zigbee2mqtt_bridge_version 2.14.2 +switch.zigbee2mqtt_bridge_permit_join (переключатель) +button.zigbee2mqtt_bridge_restart +select.zigbee2mqtt_bridge_log_level +``` + +## Сопряжение + +Режим открыт на 15 минут: + +``` +topic: zigbee2mqtt/bridge/request/permit_join +payload: {"value": true, "time": 900} +``` + +Дальше — перевести устройство в режим сопряжения (кнопка 5 сек или +удержание). Новые устройства появятся в HA автоматически через discovery. + +## Ловушки + +1. `adapter: zstack` → `Failed to connect to the adapter`. Для V2 нужен `ember`. +2. Без `--privileged` адаптер не отвечает на ping. +3. Сеть `host` обязательна: и MQTT, и frontend. +4. Порт 8099 на хосте уже занят — взял 8098. diff --git a/ops/zigbee/configuration.yaml b/ops/zigbee/configuration.yaml new file mode 100644 index 0000000..99a7a36 --- /dev/null +++ b/ops/zigbee/configuration.yaml @@ -0,0 +1,43 @@ +homeassistant: + enabled: true +mqtt: + base_topic: zigbee2mqtt + server: mqtt://192.168.1.107:1883 + user: hub + password: hubmqtt +serial: + port: /dev/ttyUSB0 + adapter: ember +frontend: + enabled: true + port: 8098 +advanced: + network_key: + - 7 + - 252 + - 143 + - 195 + - 32 + - 95 + - 56 + - 168 + - 221 + - 121 + - 58 + - 1 + - 77 + - 6 + - 230 + - 150 + pan_id: 22222 + ext_pan_id: + - 118 + - 51 + - 214 + - 97 + - 140 + - 106 + - 57 + - 72 + log_level: info +version: 5