Zigbee2MQTT: el dispositivo no se empareja

Pones el dispositivo en modo emparejamiento y nunca aparece en Zigbee2MQTT.

Por Kike · revisada en octubre de 2026 · Nivel: Intermedio · Cómo verificamos

Por qué pasa (diagnóstico)

• No está habilitado «Permit join».
• Interferencias del USB 3 o del Wi‑Fi cerca del coordinador (muy típico en Raspberry Pi 4).
• Dispositivo demasiado lejos o con la pila baja.
• Ya estaba emparejado con otra red.

Solución paso a paso

1. Activa «Permit join (All)» en el frontend de Z2M (dura un tiempo limitado).
2. Conecta el dongle con un alargador USB, lejos de puertos USB 3 y del router.
3. Empareja cerca del coordinador o de un router Zigbee (enchufe/bombilla).
4. Resetea el dispositivo según su manual y vuelve a intentarlo.
5. Mira el log de Z2M mientras emparejas.

Requisitos

• Coordinador Zigbee
• Zigbee2MQTT

Compatibilidad

• Zigbee2MQTT 1.x/2.x

Verificación

Basado en la documentación oficial citada; aún no probado en este laboratorio.

Fuentes

• Zigbee2MQTT — Emparejar dispositivos (en inglés)
• Zigbee2MQTT — FAQ (en inglés)

Manuales de aparatos relacionados

• Sonoff ZBDongle-P
• Sonoff ZBDongle-E
• Aqara Sensor de temperatura y humedad
• Aqara Sensor de puerta/ventana
• Aqara Sensor de movimiento

Guías relacionadas

• Sensor Zigbee no disponible tras cambiar la pila
• Zigbee2MQTT y ZHA se pelean por el mismo dongle Sonoff
• Dispositivos Zigbee que se caen: interferencias del coordinador USB
• Un dispositivo Matter no se empareja en Home Assistant
• Un dispositivo Matter deja de responder en Home Assistant
• ZHA: red Zigbee inestable, cambiar de canal

Más guías de Home Assistant.