# Como conectar roteadores celulares Robustel à TagoIO

> Como conectar roteadores celulares industriais IoT da Robustel (R2000, R3000, R5020) à TagoIO. Aborda encaminhamento por MQTT e HTTPS, o SDK RobustLink, a ponte de Modbus para a nuvem e casos de uso de monitoramento remoto industrial.

![Como conectar roteadores celulares Robustel à TagoIO](https://tago.io/og/pt-br/blog/how-to-connect-robustel-cellular-routers-to-tagoio.png)

A Robustel fabrica roteadores e gateways celulares industriais IoT usados em monitoramento remoto, utilities, transporte e automação industrial. As séries R2000, R3000 e R5020 conectam equipamentos de campo via RS-232, RS-485, Modbus e interfaces de I/O, e se comunicam por 4G LTE, 5G ou Wi-Fi.

A TagoIO é a camada de aplicação: ela recebe dados dos dispositivos Robustel, os armazena ao longo do tempo, alimenta dashboards e dispara alertas. Conectar a Robustel à TagoIO dá às suas operações de campo um backend de aplicação na nuvem sem que você precise construir um servidor próprio.

Este guia aborda a integração baseada em MQTT (recomendada para dados em tempo real) e o encaminhamento via HTTPS REST.

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

- Uma conta TagoIO ([plano gratuito disponível](https://tago.io/pricing))
- Um gateway Robustel (R2000, R3000, R5020 ou modelo compatível)
- Cartão SIM celular com plano de dados instalado no dispositivo Robustel
- Instrumentos de campo conectados às portas RS-485 ou I/O do Robustel

## Visão geral da arquitetura

```
[Instrumentos de campo] → (RS-485/Modbus ou I/O digital) → [Gateway Robustel]
                                                               ↓ (MQTT ou HTTPS via celular/LTE)
                                                          [TagoIO]
```

## Caminho 1: Robustel → MQTT → TagoIO (TagoTiP)

Os dispositivos Robustel suportam MQTT nativamente através do framework de aplicação RobustLink e do cliente MQTT embarcado.

### Passo 1: criar um dispositivo TagoTiP na TagoIO

1. Faça login em [admin.tago.io](https://admin.tago.io).
2. Clique em **Devices → Add Device**.
3. Procure por **TagoTiP** e selecione-o.
4. Nomeie o dispositivo e defina um **Serial Number** (usado no tópico MQTT).
5. Copie o **Authorization Hash** na aba General.

Documentação de MQTT do TagoTiP: [docs.tago.io/docs/tagotip/transports/mqtt](https://docs.tago.io/docs/tagotip/transports/mqtt)

### Passo 2: configurar o MQTT no gateway Robustel

Faça login na interface web da Robustel e navegue até **Services → RobustLink → MQTT**:

| Configuração | Valor |
|---|---|
| MQTT Broker Host | `mqtt.tip.us-e1.tago.io` (US) ou `mqtt.tip.eu-w1.tago.io` (EU) |
| Port | `1883` |
| Client ID | qualquer string única |
| Username | Os primeiros 8 caracteres hex do Authorization Hash |
| Password | Os últimos 8 caracteres hex do Authorization Hash |
| Publish Topic | `$tip/YOUR_SERIAL/push` |

### Passo 3: mapear os dados de campo para o payload do TagoTiP

Configure a coleta de dados do RobustLink na Robustel para fazer polling dos seus registradores Modbus ou I/O digital no intervalo desejado, e formate o payload de publicação usando a sintaxe do TagoTiP:

```
[temperature:=87.3#C;pressure:=4.32#bar;alarm_input:=0]
```

Para dispositivos Robustel com o SDK RobustLink (suporta scripts em Python no R5020 e no R3000 Pro):

```python
import paho.mqtt.client as mqtt

SERIAL = "robustel-site-01"
AUTH_HASH = "your_auth_hash_here"
HOST = "mqtt.tip.us-e1.tago.io"

# Read Modbus registers (example using pymodbus)
temperature = read_modbus_register(1, 40001)
pressure = read_modbus_register(1, 40002)

client = mqtt.Client()
client.username_pw_set(AUTH_HASH[:8], AUTH_HASH[8:])
client.connect(HOST, 1883)

payload = f"[temperature:={temperature}#C;pressure:={pressure}#bar]"
client.publish(f"$tip/{SERIAL}/push", payload)
client.disconnect()
```

## Caminho 2: Robustel → HTTPS REST → TagoIO

Para implantações mais simples ou dispositivos sem configuração completa de MQTT, use o cliente HTTP da Robustel para fazer POST dos dados na API da TagoIO.

### Passo 1: criar um dispositivo HTTPS na TagoIO

1. Na TagoIO, vá em **Devices → Add Device → HTTPS**.
2. Nomeie o dispositivo e copie o **Device Token**.

### Passo 2: configurar o POST HTTP no dispositivo Robustel

Na interface web da Robustel, navegue até **Services → RobustLink → HTTP**:

- **URL**: `https://api.tago.io/data`
- **Method**: POST
- **Headers**: `Device-Token: YOUR_DEVICE_TOKEN`, `Content-Type: application/json`
- **Body template**:

```json
[
  {"variable": "temperature", "value": ${temperature}},
  {"variable": "pressure", "value": ${pressure}},
  {"variable": "signal_strength", "value": ${rssi}}
]
```

O cliente HTTP do RobustLink da Robustel suporta substituição de variáveis no corpo do payload usando a sintaxe `${variable_name}` para os canais de dados mapeados.

Documentação de envio de dados: [docs.tago.io/docs/tagoio/devices/sending-data](https://docs.tago.io/docs/tagoio/devices/sending-data)

## Passo 3: verificar no Live Inspector

Abra o **Live Inspector** na TagoIO e confirme que as leituras chegam no intervalo esperado.

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

## Passo 4: construir dashboards e alertas

Em **Dashboards → +**, crie um dashboard de operação. Para implantações de monitoramento remoto com a Robustel:

- **Widget de mapa** mostrando todos os locais dos sites remotos (use latitude/longitude dos dispositivos Robustel equipados com GPS)
- **Gráficos de séries temporais** para as principais variáveis de processo
- **Cards de status** mostrando o horário da última comunicação e a intensidade do sinal celular
- **Log de alertas** mostrando eventos recentes de limite excedido

Para vários sites com layouts idênticos, use os [Blueprint Dashboards](https://docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard).

Configure [Actions](https://docs.tago.io/docs/tagoio/actions/) para alertas de offline quando um gateway Robustel parar de reportar (queda de sinal celular ou falta de energia).

## Exemplos de casos de uso

### Monitoramento remoto de estação de bombeamento

Robustel R2000 em uma estação de bombeamento de uma empresa de água. Lê vazão, pressão e nível via Modbus a partir de um PLC. Envia para a TagoIO a cada 60 segundos por LTE. O dashboard da TagoIO mostra o status da estação em tempo real. Um alerta dispara e envia um SMS se a bomba ficar offline ou se a pressão cair abaixo do mínimo.

### Detecção de vazamentos em dutos

Robustel R3000 Pro em vários pontos ao longo de um gasoduto. Sensores de pressão conectados via RS-485. Scripts de Analysis da TagoIO executam cálculos de pressão diferencial entre pontos adjacentes e sinalizam anomalias compatíveis com assinaturas de vazamento.

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

### Rastreamento de frotas e ativos móveis

Robustel R5020 em caminhões e veículos de construção. Dados de GPS + CAN-bus enviados para a TagoIO a cada 30 segundos. O widget de mapa da TagoIO mostra as posições da frota ao vivo. O tempo ocioso e o consumo de combustível são calculados via Analysis e exibidos em um dashboard de operações.

## Indo além com IA

O servidor MCP da TagoIO permite que assistentes de IA consultem os dados de campo da Robustel em linguagem natural. Pergunte: "Quais sites remotos perderam conectividade nas últimas 24 horas?" ou "Mostre a pressão média de bombeamento de cada site 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 roteadores celulares da Robustel conectam-se à TagoIO via MQTT (TagoTiP) ou HTTPS REST, enviando dados de Modbus e I/O dos instrumentos de campo por LTE. A integração é configurada no lado da Robustel através do framework RobustLink, sem necessidade de middleware adicional.

- TagoTiP MQTT: [docs.tago.io/docs/tagotip/transports/mqtt](https://docs.tago.io/docs/tagotip/transports/mqtt)
- Envio de dados: [docs.tago.io/docs/tagoio/devices/sending-data](https://docs.tago.io/docs/tagoio/devices/sending-data)
- Scripts de Analysis: [docs.tago.io/docs/tagoio/analysis](https://docs.tago.io/docs/tagoio/analysis/)
- 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)
