Настройки подключения оборудования
Статья описывает регистрацию и подключение паллетайзеров, зарядных станций и другого оборудования. Для этих объектов WCS поддерживает Modbus и OPC UA; для зарядных станций также доступен тип подключения «Автоматическая». Роботы регистрируются в отдельной форме.
Порядок настройки
- Заполните основные сведения об оборудовании и выберите его положение на карте.
- При необходимости выберите шаблон устройства.
- Выберите тип подключения.
- Заполните параметры выбранного протокола.
- Для OPC UA выберите хотя бы одну ноду.
- Нажмите «Сохранить».
- Откройте созданное оборудование и проверьте вкладки «Подключение» и «Отладка».
Параметры сети, последовательного порта, безопасности и регистров должны соответствовать конфигурации контроллера. Не подбирайте их экспериментально на рабочем оборудовании.
Основные сведения
| Поле | Обязательность | Назначение |
|---|---|---|
| «Название» | Обязательное | Понятное пользователю название оборудования |
| «Серийный номер» | Обязательное | Уникальный идентификатор оборудования |
| «Точка» | Обязательное | ID точки активной LIF-карты, к которой привязано оборудование |
| «Ориентация» | Обязательное | Целочисленный угол отображения модели на карте в градусах |
| «Карта» | Обязательное | Layout активной LIF-карты, содержащий выбранную точку |
| «Шаблон» | Необязательное | Шаблон устройства с JSON-настройками и файлами 2D- и 3D-моделей |
| «Активный» | Необязательное | Признак доступности оборудования для рабочих процессов; по умолчанию включён |
Для ориентации вводится число без знака градуса, например 0, 90, 180 или 270. Направление при 0° зависит от исходной ориентации модели, поэтому после сохранения проверьте отображение на карте.
Поле «Шаблон» отображается при наличии права просмотра шаблонов устройств. Шаблон не заменяет параметры подключения: адрес контроллера и параметры протокола задаются в карточке конкретного оборудования.
Выбор типа подключения
| Тип | Назначение | Доступность |
|---|---|---|
| Modbus TCP | Обмен Modbus с контроллером по Ethernet | Все виды стационарного оборудования |
| RTU over TCP | Передача кадров Modbus RTU через TCP-шлюз | Все виды стационарного оборудования |
| Modbus RTU | Обмен по последовательному порту | Все виды стационарного оборудования |
| Modbus ASCII | Обмен по последовательному порту в формате ASCII | Все виды стационарного оборудования |
| OPC UA | Подключение к OPC UA-серверу и подписка на выбранные ноды | Все виды стационарного оборудования |
| Автоматическая | Получение состояния без ручной настройки Modbus или OPC UA | Только зарядные станции |
Новая форма открывается с типом Modbus TCP и начальными значениями его параметров. После смены типа подключения проверьте все отображаемые поля: часть значений может быть очищена как не относящаяся к новому протоколу.

Modbus
Параметры подключения
В таблице обязательность означает, что параметр требуется для корректной работы выбранного варианта подключения. Некоторые поля интерфейс не отмечает звёздочкой, однако неполная конфигурация не позволит адаптеру установить связь.
| Параметр | Для каких типов | Обязательность | Начальное значение | Назначение |
|---|---|---|---|---|
| «Slave ID» | Все варианты Modbus | Обязательный | 1 | Адрес устройства в сети Modbus |
| «Host (IP адрес)» | Modbus TCP, RTU over TCP | Обязательный | Не задано | IP-адрес или имя узла контроллера либо шлюза |
| «Port» | Modbus TCP, RTU over TCP | Обязательный | 502 | TCP-порт контроллера или шлюза |
| «COM-порт» | Modbus RTU, Modbus ASCII | Обязательный | Не задано | Системное имя последовательного порта |
| «Baudrate» | Modbus RTU, Modbus ASCII | Обязательный | 9600 | Скорость последовательного соединения |
| «Parity» | Modbus RTU, Modbus ASCII | Обязательный | None | Контроль чётности: None, Even или Odd |
| «Stopbits» | Modbus RTU, Modbus ASCII | Обязательный | 1 | Количество стоповых битов |
| «Таймаут (мс)» | Все варианты Modbus | Обязательный | 3000 | Максимальное время ожидания ответа |
| «Интервал опроса (мс)» | Все варианты Modbus | Обязательный | 1000 | Общий период опроса оборудования |
| «Порядок байт» | Все варианты Modbus | Обязательный | Big Endian | Порядок байтов внутри регистра |
| «Порядок слов» | Все варианты Modbus | Обязательный | ABCD | Порядок слов в многорегистровом значении |
Начальные значения являются заготовкой интерфейса, а не универсальными настройками оборудования. Сверьте их с Modbus Map и параметрами контроллера.

