Files
buryan-infra/ops/zigbee/ZIGBEE.md
buryan-agent 6b269438eb 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 сущностей.
2026-10-20 21:33:13 +03:00

77 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.