How to

Como conectar dispositivos RAK Wireless ao TagoIO

Guia passo a passo para conectar sensores RAK Wireless WisBlock e gateways RAK ao TagoIO. Aborda a configuração do servidor de rede LoRaWAN (TTN e ChirpStack), o parsing de payload e casos de uso reais em agricultura inteligente, monitoramento industrial e sensoriamento ambiental.

Thiago Lima ·
Como conectar dispositivos RAK Wireless ao TagoIO

A RAK Wireless constrói um dos ecossistemas LoRaWAN mais flexíveis disponíveis hoje. A plataforma modular WisBlock permite combinar núcleos de sensores, módulos de comunicação e placas base para criar um nó IoT personalizado em minutos. Seus gateways RAK7258, RAK7289 e RAK7268 estão amplamente implantados em edifícios, campi e instalações industriais.

O TagoIO fornece a camada de aplicação: gerenciamento de dispositivos, armazenamento de dados, dashboards, alertas e uma API REST completa. Juntos, o hardware da RAK e o TagoIO cobrem toda a stack, do sensor à decisão, mas conectá-los exige alguns passos deliberados dos dois lados.

Este guia percorre a integração de ponta a ponta, da configuração do servidor de rede LoRaWAN até o seu primeiro dashboard ao vivo.

O que você precisa antes de começar

  • Uma conta TagoIO (plano gratuito disponível)
  • Um gateway RAK (RAK7258, RAK7289, RAK7268C ou similar)
  • Um ou mais nós sensores WisBlock ou dispositivos finais LoRaWAN da RAK
  • Um servidor de rede LoRaWAN: The Things Network (TTN) ou uma instância ChirpStack auto-hospedada

Como a integração funciona

Os gateways RAK encaminham pacotes LoRaWAN para um servidor de rede (NS). O NS decodifica o endereçamento do dispositivo e entrega o payload a uma camada de aplicação, neste caso, o TagoIO.

Existem dois caminhos principais:

Caminho 1: Gateway RAK → The Things Network → TagoIO Esta é a configuração mais comum. O TTN cuida da camada MAC do LoRaWAN, e a integração nativa do TagoIO com o TTN recebe os uplinks via webhook.

Caminho 2: Gateway RAK → ChirpStack → webhook HTTPS do TagoIO Para implantações privadas ou instalações on-premise, gateways RAK rodando ChirpStack (embutido no firmware AEP do RAK7258) podem encaminhar payloads decodificados ao TagoIO via HTTP POST.

Os dois caminhos produzem o mesmo resultado no TagoIO. Escolha de acordo com a sua preferência de infraestrutura de rede.

Caminho 1: RAK + The Things Network + TagoIO

Passo 1: registre seu gateway no TTN

  1. Faça login em console.cloud.thethings.network.
  2. Acesse Gateways e clique em Register gateway.
  3. Informe o EUI do seu gateway (encontrado na etiqueta do gateway RAK ou na interface de administração).
  4. Selecione o plano de frequência correspondente à sua região (EU868, US915, AU915, etc.).
  5. Salve e verifique se o gateway aparece como Connected.

Passo 2: registre seu dispositivo final no TTN

  1. No seu aplicativo TTN, clique em Register end device.
  2. Escolha seu módulo WisBlock no repositório de dispositivos (por exemplo, RAK4631 com o perfil de sensor apropriado) ou insira as credenciais manualmente.
  3. Copie o AppEUI, o DevEUI e o AppKey gerados, pois você vai programá-los no seu nó WisBlock por meio do RAK Serial Port Tool ou de comandos AT.

Passo 3: crie um dispositivo no TagoIO

  1. Faça login em admin.tago.io.
  2. Clique em Devices na barra lateral esquerda e depois em Add Device.
  3. Procure por The Things Network v3 na lista de conectores e selecione.
  4. Dê ao dispositivo um nome que corresponda ao seu dispositivo final no TTN.
  5. O TagoIO vai gerar uma URL de webhook e um Authorization Token. Copie os dois.

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

