# Modbus в MQTT

> PLCGateway опрашивает устройства Modbus TCP и RTU — счётчики электроэнергии, приводы, ПЛК, датчики — и публикует их регистры и coils в MQTT-брокер как именованные масштабированные значения.

Устройства Modbus отвечают только на запросы и возвращают сырое содержимое регистров. IoT-платформе нужно обратное: именованные значения, которые приходят сами. PLCGateway опрашивает регистры, собирает 32- и 64-битные значения в правильном порядке слов, применяет масштабирование и публикует каждый тег при изменении.

В одной установке поддерживаются Modbus TCP, RTU over TCP и RTU по последовательной линии (RS-485 / RS-232), поэтому счётчик электроэнергии с последовательным интерфейсом и ПЛК с Ethernet попадают в один брокер. Соседние регистры читаются одним запросом.

- **Источник:** [Modbus TCP / RTU](https://plcgateway.com/ru/protocols/modbus.md) (`modbus_tcp`, `modbus_rtu_tcp`, `modbus_rtu`)
- **Подключение:** TCP 502 · RTU over TCP · RS-485 / RS-232
- **Приёмник:** [MQTT](https://plcgateway.com/ru/integrations.md)
- **Запись:** да
- **Входит в:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

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

1. Добавьте устройство, выберите Modbus TCP, RTU over TCP или RTU serial и укажите IP-адрес либо последовательный порт со скоростью передачи и чётностью.
2. Задайте unit id и, для 32-битных значений, порядок слов устройства.
3. Создайте теги с адресами и типами данных или импортируйте список регистров из CSV; проверьте связь, чтобы увидеть первые значения.
4. Откройте Gateway → MQTT, введите адрес брокера, порт и учётные данные, включите TLS, если брокер этого требует, и задайте базовый топик.
5. Выберите публикацию при изменении или с интервалом и формат — JSON или само значение, затем проверьте топики с помощью mosquitto_sub или в своей платформе.

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

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

| Тег | Адрес | Пример значения |
|---|---|---|
| `ActivePower` | `HR100` | 42.75 kW |
| `Energy` | `HR200` | 128450.5 kWh |
| `PumpRunning` | `C12` | true |

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

```
plcgateway/status online
plcgateway/meter1/ActivePower {"q":"GOOD","t":1794465246839,"u":"kW","v":42.75}
plcgateway/meter1/Energy {"q":"GOOD","t":1794465246839,"u":"kWh","v":128450.5}
plcgateway/meter1/PumpRunning {"q":"GOOD","t":1794465246839,"v":true}
```

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

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

- [Modbus TCP / RTU](https://plcgateway.com/ru/protocols/modbus.md)
- [Schneider Electric Modicon](https://plcgateway.com/ru/controllers/schneider-electric.md)
- [Контроллеры на базе CODESYS](https://plcgateway.com/ru/controllers/codesys-plcs.md)
- [Автоматизация зданий и счётчики энергии](https://plcgateway.com/ru/controllers/building-automation.md)

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

### Работает ли это с Modbus RTU по RS-485?

Да. Используйте последовательный порт или USB-адаптер компьютера либо преобразователь последовательного интерфейса в Ethernet с RTU over TCP. Скорость передачи, чётность и unit id задаются для каждого устройства.

### Как обрабатываются 32-битные значения float?

Тип данных тега определяет разрядность, а порядок слов (ABCD, CDAB, BADC, DCBA) выбирается для устройства или для отдельного тега, поэтому публикуется само вещественное число, а не два сырых регистра.

### Можно ли записать регистр через MQTT?

Да, если запись включена: значение, отправленное в топик /set тега, записывается в holding-регистр или coil.

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

- [Modbus в OPC UA](https://plcgateway.com/ru/solutions/modbus-to-opc-ua.md)
- [Siemens S7 в MQTT](https://plcgateway.com/ru/solutions/siemens-s7-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)
- [Allen-Bradley EtherNet/IP в MQTT](https://plcgateway.com/ru/solutions/ethernet-ip-to-mqtt.md)
- [Все протоколы](https://plcgateway.com/ru/protocols.md)

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

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