Esta página es para personas que escriben el firmware de dispositivos o el software de pasarelas. Reúne en un solo lugar lo que Hermetry hace cuando rechaza o finaliza una conexión y cómo debe volver a conectarse un dispositivo. Los ajustes de conexión, los inicios de sesión y los motivos de desconexión que se muestran en la pestaña Log están en MQTT; las reglas generales de los dispositivos están en Protocol versions and device rules.
Los códigos CONNACK que envía Hermetry
| Código | Cuándo lo envía Hermetry | Calendario |
|---|---|---|
| 0 | El inicio de sesión es aceptado | Se restablece tras 60 segundos conectado (más abajo) |
| 1 | El CONNECT es para un nivel de protocolo que Hermetry no admite, como MQTT 5 | Detenerse. Corregir el cliente. |
| 3 | El servicio se está iniciando, deteniendo o está ocupado; la dirección del dispositivo queda bloqueada durante un breve tiempo tras inicios de sesión fallidos; un nombre de usuario MQTT se retiene tras contraseñas incorrectas repetidas; el dispositivo se retiene tras una disputa por la toma de control; la plataforma está bajo carga y retiene a su organización | Normal |
| 4 | Token de acceso desconocido, nombre de usuario o contraseña MQTT incorrectos, o un CONNECT sin nombre de usuario | Largo |
| 5 | No autorizado: el dispositivo está deshabilitado, su certificado está revocado o caducado, la organización está suspendida o ha alcanzado su límite de dispositivos o de dispositivos conectados, o el perfil no permite el tipo de inicio de sesión, la red o el puerto | Largo |
Hermetry no envía CONNACK 2 con MQTT 3.1.1. El ID de cliente nunca es motivo para rechazar un inicio de sesión: se acepta cualquier ID de cliente y la sesión se registra con el número de serie del dispositivo (o con su ID de dispositivo si no tiene número de serie). El motivo de un código nunca se envía al dispositivo; se escribe en la pestaña Log del dispositivo.
Conexiones cerradas sin CONNACK
Algunas conexiones se cierran antes de que pueda enviarse un CONNACK. El dispositivo solo ve un socket cerrado y sigue el calendario normal.
| Situación | Predeterminado |
|---|---|
| El handshake TLS y el CONNECT no se completan a tiempo | 5 segundos desde la conexión TCP |
| Demasiadas conexiones desde la misma dirección pública inician sesión en el mismo momento | 64 por dirección en cada nodo del broker |
| La dirección se bloquea tras inicios de sesión fallidos | Más de 10 inicios de sesión fallidos en 5 minutos bloquean la dirección durante 60 segundos |
Sesiones que Hermetry finaliza
Hermetry no envía un código de motivo en una desconexión: el dispositivo ve que la conexión se cierra. Qué debe hacer a continuación:
| Por qué terminó la sesión | Qué hacer |
|---|---|
| No llegó nada durante 1,5 veces el keepalive | Volver a conectar según el calendario normal. Compruebe que el dispositivo envía PINGREQ cuando está inactivo. |
| Otra conexión del mismo dispositivo tomó el control | Volver a conectar según el calendario normal. Si se repite, dos dispositivos comparten una misma credencial. |
| La credencial fue rotada o revocada, el dispositivo fue deshabilitado o eliminado, o la organización fue suspendida (se vuelve a comprobar aproximadamente cada 60 segundos) | Volver a conectar según el calendario normal. El siguiente CONNACK (4 o 5) pasa el dispositivo al calendario largo. |
| El dispositivo superó repetidamente su límite de tasa | Volver a conectar según el calendario normal y, después, enviar menos. Consulte Device profiles. |
| Un nodo del broker se reinicia | Sus conexiones se cierran durante unos 30 segundos en orden aleatorio. Volver a conectar según el calendario normal; un CONNECT que llega a un nodo que se está apagando recibe CONNACK 3. |
| Un mensaje no pudo ponerse en cola (no recibió PUBACK) | La sesión se cierra unos 5 segundos después. Volver a conectar y, después, enviar de nuevo los mensajes no confirmados. |
Keepalive
- Conecte con un keepalive de 60 segundos y envíe PINGREQ cuando no tenga nada más que enviar.
- Hermetry cierra una sesión cuando no llega nada durante 1,5 veces el keepalive: 90 segundos con 60.
- Un keepalive de 0, o uno superior al máximo del broker (300 segundos por defecto), se atiende con el máximo.
- Un mensaje Will se acepta y se ignora. Hermetry decide por sí mismo el estado de la conexión.
Los dos calendarios de reintento
| Calendario normal | Calendario largo | |
|---|---|---|
| Se usa tras | Una red caída, un socket cerrado, CONNACK 3 | El primer CONNACK 4 o 5 |
| Primera espera | 1 segundo (un dispositivo puede empezar hasta a los 5 segundos) | 5 minutos (un dispositivo puede empezar hasta a los 15 minutos) |
| Esperas siguientes | Se duplica en cada intento | Se duplica en cada intento |
| Espera más larga | 5 minutos (hasta 30 minutos mientras el enlace activo del dispositivo es medido) | 1 hora |
| Jitter | Cada espera multiplicada por un factor aleatorio entre 0,5 y 1,5 | Igual |
Reglas que acompañan a los calendarios:
- Restablezca el calendario tras una conexión que haya durado al menos 60 segundos. Una conexión que se cae antes no lo restablece, así que un dispositivo que el servidor cierra continuamente no se reconecta en un bucle cerrado.
- El calendario normal también vuelve a empezar cuando el dispositivo cambia su enlace activo, por ejemplo de Ethernet a datos móviles.
- Tras un arranque o una actualización de firmware, espere entre 0 y 30 segundos aleatorios antes del primer intento. Así, una oleada de dispositivos actualizados no se reconecta en un pico único.
- Deténgase ante CONNACK 1 hasta que el cliente se corrija.
El calendario largo devuelve un dispositivo a la conexión en unos 90 minutos tras corregir el problema, por ejemplo después de volver a habilitar el dispositivo o de subir el plan.
/* Wait before reconnect attempt n (n = 0, 1, 2 ...), in seconds. */
double backoff_s(int n, int long_schedule)
{
double first = long_schedule ? 300.0 : 1.0;
double cap = long_schedule ? 3600.0 : 300.0;
double wait = first * pow(2.0, n);
if (wait > cap)
wait = cap;
return wait * (0.5 + (double)rand() / RAND_MAX); /* factor 0.5 to 1.5 */
}
Consejo
Inicialice el generador aleatorio de forma distinta en cada dispositivo, por ejemplo a partir de su número de serie y de una fuente de aleatoriedad de hardware. Los dispositivos que comparten semilla eligen las mismas esperas y siguen llegando a la vez.
Contraseñas incorrectas repetidas
Tras más de 5 inicios de sesión fallidos (CONNACK 4) para un mismo nombre de usuario MQTT desde una misma red en 15 minutos, a ese nombre de usuario se le responde CONNACK 3 durante 15 segundos, duplicándose con cada nuevo fallo hasta 5 minutos. Un dispositivo que ha recibido un CONNACK 4 y después recibe CONNACK 3 suele seguir usando la contraseña incorrecta: manténgalo en el calendario largo hasta que una conexión tenga éxito.
Mediante la API HTTP del dispositivo
| Estado | Significado | Qué hacer |
|---|---|---|
429 rate_limited | Se supera la tasa del dispositivo o de la organización, o la tasa de peticiones de la dirección del cliente (50 por segundo, con ráfagas de 200, por defecto) | La petición no se guardó. Espere los segundos indicados en Retry-After y envíela de nuevo. |
429 blocked | La dirección se bloquea tras inicios de sesión fallidos | Espere los segundos indicados en Retry-After (el resto del bloqueo). Corrija el token. |
503 | El servicio está ocupado, no está listo o se está apagando, o retiene a su organización | Espere los segundos indicados en Retry-After (30) y después siga el calendario normal. |
401 | Sin token, o un token desconocido | Calendario largo. Compruebe el token. |
403 | No autorizado: dispositivo deshabilitado, organización suspendida, fuera de las redes permitidas por el perfil, o una regla del perfil (tls_required, quarantined) | Calendario largo, o corrija la configuración. |
400, 413 | El propio mensaje es incorrecto o demasiado grande | No vuelva a enviar el mismo mensaje. |
Cuando el dispositivo vuelve a estar disponible
Siga el orden de conexión de MQTT: suscribirse, enviar hello, pedir los atributos compartidos y, después, enviar las lecturas almacenadas antes que las lecturas en vivo. Dos puntos son importantes tras una interrupción larga:
- Las lecturas almacenadas deben ajustarse a la tasa de reenvío que el dispositivo encuentra en el atributo compartido
session_limits. No envíe todo el buffer tan rápido como permita el enlace. - Tras una interrupción, muchos dispositivos piden sus ajustes al mismo tiempo, y Hermetry los regula. Las secciones de ajustes que falten en la respuesta pueden llegar momentos después por
v1/attributes/set, con la misma forma. Aplíquelas en cuanto lleguen.

