Cómo conectar gateways LoRaWAN de Kerlink a TagoIO

Kerlink es un fabricante francés de infraestructura LoRaWAN con una fuerte presencia en despliegues de ciudades inteligentes, servicios públicos e industria. Sus equipos Wirnet iStation (exterior industrial), Wirnet iFemtoCell (interior) y Wirnet Station son reconocidos por su calidad de construcción y su fiabilidad de grado operador. Kerlink también opera el Wanesy Management Center, un servidor de red LoRaWAN en la nube.

TagoIO se ubica en la capa de aplicación: recibe los datos de los dispositivos, los almacena y te permite crear dashboards, alertas y automatizaciones. Conectar Kerlink a TagoIO significa enlazar la salida del servidor de red de Kerlink con el endpoint de ingesta de datos de TagoIO.

Esta guía cubre dos caminos: el reenvío desde el Wanesy Management Center de Kerlink hacia TagoIO, y un LNS privado de ChirpStack ejecutándose junto a los gateways de Kerlink.

Lo que necesitas antes de empezar

Una cuenta de TagoIO (plan gratuito disponible)
Un gateway de Kerlink (iStation, iFemtoCell, Wirnet Station o compatible)
Un servidor de red LoRaWAN: Kerlink Wanesy Management Center o ChirpStack autoalojado
Dispositivos finales registrados en tu servidor de red

Visión general de la arquitectura

Los gateways de Kerlink actúan como reenviadores de paquetes de radio. No ejecutan lógica de aplicación: eso reside en el LNS. El LNS decodifica las tramas LoRaWAN, identifica los dispositivos y enruta los payloads de aplicación hacia el endpoint que elijas.

Tu punto de integración con TagoIO siempre es el LNS, nunca el gateway directamente.

[sensores LoRaWAN] → [gateway Kerlink] → [LNS (Wanesy o ChirpStack)] → [TagoIO vía HTTPS]

Camino 1: Kerlink Wanesy Management Center → TagoIO

Wanesy MC admite notificaciones push (también llamadas “push connectors”) que envían los uplinks de los dispositivos mediante POST a cualquier endpoint HTTPS.

Paso 1: Crear un dispositivo en TagoIO

Inicia sesión en admin.tago.io.
Ve a Devices → Add Device.
Selecciona HTTPS como tipo de conector.
Asigna un nombre al dispositivo (por ejemplo, kerlink-end-device-01).
Haz clic en Create Device y copia el Device Token desde la pestaña General.

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

Paso 2: Crear un Push Connector en Wanesy MC

Inicia sesión en tu cuenta de Wanesy Management Center.
Ve a Applications y abre o crea una aplicación.
Ve a Push connectors y haz clic en Add.
Elige HTTP como tipo de conector.
Configura la URL como:
```
https://api.tago.io/data
```
Añade el header HTTP:
```
Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
```
Establece el formato de push en JSON (por defecto).
Guarda y activa el conector.

Wanesy ahora enviará mediante POST cada uplink de los dispositivos de esta aplicación a TagoIO.

Paso 3: Parsear el payload de Wanesy en TagoIO

Wanesy envía un objeto JSON con la información del dispositivo y el payload codificado en base64. Añade un Payload Parser a tu dispositivo de TagoIO para extraer las lecturas del sensor.

Abre Devices → [tu dispositivo] → Payload Parser y escribe:

// Wanesy payload structure
const decodedBytes = Buffer.from(payload.payloadHex, "hex");

// Example for a temperature/humidity sensor with 2-byte temperature, 1-byte humidity
const temperature = decodedBytes.readInt16BE(0) / 100;
const humidity = decodedBytes.readUInt8(2);

payload = [
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" },
  { variable: "rssi", value: payload.gwInfo?.[0]?.rssi || null },
  { variable: "snr", value: payload.gwInfo?.[0]?.snr || null }
];

Ajusta la lógica de decodificación para que coincida con el formato de payload de tu sensor.

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

Camino 2: Gateway de Kerlink + ChirpStack → TagoIO

Muchos operadores de Kerlink ejecutan ChirpStack junto a sus gateways, ya sea en sus instalaciones o en la nube. La integración HTTP de ChirpStack puede enviar datos directamente a TagoIO.

Paso 1: Configurar el gateway de Kerlink como reenviador de paquetes

La mayoría de los gateways de Kerlink ejecutan el Semtech UDP Packet Forwarder o el Kerlink Common Packet Forwarder. Apunta el gateway a la dirección y al puerto de tu ChirpStack Network Server (por defecto: UDP 1700).

