LQI y RSSI en Zigbee2MQTT: qué valores son aceptables y cómo medirlos
Publicado: · Última revisión:
Cuando una red Zigbee va mal, Zigbee2MQTT te da dos números para diagnosticar cada enlace: LQI y RSSI. No miden lo mismo, y mezclarlos lleva a conclusiones equivocadas. Uno mide cuántos errores hay; el otro, cuánta señal llega.
Qué es el LQI
El LQI (Link Quality Indicator) es un valor de 0 a 255 que representa la calidad del enlace en la capa de red. La FAQ de Zigbee2MQTT lo resume así: un valor cerca de 255 indica una tasa de error medida próxima a cero, y un dispositivo que se mantiene en 40 o más suele poder tratarse como aceptable para operación normal.
Qué es el RSSI
El RSSI (Received Signal Strength Indicator) mide la potencia de la señal recibida, en decibelios-milivatio (dBm). Son números negativos, normalmente entre 0 y -100: cuanto más cerca de 0, más fuerte es la señal. No es lo mismo que el LQI: puedes tener mucha señal y mala calidad de enlace si algo genera interferencia en el canal.
Dónde verlos
En la interfaz web de Zigbee2MQTT, el mapa de red muestra el LQI de cada enlace entre dispositivos; el detalle del enlace incluye también el RSSI. En MQTT, el payload del dispositivo expone el valor como linkquality:
topic: zigbee2mqtt/mi_sensor
{
"battery": 87,
"linkquality": 132,
"temperature": 21.4
}Rangos orientativos
Estos rangos son una guía de lectura basada en la FAQ oficial y en la documentación de la comunidad. El RSSI óptimo depende del montaje: ni demasiado alto ni demasiado bajo, porque un receptor muy pegado al coordinador puede saturarse (discusión #6694 de Koenkk/zigbee2mqtt).
| Métrica | Fuerte | Aceptable | Débil |
|---|---|---|---|
| LQI (0-255) | ≥ 100 | 40-99 | < 40 |
| RSSI (dBm) | -60 a -40 | -70 a -60 | < -80 |
Qué hacer con el dato
- Un dispositivo con LQI por debajo de 40 retransmite más y contesta más lento. Mira si puedes acercarlo al router Zigbee más próximo.
- Un RSSI muy bueno con LQI malo apunta a interferencia, no a cobertura: toca cambiar de canal Zigbee o alejar fuentes 2,4 GHz.
- Un valor aislado no dice casi nada: graba varias muestras y mira la tendencia, no una lectura puntual.
Fuentes consultadas este mes: FAQ de Zigbee2MQTT (agosto 2026) y discusión #6694 del repositorio oficial.
Changelog de la pieza
- 30/09/2026: meta-description ajustada a rango, JSON-LD Article añadido y tabla envuelta para que haga scroll en móvil. Datos LQI/RSSI verificados contra la FAQ oficial.