Hermetry acepta datos de varias formas. Todas terminan en el mismo lugar: un dispositivo en tu lista Devices, con su telemetría, atributos, alarmas y paneles. La forma adecuada depende de lo que el dispositivo puede hacer: si puede mantener una conexión abierta, si habla LoRaWAN, si está detrás de otra caja o si solo puede ser consultado. Esta página te ayuda a elegir.
Decisión rápida
| Tu dispositivo… | Usa | Empieza aquí |
|---|---|---|
| puede mantener una conexión TCP abierta y tiene TLS (un controlador, un PC industrial, una placa microcontroladora con Wi-Fi o celular) | MQTT sobre TLS | MQTT |
| se despierta, envía y vuelve a dormir, o está en una red que bloquea MQTT | API HTTPS de dispositivos | API HTTP de dispositivos |
| es un sensor LoRaWAN con batería (EU868) | LoRaWAN, a través de una pasarela LoRaWAN | Conecta tu primer sensor LoRaWAN |
| habla Modbus, RS485 u otro bus de campo, o BLE, detrás de un router o pasarela que informa por él | Detrás de una pasarela | Dispositivos detrás de una pasarela |
| no puede conectarse por iniciativa propia pero responde a SNMP (un SAI, un switch, una impresora, un servidor) | Consultado por la plataforma (dispositivo de red) | Consulta de dispositivos por SNMP |
| es una cámara IP o un grabador | Cámara o grabador (consultado, vista en directo) | Añade una cámara o un grabador |
| es un router, pasarela o controlador licenciado fabricado para Hermetry | Reclámalo con el código de su página Cloud | Añadir y reclamar dispositivos |
Todas estas vías parten de Devices > New device. El panel ofrece una opción por cada vía que tenga tu organización, y Other device para dispositivos MQTT y HTTP.
Compara las vías
| MQTT | HTTPS | LoRaWAN | Detrás de una pasarela | Consultado | Dispositivo licenciado | |
|---|---|---|---|---|---|---|
| El dispositivo abre la conexión | Sí | Sí, por mensaje | A través de su pasarela LoRaWAN | La pasarela lo hace | No: la plataforma pregunta | Sí (MQTT) |
| Inicio de sesión | Token, MQTT básico o X.509 | Token (cabecera bearer) | Claves (OTAA o ABP) en la radio; sin inicio de sesión en la plataforma | El inicio de sesión propio de la pasarela | Credenciales de la caja, almacenadas solo para escritura | Certificado X.509 |
| Estado en línea | Conexión en vivo, mensaje reciente o última vez visto | Mensaje reciente o última vez visto | Mensaje reciente (perfil integrado) | A partir de los mensajes de conexión y desconexión de la pasarela | Solo última vez visto | Conexión en vivo |
| Comandos al dispositivo | Sí | Sí (long poll) | Downlinks sin procesar | En desarrollo | No | Sí, además de ajustes remotos y acceso remoto |
| Firmware por aire (OTA) | Sí, si el firmware lo admite | No | No | No | No | Sí |
| Cuenta para el límite de dispositivos | Cada dispositivo | Cada dispositivo | Cada pasarela y cada sensor | La pasarela y cada hijo | Cada dispositivo consultado | Cada dispositivo |
MQTT
La opción por defecto y la más completa. El dispositivo mantiene una conexión abierta, publica telemetría y atributos, y recibe comandos y cambios de atributos compartidos al instante. Usa TLS en el puerto 8883. El MQTT sin cifrar en el puerto 1883 se rechaza, salvo que un perfil lo permita para dispositivos que no pueden usar TLS.
El firmware existente que usa los temas v1/devices/me/telemetry puede conservarlos con el esquema de temas Legacy compatible, y el firmware con nombres de tema propios puede usar Custom topics. Consulta Perfiles de dispositivo.
HTTPS
Cada mensaje es un único POST con el token del dispositivo en la cabecera Authorization: Bearer. Es adecuado para dispositivos con batería y redes restrictivas. Un dispositivo también puede esperar comandos con un long poll. Los dispositivos que no pueden enviar cabeceras pueden poner el token en la URL, a costa de perder MQTT y los comandos en su perfil.
LoRaWAN
Hermetry tiene su propio servidor de red LoRaWAN para EU868, con activación OTAA y ABP, Clase A y Clase C. Registras pasarelas (pasarelas Basics Station o routers licenciados) y sensores; un codec convierte cada trama en lecturas. Consulta LoRaWAN.
Detrás de una pasarela
Una pasarela inicia sesión como ella misma e informa de sus dispositivos hijos con los temas v1/gw/*. Hermetry crea cada hijo la primera vez que la pasarela lo informa. Hasta 500 hijos por pasarela por defecto.
En desarrollo: el envío de comandos y cambios de atributos compartidos a dispositivos detrás de una pasarela está en desarrollo. Hoy la pasarela informa de sus hijos; planifica los comandos para la propia pasarela. Consulta Comandos a dispositivos detrás de una pasarela.
Consultado por la plataforma
Algunas cajas no pueden conectarse por iniciativa propia. Hermetry las alcanza mediante un endpoint: la dirección pública de la caja, sus ajustes y sus secretos de solo escritura. Hay dos tipos disponibles:
- Dispositivo de red: un agente SNMP (v3, o v2c si se activa) que la plataforma consulta en un intervalo con una plantilla (por ejemplo SAI, interfaces de red, recursos del host, impresoras).
- Cámara o grabador: una cámara IP o un grabador, para vista en directo.
La caja debe tener una dirección pública, y tu cortafuegos debe permitir las direcciones del sondeador de la plataforma. Cada resultado de consulta cuenta como un mensaje. Consulta Endpoints de protocolo.
Dispositivos licenciados
Los routers, pasarelas y controladores licenciados fabricados para Hermetry vienen con una identidad y un certificado de fábrica. Los reclamas con el código de su página Cloud local; después se conectan con su certificado y ofrecen ajustes remotos, actualizaciones de firmware y, en el caso de los routers, acceso remoto a su panel web. Un router licenciado también puede ser una pasarela LoRaWAN y una pasarela para dispositivos de campo. Consulta Dispositivos licenciados.
Preguntas que deciden
- ¿El dispositivo tiene un reloj real? Si no, deja que Hermetry asigne la hora (envía sin
ts). Nunca inventes marcas de tiempo. - ¿Tienes que enviarle comandos? Entonces usa MQTT (o HTTPS con long poll), no un dispositivo consultado ni un hijo de pasarela.
- ¿Está en un enlace móvil? MQTT con mensajes agrupados es lo más económico. Las actualizaciones de firmware por enlaces medidos esperan por defecto.
- ¿Puede usar TLS? Si no, asígnale un perfil aparte que permita MQTT sin cifrar y fija sus redes. Consulta Seguridad del transporte de dispositivos.
- ¿Cuántos del mismo tipo? Ponlos en un mismo perfil y añádelos mediante importación masiva, mediante autoaprovisionamiento, o, para LoRaWAN, mediante modo de emparejamiento.