Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Dispositivos detrás de una pasarela

Cómo una pasarela notifica dispositivos de campo como dispositivos hijos en los temas v1/gw: cargas útiles, creación de hijos, perfiles, nombres y límites.

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 detrás de una pasarela.

Una pasarela licenciada que ejecuta Hermetry Edge hace todo esto por usted; consulte Pasarelas licenciadas y Hermetry Edge. Siga leyendo si escribe su propio software de pasarela o quiere saber qué ocurre con los datos.

En la nube de Hermetry, los dispositivos de campo se leen a través de Hermetry Edge; el software de pasarela propio es para instalaciones locales (on-premises).

Configurar el dispositivo pasarela

  1. Cree o elija un perfil de dispositivo para la pasarela. Debe usar el esquema de temas v1/ predeterminado. El esquema Legacy compatible no incluye la API de pasarela.
  2. En Devices > New device, añada la pasarela y active This device is a gateway. Un dispositivo sin esta opción se rechaza en todos los temas v1/gw/* (forbidden_topic).
  3. 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.
  4. Opcional: en el perfil de la pasarela, configure Profile of new children y Max children of a gateway (véase más abajo).

La pasarela inicia sesión como ella 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 útilSignificado
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á presente.
v1/gw/telemetryVéase más abajoLecturas 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 indexado por el nombre del 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 o 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 notifica, mediante connect, telemetría o atributos. Un hijo que aparece en telemetría sin un connect previo 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 Profile of new children del perfil de la pasarela; si no, el Generic child profile integrado, que Hermetry crea la primera vez que se necesita. Un hijo anunciado sin type omite el primer paso.
  • Nombre del dispositivo: el nombre del hijo en el cable. Si ya existe en su organización un dispositivo con ese nombre, el nombre pasa a ser <wire name> · <gateway name> y, después, ese nombre con 2, 3 y así sucesivamente.
  • Renombrar el hijo en Hermetry no cambia su nombre en el cable. La pasarela seguirá refiriéndose a él por el nombre que envió.
  • Los primeros registros de un hijo recién creado pueden descartarse mientras se crea. Hermetry pide el hijo una vez y el siguiente mensaje lo encuentra.

Nombres de los hijos

ReglaValor
LongitudDe 1 a 128 caracteres
No permitidoCaracteres de control, espacio al principio o al final
MayúsculasDistingue mayúsculas: abc y ABC son dos hijos distintos de una misma pasarela
UnicidadPor pasarela

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

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

Límites

LímiteValor
Hijos por pasarelaEl Max children of a gateway del perfil (por defecto 500), nunca por encima del valor de su plan (500 si el plan no indica ninguno) ni del máximo de la plataforma, 1.000
Límite de dispositivosCada hijo cuenta para el límite de dispositivos de su plan
Un mensaje de pasarelaComo máximo 64 KiB, o el Max message payload (bytes) del perfil de la pasarela si es menor
Hijos en un mensaje500; los demás se omiten
Registros por hijo en un mensaje1.000; los demás se omiten
meta por registro256 bytes

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

Los límites de frecuencia se aplican dos veces. Primero, los límites del perfil propio del gateway cuentan el mensaje completo, incluidos 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ímites 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 elimina en un minuto aproximadamente: sus registros ya no se aceptan.

Solución de problemas

SíntomaCausa y solución
La pasarela se desconecta tras algunos mensajes v1/gw/*El dispositivo no está marcado como pasarela. Tres temas rechazados en un minuto cierran la sesión. Active This device is a gateway.
No aparece ningún hijoEl 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 un perfil incorrectoEl type no coincide exactamente con el nombre de un perfil. Renombre el perfil o configure Profile of new children 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 nombresYa existía un dispositivo con el nombre del cable, así que el hijo se llamó <wire name> · <gateway name>.

Relacionado