Como conectar gateways LoRaWAN da Kerlink ao TagoIO

A Kerlink é uma fornecedora francesa de infraestrutura LoRaWAN com forte presença em implantações de cidades inteligentes, utilities e indústria. Seus dispositivos Wirnet iStation (industrial para ambientes externos), Wirnet iFemtoCell (interno) e Wirnet Station são conhecidos pela qualidade de construção e pela confiabilidade de nível carrier. A Kerlink também opera o Wanesy Management Center, um servidor de rede LoRaWAN baseado em nuvem.

O TagoIO fica na camada de aplicação: ele recebe os dados dos dispositivos, armazena tudo e permite criar dashboards, alertas e automações. Conectar a Kerlink ao TagoIO significa ligar a saída do servidor de rede da Kerlink ao endpoint de ingestão de dados do TagoIO.

Este guia cobre dois caminhos: o encaminhamento do Kerlink Wanesy Management Center para o TagoIO e um LNS ChirpStack privado rodando ao lado dos gateways Kerlink.

O que você precisa antes de começar

Uma conta no TagoIO (plano gratuito disponível)
Um gateway Kerlink (iStation, iFemtoCell, Wirnet Station ou compatível)
Um servidor de rede LoRaWAN: Kerlink Wanesy Management Center ou ChirpStack auto-hospedado
Dispositivos finais registrados no seu servidor de rede

Visão geral da arquitetura

Os gateways Kerlink atuam como encaminhadores de pacotes de rádio. Eles não rodam a lógica da aplicação: isso fica no LNS. O LNS decodifica os frames LoRaWAN, identifica os dispositivos e roteia os payloads da aplicação para o endpoint que você escolher.

Seu ponto de integração com o TagoIO é sempre o LNS, nunca o gateway diretamente.

[sensores LoRaWAN] → [gateway Kerlink] → [LNS (Wanesy ou ChirpStack)] → [TagoIO via HTTPS]

Caminho 1: Kerlink Wanesy Management Center → TagoIO

O Wanesy MC oferece suporte a notificações push (também chamadas de “push connectors”) que fazem POST dos uplinks dos dispositivos para qualquer endpoint HTTPS.

Passo 1: Crie um dispositivo no TagoIO

Faça login em admin.tago.io.
Vá em Devices → Add Device.
Selecione HTTPS como o tipo de conector.
Dê um nome ao dispositivo (por exemplo, kerlink-end-device-01).
Clique em Create Device e copie o Device Token na aba General.

Documentação de dispositivos: docs.tago.io/docs/tagoio/devices

Passo 2: Crie um Push Connector no Wanesy MC

Faça login na sua conta do Wanesy Management Center.
Navegue até Applications e abra ou crie uma aplicação.
Vá em Push connectors e clique em Add.
Escolha HTTP como o tipo de conector.
Defina a URL como:
```
https://api.tago.io/data
```
Adicione o header HTTP:
```
Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
```
Defina o formato do push como JSON (padrão).
Salve e ative o conector.

O Wanesy agora fará POST de todo uplink dos dispositivos dessa aplicação para o TagoIO.

Passo 3: Faça o parsing do payload do Wanesy no TagoIO

O Wanesy envia um objeto JSON com as informações do dispositivo e o payload codificado em base64. Adicione um Payload Parser ao seu dispositivo TagoIO para extrair as leituras dos sensores.

Abra Devices → [seu dispositivo] → Payload Parser e escreva:

// 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 }
];

Ajuste a lógica de decodificação para corresponder ao formato de payload do seu sensor.

Documentação do Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser

Caminho 2: gateway Kerlink + ChirpStack → TagoIO

Muitos operadores Kerlink rodam o ChirpStack ao lado dos seus gateways, seja on-premise ou na nuvem. A integração HTTP do ChirpStack pode enviar dados diretamente para o TagoIO.

Passo 1: Configure o gateway Kerlink como packet forwarder

A maioria dos gateways Kerlink roda o Semtech UDP Packet Forwarder ou o Kerlink Common Packet Forwarder. Aponte o gateway para o endereço e a porta do seu servidor de rede ChirpStack (padrão: UDP 1700).

