# Beckhoff TwinCAT ADS в MQTT

> PLCGateway читает контроллеры TwinCAT 2 и TwinCAT 3 по ADS, просматривает их символы и публикует выбранные переменные в ваш MQTT-брокер — без кода MQTT в проекте ПЛК.

TwinCAT умеет публиковать MQTT из ПЛК с помощью IoT-функции и функциональных блоков в проекте. PLCGateway — путь без кода в ПЛК: он подключается по ADS, выводит список символов работающего проекта и публикует выбранные вами переменные.

Шлюз находит системы TwinCAT в сети, сам добавляет маршрут ADS на контроллере и берёт типы данных из ПЛК. Он работает в Windows или Linux, на ПК или компактном устройстве в той же сети.

- **Источник:** [Beckhoff TwinCAT ADS](https://plcgateway.com/ru/protocols/beckhoff-ads.md) (`ads`)
- **Подключение:** ADS / AMS · TCP 48898 · UDP 48899
- **Приёмник:** [MQTT](https://plcgateway.com/ru/integrations.md)
- **Запись:** да
- **Входит в:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Настройка за пять шагов

1. Добавьте устройство с протоколом Beckhoff TwinCAT (ADS) и нажмите «Найти системы TwinCAT»; при выборе ПЛК его IP-адрес и AMS NetId заполняются автоматически.
2. Нажмите «Добавить маршрут в ПЛК» и введите пользователя ПЛК (в старых образах Beckhoff: Administrator / 1). Это нужно сделать один раз.
3. Откройте обозреватель символов, выберите переменные программ и глобальные переменные и добавьте их за один шаг — типы данных берутся из ПЛК.
4. Откройте Gateway → MQTT, введите адрес брокера, порт и учётные данные, включите TLS, если брокер этого требует, и задайте базовый топик.
5. Выберите публикацию при изменении или с интервалом и формат — JSON или само значение, затем проверьте топики с помощью mosquitto_sub или в своей платформе.

## Пример: топики и payload

Устройство с id cx1 и такими тегами публикуется так, как показано ниже; строки — это вывод mosquitto_sub -v. Имена и значения приведены для примера.

| Тег | Адрес | Пример значения |
|---|---|---|
| `LineSpeed` | `MAIN.Speed` | 12.5 m/min |
| `PumpRunning` | `GVL.Line1.Pump.Running` | true |
| `Setpoint` | `MAIN.Recipe[3]` | 75.5 °C |

**Топики и payload 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}
```

Топик: базовый топик / id устройства / имя тега. Payload в формате JSON содержит значение (v), качество (q), метку времени в миллисекундах (t) и единицу измерения (u).

## Публикатор MQTT в PLCGateway

PLCGateway публикует каждый тег в ваш MQTT-брокер — Mosquitto, EMQX, HiveMQ, AWS IoT Core или облачную платформу через мост, — и ИТ-системы подписываются на топики, а не опрашивают контроллер. Поддерживается MQTT 3.1.1 по TCP или TLS с именем пользователя и паролем.

Значения отправляются при изменении или с заданным интервалом — в формате JSON с качеством и меткой времени или как само значение. Retained-топик состояния с last will сообщает подписчикам, в сети ли шлюз.

- Один топик на тег: базовый топик / устройство / тег, базовый топик задаётся произвольно
- QoS 0 или 1, retained-сообщения, birth-сообщение и last will
- Запись по желанию: значение, опубликованное в топик /set тега, записывается в контроллер
- Пока брокер недоступен, сообщения копятся в очереди и отправляются после переподключения

![Настройки публикации MQTT: брокер, TLS, базовый топик, режим публикации и формат payload](https://plcgateway.com/assets/img/shots/mqtt-1400.webp)

## Контроллеры и устройства

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

## Вопросы и ответы

### Нужен ли на компьютере шлюза TwinCAT или маршрутизатор ADS?

Нет. PLCGateway сам реализует ADS, и ему не нужны ни установка TwinCAT, ни маршрутизатор. Собственный маршрут на контроллере он добавляет сам — под пользователем, которого вы вводите один раз.

### Работает ли это с TwinCAT 2?

Да. Поддерживаются TwinCAT 2 и TwinCAT 3 на встраиваемых ПК серии CX, промышленных ПК и контроллерах Bus Terminal — по имени символа или по адресу в памяти и образе процесса.

### Что происходит после загрузки проекта или онлайн-изменения?

PLCGateway замечает изменение таблицы символов, переподключается и заново разрешает переменные, поэтому топики сохраняют свои имена и продолжают получать новые значения.

## Связанные решения

- [Beckhoff TwinCAT ADS в OPC UA](https://plcgateway.com/ru/solutions/beckhoff-ads-to-opc-ua.md)
- [Modbus в MQTT](https://plcgateway.com/ru/solutions/modbus-to-mqtt.md)
- [Allen-Bradley EtherNet/IP в MQTT](https://plcgateway.com/ru/solutions/ethernet-ip-to-mqtt.md)
- [FANUC FOCAS в MQTT](https://plcgateway.com/ru/solutions/fanuc-focas-to-mqtt.md)
- [Станки Haas в MQTT](https://plcgateway.com/ru/solutions/haas-to-mqtt.md)
- [MTConnect в MQTT](https://plcgateway.com/ru/solutions/mtconnect-to-mqtt.md)
- [Все протоколы](https://plcgateway.com/ru/protocols.md)

_Названия продуктов и моделей являются товарными знаками их владельцев. Они упоминаются только для того, чтобы показать, с каким оборудованием работают драйверы; PLCGateway не связан с этими компаниями._

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