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
- 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. - 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). - 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 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 ú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á presente. |
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 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}}
}
tses 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.valuessigue 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
metaopcional con datos sobre la lectura, por ejemplo"meta": {"lora": {"rssi": -97, "snr": 7.5}}.metaocupa como máximo 256 bytes. Nunca se almacena como lectura. Solo sus miembrosloraysnmp(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 untsque 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
typeenviado enconnect; 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 sintypeomite 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 con2,3y 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
| 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 distintos de una misma pasarela |
| Unicidad | Por 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ímite | Valor |
|---|---|
| Hijos por pasarela | El 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 dispositivos | Cada hijo cuenta para el límite de dispositivos de su plan |
| Un mensaje de pasarela | Como máximo 64 KiB, o el Max message payload (bytes) del perfil de la pasarela si es menor |
| Hijos en un mensaje | 500; los demás se omiten |
| Registros por hijo en un mensaje | 1.000; los demás se omiten |
meta por registro | 256 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
connectydisconnectestablecen 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íntoma | Causa 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 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 un perfil incorrecto | El 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 nombres | Ya existía un dispositivo con el nombre del cable, así que el hijo se llamó <wire name> · <gateway name>. |

