# 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.

![Como conectar dispositivos RAK Wireless ao TagoIO](https://tago.io/og/pt-br/blog/how-to-connect-rak-wireless-devices-to-tagoio.png)

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](https://tago.io/pricing))
- 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](https://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](https://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](https://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](https://docs.tago.io/docs/tagoio/devices/sending-data):

```json
[
  {"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):

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

```javascript
// 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](https://docs.tago.io/docs/tagoio/dashboards/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](https://docs.tago.io/docs/tagoio/dashboards/)

## Passo 8: configure alertas

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

- Dispositivos 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/)
- Templates de Dashboard: [docs.tago.io/docs/tagoio/dashboards](https://docs.tago.io/docs/tagoio/dashboards/)
- Actions: [docs.tago.io/docs/tagoio/actions](https://docs.tago.io/docs/tagoio/actions/)
- TagoIO 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)