# Como conectar gateways LoRaWAN da Kerlink ao TagoIO

> Guia completo para conectar gateways LoRaWAN da Kerlink (iStation, iFemtoCell, Wirnet) ao TagoIO. Aborda o Wanesy Management Center, o encaminhamento via LNS do ChirpStack, o parsing de payload e cenários de uso para cidades inteligentes e ambientes industriais.

![Como conectar gateways LoRaWAN da Kerlink ao TagoIO](https://tago.io/og/pt-br/blog/how-to-connect-kerlink-lorawan-gateways-to-tagoio.png)

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](https://tago.io/pricing))
- 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

1. Faça login em [admin.tago.io](https://admin.tago.io).
2. Vá em **Devices → Add Device**.
3. Selecione **HTTPS** como o tipo de conector.
4. Dê um nome ao dispositivo (por exemplo, `kerlink-end-device-01`).
5. Clique em **Create Device** e copie o **Device Token** na aba General.

Documentação de dispositivos: [docs.tago.io/docs/tagoio/devices](https://docs.tago.io/docs/tagoio/devices/)

### Passo 2: Crie um Push Connector no Wanesy MC

1. Faça login na sua conta do Wanesy Management Center.
2. Navegue até **Applications** e abra ou crie uma aplicação.
3. Vá em **Push connectors** e clique em **Add**.
4. Escolha **HTTP** como o tipo de conector.
5. Defina a URL como:

   ```
   https://api.tago.io/data
   ```

6. Adicione o header HTTP:

   ```
   Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
   ```

7. Defina o formato do push como **JSON** (padrão).
8. 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:

```javascript
// 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](https://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

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

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

1. Na sua Application do ChirpStack, vá em **Integrations → HTTP**.
2. Defina a **Uplink URL** como:

   ```
   https://api.tago.io/data
   ```

3. Adicione o header personalizado:

   ```
   Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
   ```

4. 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).

```javascript
// 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](https://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](https://docs.tago.io/docs/tagoio/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](https://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](https://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](https://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](https://docs.tago.io/docs/tagoio/devices/)
- Payload Parser: [docs.tago.io/docs/tagoio/devices/payload-parser](https://docs.tago.io/docs/tagoio/devices/payload-parser/)
- Actions: [docs.tago.io/docs/tagoio/actions](https://docs.tago.io/docs/tagoio/actions/)
- Dashboards: [docs.tago.io/docs/tagoio/dashboards](https://docs.tago.io/docs/tagoio/dashboards/)
- Integração MCP: [docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration](https://docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration)

[llms.txt](https://tago.io/llms.txt)