Dispositivos – Hermetry

Un dispositivo es cualquier elemento 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, consultar su estado, enviarles comandos, actualizar su firmware y cambiar su configuración.

El modelo de dispositivo

Parte	Qué es	Leer
Dispositivo	Un registro en Dispositivos: nombre (único en su organización), etiqueta, tipo, perfil, estado, número de serie opcional e indicación de 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, temas, 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 (almacenados en la plataforma).	Atributos
Estado de conexión	En línea o fuera de línea según la regla del perfil, última vez visto, registro de conexión.	Estado de conexión y actividad
Ubicación	El emplazamiento, edificio, sala o máquina donde está el dispositivo.	Ubicación de 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 temas y cargas MQTT
HTTPS	Dispositivos que se despiertan, envían y vuelven a dormir, o redes que bloquean MQTT	API HTTP de dispositivos
LoRaWAN	Sensores con batería tras pasarelas LoRaWAN (EU868)	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 sabe cuál le conviene? Consulte Elija cómo conectar sus dispositivos.

Cómo entran los dispositivos en su organización

Vía	Úsela para	Página
Nuevo dispositivo (manual)	Unos pocos dispositivos que configura usted mismo	Añadir y reclamar dispositivos
Importar desde un archivo CSV	Decenas a 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 notifica 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 prueban 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.
Deshabilitado	Se rechaza el dispositivo al conectarse. Su conexión activa finaliza al deshabilitarlo.
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 mostrarse como En línea, Fuera de línea, Nunca conectado o solo Última vez visto, 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 deshabilitar 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 de IoT añaden sus propios permisos (comandos, firmware, alarmas, LoRaWAN, ajustes). Consulte la Referencia de permisos.

Límites

Su plan define el número de dispositivos que puede tener. Cuenta cada dispositivo: 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. Consulte Planes y el complemento de IoT.

En esta sección

Básico

Conexión

Gestión remota de dispositivos