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

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

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

• Модели

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

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

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

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

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

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

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

Протокол	Идентификатор	Пример
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	coap:<id>, где id указывается в первом запросе в UriPath в виде objects/:id/packets или api/v1/objects/:id/packets Размер id — не регламентирован	coap:123456789000001
LwM2M	UniqueEndpointName — 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 и задайте заголовок в виде

Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

• Координаты

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

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

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

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