# Como conectar sensores LoRaWAN da Tektelic ao TagoIO

> Como conectar sensores LoRaWAN da Tektelic (TUNDRA, HOME, KONA) ao TagoIO. Aborda o encaminhamento pelo Tektelic Network Server, o caminho de integração via TTN, o parsing de payload para cada família de sensores e casos de uso em edifícios inteligentes e monitoramento industrial.

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

A Tektelic Communications fabrica uma linha completa de hardware LoRaWAN: gateways, network servers e sensores. Sua linha de sensores cobre aplicações de edifícios inteligentes (HOME Sensor, TUNDRA Slim, SPARK), industriais (sensores ambientais BREEZE e BOREALIS) e de agricultura.

Os dispositivos da Tektelic enviam uplinks LoRaWAN padrão. Você pode roteá-los pelo próprio Network Server da Tektelic (TNS), pelo The Things Network ou por qualquer LNS que suporte webhooks HTTPS, e encaminhar os dados ao TagoIO para armazenamento de longo prazo, dashboards e alertas.

Este guia cobre tanto o caminho pelo Tektelic Network Server quanto o caminho via TTN.

## O que você precisa antes de começar

- Uma conta TagoIO ([plano gratuito disponível](https://tago.io/pricing))
- Sensores Tektelic (TUNDRA, HOME, BOREALIS ou similares)
- Um gateway Tektelic ou um gateway LoRaWAN compatível
- Acesso ao Tektelic Network Server (TNS) ou a uma conta TTN

## Caminho 1: Tektelic Network Server para o TagoIO

### Passo 1: crie um dispositivo no TagoIO

1. Acesse [admin.tago.io](https://admin.tago.io).
2. Vá em **Devices → Add Device → HTTPS**.
3. Dê um nome ao dispositivo e salve.
4. 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: configure uma integração de push no Tektelic NS

1. Acesse a interface web do Tektelic Network Server.
2. Vá até sua aplicação e selecione **Application Integrations**.
3. Adicione uma integração **HTTP Push**.
4. Defina a URL como `https://api.tago.io/data`.
5. Adicione o cabeçalho: `Device-Token: YOUR_TAGOIO_DEVICE_TOKEN`.
6. Salve e habilite.

### Passo 3: escreva o Payload Parser

Os sensores da Tektelic codificam dados usando seu próprio formato binário. Consulte o decodificador de payload do seu sensor específico na [documentação de produtos da Tektelic](https://support.tektelic.com).

Exemplo para o Tektelic TUNDRA Slim (temperatura + umidade):

```javascript
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: "%" }
];
```

Em sensores Tektelic com múltiplos canais, cada tipo de canal é identificado por um byte de identificador de dados no payload. Faça o parsing de cada canal de acordo e retorne todas as variáveis no formato de array do TagoIO.

Documentação do Payload Parser: [docs.tago.io/docs/tagoio/devices/payload-parser](https://docs.tago.io/docs/tagoio/devices/payload-parser/)

## Caminho 2: sensores Tektelic para o The Things Network para o TagoIO

Se você preferir rotear os sensores Tektelic pelo TTN:

1. Registre o sensor Tektelic no TTN usando seu DevEUI, AppEUI e AppKey.
2. No TagoIO, crie um dispositivo usando o connector **The Things Network v3**.
3. Copie a URL do Webhook e o Authorization Token do TagoIO.
4. Adicione um Custom webhook no TTN apontando para a URL do TagoIO com o cabeçalho Authorization.
5. Adicione um Payload Parser no TagoIO para decodificar o payload binário da Tektelic a partir de `payload.uplink_message.frm_payload`.

Para o HOME Sensor (temperatura, umidade, luminosidade, movimento):

```javascript
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 }
];
```

## Passo 4: verifique no Live Inspector

Abra o **Live Inspector** no seu dispositivo TagoIO e confirme que as variáveis chegam corretamente.

Documentação do Live Inspector: [docs.tago.io/docs/tagoio/devices/live-inspector](https://docs.tago.io/docs/tagoio/devices/live-inspector)

## Passo 5: monte os dashboards

Os sensores Tektelic costumam ser instalados em lotes por todo um edifício. Use os [Blueprint Dashboards](https://docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard) para gerenciar vários sensores com um único layout.

Para implantações em escritórios ou edifícios inteligentes, um dashboard padrão inclui:

- Temperatura e umidade por sala ao longo do tempo
- Mapa de calor de ocupação a partir dos sensores de movimento
- Concentração de CO2 por zona (se estiver usando o BOREALIS)
- Tabela de histórico de alertas

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

## Exemplos de casos de uso

### Monitoramento de conforto em escritório inteligente

Sensores Tektelic HOME em cada sala de reunião e área de planta aberta. O Blueprint Dashboard do TagoIO mostra à equipe de facilities uma visão andar por andar de temperatura, umidade e ocupação. As actions disparam mudanças no setpoint do HVAC via API do BMS quando as faixas de conforto são ultrapassadas.

### Monitoramento de câmara fria

Sensores Tektelic TUNDRA em salas refrigeradas e freezers. O TagoIO armazena as leituras a cada 5 minutos, gera relatórios de conformidade para auditorias de segurança alimentar e envia alertas imediatos por SMS quando a temperatura sai da faixa.

### Conformidade ambiental industrial

Sensores Tektelic BREEZE acompanhando material particulado, CO2 e VOCs em uma área de manufatura. Scripts de Analysis do TagoIO calculam médias móveis de 8 horas para relatórios regulatórios. Relatórios diários são gerados automaticamente por um script de Analysis e enviados por e-mail à equipe de segurança.

## Indo além com IA

O servidor MCP do TagoIO permite que assistentes de IA como o Claude consultem os dados dos seus sensores Tektelic em linguagem natural. Pergunte: "Quais andares ficaram acima de 25°C por mais de 2 horas hoje?" ou "Mostre os padrões de movimento nas salas de conferência na ú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 sensores Tektelic se conectam ao TagoIO pelo Tektelic Network Server ou pelo TTN, usando integração de push HTTPS. A principal tarefa de integração é escrever um payload parser que decodifique o formato binário da Tektelic. Com os dados fluindo, o TagoIO cuida do armazenamento, dos dashboards com múltiplos dispositivos e dos alertas em tempo real.

- Devices: [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/)
- Blueprint Dashboards: [docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard](https://docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard)
- Actions: [docs.tago.io/docs/tagoio/actions](https://docs.tago.io/docs/tagoio/actions/)
- 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)