Un dispositivo es cualquier cosa que envía datos a Hermetry o recibe comandos de él: un sensor, un controlador, un contador, una cámara, una pasarela LoRaWAN, un router licenciado. Cada dispositivo pertenece a una organización y usa exactamente un perfil de dispositivo. Esta sección explica cómo añadir dispositivos, conectarlos, mantener sus credenciales a salvo, leer su estado, enviarles comandos, actualizar su firmware y cambiar sus ajustes.
El modelo de dispositivo
| Parte | Qué es | Leer |
|---|---|---|
| Dispositivo | Un registro en Dispositivos: nombre (único en tu organización), etiqueta, tipo, perfil, estado, número de serie opcional y si es una pasarela. | La lista de Dispositivos y la página del dispositivo |
| Perfil de dispositivo | Los ajustes compartidos por un mismo tipo de dispositivo: transporte, inicios de sesión, topics, límites, regla de conexión, claves de telemetría y configuración, aprovisionamiento, además de reglas de alarma, comandos y firmware. | Perfiles de dispositivo |
| Credencial | Aquello con lo que el dispositivo inicia sesión. Como máximo una credencial activa por dispositivo. | Credenciales de dispositivo |
| Telemetría | Lecturas con marca de tiempo, una serie por clave. | Telemetría y datos |
| Atributos | Valores que describen o configuran el dispositivo: client (del propio dispositivo), shared (enviados al dispositivo) y server (guardados en la plataforma). | Atributos |
| Estado de conexión | Online u offline según la regla del perfil, última conexión y registro de conexiones. | Estado de conexión y actividad |
| Ubicación | El sitio, edificio, sala o máquina donde se encuentra el dispositivo. | Ubicar dispositivos |
Cómo llegan los dispositivos a Hermetry
| Vía | Para | Página |
|---|---|---|
| MQTT 3.1.1 sobre TLS | Dispositivos que mantienen una conexión abierta | MQTT, Referencia de topics y payloads de MQTT |
| HTTPS | Dispositivos que se despiertan, envían y vuelven a dormir, o redes que bloquean MQTT | API HTTP de dispositivos |
| LoRaWAN | Sensores de batería tras pasarelas LoRaWAN | LoRaWAN |
| A través de una pasarela | Dispositivos de campo tras un router o pasarela que informa por ellos | Pasarelas y dispositivos tras una pasarela |
| Consultados por la plataforma | Equipos que no pueden conectarse por sí mismos: agentes SNMP, cámaras IP y grabadores | Pasarelas y dispositivos tras una pasarela |
¿No sabes cuál encaja? Consulta Elige cómo conectar tus dispositivos.
Cómo entran los dispositivos en tu organización
| Vía | Úsalo para | Página |
|---|---|---|
| Nuevo dispositivo (manual) | Unos pocos dispositivos que configuras tú mismo | Añadir y reclamar dispositivos |
| Importar desde un archivo CSV | Decenas o cientos de dispositivos a la vez (hasta 1.000 filas por archivo) | Importar dispositivos en lote |
| Autoaprovisionamiento con una clave de perfil | Muchos dispositivos idénticos que se registran solos en el primer arranque | Añadir y reclamar dispositivos, Cuarentena |
| Reclamar | Dispositivos licenciados, con el código de su página de Cloud | Dispositivos licenciados |
| Una pasarela registra un nuevo hijo | Dispositivos de campo tras una pasarela | Dispositivos tras una pasarela |
| Registro LoRaWAN o modo de emparejamiento | Sensores LoRaWAN | Añadir un dispositivo OTAA, Modo de emparejamiento |
Cómo demuestran los dispositivos quiénes son
| Credencial | Inicio de sesión |
|---|---|
| Token de acceso | Usuario MQTT = token, contraseña vacía. HTTP: Authorization: Bearer <token>. |
| MQTT básico | Usuario y contraseña, opcionalmente fijados a un único ID de cliente. |
| Certificado X.509 | Un certificado de cliente emitido por la autoridad de certificación de dispositivos de Hermetry. Lo usan los dispositivos licenciados. |
Los secretos se muestran una sola vez, cuando se emiten o rotan. Hermetry solo almacena hashes. Los sensores LoRaWAN, los hijos de pasarela y los dispositivos consultados no tienen credencial propia: su pasarela, el servidor de red o el sondeador aportan sus datos.
Estado del dispositivo
| Estado | Significado |
|---|---|
| Activo | El dispositivo puede conectarse y sus datos se almacenan. |
| Desactivado | El dispositivo es rechazado al conectarse. Su conexión activa termina al desactivarlo. |
| En cuarentena | El dispositivo se registró por sí mismo y espera aprobación. Puede conectarse, pero sus datos se descartan hasta que un administrador lo active. Cuenta para su límite de dispositivos. |
El estado es independiente del estado de conexión. Un dispositivo activo puede estar Online, Offline, Nunca conectado, o mostrar solo Última conexión, según la regla de conexión de su perfil.
Permisos
| Permiso | Rol mínimo por defecto |
|---|---|
| Ver dispositivos | Usuario |
| Crear dispositivos | Administrador |
| Editar y desactivar dispositivos | Administrador |
| Eliminar dispositivos | Administrador |
| Gestionar credenciales de dispositivo | Administrador |
| Ver atributos de dispositivo | Usuario |
| Escribir atributos server y shared de dispositivo | Administrador |
Otros módulos IoT añaden sus propios permisos (comandos, firmware, alarmas, LoRaWAN, ajustes). Consulta la Referencia de permisos.
Límites
Tu plan fija el número de dispositivos que puedes tener. Cada dispositivo cuenta: los dispositivos en cuarentena, las pasarelas y sensores LoRaWAN, los hijos de pasarela y los dispositivos consultados. Al alcanzar el límite, los nuevos dispositivos se rechazan con el mensaje de que se ha alcanzado el límite de dispositivos del plan. Consulta Planes y el complemento IoT.
En esta sección
Básico
- La lista de Dispositivos y la página del dispositivo
- Perfiles de dispositivo
- Añadir y reclamar dispositivos
- Importar dispositivos en lote
- Cuarentena para dispositivos autorregistrados
- Credenciales de dispositivo
- Atributos
- Estado de conexión y actividad
Conexión
- MQTT
- Referencia de topics y payloads de MQTT
- API HTTP de dispositivos
- LoRaWAN
- Pasarelas y dispositivos tras una pasarela
Gestión remota de dispositivos

