Создание объекта устройства
Для создания нового объекта перейдите на вкладку Объекты. Добавьте объект,
нажав на плюсик. Сформируется форма, содержащая всю необходимую конфигурационную
информацию о новом объекте.
Основные разделы:
- Модель
Выберите из выпадающего списка созданную ранее модель. Указание модели для
объекта определяет для него перечень параметров, команд, событий и
конфигурационных данных. Редактируя модель, вы одновременно настраиваете все
объекты, у которых эта модель выбрана.
- Использовать как бота
Бот — это внутренний инструмент в платформе, позволяющий эмулировать работу
устройства. Он помогает при прототипировании IoT-идей без подключения реальных
устройств и для тестирования работоспособности сущностей, созданных на
платформе. Выберите Использовать как бота, если пока не планируете
подключать реальное устройство. Подробно о работе с ботами рассказано в разделе
Бот.
- Идентификатор
Введите идентификатор объекта, по которому в дальнейшем будет происходить
распознавание объекта системой. Идентификатор должен быть не длиннее 30 символов и может содержать только латинские буквы,
цифры и специальные знаки "+-_.:".
💡
У каждого объекта должен быть свой уникальный идентификатор, поэтому, если у
вас есть два устройства, для каждого из них необходимо создать свой объект,
используя, к примеру, одну и ту же модель, если устройства идентичные.
Для разных протоколов идентификатор объекта строится по-разному.
Протокол | Идентификатор | Пример |
---|---|---|
MQTT | ClientId (opens in a new tab)- идентификатор клиента, с которым подключается устройство. Минимальный размер - 5 символов, рекомендуемый размер - до 23 символов | test_mqtt_client |
Wialon IPS | wialon:<imei (opens in a new tab)> В качестве imei может выступать IMEI, уникальный ID контроллера или серийный номер устройства Размер imei - не регламентирован | wialon:123456789000001 |
Galileosky | galileosky:<imei (opens in a new tab)> Размер imei - 15 символов | galileosky:123456789000001 |
Teltonika | teltonika:<imei (opens in a new tab)> Размер imei - не регламентирован | teltonika:123456789000001 |
Navtelecom | ntcb:<imei (opens in a new tab)> Размер imei - 15 символов | ntcb:123456789000001 |
LoRaWAN | eui:<DevAddr (opens in a new tab)> DevAddr - адрес конечного устройства Размер DevAddr - 8 байт Вместо поля с названием идентификатор будет поле DevEUI, а префикс eui: подставится автоматически | eui:41e28ddd5c3f58e6 |
CoAP | id указывается в первом запросе в UriPath в виде objects/:id/packets или api/v1/objects/:id/packets Размер id - не регламентирован | test_coap_client |
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 (opens in a new tab) и
задайте заголовок в виде
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
- Координаты
Можно выбрать начальные координаты объекта путем их ввода либо указанием точки
на карте. Если после этого объект пришлет свои координаты, то опция выбора
координат перестанет быть доступной.
💡
Подсказка о типе протокола и параметрах подключения генерируется в зависимости
от выбранной модели.
Если в модели присутствуют узлы с типом Конфигурация, то в дополнительных
разделах также будут подсистемы со всеми конфигурационными параметрами для
заполнения.
Нажмите кнопку Сохранить. Перед вами откроется ваш новый объект. Однако,
получения данных с устройства пока что не происходит. Данные не будут
присылаться и отображаться до тех пор, пока оборудование не будет
сконфигурировано для подключения к платформе.
Настройка разных устройств для подключения рассмотрена в разделе
Подключение устройства.