4. Подключение устройства ​

Условия подключения ​

1. Подключаемое устройство работает по одному из поддерживаемых платформой протоколов: MQTT/COAP/HTTP.

2. Устройство передает сообщения со значением телеметрии в формате, который поддерживает платформа:

   • {"key1":"value1", "key2":"value2"} или
   • [{"key1":"value1"}, {"key2":"value2"}] или
   • {"ts":1451649600512, "values":{"key1":"value1", "key2":"value2"}}

3. Адреса подключения:

   Протокол	Хост	Порт
   MQTT	213.87.46.149	1883
   COAP	213.87.46.149	5693

Описание процесса ​

Для подключения устройства к MTС IoT HUB необходимо выполнить следующие действия:

1. Создать класс устройства и Создать устройство.

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

   • формат для передачи/получения атрибутов;
   • формат для передачи телеметрии;
   • формат для передачи/получения RPC-команд.

3. Осуществить настройку подключения устройства для передачи данных по выбранному протоколу:

   • Если формат сообщений соответствует формату предлагаемому платформой, то необходимо подключить устройство используя Device API. Настройка интеграционной конфигурации в платформе уже осуществлена.

   • Если формат сообщений отличается от формата, предлагаемого платформой, то для подключения устройств необходимо самостоятельно настроить интеграционную конфигурацию используя Management API.

   Подробнее об интеграционной конфигурации...

   Платформа содержит следующие сущности, которые участвуют в настройке интеграционных конфигураций:

   • Папка — предназначена для агрегации других сущностей.
   • Входящий адрес подключения (endpoint) – предназначен для задания условий подключения к платформе.
   • Исходящий адрес подключения (endpoint) — предназначен для задания пути, куда будет отправлено сообщение из платформы в сторону устройства.
   • Интеграционная конфигурация — предназначена для настройки адаптера. Задаются таймаут для выполнения связанных операций, уровень логирования и массив ошибок, для обработки ответов от устройств.
   • Входящая операция – задается логика обработки входящих сообщений от устройства.
   • Исходящая операция – задается логика обработки сообщений, полученных из платформы.
   • Действие (action) – предназначено для выполнения некоторой дополнительной функциональности. Действия могут быть: выполнить авторизацию устройства, установить сессию, переопределить параметр, использовать регулярное выражение и др.
   • Скрипт – содержит функцию, написанную пользователем в JS, для преобразования входящего сообщения в формат платформы или исходящего сообщения в формат устройства.
   • Хост – содержит информацию о хосте, порте, протоколе, требуемых для отправки сообщений в сторону устройства.
   • Ошибка – содержит условия срабатывания этой ошибки и логику ее обработки.
   • Тип действия — предназначен для задания типа действия для Действия. Возможные значения:
     • авторизация по токену,
     • регистрация сессии,
     • задание параметров,
     • деригестрация сессии,
     • пинг,
     • запрос атрибутов.
   • Тип значения — предназначен для определения типа значения для Типа действия. Возможные значения: default (значение подставляется из username, указанного в контексте полученного сообщения), jsonPath, string, number, regexp.

4. Подключить устройство по одному из подходящих протоколов, указав его идентификатор в платформе. Он соответствует атрибуту созданному на шаге создания устройства — в качестве примера фигурирует атрибут "token" со значением generatedToken-e53d7b39-11c8-4ae4-8363-474df9325262.

5. Проверить подключение устройства: при отправке устройством сообщения connect платформа отправит ответ conack.