Como conectar sensores LoRaWAN da Tektelic ao TagoIO

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

Acesse admin.tago.io.
Vá em Devices → Add Device → HTTPS.
Dê um nome ao dispositivo e salve.
Copie o Device Token na aba General.

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

Passo 2: configure uma integração de push no Tektelic NS

Acesse a interface web do Tektelic Network Server.
Vá até sua aplicação e selecione Application Integrations.
Adicione uma integração HTTP Push.
Defina a URL como https://api.tago.io/data.
Adicione o cabeçalho: Device-Token: YOUR_TAGOIO_DEVICE_TOKEN.
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.

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

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

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

Se você preferir rotear os sensores Tektelic pelo TTN:

Registre o sensor Tektelic no TTN usando seu DevEUI, AppEUI e AppKey.
No TagoIO, crie um dispositivo usando o connector The Things Network v3.
Copie a URL do Webhook e o Authorization Token do TagoIO.
Adicione um Custom webhook no TTN apontando para a URL do TagoIO com o cabeçalho Authorization.
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):

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

Passo 5: monte os dashboards

Os sensores Tektelic costumam ser instalados em lotes por todo um edifício. Use os Blueprint Dashboards 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

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

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
Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser
Blueprint Dashboards: docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard
Actions: docs.tago.io/docs/tagoio/actions
MCP: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration