Conecte su primer dispositivo

Esta página conecta un dispositivo que inicia sesión con un token de acceso. Tarda unos cinco minutos. Puede usar el dispositivo real o un ordenador con un cliente MQTT o curl que lo sustituya. Para sensores LoRaWAN, siga Conecte su primer sensor LoRaWAN en su lugar; para dispositivos con licencia, consulte Añadir y asignar dispositivos.

Lo que necesita

• El rol Admin o Owner (permiso para crear dispositivos y gestionar sus credenciales).
• Un cliente MQTT 3.1.1 con TLS, o curl. Los ejemplos usan mosquitto_pub, el cliente que también muestra la página del dispositivo.
• Acceso saliente al puerto TCP 8883 (MQTT sobre TLS) o 443 (HTTPS).

1. Añada el dispositivo

1. Abra Dispositivos en el menú de IoT.
2. Seleccione Nuevo dispositivo. El panel pregunta ¿Qué está añadiendo? cuando se ofrecen varias opciones; elija Otro dispositivo («Cualquier otro dispositivo: asígnele un nombre y un perfil, y recibirá un token de acceso.»).
3. Rellene el formulario:

Campo	Qué introducir
Nombre	Un nombre único en su organización, por ejemplo boiler-07. Obligatorio, hasta 128 caracteres.
Etiqueta	Texto libre opcional, por ejemplo Sala de calderas, norte.
Perfil de dispositivo	Mantenga por ahora El perfil predeterminado. Más adelante puede pasar el dispositivo a otro perfil.
Este dispositivo es una puerta de enlace	Déjelo desactivado. Actívelo solo para un dispositivo que informe por otros dispositivos.

1. Seleccione Crear dispositivo.

El panel muestra Nuevo secreto: Cópielo ahora: se muestra una sola vez y no se puede volver a leer. con el Token de acceso del dispositivo, y una tarjeta Detalles de conexión que ya incluye el token en sus líneas de ejemplo.

Si no se muestra ningún token, su organización ha desactivado Emitir un token de acceso para nuevos dispositivos (Dispositivos > ⋯ > Ajustes). En ese caso el dispositivo se crea sin credencial; consulte Credenciales de dispositivo.

2. Lea los detalles de conexión

La tarjeta Detalles de conexión muestra:

Elemento	Significado
Broker MQTT	El host y el puerto a los que se conecta el dispositivo.
Seguridad	TLS (mqtts): el certificado del servidor es público, o MQTT sin cifrar cuando el perfil lo permite.
Inicio de sesión	Usuario = el token de acceso, contraseña vacía, cualquier ID de cliente
Tema de telemetría y Tema de atributos	Donde el dispositivo publica.
Comandos (suscripción)	Donde el dispositivo escucha los comandos.
Telemetría HTTPS y Cabecera	La dirección y la cabecera para dispositivos que usan HTTPS.
Mensaje de ejemplo (JSON), Enviar con mosquitto_pub, Enviar con curl	Líneas que puede copiar y ejecutar.

Después, los administradores encuentran la misma tarjeta en la pestaña Credenciales del dispositivo (con un marcador de posición en lugar del token).

3. Envíe un mensaje por MQTT

Inicie sesión con el token como usuario y una contraseña vacía, y publique un objeto JSON en v1/telemetry con QoS 1:

mosquitto_pub -h <broker host> -p 8883 \
  --capath /etc/ssl/certs \
  -u "<ACCESS_TOKEN>" \
  -i boiler-07 \
  -q 1 \
  -t v1/telemetry \
  -m '{"temperature": 21.5, "humidity": 40}'

• Use el nombre de host que muestra la tarjeta. TLS necesita el nombre, no una dirección IP.
• El ID de cliente puede tener de 1 a 64 caracteres de A–Z a–z 0–9 . _ : -.
• Hermetry guarda cada clave como una serie propia y marca los valores con la hora en que los recibe.

3b. O envíelo por HTTPS

curl -X POST "https://<device host>/api/v1/telemetry" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"temperature": 21.5, "humidity": 40}'

Una respuesta 200 con cuerpo vacío significa que el mensaje fue aceptado. Consulte API HTTP de dispositivos.

4. Compruebe que ha llegado

1. Abra Dispositivos y seleccione el nombre del dispositivo.
2. La columna Conexión y la cabecera del dispositivo muestran En línea mientras hay una sesión MQTT abierta (con la regla Conexión en directo del perfil predeterminado). Un dispositivo solo HTTP con esa regla nunca aparece en línea; consulte Estado de conexión y actividad.
3. Abra la pestaña Telemetría. La tabla Últimos valores muestra temperature y humidity con su hora.
4. Marque una clave numérica y use Gráfico para ver su tendencia desde la Última hora hasta los Últimos 7 días.

Envíe algunos mensajes más con otros valores para ver cómo se mueve el gráfico.

Si no llega nada

Síntoma	Causa probable
El cliente indica «bad username or password» (CONNACK 4).	El token es incorrecto o se ha rotado.
El cliente indica «not authorised» (CONNACK 5).	El dispositivo está desactivado, o el perfil no permite este tipo de inicio de sesión ni esta red, o exige TLS. El motivo se escribe en la pestaña Registro del dispositivo.
La conexión al puerto 1883 es rechazada.	El perfil exige TLS. Use el puerto 8883.
Falla el handshake de TLS.	Conectó por dirección IP, o su cliente no tiene un paquete de CA. Use el nombre de host y el almacén de CA del sistema.
HTTP responde 401.	Falta la cabecera Authorization: Bearer o el token es incorrecto.
El dispositivo aparece en línea, pero no aparece ningún valor.	La carga no es un objeto JSON, o una clave incumple las reglas de claves (por ejemplo, empieza por _ o fw_). Consulte Referencia de temas y cargas MQTT.

Más causas aparecen en Un dispositivo no se conecta y Los datos no llegan.

Lo que hizo

• Creó un dispositivo con el perfil predeterminado, que exige TLS y acepta tokens de acceso.
• El dispositivo inició sesión con su token y publicó telemetría.
• Cada mensaje cuenta para la cuota mensual de mensajes de su organización. Consulte Cuota de mensajes y uso.

Siguiente paso

Cree su primer panel.