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

Для создания нового объекта перейдите на вкладку Объекты. Добавьте объект, нажав на плюсик. Сформируется форма, содержащая всю необходимую конфигурационную информацию о новом объекте.
Основные разделы:
  • Модель
Выберите из выпадающего списка созданную ранее модель. Указание модели для объекта определяет для него перечень параметров, команд, событий и конфигурационных данных. Редактируя модель, вы одновременно настраиваете все объекты, у которых эта модель выбрана.
  • Использовать как бота
Бот — это внутренний инструмент в платформе, позволяющий эмулировать работу устройства. Он помогает при прототипировании IoT-идей без подключения реальных устройств и для тестирования работоспособности сущностей, созданных на платформе. Выберите Использовать как бота, если пока не планируете подключать реальное устройство. Подробно о работе с ботами рассказано в разделе Бот.
  • Идентификатор
Введите идентификатор объекта, по которому в дальнейшем будет происходить распознавание объекта системой. Идентификатор должен быть не длиннее 30 символов и может содержать только латинские буквы, цифры и специальные знаки "+-_:".
💡
У каждого объекта должен быть свой уникальный идентификатор, поэтому, если у вас есть два устройства, для каждого из них необходимо создать свой объект, используя, к примеру, одну и ту же модель, если устройства идентичные.
Для разных протоколов идентификатор объекта строится по-разному.
ПротоколИдентификаторПример
MQTT

ClientId- идентификатор клиента, с которым подключается устройство.

Минимальный размер - 5 символов,

рекомендуемый размер - до 23 символов

test_mqtt_client
Wialon IPS

wialon:<imei>

В качестве imei может выступать IMEI, уникальный ID контроллера или серийный номер устройства

Размер imei - не регламентирован

wialon:123456789000001
Galileosky

galileosky:<imei>

Размер imei - 15 символов

galileosky:123456789000001
Teltonika

teltonika:<imei>

Размер imei - не регламентирован

teltonika:123456789000001
Navtelecom

ntcb:<imei>

Размер imei - 15 символов

ntcb:123456789000001
LoRaWAN

eui:<DevAddr>
DevAddr - адрес конечного устройства

Размер DevAddr - 8 байт

Вместо поля с названием идентификатор будет поле DevEUI, а префикс eui: подставится автоматически

eui:41e28ddd5c3f58e6
CoAP

id указывается в первом запросе в UriPath в виде
objects/:id/packets

или
api/v1/objects/:id/packets

Размер id - не регламентирован

test_coap_client
LwM2MUniqueEndpointName - IMEI или другой уникальный ID подключаемого устройства. Минимальный размер - 5 символовtest_lwm2m_client
WebSocket

id указывается в первом запросе в UriPath в виде
objects/:id/connect

или
api/v1/objects/:id/connect

Размер id - не регламентирован

test_ws_client
  • Имя
Имя объекта будет отображено в интерфейсе объектов и позволит отличать один объект от другого.
  • Статус
В статусе можно указать краткую информацию в виде текста или ссылки. Статусом можно управлять по API и использовать его как дополнительную индикацию на объекте (например, Арендован, Свободен, Поломка и т.д.).
  • Описание
В описании можно указать подробную характеристику объекта.
Дополнительные разделы:
  • MQTT аутентификация (только если выбрана модель MQTT)
Для того чтобы ввести дополнительную защиту созданного объекта от несанкционированного доступа и подключения к нему на платформе, укажите логин и пароль. В этом случае злоумышленник, зная только идентификатор вашего устройства, не сможет подключиться к объекту. Если потом потребуется снять защиту, сотрите логин и пароль и сохраните.
  • ws_auth (только если выбрана модель WebSocket)
Указание логина и пароля аналогично MQTT аутентификации. При подключении воспользуйтесь HTTP Basic Authentication (opens in a new tab) и задайте заголовок в виде
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
  • Координаты
Можно выбрать начальные координаты объекта путем их ввода либо указанием точки на карте. Если после этого объект пришлет свои координаты, то опция выбора координат перестанет быть доступной.
💡
Подсказка о типе протокола и параметрах подключения генерируется в зависимости от выбранной модели.
Если в модели присутствуют узлы с типом Конфигурация, то в дополнительных разделах также будут подсистемы со всеми конфигурационными параметрами для заполнения.
Нажмите кнопку Сохранить. Перед вами откроется ваш новый объект. Однако, получения данных с устройства пока что не происходит. Данные не будут присылаться и отображаться до тех пор, пока оборудование не будет сконфигурировано для подключения к платформе.
Настройка разных устройств для подключения рассмотрена в разделе Подключение устройства.