Модели

Модель - это формализованное представление устройства, подключаемого к платформе. В модели описываются параметры, которые отправляет устройство, и команды управления, которые оно может отработать. Единожды созданная модель может быть использована как для одного, так и для нескольких объектов, если они обладают одинаковым набором считываемых данных и выполняемых функций.

Если у вас есть три одинаковых датчика, передающих температуру и влажность, то нужно создать только одну модель, но три объекта (для каждого устройства)

Функции модели:

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

• автоматически рендерит интерфейс для визуализации данных от устройства;

• используется для формирования сценариев автоматизации и обработчиков данных.

1. Имя модели

2. Описание модели

3. Шаблон (используемый протокол передачи данных)

4. Количество объектов с этой моделью. Нажмите на него, чтобы применить фильтр к списку объектов по данной модели

Создание модели

Для создания новой модели перейдите на вкладку Модели. Добавьте модель, нажав на плюсик.

Заполните следующие поля:

• имя — наименование модели;

• описание — подробная характеристика модели, заполняется при необходимости;

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

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

Нажмите кнопку Создать. Перед вами откроется ваша новая модель. В левой части отображается древовидная структура модели, включающая в себя разнотипные узлы. В правой - окно редактирования выбранного узла.

Связанные сервисы

В этом разделе отображаются сервисы, связанные с моделью. Чтобы добавить новые, нажмите кнопку «Выбрать».

В открывшемся окне выбираем необходимые сущности

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

Общие

Сначала в каждом узле указывается его тип. В зависимости от выбранного типа формируются соответствующие поля формы для последующего заполнения.

Типы:

• Подсистема - тип узла, который служит для организации структуры модели, позволяя объединять параметры в группы. Подсистема подразумевает, что данный узел содержит в себе несколько элементов в виде ответвлений древовидной структуры.

• Аргумент – это параметр, который передает устройство на платформу (например, текущее измерение сенсора).Аргументы могут быть числовыми, логическими, строковыми или представлять собой объект или массив. При этом для числовых аргументов можно указать единицу измерения, изображение и задать уровни.

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

• Действие - это операция, которая нужна для отправки команды на устройство или запуска автомата.

• Событие - это наступление определенных условий, которое либо было зафиксировано объектом, либо произошло во внешних по отношению к объекту контроля приложениях. События используются в автоматах при построении переходов между состояниями. Именно по произошедшим с объектом событиям эти переходы и происходят.

У каждого типа есть пиктограмма, которая отображается слева от узла в дереве модели. Это позволяет визуально определять, к какому типу относится тот или иной узел.

Далее вводится уникальный по модели идентификатор и имя узла. Идентификатор необходим для распознавания узла в системе. Он является названием поля из данных о состоянии устройства при обращении к нему через API. Имя, в отличие от идентификатора, может быть неуникальным. Как идентификатор, так и имя генерируются при создании узла, их следует заменить на те идентификатор и имя, которые вам понятны и удобны.

Идентификатор должен быть уникальным

Импорт/экспорт

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

Импорт

Импорт производится при создании модели. Чтобы загрузить файл, нужно при создании модели выбрать “Загрузить готовую модель”

Из файла:Перетащите JSON-файл модели в указанную область — после этого он автоматически загрузится на платформу.

По ссылке: В появившемся поле ввода (с подсказкой «Укажите URL») необходимо ввести прямую ссылку на JSON-файл модели, доступный по сети (например, размещённый в облачном хранилище или на публичном сервере).

Экспорт

Для экспорта модели нажмите на кнопку Скачать .json.