Files
templates/doc/MODBUS_GATEWAY.md
T
Andrey 41f5bf5e94 Добавить общий кодек и Qt-порт Modbus
Реализовать маршруты TCP/RTU, корреляцию ответов, настройки и общий канал Linux-консоли FTDI.
Проверить протокольные эталоны и взаимодействие Qt с единым C-ядром.
2026-11-13 20:32:52 +03:00

3.4 KiB

Общее ядро Modbus-шлюза

c/set-protocol/include/set_modbus_gateway.h и c/set-protocol/src/set_modbus_gateway.c обслуживают RTU ↔ TCP, проверку ответов и атомарную таблицу маршрутов. Код C99 не использует heap, файловую систему, HAL, системные часы и глобальное состояние. CRC16 берётся из существующего set_crc.c.

Слои: GUI / ARM-служба → общее C-ядро → QtSerialPort / Linux UART и TCP. python/set_devices/modbus_gateway.py предоставляет ctypes-модели, python/set_devices/qt_ports/modbus_gateway_port.py — очередь USB и локальный TCP endpoint для переиспользования готового Modbus UI. Физические tty, GPIO DE, Linux интерфейсы и карта FPGA остаются в проекте платы.

API Контракт
smg_tcp_size, smg_rtu_size, smg_rtu_response_size Полный размер ADU, 0 для неполного префикса, -1 для неверного формата
smg_decode_tcp, smg_decode_rtu Один целый ADU; RTU проверяется CRC до извлечения PDU
smg_check FC01/02/03/04/05/06/15/16, количества, byte count, адресный диапазон
smg_tcp, smg_rtu Только сериализация; явные размеры и владение памятью вызывающего
smg_accept_tcp, smg_accept_rtu Корреляция, функция, ожидаемая длина и echo записи до выдачи PDU
smg_config_pack, smg_config_unpack Частная FC65, версия 1, до 20 уникальных входных адресов

Структуры smg_request, smg_route, smg_config являются native ABI, а не wire-форматом. Нельзя передавать их через USB посредством memcpy. Numeric IPv4 хранит значение адреса старшим октетом в старших битах. Поля конфигурации сериализуются явно без padding C-компилятора.

Unit ID 248 зарезервирован для управления. FC65 op=1 читает настройки, op=2 применяет целиком, op=3 возвращает подтверждённую модель. Заголовок конфигурации имеет 13 байт вместе с FC/op/version; маршрут — 10 байт. Поля маршрута: source, target, transport, interface, IPv4 BE32, port BE16. Сериализация времени и baud выполняется C API; UI не знает этих смещений.

В качестве потребителя используется Zynq RK7020: demo/modbus_gateway/server.c, панель SETGUI pc/zynq_modbus_panel.py. Аппаратные ограничения и установка описаны в zynq/docs/MODBUS_GATEWAY.md. Публичный модуль собирается штатным CMake set-protocol; test_modbus_gateway проверяет независимые эталонные байты, CRC, границы, remap, Transaction ID и транзакционность конфигурации.