# Beckhoff TwinCAT ADS

> Conecte controladores TwinCAT 2 e TwinCAT 3 pelo nome das variáveis, navegue pelos símbolos do CLP e use-os em OPC UA, SCADA e fluxos de trabalho com IA, sem TwinCAT no PC.

O PLCGateway fala ADS via TCP 48898 diretamente com o roteador TwinCAT do controlador; no PC do gateway não é preciso instalar o TwinCAT nem um roteador ADS. As variáveis são lidas pelos nomes do CLP – variáveis de programa e globais, membros de estruturas, elementos de array e strings – e as leituras de cada ciclo são agrupadas em comandos ADS sum, para que listas longas de variáveis continuem rápidas.

O formulário do dispositivo encontra os sistemas TwinCAT na rede, preenche o endereço IP e o AMS NetId e adiciona a rota ADS no CLP com um clique. Quando um novo programa é carregado no CLP, o driver percebe e resolve as variáveis novamente por conta própria.

- **ID do driver:** `ads`
- **Conexão:** ADS / AMS · TCP 48898 · UDP 48899
- **Navegação de endereços:** sim
- **Escrita:** sim
- **Incluído em:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## O que o PLCGateway lê e escreve

- Variáveis de programa e globais (MAIN, GVL ...)
- Membros de estruturas e variáveis de blocos de função
- Elementos de array, também multidimensionais
- BOOL, tipos inteiros, REAL, LREAL, STRING, WSTRING, TIME e ENUM
- Memória do CLP e imagem de processo por endereço direto (%M, %I, %Q)
- Navegação de símbolos com os tipos de dados do CLP

## Exemplos de endereços

| Endereço | Significado |
|---|---|
| `MAIN.Speed` | Variável de programa |
| `GVL.Line1.Pump.Running` | Membro de estrutura em uma lista de variáveis globais |
| `MAIN.Recipe[3] · MAIN.Matrix[1,2]` | Elementos de array |
| `.Counter` | Variável global do TwinCAT 2 |
| `%MW10 · %MX2.3` | Memória do CLP (word, bit) |
| `%IB0 · %QX1.0` | Imagem de processo das entradas / saídas |

## Controladores e dispositivos

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

## Conecte em poucos 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. Use as variáveis em telas, histórico e alarmes ou publique-as via OPC UA e MQTT.

## Perguntas e respostas

### Preciso do TwinCAT ou de um roteador ADS no PC?

Não. O próprio PLCGateway se conecta ao roteador TwinCAT do controlador via TCP 48898; o TwinCAT só é necessário no controlador.

### Para que serve a rota ADS?

O TwinCAT responde apenas a computadores que têm uma rota no CLP. O PLCGateway a adiciona pelo formulário do dispositivo com o nome de usuário e a senha do CLP; a senha não é armazenada.

### O TwinCAT 2 e os Bus Terminal Controllers BC/BX são suportados?

Sim. Os runtimes do TwinCAT 2 são acessados nas portas AMS 801 a 831; os Bus Terminal Controllers, que não guardam símbolos, são lidos por endereço direto (%MW, %IX ...).

## Protocolos relacionados

- [Cliente OPC UA](https://plcgateway.com/pt/protocols/opc-ua.md)
- [Listas de variáveis de rede (NVL) CODESYS](https://plcgateway.com/pt/protocols/codesys-nvl.md)
- [Allen-Bradley EtherNet/IP (CIP)](https://plcgateway.com/pt/protocols/ethernet-ip.md)
- [Modbus TCP / RTU](https://plcgateway.com/pt/protocols/modbus.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/protocols/beckhoff-ads