Создание объекта устройства

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

Основные разделы:

  • Модели

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

  • Использовать как бота

Бот — это внутренний инструмент в платформе, позволяющий эмулировать работу устройства. Он помогает при прототипировании IoT-идей без подключения реальных устройств и для тестирования работоспособности сущностей, созданных на платформе. Выберите Использовать как бота, если пока не планируете подключать реальное устройство. Подробно о работе с ботами рассказано в разделе Бот.

  • Идентификатор

Введите идентификатор объекта, по которому в дальнейшем будет происходить распознавание объекта системой.

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

Для разных протоколов идентификатор объекта строится по-разному.

ПротоколИдентификаторПример
MQTTClientId — идентификатор клиента, с которым
подключается устройство.
Минимальный размер — 5 символов,
рекомендуемый размер — до 23 символов
test_mqtt_client
Wialon IPSwialon:<imei>
В качестве imei может выступать IMEI,
уникальный ID контроллера или серийный
номер устройства
Размер imei — не регламентирован
wialon:123456789000001
Galileoskygalileosky:<imei>
Размер imei — 15 символов
galileosky:123456789000001
Teltonikateltonika:<imei>
Размер imei — не регламентирован
teltonika:123456789000001
Navtelecomntcb:<imei>
Размер imei — 15 символов
ntcb:123456789000001
LoRaWANeui:<DevAddr>
DevAddr — адрес конечного устройства
Размер DevAddr — 8 байт  
Вместо поля с названием идентификатор
будет поле DevEUI, а префикс eui:
подставится автоматически
eui:41e28ddd5c3f58e6
CoAPcoap:<id>, где id указывается в
первом запросе в UriPath в виде
objects/:id/packets
или api/v1/objects/:id/packets
Размер id — не регламентирован
coap:123456789000001
LwM2MUniqueEndpointName — IMEI или другой уникальный ID подключаемого устройства. Минимальный размер — 5 символовtest_lwm2m_client
WebSocketid указывается в первом запросе в UriPath в виде
objects/:id/connect
или
api/v1/objects/:id/connect
Размер id — не регламентирован
test_ws_client
  • Имя

Имя объекта будет отображено в интерфейсе объектов и позволит отличать один объект от другого.

  • Статус

В статусе можно указать краткую информацию в виде текста или ссылки. Статусом можно управлять по API и использовать его как дополнительную индикацию на объекте (например, Арендован, Свободен, Поломка и т.д.).

  • Описание

В описании можно указать подробную характеристику объекта.

Дополнительные разделы:

  • MQTT аутентификация (только если выбрана модель MQTT)

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

  • ws_auth (только если выбрана модель WebSocket)

Указание логина и пароля аналогично MQTT аутентификации. При подключении воспользуйтесь HTTP Basic Authentication и задайте заголовок в виде

Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

  • Координаты

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

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

Нажмите кнопку Сохранить. Перед вами откроется ваш новый объект. Однако, получения данных с устройства пока что не происходит. Данные не будут присылаться и отображаться до тех пор, пока оборудование не будет сконфигурировано для подключения к платформе.

Настройка разных устройств для подключения рассмотрена в разделе Подключение устройства.