Создание модели устройства

• имя — наименование модели;
• описание — подробная характеристика модели, заполняется при необходимости;
• импорт — возможность импортировать готовую модель в виде файла или по ссылке.

Параметры узлов модели

Общие

• Подсистема - тип узла, который служит для организации структуры модели, позволяя объединять параметры в группы. Подсистема подразумевает, что данный узел содержит в себе несколько элементов в виде ответвлений древовидной структуры.
• Аргумент – это параметр, который передает устройство на платформу (например, текущее измерение сенсора).
  Аргументы могут быть числовыми, логическими, строковыми или представлять собой объект или массив. При этом для числовых аргументов можно указать единицу измерения, изображение и задать уровни.
• Конфигурация – это параметр, значение которого затем можно задать в в интерфейсе объекта. Его можно использовать в работе автоматов и обработчиков. По своей сути, узлы с данным типом — это константы, которые необходимы для хранения дополнительной информации об объекте. Это может быть, к примеру, максимально допустимая температура, объем топливного бака, длительность работы и т.п.
• Действие - это операция, которая нужна для отправки команды на устройство или запуска автомата.
• Событие - это наступление определенных условий, которое либо было зафиксировано объектом, либо произошло во внешних по отношению к объекту контроля приложениях. События используются в автоматах при построении переходов между состояниями. Именно по произошедшим с объектом событиям эти переходы и происходят.

Для типа “Аргумент”

• тип данных: выбирается один из возможных типов данных: числовой, логический, строковый, объект или массив. Тип данных служит для корректного отображения значений параметров в интерфейсе. Также для определенных типов есть дополнительные возможности:
  • числовой: указание множителя, единицы измерения, изображения и уровней перехода (разделы При разборе и Отображение);
  • логический: указание изображения и уровней перехода (разделы При разборе и Отображение);
  • объект: разбор данных в формате JSON (пример).
• источник: по нему происходит поиск значения параметра в структуре данных, полученных от устройства; строго зависит от протокола. Конфигурирование источников для конкретных протоколов подробно рассмотрено в разделе примеров;
• линейный: данный переключатель определяет, можно ли построить по параметру линейный график (плавно возрастающий или плавно убывающий): например, по температуре можно, а по широте или долготе - нет, такой график по отдельной координате не имеет смысла. При активации этого флага становится доступным добавление изображения в качестве иконки данного параметра и указание уровней индикации текущего значения параметра.

• множитель: параметр, полученный от устройства, умножится на указанное значение (функция доступна только для чисел);
• сохранять binary как: служит для отображения данных в интерфейсе объекта в разном формате (например, Text - “ok”, Base64 - “b2s=”, HEX - “6F 6B”);
• единица измерения: для отображения рядом с числом; дополнительная функция есть у следующих единиц измерения:
  • проценты (%) - число помещается в шкалу, заполняющуюся согласно полученному значению процента;
  • миллисекунды (мс) - число, полученное в миллисекундах UNIX, конвертируется в удобочитаемый формат даты и времени.
• изображение: svg иконка для дополнительной индикации, представляет параметр в графическом виде на карточке объекта;
• уровни: пороги изменения цвета иконки и текста.

• число
  • изменение уровня при попадании полученной величины в определенный диапазон значений
    
  • изменение уровня при точном совпадении полученной величины с указанным значением
    
• логический тип

• строка

Для типа “Конфигурация”

Для типа “Действие”

• автомат: в поле Автомат выберите тот автомат, который нужно запустить по команде;
• команду к устройству: в поле Отправить выберите тип команды в зависимости от протокола, после чего в разделе С параметрами укажите параметры команды.

1. конкретные значения, которые будут каждый раз отправляться в команде;

2. параметры, значение которых можно указать непосредственно при отправке команды. Это нужно, если пользователь не знает заранее те значения, которые необходимо передавать в команде, либо эти значения раз от раза могут меняться. Для создания такого параметра необходимо при создании команды в модели объявить его в фигурных скобках {{param_name}};

3. текущие параметры устройства. Для создания такого параметра необходимо при создании команды в модели указать в фигурных скобках object.state и после точки указать идентификатор параметра из модели (например, {{object.state.temperature}}). При отправке команды подставится значение этого параметра из журнала.

Для корневого узла

Формирование структуры модели

• Скрыть (иконка “глаз”) - скрытие элемента из интерфейса объекта. Этот параметр не будет обрабатываться платформой и отображаться в журнале, но при необходимости его можно вернуть. В случае скрытия узла с типом Подсистема параметры, которые в нее входят, также скрываются в интерфейса объекта;

• Добавить - создание нового узла в виде ответвления для выбранного элемента на уровень ниже;
• Копировать - копирование выбранного элемента. При этом копируется вся заполненная по узлу информация с тем отличием, что у идентификатора приписывается сгенерированный постфикс, а у имени добавляется надпись ”(copy)”;
• Удалить - удаление выбранного элемента.