Реализовать маршруты TCP/RTU, корреляцию ответов, настройки и общий канал Linux-консоли FTDI. Проверить протокольные эталоны и взаимодействие Qt с единым C-ядром.
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 и транзакционность конфигурации.