ModbusMapDocGenerator
Статья описывает назначение внешнего модуля ModbusMapDocGenerator, его место в цепочке генерации и структуру итогового Excel-файла ModbusMap.xls.
Назначение
Section titled “Назначение”Внешний модуль ModbusMapDocGenerator входит в библиотеку StandardModules.dll и предназначен для создания Excel-документа ModbusMap с картой регистров Modbus выбранного ПЛК для передачи сторонним организациям.
Модуль формирует таблицу соответствия:
- человекочитаемого наименования сигнала;
- тега тех. объекта;
- типа данных;
- адресов регистров чтения и записи;
- кодов Modbus-функций;
- текстовых состояний дискретных сигналов.
Результат используется для сдачи проектной документации, согласования карты Modbus с интеграторами и проверки назначенных адресов после генерации.
Внешний вид модуля в Uniplant Atomix
Section titled “Внешний вид модуля в Uniplant Atomix”
Карточка внешнего модуля «ModbusMapDocGenerator» в Uniplant Atomix
Роль в цепочке генерации
Section titled “Роль в цепочке генерации”Перед выгрузкой Excel-документа модуль использует результат MapCreator: карта Modbus строится по инстансам выбранного ПЛК, после чего данные переносятся в шаблон Excel.
Адреса регистров и коды Modbus-функций в ModbusMap.xls рассчитываются по тому же алгоритму, что и при генерации словаря Unimod: стартовые адреса из PlcOptions, отбор экземпляров по isMapped, сортировка по TechObject.modbusTemplate, привязка каналов по mapping и опция округления DI/COIL. Подробное описание правил — в статье Алгоритм присвоения адресов Modbus; пошаговый пример — в Пример адресации Modbus: AiProc3 / 4_20mA_namur.
Пользователь запускает ModbusMapDocGenerator кнопкой Play; MapCreator отрабатывает автоматически внутри общей цепочки генерации.
Результат и структура
Section titled “Результат и структура”Результат работы
Section titled “Результат работы”После успешного выполнения модуль сохраняет файл ModbusMap.xls в каталог документации ПЛК:
%JSC%\USR\PRJ\ResultFiles\PLC\<PlcName>\Docs\ModbusMap\ModbusMap.xls
Для быстрого доступа к файлу используйте кнопку «Открыть папку документации» в разделе «Результат сборки» (аналогично Выгрузке упаковки DI в Modbus).
Шаблон оформления Excel берётся из глобальной настройки [MODBUS_BASE_PATH] (по умолчанию %JSC%\Conf\Models\System\Docs\ModbusBase.xls). Подробнее: Глобальные настройки SettingManager.
Структура файла ModbusMap.xls
Section titled “Структура файла ModbusMap.xls”Итоговый документ содержит один лист с таблицей сигналов. Первая строка — заголовки колонок, далее по одной строке на каждый Modbus-канал.
| Колонка | Назначение |
|---|---|
| Наименование сигнала | Человекочитаемое описание: имя ПЛК, типовой блок и канал (например, «Входной сигнал Открыт», «Недостоверность сигнала Открыт»). |
| Тег | Полный тег тех. объекта и канала (P0_72MOV0001.InOpen, P0_72MOV0001.OprOpen). |
| Минимум шкалы | Нижняя граница шкалы для аналоговых сигналов. |
| Максимум шкалы | Верхняя граница шкалы для аналоговых сигналов. |
| Ед. измерения | Единица измерения (C, bar, % и т.п.). |
| Коэф. масштабирования | Коэффициент масштабирования значения. |
| State 0 (FALSE) | Текстовое состояние логического 0 (для дискретных сигналов). |
| Признак State 0 (FALSE) | Подпись/признак для состояния FALSE. |
| State 1 (TRUE) | Текстовое состояние логического 1 (например, «Сработка», «Пуск команды»). |
| Признак State 1 (TRUE) | Подпись/признак для состояния TRUE. |
| Тип данных | Bool, Integer, Real. |
| Адрес регистра чтения (дес.) | Десятичный Modbus-адрес для чтения. |
| Адрес регистра записи (дес.) | Десятичный Modbus-адрес для записи; заполняется для команд и параметров с двусторонним обменом. |
| Бит | Номер бита в слове для дискретных сигналов в packed-формате (если используется упаковка). |
| Код функции | Modbus-функции чтения и/или записи. |
| Значение команды | Значение команды (если задано в карте). |
| Примечание | Дополнительный комментарий к строке. |
Алгоритм работы
Section titled “Алгоритм работы”- Проверяется контекст выбранного ПЛК и инициализация настроек.
- MapCreator строит Modbus-карту по инстансам модели ПЛК.
- Данные карты переносятся в Excel-шаблон
[MODBUS_BASE_PATH]. - Итоговый файл
ModbusMap.xlsсохраняется вDocs\ModbusMapкаталога результатов ПЛК. - В логе фиксируется завершение операции; у модуля отображается статус успешного выполнения.
Связанные разделы
Section titled “Связанные разделы”- Алгоритм присвоения адресов Modbus — правила расчёта адресов, используемые MapCreator и этим модулем.
- MapCreator — построение Modbus-карты, используемой модулем.
- Выгрузка упаковки DI в Modbus — формирование packed-карты
ModbusMapPacked.xls.