Acesse a CLI do gateway via SSH ou pelo Kerlink WMC para atualizar o global_conf.json com o endereço do seu servidor ChirpStack.

Passo 2: Registre o gateway e o dispositivo no ChirpStack

No ChirpStack, vá em Gateways → Add gateway e registre seu dispositivo Kerlink.
Crie um Device Profile que corresponda à versão LoRaWAN e à região do seu dispositivo final.
Registre seus dispositivos finais em uma Application.

Passo 3: Adicione uma integração HTTPS do TagoIO no ChirpStack

Na sua Application do ChirpStack, vá em Integrations → HTTP.
Defina a Uplink URL como:
```
https://api.tago.io/data
```
Adicione o header personalizado:
```
Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
```
Salve.

Passo 4: Faça o parsing do payload do ChirpStack no TagoIO

O ChirpStack envia os uplinks como JSON. Se você configurar um codec no ChirpStack, o objeto decodificado chega em payload.object. Caso contrário, decodifique os bytes brutos de 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 = [];
}

Passo 5: Verifique no Live Inspector

Após concluir qualquer um dos caminhos, abra o Live Inspector no seu dispositivo TagoIO e confirme que os dados chegam no próximo ciclo de uplink.

Documentação do Live Inspector: docs.tago.io/docs/tagoio/devices/live-inspector

Passo 6: Crie dashboards e alertas

Crie um dashboard em Dashboards → +. Widgets típicos para uma implantação industrial ou de cidade inteligente baseada em Kerlink:

Widget de mapa para a localização dos dispositivos
Gráficos de série temporal para as leituras dos sensores ao longo do tempo
Cartões de qualidade de sinal mostrando RSSI e SNR por gateway
Mapa de calor se você tiver muitos nós reportando para uma área de cobertura

Configure Actions para:

Alertas por limite (temperatura, vibração, detecção de enchente)
Detecção de dispositivo offline (nenhum dado recebido em X minutos)
Relatórios automáticos por e-mail ou webhook para um sistema de tickets

Documentação de Actions: docs.tago.io/docs/tagoio/actions

Exemplos de casos de uso

Utilities em cidades inteligentes

Gateways Kerlink Wirnet iStation instalados em postes de iluminação. Sensores monitoram pressão da água, nível de enchimento de lixeiras e nós de qualidade do ar em todo um município. O TagoIO agrega todas as leituras, exibe um mapa de toda a cidade e dispara alertas para a operação municipal quando as lixeiras chegam a 80% da capacidade.

Monitoramento industrial de vibração

Gateways Kerlink iFemtoCell em uma fábrica. Sensores de vibração LoRaWAN em máquinas rotativas reportam ao TagoIO. Scripts de análise calculam escores de anomalia baseados em FFT e sinalizam desgaste inicial dos rolamentos antes da falha.

Documentação de Analysis: docs.tago.io/docs/tagoio/analysis

Gestão de energia em edifícios

Vários medidores de energia LoRaWAN conectados ao TagoIO por meio de gateways Kerlink. O TagoIO armazena os dados de medição, calcula o consumo diário e mensal por circuito e gera relatórios de custo. Os Blueprint Dashboards dão aos gestores de cada andar a sua própria visão.

Indo além com IA

O servidor MCP do TagoIO permite consultas em linguagem natural sobre os dados dos seus sensores Kerlink. Pergunte ao Claude: “Quais dispositivos têm a pior qualidade de sinal?” ou “Mostre todas as anomalias nos dados de vibração da última semana.”

Documentação do MCP: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration

Resumo

Os gateways Kerlink encaminham os pacotes LoRaWAN para um servidor de rede. O servidor de rede, seja o próprio Wanesy MC da Kerlink ou um ChirpStack auto-hospedado, envia os payloads dos dispositivos para o TagoIO via HTTPS. Um Payload Parser no TagoIO decodifica os dados binários em variáveis limpas para armazenamento e visualização.

Dispositivos no TagoIO: 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
Integração MCP: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration