MQTT·Avanzato 22 minAggiornato: 30 marzo 2026

Integrare Dispositivi Zigbee con Shangrilux tramite Zigbee2MQTT

Usa Zigbee2MQTT per collegare serrature, sensori e attuatori Zigbee a Shangrilux tramite broker MQTT locale.

Nota: Zigbee2MQTT supporta oltre 3.000 dispositivi da 400+ brand (Aqara, IKEA, Philips Hue, Sonoff, Tuya, Xiaomi, Bosch, ecc.). Consulta zigbee2mqtt.io/supported-devices per verificare compatibilità del tuo dispositivo.

Prerequisiti

Coordinatore Zigbee USB: Sonoff Zigbee 3.0 Dongle Plus (raccomandato), CC2652R, ConBee II o Phoscon
Raspberry Pi 4 o server Linux per ospitare Zigbee2MQTT (Docker raccomandato)
Broker Mosquitto installato (vedi guida MQTT)
Node.js 20+ o Docker Engine
Dispositivi Zigbee compatibili (serrature, sensori, luci)

Installazione Zigbee2MQTT

Installazione con Docker Compose (raccomandato)

Crea il file docker-compose.yml:

yaml

version: '3.8'
services:
  zigbee2mqtt:
    image: koenkk/zigbee2mqtt:latest
    container_name: zigbee2mqtt
    restart: unless-stopped
    volumes:
      - ./z2m-data:/app/data
      - /run/udev:/run/udev:ro
    ports:
      - "8080:8080"
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # dongle Sonoff
    environment:
      - TZ=Europe/Rome

Configura configuration.yaml

Crea ./z2m-data/configuration.yaml:

yaml

homeassistant: false
permit_join: false   # cambia in true per aggiungere dispositivi
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://192.168.1.200:1883
  user: shangrilux
  password: TUA_PASSWORD_MQTT
serial:
  port: /dev/ttyUSB0
  adapter: deconz   # o ember per Sonoff
frontend:
  port: 8080
  auth_token: TOKEN_SICURO_FRONTEND
advanced:
  log_level: info
  pan_id: GENERATE
  channel: 25

Aggiungi dispositivi Zigbee

Abilita temporaneamente il pairing: in Zigbee2MQTT Frontend (http://192.168.1.x:8080) → clicca "Allow join (All)" → metti il dispositivo in modalità pairing (procedura diversa per ogni brand — consulta zigbee2mqtt.io). Il dispositivo appare entro 60 secondi.

Configura le serrature Zigbee

Le serrature Zigbee (es. Aqara N200, Sonoff ZBMINIL2, Danalock V3) pubblicano automaticamente su:

bash

# Topic auto-generati da Zigbee2MQTT
zigbee2mqtt/Serratura_Camera_101        # Stato completo (JSON)
zigbee2mqtt/Serratura_Camera_101/set    # Comandi
zigbee2mqtt/Serratura_Camera_101/get    # Richiesta stato

# Esempio payload ricevuto da Aqara N200:
{
  "state": "LOCK",
  "battery": 82,
  "door_state": "CLOSED",
  "lock_state": "LOCKED",
  "sound_volume": "HIGH",
  "linkquality": 98
}

Collega Zigbee2MQTT a Shangrilux

In Shangrilux Admin → Integrazioni → MQTT → configura il broker Mosquitto. Poi in Integrazioni → Zigbee2MQTT → imposta base_topic (zigbee2mqtt) e mappa ogni dispositivo all'unità/camera corrispondente.

Manda comandi alla serratura

Shangrilux pubblica comandi sul topic /set:

bash

# Apri serratura (publish su mosquitto)
mosquitto_pub -h 192.168.1.200 -t "zigbee2mqtt/Serratura_Camera_101/set" \
  -m '{"state": "UNLOCK"}' -u shangrilux -P password

# Risposta asincrona su topic principale:
# { "state": "UNLOCK", "linkquality": 95, ... }

Dispositivi Zigbee Raccomandati per Hospitality

Dispositivo	Brand	Funzione	Note
N200	Aqara	Serratura + sensore porta + lettore NFC	Molto stabile, raccomandato
ZBMINIL2	Sonoff	Relè per serrature elettromeccaniche	Economico, max 10A
Danalock V3	Danalock	Serratura cilindro europea Z-Wave + Zigbee	Dual protocol
WSDCGQ11LM	Aqara	Sensore T/H per clima camera	Precisione ±0.2°C
JTQJ-BF-01LM	Aqara	Sensore gas/fumo	Obbligatorio in cucine
E1524/E1743	IKEA	Luci smart a basso costo	Zigbee 3.0

Attenzione: Zigbee usa la banda 2,4 GHz come Wi-Fi e Bluetooth. In ambienti con molti dispositivi Wi-Fi, usa il canale Zigbee 25 o 26 per minimizzare le interferenze. Non mettere il dongle Zigbee direttamente sulla porta USB del server — usa un'estensione USB da almeno 50cm.

#zigbee#zigbee2mqtt#sonoff#aqara#mqtt#open-source#hue