# Como conectar dispositivos IoT industriais da Advantech à TagoIO

> Como conectar gateways IoT industriais e controladores edge da Advantech à TagoIO. Cobre o encaminhamento de dados via MQTT e REST API a partir dos dispositivos das séries WISE-4000 e ECU, a ponte Modbus-para-nuvem, a formatação de payload e casos de uso de monitoramento industrial.

![Como conectar dispositivos IoT industriais da Advantech à TagoIO](https://tago.io/og/pt-br/blog/how-to-connect-advantech-industrial-iot-devices-to-tagoio.png)

A Advantech fabrica gateways IoT de nível industrial, controladores edge e módulos de I/O usados em fábricas, concessionárias de energia e indústrias de processo no mundo todo. Os módulos de I/O sem fio da série WISE-4000, os controladores edge ECU-1000 e os módulos de aquisição de dados ADAM conectam-se diretamente a instrumentos de campo: termopares, transdutores de pressão, medidores de vazão e CLPs, e transmitem leituras por Ethernet ou rede celular.

A TagoIO fornece a camada de aplicação: uma plataforma em nuvem para armazenamento de dados, dashboards, alertas e integração via API. Conectar o hardware da Advantech à TagoIO cria uma ponte entre os dados de campo da sua OT (Tecnologia Operacional) e os sistemas e fluxos de trabalho de TI que precisam deles.

Este guia aborda a integração via MQTT (o caminho preferencial para os dispositivos WISE e ECU da Advantech) e o encaminhamento via REST API para dispositivos com suporte a HTTP.

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

- Uma conta TagoIO ([plano gratuito disponível](https://tago.io/pricing))
- Um gateway ou módulo de I/O da Advantech (WISE-4050, WISE-4060, ECU-1051 ou similar)
- Conectividade de rede do dispositivo Advantech até a internet
- Instrumentos de campo conectados aos canais de I/O da Advantech

## Visão geral da arquitetura

Os dispositivos da Advantech têm suporte nativo a MQTT. Os módulos da série WISE-4000 têm um cliente MQTT embutido que publica dados de I/O em tópicos configuráveis. Os controladores ECU oferecem suporte a Node-RED e Python para lógicas de encaminhamento mais complexas.

```
[Instrumentos de campo/CLPs]
        ↓ (Modbus/4-20mA/I/O digital)
[Gateway/módulo de I/O da Advantech]
        ↓ (MQTT ou HTTPS)
[TagoIO: armazenamento, dashboards, alertas]
```

## Caminho 1: Série WISE-4000 → MQTT → TagoIO (TagoTiP)

A série WISE-4000 tem um cliente MQTT embutido que publica leituras de I/O analógicas e digitais. Use o TagoTiP (o protocolo MQTT da TagoIO) para receber esses dados.

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

1. Faça login em [admin.tago.io](https://admin.tago.io).
2. Clique em **Devices → Add Device**.
3. Pesquise por **TagoTiP** e selecione.
4. Dê um nome ao dispositivo (por exemplo, `wise-4050-machine-01`).
5. Defina um **Serial Number** (usado no caminho do tópico MQTT).
6. Salve e copie o **Authorization Hash** da aba General.

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

### Passo 2: Configure o MQTT no WISE-4050

Faça login na interface web do WISE-4050 e vá até a seção de configuração do MQTT:

| Configuração | Valor |
|---|---|
| MQTT Broker | `mqtt.tip.us-e1.tago.io` |
| Porta | `1883` |
| Usuário | Primeiros 8 caracteres do seu Authorization Hash |
| Senha | Últimos 8 caracteres do seu Authorization Hash |
| Tópico de publicação | `$tip/YOUR_SERIAL_NUMBER/push` |
| QoS | 1 |

Defina o **Publish Interval** com a frequência de envio desejada (por exemplo, a cada 30 segundos).

### Passo 3: Mapeie as leituras dos canais do WISE para o payload do TagoTiP

O formato de payload do TagoTiP usa uma sintaxe de texto compacta:

```
[ai0:=4.32#mA;ai1:=18.7#mA;di0:=1;temperature:=87.3#C]
```

Configure o payload do tópico do WISE-4050 para publicar os canais de entrada analógica nesse formato. Os dispositivos WISE oferecem suporte a templates de payload personalizados: consulte o manual do usuário do WISE-4050 para configurar os mapeamentos de tópico e payload.

Se você estiver usando um controlador ECU com Node-RED, o function node para montar um payload TagoTiP fica assim:

```javascript
const ai0 = msg.payload.AI_0;
const ai1 = msg.payload.AI_1;
const di0 = msg.payload.DI_0;

msg.payload = `[ai_channel_0:=${ai0}#mA;ai_channel_1:=${ai1}#mA;digital_input_0:=${di0}]`;
msg.topic = "$tip/wise-4050-machine-01/push";
return msg;
```

## Caminho 2: ECU da Advantech → Node-RED → HTTPS → TagoIO

Os controladores da série ECU-1000 rodam Node-RED, o que facilita a montagem de um pipeline de dados para a REST API da TagoIO.

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

1. Na TagoIO, vá em **Devices → Add Device → HTTPS**.
2. Nomeie o dispositivo e salve.
3. Copie o **Device Token** da aba General.

### Passo 2: Monte um flow no Node-RED do ECU

Instale a palette `node-red-contrib-modbus` para ler os registradores Modbus e, em seguida, encaminhe os dados para a TagoIO:

```
[Modbus Read] → [Function: mapear registradores para o formato da TagoIO] → [HTTP Request: POST para a TagoIO]
```

Function node:

```javascript
const registers = msg.payload; // Array of Modbus register values

const pressure = registers[0] * 0.1; // scale factor
const flow = registers[1] * 0.01;
const temperature = registers[2] / 10;

msg.payload = JSON.stringify([
  { variable: "pressure", value: pressure, unit: "bar" },
  { variable: "flow_rate", value: flow, unit: "L/min" },
  { variable: "temperature", value: temperature, unit: "C" }
]);

msg.headers = {
  "Content-Type": "application/json",
  "Device-Token": "YOUR_TAGOIO_DEVICE_TOKEN"
};

msg.url = "https://api.tago.io/data";
return msg;
```

Esse padrão funciona com qualquer instrumento conectado via Modbus: medidores de vazão, transmissores de pressão, sensores de nível, analisadores.

Formato de envio de dados: [docs.tago.io/docs/tagoio/devices/sending-data](https://docs.tago.io/docs/tagoio/devices/sending-data)

## Passo 3: Verifique no Live Inspector

Abra o **Live Inspector** na TagoIO e confirme que as leituras do seu dispositivo Advantech chegam com os valores e nomes de variáveis corretos.

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

## Passo 4: Monte dashboards para operações industriais

Em **Dashboards → +**, crie um dashboard para o operador. Widgets comuns em implantações industriais com a Advantech:

- **Gráficos de medidor (gauge)** para leituras atuais de pressão, temperatura e vazão
- **Gráficos de série temporal** mostrando tendências ao longo de 24 horas, 7 dias ou do período do turno
- **Indicadores de status** para estados de I/O digital (válvula aberta/fechada, alarme ativo)
- **Contadores de OEE ou produção** atualizados via scripts de Analysis

Para implantações com várias máquinas ou várias plantas, use os [Blueprint Dashboards](https://docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard) para replicar um único layout em todos os ativos.

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

## Passo 5: Alertas e automação

Use as [Actions](https://docs.tago.io/docs/tagoio/actions/) para:
- Enviar SMS ou e-mail quando a pressão ultrapassar limites seguros
- Disparar um script de Analysis da TagoIO quando uma entrada digital de alarme for para HIGH
- Chamar uma API externa (por exemplo, um sistema CMMS/ERP) quando uma máquina entrar em estado de falha

Para processamentos mais complexos: cálculo de OEE, detecção de desvio ao longo do tempo ou pontuação de anomalias, use os [Analysis Scripts](https://docs.tago.io/docs/tagoio/analysis/) em JavaScript.

## Exemplos de casos de uso

### Monitoramento de bombas e compressores

WISE-4050 conectado a transmissores de pressão e temperatura 4-20mA em um skid de bombas. Leituras a cada 30 segundos enviadas à TagoIO. Um script de Analysis calcula o índice de eficiência da curva da bomba e o grava de volta como uma variável derivada. Alertas disparam quando a eficiência cai abaixo da linha de base.

### Utilização de máquinas CNC

ECU-1051 conectado a máquinas CNC via Modbus. Lê a velocidade do fuso, a carga do eixo e o status de execução/ociosidade do programa. A TagoIO calcula a utilização da máquina por turno e grava relatórios diários de OEE em uma planilha do Google Sheets conectada via HTTP Action.

### Medição em concessionárias de energia

Módulos de I/O Ethernet ADAM-6717 lendo saídas de pulso de medidores de energia. As leituras são agregadas na TagoIO para calcular o consumo de kWh por hora. Um dashboard mostra as tendências de custo de energia por linha de produção.

## Indo além com IA

O servidor MCP da TagoIO permite consultar os dados das suas máquinas Advantech em linguagem natural. Pergunte ao Claude: "Qual foi o pico de pressão na Máquina 3 ontem à noite?" ou "Mostre todos os dispositivos que tiveram um disparo de alarme digital 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 dispositivos industriais da Advantech se conectam à TagoIO via MQTT (TagoTiP) ou HTTPS REST. Os dispositivos da série WISE-4000 usam o cliente MQTT embutido; os controladores ECU usam Node-RED para roteamento mais complexo e para a ponte Modbus. Qualquer um dos caminhos leva os dados de I/O Modbus e analógicos para a TagoIO, onde ficam disponíveis para armazenamento, visualização e alertas.

- MQTT no TagoTiP: [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)
- Analysis Scripts: [docs.tago.io/docs/tagoio/analysis](https://docs.tago.io/docs/tagoio/analysis/)
- Dashboards: [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/)

[llms.txt](https://tago.io/llms.txt)