Esta página responde a las preguntas que más suelen hacer los nuevos clientes y los desarrolladores de firmware. Cada respuesta es breve y enlaza con la página con todos los detalles.
Primeros pasos
¿Qué necesito para conectar mi primer dispositivo?
Una organización, un miembro con el rol Admin (crear dispositivos lo necesita por defecto) y un dispositivo o un ordenador que pueda ejecutar un cliente MQTT o curl. La red debe permitir el tráfico TCP saliente por el 8883 (MQTT sobre TLS) o por el 443 (HTTPS). Consulta Conecta tu primer dispositivo.
¿Dónde encuentro el nombre de host al que se conectan mis dispositivos?
En la tarjeta Detalles de conexión de la página del dispositivo. Muestra el host del broker, el puerto y la dirección HTTPS de ese dispositivo. Consulta Nombres de host, puertos y direcciones IP.
¿Qué puertos debe permitir nuestro cortafuegos?
TCP 8883 saliente para MQTT sobre TLS, y 443 para la aplicación y la API HTTP de los dispositivos. Las pasarelas LoRaWAN usan el puerto indicado en su dirección del servidor de red; si no muestra ninguno, el 443. No es necesario que entre tráfico, salvo para los dispositivos que Hermetry consulta, como los agentes SNMP y las cámaras. Consulta Nombres de host, puertos y direcciones IP.
¿Qué navegadores podemos usar?
Chrome, Edge y Firefox 111 o posterior, y Safari 16.4 o posterior. Las passkeys, las notificaciones push, las vistas 3D y el vídeo de cámaras tienen requisitos adicionales. Consulta Navegadores compatibles.
Conexión de dispositivos
¿Qué protocolos pueden usar mis dispositivos?
MQTT sobre TLS, la API de dispositivos HTTPS y LoRaWAN a través del servidor de red de Hermetry. Los dispositivos que no pueden conectarse por sí mismos pueden ser consultados (SNMP, cámaras) o informar a través de una pasarela. Consulta Elige cómo conectar.
¿Es compatible MQTT 5?
No. Hermetry usa MQTT 3.1.1 (nivel de protocolo 4). Un CONNECT para MQTT 5 se rechaza con el código de retorno 1 de CONNACK. Consulta MQTT.
¿Puede conectarse un dispositivo sin TLS?
Solo si su perfil de dispositivo permite MQTT sin cifrar en el puerto 1883. Por defecto, los perfiles solo admiten TLS (puerto 8883), y un dispositivo que inicie sesión en el puerto 1883 será rechazado. Consulta Seguridad del transporte de dispositivos.
¿Cómo demuestra un dispositivo quién es?
Con un token de acceso (el nombre de usuario MQTT, o un token Bearer sobre HTTPS), con un nombre de usuario y contraseña MQTT, o con un certificado X.509. Cada dispositivo debe tener su propia credencial. Consulta Credenciales de dispositivo.
¿Con qué tema y carga útil envío la telemetría?
Publica un objeto JSON en v1/telemetry, por ejemplo {"temperature": 21.5}, o un objeto con ts y values. Consulta Referencia de temas y cargas útiles MQTT.
Nuestro firmware ya publica en v1/devices/me/telemetry. ¿Tenemos que cambiarlo?
No, si asignas a su perfil el esquema de temas Compatible con legado. Ese esquema solo transporta telemetría y atributos, sin temas de comandos. Consulta Referencia de temas y cargas útiles MQTT.
¿Qué tamaño puede tener un mensaje?
64 KiB por defecto. Un perfil puede fijar su límite de carga útil entre 1 KiB y 64 KiB. Consulta Perfiles de dispositivo.
¿Qué ocurre con las lecturas con una marca de tiempo incorrecta?
Una lectura con más de 10 minutos de adelanto se descarta, no se corrige; la configuración de telemetría de la organización puede cambiar ese margen. Una lectura sin marca de tiempo recibe la hora en que llegó, por lo que un dispositivo sin reloj sincronizado debe omitir la marca de tiempo. Consulta Marcas de tiempo, lecturas tardías y duplicadas.
Firmware y acceso remoto
¿Cómo llegan las actualizaciones de firmware a un dispositivo?
Hermetry escribe la actualización como atributos compartidos, incluido fw_url, un enlace HTTPS de descarga de corta duración (15 minutos por defecto). El dispositivo descarga, verifica e instala la imagen e informa de su progreso en fw_state. No se puede asignar una imagen sin firmar salvo que el perfil lo permita. Consulta Actualizaciones de firmware (OTA).
¿Podemos abrir el panel web de un router sin una dirección IP fija?
Sí, para routers con licencia reclamados cuyo firmware lo admita. El router establece la conexión saliente cuando seleccionas Abrir panel, así que no hace falta abrir ningún puerto en la instalación. Un router admite como máximo 3 sesiones abiertas. Consulta Acceso remoto al panel de un router.
Organización y seguridad
¿Podemos usar nuestro propio dominio?
Cada organización tiene una dirección gratuita bajo el dominio de la plataforma. Un dominio personalizado, como iot.example.com, está disponible si tu plan incluye dominios personalizados; tú creas los registros DNS y el certificado se gestiona por ti. Consulta Direcciones web y dominios personalizados.
¿Por qué los correos de inicio de sesión llegan desde el remitente de la plataforma y no desde el nuestro?
Los códigos de inicio de sesión, restablecimientos de contraseña, verificaciones y enlaces de invitación siempre pasan por el servicio de correo propio de la plataforma, para que ningún otro servidor de correo pueda leerlos. Aun así, llevan la marca de tu organización. Consulta Correos de cuenta y seguridad.
¿Cómo podemos proteger el inicio de sesión de nuestros miembros?
Los miembros pueden añadir passkeys, una aplicación de autenticación, o códigos por correo electrónico o SMS, y un propietario puede exigir la verificación en dos pasos a todos los miembros. Consulta Inicio de sesión en dos pasos y passkeys.

