How to

Cómo conectar sensores LoRaWAN de Tektelic a TagoIO

Cómo conectar sensores LoRaWAN de Tektelic (TUNDRA, HOME, KONA) a TagoIO. Cubre el reenvío desde el Tektelic Network Server, la ruta de integración con TTN, el parseo de payload para cada familia de sensores y casos de uso en edificios inteligentes y monitoreo industrial.

David Hall ·
Cómo conectar sensores LoRaWAN de Tektelic a TagoIO

Tektelic Communications fabrica una pila completa de hardware LoRaWAN: gateways, network servers y sensores. Su línea de sensores abarca aplicaciones de edificios inteligentes (HOME Sensor, TUNDRA Slim, SPARK), industriales (sensores ambientales BREEZE y BOREALIS) y de agricultura.

Los dispositivos de Tektelic envían uplinks LoRaWAN estándar. Puedes enrutarlos a través del propio Network Server de Tektelic (TNS), de The Things Network o de cualquier LNS que admita webhooks HTTPS, y reenviar los datos a TagoIO para almacenamiento a largo plazo, dashboards y alertas.

Esta guía cubre tanto la ruta del Tektelic Network Server como la ruta de TTN.

Lo que necesitas antes de empezar

  • Una cuenta de TagoIO (plan gratuito disponible)
  • Sensores de Tektelic (TUNDRA, HOME, BOREALIS o similares)
  • Un gateway de Tektelic o un gateway LoRaWAN compatible
  • Acceso al Tektelic Network Server (TNS) o una cuenta de TTN

Ruta 1: del Tektelic Network Server a TagoIO

Paso 1: crea un dispositivo en TagoIO

  1. Inicia sesión en admin.tago.io.
  2. Ve a Devices → Add Device → HTTPS.
  3. Asigna un nombre al dispositivo y guarda.
  4. Copia el Device Token desde la pestaña General.

Documentación de dispositivos: docs.tago.io/docs/tagoio/devices

Paso 2: configura una integración push en el Tektelic NS

  1. Inicia sesión en la interfaz web del Tektelic Network Server.
  2. Ve a tu aplicación y selecciona Application Integrations.
  3. Agrega una integración HTTP Push.
  4. Establece la URL en https://api.tago.io/data.
  5. Agrega el encabezado: Device-Token: YOUR_TAGOIO_DEVICE_TOKEN.
  6. Guarda y habilítala.

Paso 3: escribe el Payload Parser

Los sensores de Tektelic codifican los datos usando su propio formato binario. Consulta el decodificador de payload de tu sensor específico en la documentación de productos de Tektelic.

Ejemplo para el Tektelic TUNDRA Slim (temperatura + humedad):

const raw = Buffer.from(payload.data || payload.payload_hex, "hex");

// TUNDRA Slim standard payload: 2-byte temp (signed, /10), 2-byte humidity (/10)
const temperature = raw.readInt16BE(0) / 10;
const humidity = raw.readInt16BE(2) / 10;

payload = [
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" }
];

En los sensores multicanal de Tektelic, cada tipo de canal se identifica mediante un byte identificador de datos en el payload. Parsea cada canal en consecuencia y devuelve todas las variables en el formato de array de TagoIO.

Documentación del Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser

Ruta 2: de los sensores Tektelic a The Things Network y a TagoIO

Si prefieres enrutar los sensores de Tektelic a través de TTN:

  1. Registra el sensor de Tektelic en TTN usando su DevEUI, AppEUI y AppKey.
  2. En TagoIO, crea un dispositivo usando el conector The Things Network v3.
  3. Copia la URL del Webhook y el Authorization Token desde TagoIO.
  4. Agrega un webhook personalizado (Custom webhook) en TTN que apunte a la URL de TagoIO con el encabezado Authorization.
  5. Agrega un Payload Parser en TagoIO para decodificar el payload binario de Tektelic desde payload.uplink_message.frm_payload.

Para el HOME Sensor (temperatura, humedad, luz, movimiento):

const raw = Buffer.from(payload.uplink_message.frm_payload, "base64");
// Adjust offsets per Tektelic HOME Sensor payload spec
const temperature = raw.readInt16BE(1) / 10;
const humidity = raw.readUInt8(3) / 2;
const light = raw.readUInt16BE(4);
const motion = raw.readUInt8(6) & 0x01;

payload = [
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" },
  { variable: "light", value: light, unit: "lux" },
  { variable: "motion", value: motion }
];

Paso 4: verifica en el Live Inspector

Abre el Live Inspector en tu dispositivo de TagoIO y confirma que las variables lleguen correctamente.

Documentación del Live Inspector: docs.tago.io/docs/tagoio/devices/live-inspector

Paso 5: crea dashboards

Los sensores de Tektelic suelen desplegarse en lotes por todo un edificio. Usa los Blueprint Dashboards para administrar varios sensores con un solo diseño.

Para despliegues en oficinas o edificios inteligentes, un dashboard estándar incluye:

  • Temperatura y humedad por sala a lo largo del tiempo
  • Mapa de calor de ocupación a partir de los sensores de movimiento
  • Concentración de CO2 por zona (si usas BOREALIS)
  • Tabla de historial de alertas

Documentación de dashboards: docs.tago.io/docs/tagoio/dashboards

Ejemplos de casos de uso

Monitoreo de confort en oficinas inteligentes

Sensores HOME de Tektelic en cada sala de reuniones y zona de planta abierta. El Blueprint Dashboard de TagoIO le muestra al equipo de instalaciones una vista por piso de la temperatura, la humedad y la ocupación. Las acciones disparan cambios de setpoint del HVAC a través de la API del BMS cuando se superan los rangos de confort.

Monitoreo de cámaras frigoríficas

Sensores TUNDRA de Tektelic en salas refrigeradas y congeladores. TagoIO almacena las lecturas cada 5 minutos, genera informes de cumplimiento para auditorías de seguridad alimentaria y envía alertas por SMS inmediatas cuando la temperatura se desvía.

Cumplimiento ambiental industrial

Sensores BREEZE de Tektelic que rastrean material particulado, CO2 y COV en un área de fabricación. Los scripts de Analysis de TagoIO calculan promedios móviles de 8 horas para los informes regulatorios. Los informes diarios se generan automáticamente mediante un script de Analysis y se envían por correo al equipo de seguridad.

Llévalo más lejos con IA

El servidor MCP de TagoIO permite que asistentes de IA como Claude consulten los datos de tus sensores Tektelic en lenguaje natural. Pregunta: “¿Qué pisos han estado por encima de 25°C durante más de 2 horas hoy?” o “Muéstrame los patrones de movimiento en las salas de conferencia durante la última semana.”

Documentación de MCP: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration

Resumen

Los sensores de Tektelic se conectan a TagoIO ya sea a través del Tektelic Network Server o de TTN, usando una integración push HTTPS. La principal tarea de integración es escribir un payload parser que decodifique el formato binario de Tektelic. Una vez que los datos fluyen, TagoIO se encarga del almacenamiento, los dashboards multidispositivo y las alertas en tiempo real.