Dispositivos detrás de una pasarela

Una pasarela recopila datos de dispositivos de campo que no pueden conectarse a Hermetry por sí mismos (contadores Modbus, controladores RS485, sensores BLE y otros) y los envía por su propia conexión. Hermetry convierte cada dispositivo de campo en un dispositivo hijo: un dispositivo propio con lecturas, atributos, alarmas y paneles. Esta página es la referencia completa del lado de la pasarela. Para un resumen breve, consulte Pasarelas y dispositivos tras una pasarela.

Una pasarela con licencia que ejecute Hermetry Edge hace todo esto por usted; consulte Pasarelas con licencia y Hermetry Edge. Siga leyendo si escribe usted mismo el software de la pasarela o desea saber qué ocurre con los datos.

Configurar el dispositivo pasarela

Cree o elija un perfil de dispositivo para la pasarela. Debe usar el esquema de temas v1/ predeterminado. El esquema Compatible con versiones anteriores no incluye la API de pasarela.
En Dispositivos > Nuevo dispositivo, añada la pasarela y active Este dispositivo es una pasarela. Un dispositivo sin esta opción es rechazado en todos los temas v1/gw/* (forbidden_topic).
Asigne a la pasarela sus credenciales (token de acceso, MQTT básico o certificado X.509), como para cualquier dispositivo MQTT. Consulte Credenciales del dispositivo.
Opcional: en el perfil de la pasarela, configure Perfil de nuevos hijos y Máximo de hijos de una pasarela (véase más abajo).

La pasarela inicia sesión como sí misma. Los hijos nunca reciben credenciales propias y nunca inician sesión.

Temas y cargas útiles

Todos los temas de la pasarela usan QoS 1.

Tema (de la pasarela a Hermetry)	Carga útil	Significado
`v1/gw/connect`	`{"device": "Meter A", "type": "lorawan-meter"}`	El hijo está presente. `type` es opcional y elige el perfil del hijo.
`v1/gw/disconnect`	`{"device": "Meter A"}`	El hijo ya no está.
`v1/gw/telemetry`	Véase más abajo	Lecturas de uno o más hijos.
`v1/gw/attributes`	`{"Meter A": {"lora.rssi": -97}}`	Atributos de cliente de uno o más hijos.

La telemetría es un objeto con clave por nombre de hijo. Cada hijo contiene un registro o una lista de registros:

{
  "Meter A": [
    {"ts": 1759572000000, "values": {"kwh": 1203.4, "voltage": 229.8}},
    {"ts": 1759572060000, "values": {"kwh": 1203.6, "voltage": 230.1}}
  ],
  "Meter B": {"values": {"flow_m3h": 12.7}}
}

ts es la hora en milisegundos en que se obtuvo el valor. Omítalo si el reloj de la pasarela no está configurado; Hermetry usará entonces la hora de llegada. Consulte Marcas de tiempo, lecturas tardías y duplicadas.
values sigue las mismas reglas de claves y valores que la telemetría de cualquier dispositivo. Consulte Claves de telemetría.
Un registro puede incluir un objeto meta opcional con datos sobre la lectura, por ejemplo "meta": {"lora": {"rssi": -97, "snr": 7.5}}. meta ocupa como máximo 256 bytes. Nunca se almacena como lectura. Solo sus miembros lora y snmp (cada uno con como máximo 8 valores simples) se pasan a sus flujos como metadatos del mensaje; el resto se ignora.
Un registro sin values, o con un ts que no sea un número positivo, se omite. El resto del mensaje se conserva.

Un atributo de cliente opcional time_quality en un hijo, {"source": true, "arrival": false, "synced": true}, indica si las marcas de tiempo proceden del reloj propio del hijo, de la hora de llegada a la pasarela, y si el reloj de la pasarela estaba sincronizado. Es solo informativo.

Cómo se crean los hijos

Hermetry crea un hijo la primera vez que la pasarela lo informa, mediante connect, telemetría o atributos. Un hijo visto en telemetría sin un connect se considera conectado.

El hijo pertenece a la organización de la pasarela. Nunca se reclama por separado.
Perfil, en este orden: un perfil de su organización con el nombre exacto del type enviado en connect; si no, el Perfil de nuevos hijos del perfil de la pasarela; si no, el Perfil genérico de hijo integrado, que Hermetry crea la primera vez que hace falta. Un hijo anunciado sin type omite el primer paso.
Nombre del dispositivo: el nombre del hijo tal como se envía. Si ya existe un dispositivo con ese nombre en su organización, el nombre pasa a ser <nombre enviado> · <nombre de la pasarela> y, después, ese nombre con 2, 3 y así sucesivamente.
Renombrar el hijo en Hermetry no cambia su nombre enviado. La pasarela seguirá direccionándolo por el nombre que envió.
Los primeros registros de un hijo recién creado pueden perderse mientras se crea. Hermetry solicita el hijo una vez y el mensaje siguiente lo encuentra.

Nombres de los hijos

Regla	Valor
Longitud	De 1 a 128 caracteres
No permitido	Caracteres de control, espacio al principio o al final
Mayúsculas	Distingue mayúsculas: `abc` y `ABC` son dos hijos de una misma pasarela
Unicidad	Por pasarela

Un nombre que incumpla una regla se omite y se contabiliza; los demás hijos del mensaje se conservan.

Un dispositivo que se conecta directamente tiene prioridad. Si el nombre del hijo es igual al número de serie de un dispositivo de su organización que tiene credenciales propias (sin distinguir mayúsculas), el hijo es rechazado (child_conflict_direct) y no se crea. Así se evita que un dispositivo con su propia sesión en la nube aparezca dos veces.

Límites

Límite	Valor
Hijos por pasarela	El Máximo de hijos de una pasarela del perfil (predeterminado 500), nunca por encima del valor de su plan (500 si el plan no indica ninguno) ni del límite de la plataforma de 1.000
Límite de dispositivos	Cada hijo cuenta para el límite de dispositivos de su plan
Un mensaje de pasarela	Como máximo 64 KiB, o el Tamaño máximo de carga útil del mensaje (bytes) del perfil de la pasarela si es menor
Hijos en un mensaje	500; los que excedan se omiten
Registros por hijo en un mensaje	1.000; los que excedan se omiten
`meta` por registro	256 bytes

Un hijo que superaría el límite de hijos o el de dispositivos es rechazado (child_limit o device_limit), y sus registros se descartan.

Los límites de frecuencia se aplican dos veces. Primero, los límites del propio perfil de la pasarela cuentan el mensaje completo, incluidos todos los puntos de datos de cada hijo. Después, los límites del perfil de cada hijo se aplican a su parte: un hijo que supere sus límites pierde solo sus propios registros (child_rate_limited). Consulte Perfiles de dispositivo para los campos de límite y Cuota de mensajes y uso.

Estado de la conexión

connect y disconnect establecen el estado de conexión del hijo.
Cuando la pasarela se desconecta, todos sus hijos pasan a desconectados con ella.
Un hijo deshabilitado se descarta en aproximadamente un minuto: sus registros dejan de aceptarse.

Comandos a los hijos

El envío de comandos y los cambios de atributos compartidos a un hijo a través de su pasarela está en desarrollo. No construya sobre ello todavía. Consulte Comandos a dispositivos tras una pasarela.

Resolución de problemas

Síntoma	Causa y solución
La pasarela se desconecta después de algunos mensajes `v1/gw/*`	El dispositivo no está marcado como pasarela. Tres temas rechazados en un minuto cierran la sesión. Active Este dispositivo es una pasarela.
No aparece ningún hijo	El nombre del hijo incumple una regla, se ha alcanzado el límite de hijos o de dispositivos, o un dispositivo directo usa ese número de serie. Compruebe el recuento de dispositivos en el uso.
Un hijo tiene el perfil incorrecto	El `type` no coincide exactamente con el nombre de un perfil. Renombre el perfil o configure Perfil de nuevos hijos en el perfil de la pasarela. Para cambiar el perfil de un hijo existente, hágalo en la página del dispositivo hijo.
Un hijo muestra dos nombres	Ya existía un dispositivo con el nombre enviado, por lo que el hijo se llamó `<nombre enviado> · <nombre de la pasarela>`.