# Como conectar o Multitech Conduit à TagoIO

> Guia passo a passo para conectar o gateway Multitech Conduit AEP à TagoIO. Aborda as opções de LNS mPower e ChirpStack, encaminhamento de dados por MQTT e HTTPS, parsing de payload e exemplos de implantação para monitoramento industrial e automação predial.

![Como conectar o Multitech Conduit à TagoIO](https://tago.io/og/pt-br/blog/how-to-connect-multitech-conduit-to-tagoio.png)

O Multitech Conduit é um dos gateways LoRaWAN mais consolidados em implantações industriais e comerciais na América do Norte. O modelo Conduit AEP (Application Enablement Platform) roda um ambiente Linux local com um LoRaWAN Network Server integrado e suporta encaminhamento de dados tanto por HTTPS quanto por MQTT.

A TagoIO é a camada de aplicação: ela armazena leituras de sensores, alimenta dashboards, dispara alertas e expõe seus dados por meio de uma API REST. Conectar o Conduit AEP à TagoIO entrega uma stack completa do local até a nuvem, sem nenhuma dependência de nuvem de terceiros entre o gateway e a sua aplicação.

Este guia cobre dois caminhos de integração: envio por HTTPS do Conduit AEP direto para a TagoIO e encaminhamento por MQTT usando o TagoTiP.

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

- Uma conta TagoIO ([plano gratuito disponível](https://tago.io/pricing))
- Um Multitech Conduit AEP (MTCAP, MTCDTIP ou modelo compatível)
- O firmware mPower® (vem pré-instalado no Conduit AEP)
- Dispositivos finais registrados (LoRaWAN OTAA ou ABP)

## Visão geral da arquitetura

O Conduit AEP roda um LoRaWAN Network Server localmente. Os dispositivos finais entram na rede através do gateway, e o LNS do AEP decodifica e roteia os payloads de aplicação. Você configura o AEP para enviar esses payloads para a TagoIO via HTTPS ou MQTT.

```
[sensores LoRaWAN] → [LNS do Conduit AEP] → [TagoIO via HTTPS ou MQTT]
```

## Caminho 1: Conduit AEP → HTTPS → TagoIO

Este caminho usa a interface web do mPower para criar um Custom App que faz POST dos dados para a API da TagoIO.

### Passo 1: criar um dispositivo na TagoIO

1. Faça login em [admin.tago.io](https://admin.tago.io).
2. Vá em **Devices → Add Device**.
3. Selecione **HTTPS** como connector.
4. Nomeie o dispositivo (por exemplo, `conduit-sensor-node-01`).
5. Copie o **Device Token** na aba General.

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

### Passo 2: registrar os dispositivos finais no Conduit AEP

1. Faça login na interface web mPower do seu Conduit (padrão: `https://192.168.2.1`).
2. Vá em **LoRaWAN → Network Server**.
3. Clique em **Add Device** e informe **DevEUI**, **AppEUI** e **AppKey** de cada sensor.
4. Atribua cada dispositivo a uma **Application**.

### Passo 3: criar um Custom App no Conduit AEP

O Conduit AEP suporta Node-RED ou scripts customizados em Python/Node.js por meio do App Framework. Aqui usamos o fluxo Node-RED integrado para encaminhar os dados.

1. Na interface do mPower, vá em **App → Node-RED** e inicie a ferramenta.
2. Crie um fluxo:
   - **Input**: nó LoRa (recebe o uplink do LNS do AEP)
   - **Function node**: faz o parsing do payload e o formata para a TagoIO
   - **HTTP request node**: faz POST para `https://api.tago.io/data` com o header `Device-Token`

Código de exemplo do function node:

```javascript
const loraMsg = msg.payload;
const rawHex = loraMsg.data;

// Example: 2-byte temperature, 2-byte humidity
const buf = Buffer.from(rawHex, "hex");
const temperature = buf.readInt16BE(0) / 100;
const humidity = buf.readInt16BE(2) / 100;

msg.payload = JSON.stringify([
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" },
  { variable: "rssi", value: loraMsg.rssi },
  { variable: "snr", value: loraMsg.snr }
]);

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

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

return msg;
```

3. Faça o deploy do fluxo. Os dados passarão a fluir do Conduit AEP para a TagoIO a cada uplink.

## Caminho 2: Conduit AEP → MQTT → TagoIO (TagoTiP)

Para aplicações de menor latência ou se você prefere MQTT a HTTP, use o TagoTiP: o protocolo MQTT da TagoIO.

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

1. Na TagoIO, vá em **Devices → Add Device**.
2. Pesquise por **TagoTiP** e selecione.
3. Defina o **Serial Number** deste dispositivo (ele mapeia para o tópico MQTT).
4. Salve e anote o **Authorization Hash** na aba General.

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

### Passo 2: configurar o encaminhamento por MQTT no Conduit AEP

No function node do Node-RED, altere a saída para publicar no TagoTiP:

```javascript
const SERIAL = "conduit-node-01";
const AUTH_HASH = "your_auth_hash_here";

const loraMsg = msg.payload;
const buf = Buffer.from(loraMsg.data, "hex");
const temperature = buf.readInt16BE(0) / 100;
const humidity = buf.readInt16BE(2) / 100;

msg.topic = `$tip/${SERIAL}/push`;
msg.payload = `[temperature:=${temperature}#C;humidity:=${humidity}#%]`;

return msg;
```

Conecte um nó **MQTT out** a esse function node, configurado com:

| Configuração | Valor |
|---|---|
| Server | `mqtt.tip.us-e1.tago.io` (US) ou `mqtt.tip.eu-w1.tago.io` (EU) |
| Port | `1883` (ou `8883` com TLS) |
| Username | Os 8 primeiros caracteres hex do seu Authorization Hash |
| Password | Os 8 últimos caracteres hex do seu Authorization Hash |

## Passo 3: verificar no Live Inspector

Abra o **Live Inspector** do seu dispositivo na TagoIO e confirme que as variáveis chegam corretamente a cada ciclo de uplink.

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

## Passo 4: criar dashboards e alertas

Crie dashboards em **Dashboards → +**. O Conduit AEP é usado com frequência em:

- **Ambientes industriais**: exibir métricas de saúde das máquinas por ativo
- **Automação predial**: monitoramento de HVAC, iluminação e energia por andar
- **Sites remotos**: Conduit com conexão celular e sensores alimentados por energia solar

Para implantações Conduit em múltiplos sites, use os [Blueprint Dashboards](https://docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard) para criar um único layout que se aplica automaticamente a cada site com base nas tags dos dispositivos.

Configure [Actions](https://docs.tago.io/docs/tagoio/actions/) para:
- Notificações de violação de limiar
- Alertas de dispositivo offline quando nenhum dado chega dentro de uma janela configurável
- Exportações de relatórios automatizadas

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

## Exemplos de casos de uso

### Monitoramento industrial

Conduit AEP instalado em uma fábrica com sensores de vibração LoRaWAN em motores e bombas. O Node-RED no Conduit faz o parsing e encaminha os dados para a TagoIO. Scripts de Analysis na TagoIO rodam detecção de anomalias nas assinaturas de vibração e abrem chamados de manutenção quando padrões precoces de desgaste são detectados.

### Automação predial com sensores de HVAC

Vários sensores LoRaWAN de temperatura e umidade espalhados por um edifício comercial. O Conduit AEP roteia as leituras para a TagoIO. A TagoIO alimenta um Blueprint Dashboard mostrando os níveis de conforto por zona e se integra a sistemas BMS por meio de chamadas de API nas Actions.

### Monitoramento ambiental remoto

Conduit MTCDTIP (com backup celular) em uma estação de monitoramento de uma concessionária de água. Sensores LoRaWAN de nível e qualidade da água reportam para a TagoIO. Se a conectividade celular cai, o Conduit armazena as leituras localmente (via SQLite no Node-RED) e ressincroniza quando a conexão retorna.

## Indo além com IA

O servidor MCP da TagoIO conecta assistentes de IA como o Claude aos dados dos seus sensores Conduit. Depois de integrado, você pode fazer perguntas em linguagem natural sobre sua implantação sem escrever consultas manualmente.

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

O Multitech Conduit AEP se conecta à TagoIO via HTTPS ou MQTT. O Node-RED no Conduit cuida da lógica de integração: faz o parsing dos payloads LoRaWAN brutos do LNS do AEP e encaminha dados limpos para a TagoIO. Assim que os dados começam a fluir, a TagoIO gerencia o armazenamento, os dashboards e o alerta.

- Dispositivos TagoIO: [docs.tago.io/docs/tagoio/devices](https://docs.tago.io/docs/tagoio/devices/)
- Formato de envio de dados: [docs.tago.io/docs/tagoio/devices/sending-data](https://docs.tago.io/docs/tagoio/devices/sending-data)
- MQTT do TagoTiP: [docs.tago.io/docs/tagotip/transports/mqtt](https://docs.tago.io/docs/tagotip/transports/mqtt)
- 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)