Порядок байт и слов
«Порядок байт» определяет расположение байтов внутри одного регистра:
- Big Endian — старший байт передаётся первым;
- Little Endian — младший байт передаётся первым.
«Порядок слов» применяется к значениям, занимающим несколько регистров. Поддерживаются варианты ABCD, BADC, CDAB и DCBA.
Если вместо ожидаемого значения 1 отображается 256, проверьте порядок байт. Если неверно интерпретируются 32-битные значения, проверьте порядок слов.
Два интервала опроса
В конфигурации Modbus могут одновременно использоваться:
- «Интервал опроса (мс)» в карточке оборудования — общий период работы подключения;
polling_interval_msв элементеregister_blocksшаблона устройства — период чтения конкретного блока регистров.
Слишком частый опрос увеличивает нагрузку на сеть и контроллер, а слишком редкий задерживает обновление состояния. Учитывайте оба значения при диагностике.
OPC UA
Параметры подключения
| Параметр | Обязательность | Начальное значение | Назначение |
|---|---|---|---|
| «Host (IP адрес)» | Условно обязательный | Не задано | Адрес OPC UA-сервера; используется вместе с Port для формирования Endpoint URL |
| «Port» | Условно обязательный | 4840 | Порт сервера при подключении по Host |
| «Endpoint URL» | Обязательный для подключения | Формируется как opc.tcp://<host>:<port> | Полный адрес endpoint; его можно указать вручную вместо пары Host и Port |
| «Режим безопасности» | Обязательный | None | None, Sign или Sign & Encrypt |
| «Политика безопасности» | Обязательный | None | Алгоритм безопасности, поддерживаемый сервером |
| «Тип авторизации» | Обязательный | Anonymous | Anonymous, Username / Password или Certificate |
| «Логин» и «Пароль» | Условно обязательные | Не заданы | Требуются для Username / Password |
| «Сертификат» и «Приватный ключ» | Условно обязательные | Не заданы | Требуются для Certificate, Sign или Sign & Encrypt |
| «Интервал переподключения» | Необязательный | Подсказка 5000 мс | Задержка между попытками восстановить соединение |
| «Интервал публикации» | Необязательный | Подсказка 500 мс | Запрашиваемый период публикации подписки |
| «Максимальное количество keepalive» | Необязательный | Подсказка 10 | Допустимое число keepalive для подписки |
Для адреса достаточно заполнить Host и Port либо указать готовый Endpoint URL. Значения в подсказках не записываются автоматически. Если поле оставлено пустым, фактическое поведение определяется OPC UA-адаптером.
Режим и политика безопасности должны поддерживаться сервером как совместимая пара. Для защищённого соединения используйте сертификат и закрытый ключ одного клиента в формате PEM.

Выбор нод
Для OPC UA необходимо выбрать хотя бы одну ноду:
- Заполните Endpoint URL, параметры безопасности и авторизации.
- Нажмите «Открыть дерево нод».

- При необходимости обновите дерево.
- Отметьте переменные или методы, которые должна использовать WCS.
- Нажмите «Применить».
- Сохраните оборудование.
В форме отображается количество выбранных нод относительно общего количества загруженных. Если ни одна нода не выбрана, WCS не сохраняет оборудование и выводит сообщение о необходимости выбора.
Выбранное дерево хранится в параметрах оборудования. Действие «Список нод» в таблице позволяет просмотреть его повторно. Если в шаблоне устройства уже настроены OPC UA-ноды, при выборе шаблона они подставляются в карточку оборудования и затем сохраняются вместе с ней.

Автоматическое подключение зарядной станции
Тип «Автоматическая» доступен только в форме зарядной станции. После его выбора дополнительные параметры соединения скрываются. На вкладке «Подключение» состояние отображается как «Авто», а блоки регистров и OPC UA-нод отсутствуют.
Используйте этот тип только для зарядных станций, состояние которых WCS получает через поддерживаемый внутренний механизм.

Шаблон устройства и карта данных
Параметры подключения и шаблон решают разные задачи:
- карточка оборудования определяет, где находится конкретное устройство и как установить с ним соединение;
- шаблон устройства содержит общую JSON-конфигурацию модели оборудования и файлы визуализации;
- для Modbus и OPC UA устройства шаблона описывает регистры, доступ и групповой опрос;
- для OPC UA шаблон может содержать исходный набор нод, который копируется в карточку оборудования.
JSON-карта Modbus не редактируется в карточке паллетайзера, зарядной станции или другого устройства. Она задаётся в поле «Настройки (JSON)» соответствующего шаблона.
Структура JSON-карты Modbus
| Блок | Назначение |
|---|---|
objects | Описание состояний, измерений, ошибок и команд |
register_blocks | Диапазоны регистров, которые читаются одним запросом |
register_groups | Смысловые группы параметров для отображения |
| Интеграционные поля | Дополнительные параметры конкретного адаптера, например exit_point_code |
Основные поля элемента objects:
| Поле | Назначение |
|---|---|
id | Уникальный программный код параметра |
name | Отображаемое название |
address | Адрес регистра по Modbus Map |
data_type | Тип значения, например uint16 или bool |
type | Роль параметра: состояние, измерение, ошибка или команда |
access | ro — чтение; rw — чтение и запись |
block | Ссылка на блок из register_blocks |
category | Смысловая категория параметра |
severity | Важность ошибки; используется для параметров типа alarm |
trigger | Способ отправки команды, например level или pulse |
scale и unit | Коэффициент и единица измерения |
description | Пояснение назначения и допустимых значений |
Пример минимальной структуры:
{
"description": "Контроллер секционных ворот",
"version": "1.0",
"objects": [
{
"id": "gate_opened",
"name": "Gate Opened",
"address": 200,
"type": "state",
"data_type": "uint16",
"access": "ro",
"block": "gate_status",
"description": "Состояние ворот: 0 — закрыты, 1 — открыты"
},
{
"id": "cmd_open_gate",
"name": "Open Gate",
"address": 210,
"type": "command",
"data_type": "uint16",
"access": "rw",
"trigger": "pulse",
"block": "gate_status"
}
],
"register_blocks": [
{
"name": "gate_status",
"address": 200,
"count": 11,
"type": "holding_register",
"polling_interval_ms": 1000
}
]
}Это пример структуры, а не готовая карта для конкретного контроллера. Состав полей, адреса, типы данных, команды и дополнительные параметры должны соответствовать контракту адаптера и документации производителя.
Проверка после сохранения
Откройте карточку оборудования и проверьте:
- «Обзор» — активность, положение, ориентацию и время обновления;
- «Подключение» — параметры соединения и его текущее состояние;
- «Регистры» — значения Modbus, если для шаблона настроена JSON-карта;
- «Ноды» — выбранные значения OPC UA;
- «Открыть JSON» — полную сохранённую конфигурацию соединения;
- «Отладка» → «Показать RAW-JSON» — исходное состояние, полученное WCS.
Если оборудование находится в состоянии OFFLINE:
- Проверьте питание контроллера и физическое соединение.
- Сверьте адрес, порт или параметры последовательного интерфейса.
- Для Modbus проверьте Slave ID, таймаут и Modbus Map.
- Для OPC UA проверьте Endpoint URL, безопасность, авторизацию и сертификаты.
- Убедитесь, что оборудование активно и адаптер соответствующего протокола запущен.
Если соединение установлено, но значения неверны, проверьте адреса, типы данных, порядок байт и слов, выбранные OPC UA-ноды и время последнего обновления.