Passo 4: adicione o webhook do TagoIO no TTN

  1. No seu aplicativo TTN, vá em Integrations → Webhooks.
  2. Clique em Add webhook e escolha Custom webhook.
  3. Defina a Base URL com a URL de webhook do TagoIO obtida no Passo 3.
  4. Defina o cabeçalho Authorization com o token obtido no Passo 3.
  5. Habilite Uplink message nos tipos de mensagem.
  6. Salve o webhook.

O TTN agora vai encaminhar cada uplink LoRaWAN dos seus dispositivos registrados para o TagoIO em tempo real.

Passo 5: escreva um Payload Parser para o seu sensor WisBlock

Os sensores WisBlock enviam payloads binários. O formato depende de qual módulo de sensor você acoplou. O TagoIO espera variáveis decodificadas no seu formato de dados padrão:

[
  {"variable": "temperature", "value": 22.5, "unit": "C"},
  {"variable": "humidity", "value": 58.0, "unit": "%"}
]

Para transformar o payload bruto do TTN nesse formato, adicione um Payload Parser ao seu dispositivo no TagoIO:

  1. Abra o dispositivo no TagoIO.
  2. Vá até a aba Payload Parser.
  3. Escreva uma função JavaScript que leia payload.uplink_message.decoded_payload (o TTN envia isso se você configurar um formatter no TTN) ou decodifique os bytes brutos de payload.uplink_message.frm_payload.

Exemplo de parser para um sensor ambiental WisBlock (RAK1906 / BME680):

const decoded = payload.uplink_message.decoded_payload;

if (!decoded) {
  payload = [];
  return;
}

payload = [
  { variable: "temperature", value: decoded.temperature, unit: "C" },
  { variable: "humidity", value: decoded.humidity, unit: "%" },
  { variable: "pressure", value: decoded.pressure, unit: "hPa" },
  { variable: "gas_resistance", value: decoded.gas, unit: "Ohm" }
];

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

Passo 6: verifique no Live Inspector

Abra a aba Live Inspector na página do seu dispositivo. Ela mostra cada requisição recebida em tempo real. Dispare um uplink a partir do seu nó WisBlock e confirme que as variáveis decodificadas aparecem antes de montar o dashboard.

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

Caminho 2: gateway RAK + ChirpStack + TagoIO

O RAK7258 e o RAK7289 vêm com um LNS ChirpStack embutido no firmware AEP. Isso é útil para redes LoRaWAN privadas, sem dependência do TTN.

Passo 1: configure o ChirpStack no gateway RAK

  1. Faça login na interface web do gateway RAK (padrão 192.168.230.1).
  2. Vá em LoRa Network e confirme que o ChirpStack está selecionado como servidor de rede.
  3. No servidor de aplicação do ChirpStack, crie uma Application e registre seus dispositivos finais.

Passo 2: adicione uma HTTP Integration no ChirpStack

  1. No ChirpStack, abra sua Application e clique em Integrations.

  2. Adicione uma HTTP Integration.

  3. Defina a Uplink URL com o endpoint HTTPS do TagoIO:

    https://api.tago.io/data

  4. Adicione o cabeçalho HTTP:

    Device-Token: YOUR_TAGOIO_DEVICE_TOKEN

Obtenha o token do dispositivo na aba General do seu dispositivo no TagoIO.

Documentação de token: docs.tago.io/docs/tagoio/devices/device-token

Passo 3: faça o parsing do payload do ChirpStack no TagoIO

O ChirpStack envia um objeto JSON com um campo object contendo os dados decodificados (caso você tenha configurado um codec) ou data em base64. Escreva um Payload Parser no TagoIO de acordo.

