Zigbee2MQTT con dongle Sonoff ZBDongle-E: setup completo

Published on 02/05/2026 IoT

Perché Zigbee2MQTT (Z2M)

Ogni marca Zigbee vende il proprio gateway (Philips Hue Bridge, Aqara Hub, Tuya). Ognuno è una scatola da alimentare, una app da installare, un cloud da fidarsi. Con Z2M un singolo dongle USB su Home Assistant gestisce tutti i dispositivi Zigbee, indipendentemente dal brand.

Hardware consigliato

Il Sonoff ZBDongle-E (chip EFR32MG21) è il miglior compromesso prezzo/portata/compatibilità nel 2026. Costa circa €18, supporta Zigbee 3.0 e ha già firmware coordinator preflashato.

Importante: usa una prolunga USB di almeno 30 cm. Inserito direttamente sul Pi/server, l'interferenza WiFi/USB3 dimezza la portata Zigbee.

Trovare la porta seriale

Su Home Assistant SSH:

ls -l /dev/serial/by-id/

Vedrai qualcosa tipo:

usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_xxxx-if00

Copia questo path completo: lo userai nella configurazione Z2M.

Installare l'add-on Z2M

  1. Impostazioni → Add-on → Negozio → Repository: aggiungi https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
  2. Installa Zigbee2MQTT
  3. Sotto Configuration imposta:
serial:
  port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_xxxx-if00
  adapter: ember
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://core-mosquitto:1883
  user: hauser
  password: !secret mqtt_pass
frontend:
  port: 8099

Adapter "ember"

Lo ZBDongle-E richiede l'adapter ember (EmberZNet). Errore comune: lasciare auto o zstack e ottenere "coordinator failed to start". Cambia ad ember e riavvia.

Pairing dei dispositivi

Apri il frontend Z2M su http://homeassistant.local:8099. Pulsante Permit join (default 254 secondi). Per ogni dispositivo:

  • Lampadine: alimenta tenendo premuto switch on/off 3 volte
  • Sensori temperatura/movimento: tieni premuto pin reset 5 secondi
  • Prese smart: hold pulsante power 5 secondi

Quando appare nel frontend, dagli un friendly name chiaro (cucina_temperatura, non 0x00158d000abc1234).

Estensione della rete

Il dongle copre 10-15 metri in linea d'aria. Per case grandi aggiungi router Zigbee (qualsiasi presa smart o lampadina alimentata fa da repeater). Dispositivi a batteria sono solo end device, non estendono.

Backup della rete Zigbee

Nella cartella di configurazione Z2M c'è coordinator_backup.json: contiene la network key. Se il dongle si rompe, con questo file ne configuri uno nuovo senza ri-pairare ogni dispositivo. Salvalo fuori dal Pi.

Migrazione da Hue/Aqara

Per migrare lampadine Hue: reset di fabbrica dell'app Hue (5 lampeggi), poi pairing su Z2M. Stesso processo per Aqara/Ikea Tradfri. Una volta su Z2M, il bridge Hue diventa inutile.

← Back to IoT