Guías de ThinkLink / Integración de sistemas
Integración MQTT de ThinkLink: payload de aplicación o telemetría decodificada
Conecte sistemas mediante brokers y reenviadores, distinga payload AS de telemetría e inspeccione conexión, suscripción, transformación y recepción.
Elija datos AS si el receptor necesita decodificar el protocolo. Prefiera telemetría procesada si necesita campos como temperatura y humedad. Compruebe por separado conexión, reglas habilitadas, coincidencia de temas y recepción.
Acuerde el contrato de datos entre ambos sistemas
Que dos sistemas admitan MQTT no significa que se entiendan automáticamente. Acuerde identidad, temas, formato, unidades, significado del tiempo y tratamiento de errores. Parta de un mensaje verificado y determine qué campos necesita el receptor.
Use payload de aplicación si el receptor se ocupa de interpretar el protocolo. Para análisis de negocio, la telemetría del modelo suele evitar duplicar decodificadores. Ambas opciones tienen utilidad; la falta de campos por elegir mal la fuente no es un fallo de red.
Elija entre mensajes AS y ThinkLink
La documentación enumera AS y ThinkLink como tipos distintos de broker interno. AS proporciona mensajes ascendentes descifrados; ThinkLink, telemetría procesada por el modelo. El tema debe corresponder a la capa y organización reales, no copiar una ruta de otro entorno.
| Capa | Finalidad del receptor | Trabajo pendiente |
|---|---|---|
| Mensajes AS | Conservar payload e interpretar el protocolo | Puerto, payload, protocolo e identidad |
| Telemetría procesada | Visualización, análisis y automatización | Campos, unidades, tiempo y anomalías |
| Puente NS externo | Conservar ChirpStack / TTN y usar ThinkLink | Direcciones, registros y vinculación de modelos |
Configure conexión, suscripción y después transformación
El reenvío MQTT actual usa brokers y reenviadores. Cree conexiones de origen y destino, compruebe el broker de destino y habilite la regla con su tema. Dirección, credenciales y certificados deben ajustarse a los requisitos del receptor.
Primero omita scripts y compruebe que el mensaje original llega a un tema de prueba. Después añada cambios de nombre, filtros o conversión de temas. Conserve entradas y salidas esperadas para distinguir mensajes no recibidos, descartados o transformados.
Conserve su red ChirpStack o TTN existente
El puente oficial documenta rutas MQTT bidireccionales para ChirpStack v4 y TTN v3. El reenvío normaliza las subidas al formato AS antes del modelo; las bajadas usan interfaces del servidor externo. ThinkLink sigue necesitando registros de dispositivos y modelos vinculados.
Esta opción permite conservar la red y añadir funciones de datos ThinkLink. Valide ambos sentidos: recibir una subida no demuestra funcionamiento de la cola descendente, del destino o de las ventanas de recepción, ni implica sincronización de todo el historial.
Asigne responsabilidades para cortes y duplicados
La reconexión automática no garantiza reenviar cada mensaje perdido. La documentación describe restauración de suscripciones, sin añadir garantías de búfer sin conexión ni reenvío posterior. Si necesita compensación, diseñe y pruebe consultas históricas, persistencia o reintentos de negocio.
El receptor debe evaluar duplicados, tiempos fuera de orden y mapeo de identidades. Siga algunos mensajes por hora de origen, tema y recepción; después simule corte y recuperación. La aceptación debe demostrar resultados explicables, no solo una captura de conexión activa.
- Confirme un mensaje real en origen.
- Compruebe tema y habilitación de la regla.
- Verifique equipo, campos, unidades y hora en destino.
- Pruebe reconexión y documente compensaciones necesarias.
Preguntas frecuentes
¿Hay que habilitar reenvío en cada dispositivo?
La documentación actual utiliza reglas de brokers y reenviadores; el antiguo interruptor por equipo está retirado. Consulte la versión instalada.
¿Por qué no llega telemetría si MQTT está conectado?
Revise tema, capa seleccionada, regla y resultado del script. La conexión no demuestra que haya llegado el mensaje de negocio.
Referencias y lecturas adicionales
Esta guía se basa en las fuentes oficiales siguientes. Los diagramas explican el método; consulte la documentación de su versión para menús, campos y funciones exactos. Las fuentes enlazadas están en chino.