Zigbee2MQTT на Sonoff V2, мост Яндекс.Умный дом, приложения Nextcloud

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 сущностей.
This commit is contained in:
buryan-agent committed 2026-10-20 21:33:13 +03:00
1 parent 5de4697549
commit 6b269438eb
5 files changed
+485

No files matched your search

+37
View File
@@ -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.
+53
View File
@@ -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/<id>/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 <music_token> → 403
Authorization: OAuth <x_token> → 403
Cookie: <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`
+276
View File
@@ -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()
+76
View File
@@ -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.
+43
View File
@@ -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