Создание объекта устройства
Для создания нового объекта перейдите на вкладку Объекты. Добавьте объект, нажав на плюсик. Сформируется форма, содержащая всю необходимую конфигурационную информацию о новом объекте.
Основные разделы:
- Модель
Выберите из выпадающего списка созданную ранее модель. Указание модели для объекта определяет для него перечень параметров, команд, событий и конфигурационных данных. Редактируя модель, вы одновременно настраиваете все объекты, у которых эта модель выбрана.
- Использовать как бота
Бот — это внутренний инструмент в платформе, позволяющий эмулировать работу устройства. Он помогает при прототипировании 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 - 8 байт Вместо поля с названием идентификатор будет поле DevEUI, а префикс eui: подставится автоматически | eui:41e28ddd5c3f58e6 |
| CoAP | id указывается в первом запросе в UriPath в виде или Размер id - не регламентирован | test_coap_client |
| LwM2M | UniqueEndpointName - IMEI или другой уникальный ID подключаемого устройства. Минимальный размер - 5 символов | test_lwm2m_client |
| WebSocket | id указывается в первом запросе в UriPath в виде или Размер id - не регламентирован | test_ws_client |
- Имя
Имя объекта будет отображено в интерфейсе объектов и позволит отличать один объект от другого.
- Статус
В статусе можно указать краткую информацию в виде текста или ссылки. Статусом можно управлять по API и использовать его как дополнительную индикацию на объекте (например, Арендован, Свободен, Поломка и т.д.).
- Описание
В описании можно указать подробную характеристику объекта.
Дополнительные разделы:
- MQTT аутентификация (только если выбрана модель MQTT)
Для того чтобы ввести дополнительную защиту созданного объекта от несанкционированного доступа и подключения к нему на платформе, укажите логин и пароль. В этом случае злоумышленник, зная только идентификатор вашего устройства, не сможет подключиться к объекту. Если потом потребуется снять защиту, сотрите логин и пароль и сохраните.
- ws_auth (только если выбрана модель WebSocket)
Указание логина и пароля аналогично MQTT аутентификации. При подключении воспользуйтесь HTTP Basic Authentication (opens in a new tab) и задайте заголовок в виде
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=- Координаты
Можно выбрать начальные координаты объекта путем их ввода либо указанием точки на карте. Если после этого объект пришлет свои координаты, то опция выбора координат перестанет быть доступной.
Подсказка о типе протокола и параметрах подключения генерируется в зависимости от выбранной модели.
Если в модели присутствуют узлы с типом Конфигурация, то в дополнительных разделах также будут подсистемы со всеми конфигурационными параметрами для заполнения.
Нажмите кнопку Сохранить. Перед вами откроется ваш новый объект. Однако, получения данных с устройства пока что не происходит. Данные не будут присылаться и отображаться до тех пор, пока оборудование не будет сконфигурировано для подключения к платформе.
Настройка разных устройств для подключения рассмотрена в разделе Подключение устройства.