// For ChirpStack with codec configured
const obj = payload.object;
payload = [
  { variable: "temperature", value: obj.temperature, unit: "C" },
  { variable: "humidity", value: obj.humidity, unit: "%" }
];

Passo 7: monte seu dashboard

Assim que os dados começarem a fluir, crie um dashboard no TagoIO em Dashboards → +.

Para uma implantação WisBlock com vários sensores, um layout inicial útil:

  • Widget de mapa mostrando a localização de todos os dispositivos (se houver módulo GPS acoplado)
  • Gráficos de série temporal de temperatura e umidade por dispositivo
  • Widgets de card exibindo a leitura mais recente de cada variável
  • Indicadores de status mostrando o nível de bateria e o horário do último contato

Para implantações que gerenciam muitos nós RAK em vários locais, use um Blueprint Dashboard. Um único layout se aplica automaticamente a todos os dispositivos por meio de tags.

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

Passo 8: configure alertas

Use Actions para disparar notificações quando as leituras dos sensores saírem da faixa. Úteis para implantações RAK:

  • Temperatura acima do limite → e-mail/SMS para a equipe de plantão
  • Umidade cai abaixo de 20% em um ambiente controlado → aciona a lógica de ventilação
  • Nenhum dado recebido em 1 hora → alerta de dispositivo offline

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

Exemplos de casos de uso

Agricultura inteligente

Nós WisBlock com sensores de umidade do solo (RAK12035), temperatura e umidade implantados pelo campo. O gateway externo RAK7289 cobre áreas de várias hectares. O TagoIO armazena as leituras e dispara sinais de controle de irrigação quando a umidade do solo cai abaixo da faixa desejada.

Use Blueprint Dashboards para dar a cada zona do campo sua própria visualização sem duplicar configurações.

Monitoramento ambiental industrial

Nós WisBlock com sensores de gás (RAK12004, RAK12009) e de material particulado instalados em áreas de fabricação. As leituras chegam ao TagoIO continuamente. Um script de Analysis calcula médias móveis e grava os valores computados de volta no bucket do dispositivo. Os alertas disparam quando os limites de concentração são ultrapassados.

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

Cadeia do frio e produtos perecíveis

Nós WisBlock em caminhões refrigerados ou câmaras de armazenamento. Módulo GPS (RAK1910) adicionado para rastreamento de localização. O TagoIO recebe dados de temperatura, umidade e GPS. Um widget de mapa mostra a posição dos veículos; um alerta dispara se a temperatura sair da faixa segura durante o transporte.

Indo além com IA

O servidor MCP do TagoIO conecta assistentes de IA como o Claude diretamente aos dados dos seus sensores. Assim que seus dispositivos RAK estiverem enviando dados ao TagoIO, você pode fazer perguntas em linguagem natural: “Qual zona teve a maior umidade na semana passada?” ou “Mostre todos os dispositivos que ficaram offline nas últimas 24 horas.”

Detalhes: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration

Resumo

Conectar dispositivos RAK Wireless ao TagoIO envolve três componentes: um servidor de rede LoRaWAN (TTN ou ChirpStack), um dispositivo TagoIO com o payload parser correto e uma integração via webhook entre os dois. A RAK cuida do hardware e da camada de rádio; o TagoIO cuida de tudo, dos dados brutos aos dashboards e alertas.

Comece com um gateway e um nó WisBlock. Valide os dados no Live Inspector, escreva o payload parser e construa o dashboard a partir daí.

Posts Relacionados

Como conectar sensores LoRaWAN da Elsys ao TagoIO

Como conectar sensores LoRaWAN da Elsys ao TagoIO

Jun 3, 2026

Como conectar gateways LoRaWAN da Kerlink ao TagoIO

Como conectar gateways LoRaWAN da Kerlink ao TagoIO

Jun 2, 2026

Como conectar sensores LoRaWAN da Tektelic ao TagoIO

Como conectar sensores LoRaWAN da Tektelic ao TagoIO

Jun 2, 2026