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.
- Lectura Ninguna
- Escritura Ninguna
- Suscripción Parcial
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.
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.
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.
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.
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.
Lo que no hace.
- El downlink LoRaWAN permanece desactivado hasta que el operador lo activa. Hasta entonces, un comando a un dispositivo que informó por última vez mediante una integración falla con COMMAND_TRANSPORT_UNSUPPORTED, en lugar de esperar a que caduque.
- Los mensajes de unión, estado y ubicación se confirman y se ignoran.
- Solo los números y los booleanos se convierten en lecturas; las cadenas y los nulos del objeto decodificado se omiten. Un mensaje que llega mientras el inquilino supera su cuota de ingesta se responde con 202 y no se guarda, por lo que la matriz marca la suscripción como parcial.
Integraciones de entrada: The Things Stack v3 → · Matriz de transportes → · Todas las integraciones →