# MTConnect в MQTT

> PLCGateway читает элементы данных любого агента MTConnect и публикует состояние выполнения, количество деталей, положения и conditions как топики MQTT — по топику на элемент данных, с отправкой при изменении значения.

MTConnect передаёт данные станков в виде XML-документов, которые клиент должен запросить и разобрать. Брокеры и IoT-платформы устроены наоборот: им нужны небольшие сообщения, которые сами приходят в топики. PLCGateway циклически запрашивает текущий документ агента, извлекает выбранные элементы данных и публикует каждый из них при изменении.

Элементы данных выбираются при обзоре документа probe агента и добавляются как теги, поэтому ни обработка XML, ни файл сопоставления не нужны. Samples приходят как числа, events — как текст или BOOL, а conditions — как Normal, Warning или Fault.

- **Источник:** [MTConnect](https://plcgateway.com/ru/protocols/mtconnect.md) (`mtconnect`)
- **Подключение:** HTTP · MTConnect agent (e.g. port 5000)
- **Приёмник:** [MQTT](https://plcgateway.com/ru/integrations.md)
- **Запись:** только чтение
- **Входит в:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

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

1. Убедитесь, что агент MTConnect станка доступен (например, http://machine:5000).
2. Добавьте устройство MTConnect с URL агента и при необходимости именем устройства.
3. Просмотрите элементы данных и добавьте нужные как теги.
4. Откройте Gateway → MQTT, введите адрес брокера, порт и учётные данные, включите TLS, если брокер этого требует, и задайте базовый топик.
5. Выберите публикацию при изменении или с интервалом и формат — JSON или само значение, затем проверьте топики с помощью mosquitto_sub или в своей платформе.

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

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

| Тег | Адрес | Пример значения |
|---|---|---|
| `Availability` | `avail` | AVAILABLE |
| `Execution` | `execution` | ACTIVE |
| `PartCount` | `PartCountAct` | 128 |
| `XPosition` | `Xact` | 124.375 mm |

**Топики и payload MQTT**

```
plcgateway/status online
plcgateway/mazak1/Availability {"q":"GOOD","t":1794465246839,"v":"AVAILABLE"}
plcgateway/mazak1/Execution {"q":"GOOD","t":1794465246839,"v":"ACTIVE"}
plcgateway/mazak1/PartCount {"q":"GOOD","t":1794465246839,"v":128}
plcgateway/mazak1/XPosition {"q":"GOOD","t":1794465246839,"u":"mm","v":124.375}
```

Топик: базовый топик / 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)

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

- [MTConnect](https://plcgateway.com/ru/protocols/mtconnect.md)
- [Станки с ЧПУ и MTConnect](https://plcgateway.com/ru/controllers/mtconnect-machines.md)
- [Haas Automation](https://plcgateway.com/ru/controllers/haas.md)

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

### Какие станки поддерживаются?

Любые станки с агентом MTConnect, например Mazak, Okuma, DMG MORI, Hurco и Haas NGC, а также системы ЧПУ, подключённые через адаптер MTConnect.

### Что происходит, если значение UNAVAILABLE?

Тег сохраняет свой топик, а качество в payload меняется на UNCERTAIN, поэтому подписчики могут отличить отсутствующее значение от реального.

### Можно ли управлять станком сообщениями MQTT?

Нет. MTConnect — стандарт только для чтения, записывать там нечего. Для записи используйте собственный интерфейс системы ЧПУ, например макропеременные FOCAS или Q-команды Haas.

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

- [MTConnect в OPC UA](https://plcgateway.com/ru/solutions/mtconnect-to-opc-ua.md)
- [OEE станков с ЧПУ по MTConnect](https://plcgateway.com/ru/solutions/mtconnect-oee.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)
- [Siemens S7 в MQTT](https://plcgateway.com/ru/solutions/siemens-s7-to-mqtt.md)
- [Modbus в MQTT](https://plcgateway.com/ru/solutions/modbus-to-mqtt.md)
- [Все протоколы](https://plcgateway.com/ru/protocols.md)

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

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