Accede a la CLI del gateway por SSH o desde el Kerlink WMC para actualizar global_conf.json con la dirección de tu servidor ChirpStack.

Paso 2: Registrar el gateway y el dispositivo en ChirpStack

En ChirpStack, ve a Gateways → Add gateway y registra tu equipo Kerlink.
Crea un Device Profile que coincida con la versión de LoRaWAN y la región de tu dispositivo final.
Registra tus dispositivos finales dentro de una Application.

Paso 3: Añadir una integración HTTPS de TagoIO en ChirpStack

En tu aplicación de ChirpStack, ve a Integrations → HTTP.
Configura la Uplink URL como:
```
https://api.tago.io/data
```
Añade el header personalizado:
```
Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
```
Guarda.

Paso 4: Parsear el payload de ChirpStack en TagoIO

ChirpStack envía los uplinks como JSON. Si configuras un codec en ChirpStack, el objeto decodificado llega en payload.object. De lo contrario, decodifica los bytes en bruto desde payload.data (base64).

// ChirpStack with codec configured
if (payload.object) {
  payload = Object.entries(payload.object).map(([key, val]) => ({
    variable: key,
    value: val
  }));
} else {
  // raw decode from base64
  const raw = Buffer.from(payload.data, "base64");
  // add your sensor-specific decoding here
  payload = [];
}

Paso 5: Verificar en el Live Inspector

Tras completar cualquiera de los dos caminos, abre el Live Inspector en tu dispositivo de TagoIO y confirma que los datos llegan en el siguiente ciclo de uplink.

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

Paso 6: Crear dashboards y alertas

Crea un dashboard desde Dashboards → +. Widgets habituales para un despliegue de ciudad inteligente o industrial basado en Kerlink:

Widget de mapa para las ubicaciones de los dispositivos
Gráficos de series temporales para las lecturas de los sensores a lo largo del tiempo
Tarjetas de calidad de señal que muestran RSSI y SNR por gateway
Mapa de calor si tienes muchos nodos reportando en un área de cobertura

Configura Actions para:

Alertas por umbral (temperatura, vibración, detección de inundaciones)
Detección de dispositivos sin conexión (sin datos recibidos en X minutos)
Reportes automáticos por correo electrónico o webhook hacia un sistema de tickets

Documentación de Actions: docs.tago.io/docs/tagoio/actions

Ejemplos de casos de uso

Servicios públicos de ciudades inteligentes

Gateways Kerlink Wirnet iStation montados en farolas. Los sensores monitorean la presión del agua, el nivel de llenado de los contenedores de residuos y nodos de calidad del aire en todo un municipio. TagoIO agrega todas las lecturas, muestra un mapa de toda la ciudad y dispara alertas a operaciones municipales cuando los contenedores alcanzan el 80% de su capacidad.

Monitoreo industrial de vibraciones

Gateways Kerlink iFemtoCell en una fábrica. Sensores de vibración LoRaWAN sobre maquinaria rotativa reportan a TagoIO. Los scripts de análisis calculan puntuaciones de anomalías basadas en FFT y señalan el desgaste temprano de los rodamientos antes de que fallen.

Documentación de Analysis: docs.tago.io/docs/tagoio/analysis

Gestión energética de edificios

Múltiples medidores de energía LoRaWAN conectados a TagoIO a través de gateways de Kerlink. TagoIO almacena los datos de medición, calcula el consumo diario y mensual por circuito y genera reportes de costos. Los Blueprint Dashboards dan a los responsables de cada piso su propia vista.

Llevarlo más lejos con IA

El servidor MCP de TagoIO permite consultas en lenguaje natural sobre los datos de tus sensores Kerlink. Pregúntale a Claude: “¿Qué dispositivos tienen la peor calidad de señal?” o “Muéstrame todas las anomalías en los datos de vibración de la última semana.”

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

Resumen

Los gateways de Kerlink reenvían paquetes LoRaWAN a un servidor de red. El servidor de red, ya sea el propio Wanesy MC de Kerlink o un ChirpStack autoalojado, envía los payloads de los dispositivos a TagoIO vía HTTPS. Un Payload Parser en TagoIO decodifica los datos binarios en variables limpias para su almacenamiento y visualización.

TagoIO Devices: docs.tago.io/docs/tagoio/devices
Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser
Actions: docs.tago.io/docs/tagoio/actions
Dashboards: docs.tago.io/docs/tagoio/dashboards
MCP Integration: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration