Форматы шаблонов и JSON

Как устроены устройства, каналы, команды и шаблоны

Эта глава объясняет структуру конфигурации на пользовательском уровне: что такое устройство, как описывается канал, как задается команда и когда нужен шаблон или JSON.

Устройство

Устройство объединяет адрес, имя, список каналов и список команд. Именно оно становится основной единицей, которую оператор потом видит в Конфигурация, ModBus и других разделах.

Редактор устройства

Редактор устройства на русском языке.
Здесь видно, как в одной карточке собираются основные свойства устройства.
  • Название Главный человеко-понятный идентификатор устройства в интерфейсе.
  • Адрес Modbus-адрес конкретного узла на линии.
  • Линия Определяет, по какому каналу связи устройство будет опрашиваться.
  • Описание Помогает понять назначение устройства без обращения к внешней документации.
  • Шаблон Упрощает создание, если структура уже встречалась раньше.

Канал

Канал связывает адрес регистра и способ его интерпретации с тем, как значение будет показано оператору. От настроек канала зависит, какие данные появятся на ModBus и как они будут читаться человеком.

Редактор канала

Редактор канала на русском языке.
Канал задает адрес, тип данных и правила интерпретации значения.

Канал в ModBus

Значения канала на странице ModBus на русском языке.
Так настройка канала превращается в реальное видимое значение на рабочей странице.
  • Название канала То, как оператор увидит значение в ModBus.
  • Тип регистра Определяет, откуда именно читается значение.
  • Адрес регистра Указывает точное место в карте регистров устройства.
  • Тип данных Определяет способ интерпретации числа.
  • Масштабирование Нужно для перевода сырых значений в инженерный вид.
  • Единицы измерения Делают показания понятными без дополнительных пояснений.

Команда

Команда связывает действие оператора с записью в устройство. Она должна быть понятной по названию и давать предсказуемый результат после выполнения.

Редактор команды

Редактор команды на русском языке.
Команда сначала описывается в Конфигурация, а затем становится доступной для выполнения в ModBus.

Результат команды

Результат выполнения команды на русском языке.
Оператор должен видеть ожидаемое изменение состояния после выполнения команды.
  • Название команды Должно сразу объяснять смысл действия.
  • Целевой регистр Указывает, куда именно будет отправлена запись.
  • Значение записи Определяет, что реально уйдет в устройство.
  • Ожидаемый эффект Должен быть виден оператору после выполнения команды.

Шаблон

Шаблон нужен, когда несколько устройств имеют одинаковую структуру и не хочется настраивать каждое вручную. Он ускоряет работу и снижает риск случайных расхождений между похожими устройствами.

JSON

JSON полезен для точного импорта, экспорта и разбора структуры, но это уже более чувствительный уровень работы. Если задачу можно решить обычными формами Конфигурация, лучше начинать именно с них.

Для UMEC Space используйте экспорт model JSON из карточки устройства шлюза. Этот файл загружается в UMEC Space Dashboard в разделе Models и появляется на платформе как Custom Model. После этого платформа связывает передаваемые шлюзом сенсоры и команды управления с понятной моделью устройства.

Справочный JSON

Справочный JSON устройства на русском языке.
Встроенная справка помогает понять структуру данных без ручного угадывания.

Когда использовать что

  • Формы Конфигурация: когда нужна обычная безопасная настройка.
  • Шаблоны: когда несколько устройств похожи по структуре.
  • JSON: когда нужен точный перенос или разбор структуры на более низком уровне.
  • Model JSON: когда нужно передать модель Modbus-устройства в UMEC Space Models как Custom Model.

Краткая последовательность создания устройства

  1. Настроить линию связи.
  2. Создать устройство и задать его адрес и имя.
  3. Добавить каналы для измеряемых значений.
  4. Добавить команды для управляющих действий.
  5. Проверить результат на странице ModBus.

Связанные разделы