DeviceChain
Español
Descargar
Integraciones · The Things Stack v3

Integración de The Things Stack con DeviceChain

Si tus dispositivos LoRaWAN informan a The Things Stack, un webhook personalizado de la aplicación puede reenviar cada uplink a DeviceChain. DeviceChain guarda lo que produjo tu formateador de carga útil o el decodificador del perfil de dispositivo como mediciones normales, de modo que las lecturas llegan al historial, el estado en vivo, los paneles y las reglas como cualquier otra. El dispositivo nunca se conecta a DeviceChain.

The Things Stack v3

Cómo se conecta

Creas una integración en la consola con el tipo de remitente The Things Stack v3, eliges si los dispositivos se asocian por DevEUI o por id de dispositivo, la limitas a tipos de dispositivo y copias su token bearer. El token lo genera el servidor, se muestra una vez y se guarda solo como un resumen con clave.

En The Things Stack añades un webhook personalizado con formato JSON, fijas su URL base en la URL de la integración, envías el token en una cabecera Authorization y activas el evento de mensaje de uplink con la ruta /uplink-message. La plataforma también lee las rutas /up, /uplink y /uplinks.

The Things Stack v3

Qué lee la plataforma

Sin un decodificador de carga útil en el perfil de dispositivo, la plataforma guarda la salida del formateador. Configúralo en la aplicación o el dispositivo; LoRaWAN Device Repository ofrece uno para muchos sensores. Sin ninguno, el uplink se cuenta como no decodificado y no se guarda. Con un decodificador en el perfil, DeviceChain decodifica la trama.

Con downlinks confirmados también se leen downlink_ack, downlink_nack, downlink_sent y downlink_failed; actívalos en el webhook con rutas que comiencen por downlink. Otras rutas reciben 204 y se ignoran. received_at debe estar presente y no tener más de 366 días.

The Things Stack v3

Asociación de dispositivos

Añade cada dispositivo en DeviceChain con su DevEUI como alias lorawan.deveui, o con su id de dispositivo como alias tts.device-id si elegiste asociar por id de dispositivo. Un dispositivo fuera del ámbito de la integración, o ningún dispositivo, significa que el mensaje no se guarda.

The Things Stack v3

Comandos

Cuando el operador activa el downlink LoRaWAN, un conector lorawan_downlink publicado enlaza la integración con The Things Stack. Un comando a un dispositivo con alias tts.device-id se encola allí como downlink. Sus parámetros son el puerto y la carga útil sin procesar, o valores tipados que un codificador de la definición del comando convierte en bytes.

Un downlink no confirmado tiene éxito cuando el servidor de red lo encola; esto no es una confirmación del dispositivo. Uno confirmado espera la respuesta del dispositivo; sin respuesta antes del plazo, el resultado queda desconocido. Un fallo incierto también deja el resultado desconocido.

The Things Stack v3

Confianza

El token bearer habla en nombre de cada dispositivo de los tipos incluidos en el ámbito que tenga un alias para él, y no hay firma de la carga útil, así que usa TLS, limita la integración de forma estrecha y rota el token si pudo haberse expuesto.

Aún no

Lo que no hace.

Integraciones de entrada: The Things Stack v3 → · Matriz de transportes → · Todas las integraciones →