# Beckhoff TwinCAT ADS para MQTT

> O PLCGateway lê controladores TwinCAT 2 e TwinCAT 3 via ADS, navega pelos seus símbolos e publica as variáveis selecionadas no seu broker MQTT – sem código MQTT no projeto do CLP.

O TwinCAT pode publicar MQTT a partir do CLP com uma função IoT e blocos de função no projeto. O PLCGateway é o caminho sem código no CLP: ele se conecta via ADS, lista os símbolos do projeto em execução e publica as variáveis que você seleciona.

O gateway encontra os sistemas TwinCAT na rede, cria para você a rota ADS no controlador e pega os tipos de dados do CLP. Ele roda em Windows ou Linux, em um PC ou em um pequeno dispositivo na mesma rede.

- **Origem:** [Beckhoff TwinCAT ADS](https://plcgateway.com/pt/protocols/beckhoff-ads.md) (`ads`)
- **Conexão:** ADS / AMS · TCP 48898 · UDP 48899
- **Destino:** [MQTT](https://plcgateway.com/pt/integrations.md)
- **Escrita:** sim
- **Incluído em:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Configure em cinco passos

1. Adicione um dispositivo com o protocolo Beckhoff TwinCAT (ADS) e clique em “Procurar sistemas TwinCAT”; ao selecionar o CLP, o endereço IP e o AMS NetId são preenchidos.
2. Clique em “Adicionar rota no CLP” e informe o usuário do CLP (imagens Beckhoff mais antigas: Administrator / 1). Isso é necessário apenas uma vez.
3. Abra o navegador de símbolos, selecione variáveis de programa e globais e adicione-as em um único passo – os tipos de dados vêm do CLP.
4. Abra Gateway → MQTT, informe o endereço, a porta e o login do broker, ative o TLS se o broker exigir e escolha o tópico base.
5. Escolha publicação por mudança ou por intervalo e o formato JSON ou valor puro; depois confira os tópicos com mosquitto_sub ou na sua plataforma.

## Exemplo: tópicos e payloads

Um dispositivo com o id cx1 e estas tags é publicado como abaixo; as linhas são o que o mosquitto_sub -v imprime. Nomes e valores são exemplos.

| Tag | Endereço | Valor de exemplo |
|---|---|---|
| `LineSpeed` | `MAIN.Speed` | 12.5 m/min |
| `PumpRunning` | `GVL.Line1.Pump.Running` | true |
| `Setpoint` | `MAIN.Recipe[3]` | 75.5 °C |

**Tópicos e payloads MQTT**

```
plcgateway/status online
plcgateway/cx1/LineSpeed {"q":"GOOD","t":1794465246839,"u":"m/min","v":12.5}
plcgateway/cx1/PumpRunning {"q":"GOOD","t":1794465246839,"v":true}
plcgateway/cx1/Setpoint {"q":"GOOD","t":1794465246839,"u":"°C","v":75.5}
```

Tópico: tópico base / id do dispositivo / nome da tag. O payload JSON traz o valor (v), a qualidade (q), o timestamp em milissegundos (t) e a unidade (u).

## O publicador MQTT do PLCGateway

O PLCGateway publica cada tag no seu broker MQTT – Mosquitto, EMQX, HiveMQ, AWS IoT Core ou uma plataforma em nuvem atrás de uma bridge –, assim os sistemas de TI assinam tópicos em vez de fazer polling no controlador. Ele fala MQTT 3.1.1 via TCP ou TLS, com usuário e senha.

Os valores são enviados quando mudam ou em um intervalo fixo, como JSON com qualidade e timestamp ou apenas o valor puro. Um tópico de status retido com last will informa aos assinantes se o gateway está online.

- Um tópico por tag: tópico base / dispositivo / tag, com o tópico base que você escolher
- QoS 0 ou 1, mensagens retidas, mensagem birth e last will
- Escrita opcional: um valor publicado no tópico /set da tag é escrito no controlador
- As mensagens ficam em fila enquanto o broker está inacessível e são enviadas após a reconexão

![Configurações do publicador MQTT: broker, TLS, tópico base, modo de publicação e formato do payload](https://plcgateway.com/assets/img/shots/mqtt-1400.webp)

## Controladores e dispositivos

- [Beckhoff TwinCAT ADS](https://plcgateway.com/pt/protocols/beckhoff-ads.md)
- [Beckhoff TwinCAT](https://plcgateway.com/pt/controllers/beckhoff.md)

## Perguntas e respostas

### Preciso do TwinCAT ou de um roteador ADS no computador do gateway?

Não. O PLCGateway implementa o ADS ele mesmo e não precisa de instalação do TwinCAT nem de roteador. Ele cria sua própria rota no controlador com o usuário que você informa uma vez.

### Funciona com TwinCAT 2?

Sim. TwinCAT 2 e TwinCAT 3 em Embedded PCs CX, PCs industriais e Bus Terminal Controllers são suportados, por nome de símbolo ou por endereço de memória e de imagem de processo.

### O que acontece após um download ou uma alteração online?

O PLCGateway percebe que a tabela de símbolos mudou, reconecta e resolve as variáveis de novo, então os tópicos mantêm seus nomes e continuam com os novos valores.

## Soluções relacionadas

- [Beckhoff TwinCAT ADS para OPC UA](https://plcgateway.com/pt/solutions/beckhoff-ads-to-opc-ua.md)
- [Modbus para MQTT](https://plcgateway.com/pt/solutions/modbus-to-mqtt.md)
- [Allen-Bradley EtherNet/IP para MQTT](https://plcgateway.com/pt/solutions/ethernet-ip-to-mqtt.md)
- [FANUC FOCAS para MQTT](https://plcgateway.com/pt/solutions/fanuc-focas-to-mqtt.md)
- [CNC Haas para MQTT](https://plcgateway.com/pt/solutions/haas-to-mqtt.md)
- [MTConnect para MQTT](https://plcgateway.com/pt/solutions/mtconnect-to-mqtt.md)
- [Todos os protocolos](https://plcgateway.com/pt/protocols.md)

_Os nomes de produtos e modelos são marcas de seus respectivos proprietários. Eles são citados apenas para indicar com quais equipamentos os drivers se comunicam; o PLCGateway não é afiliado a essas empresas._

---
Source: https://plcgateway.com/pt/solutions/beckhoff-ads-to-mqtt
