Датчик NiuBoL взаимодействует с платформой akenza.io через протокол MQTT.

Процесс интеграции с платформой akenza.io через протокол MQTT требует выполнения шагов, таких как настройка устройства, создание потока данных, регистрация устройства и реализация кода. Ниже приведено подробное руководство, основанное на официальной документации akenza и особенностях протокола MQTT, объясняющее, как добиться интеграции шаг за шагом.

Шаг 1: Создание учётной записи на akenza.io 

1. Регистрация учётной записи:

   - Посетите страницу регистрации https://akenza.io и создайте учётную запись. Если у вас уже есть учётная запись, войдите напрямую.

   - После входа вы будете перенаправлены на панель управления платформы akenza. 

2. Знакомство с платформой:

   - Платформа akenza поддерживает протокол MQTT и использует Eclipse Mosquitto в качестве брокера MQTT. Платформа выступает в роли брокера, а устройства — в роли клиентов MQTT.  

Шаг 2: Создание потока данных MQTT 

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

1. Переход к потоку данных:

   - В панели управления akenza нажмите на «Data Flow» в левом меню.

   - Нажмите кнопку «Create Data Flow».

2. Выбор подключения MQTT:

   - В типе подключения выберите «Connect a device over MQTT».

   - Тип устройства: Выберите «Passthrough», чтобы получать сырые данные (рекомендуется формат JSON).

   - Выходной коннектор: Выберите место хранения данных, такое как akenza DB (база данных по умолчанию) или другие поддерживаемые коннекторы, такие как InfluxDB или Webhook.

3. Генерация секрета (ключа):

   - После создания потока данных система автоматически сгенерирует секрет (ключ) для аутентификации устройства.

   - Запишите этот секрет, поскольку он будет использоваться в структуре топика MQTT и при подключении устройства. 

4. Сохранение потока данных:

   - После подтверждения настроек нажмите «Create», чтобы сохранить поток данных. 

Шаг 3: Регистрация устройства 

1. Переход к рабочему пространству:

   - В левом меню нажмите «Workspace».

   - Нажмите кнопку «Create Device».

2. Заполнение информации об устройстве:

   - Имя устройства: Назовите устройство, например, «Weather sensor» или «Soil sensor».

   - Описание (опционально): Добавьте описание устройства.

   - Теги/пользовательские поля (опционально): Добавьте теги или пользовательские поля для категоризации.

   - Поток данных: Выберите поток данных MQTT, созданный на предыдущем шаге.

3. Генерация идентификатора устройства:

   - Нажмите «Generate ID», чтобы сгенерировать уникальный ID для устройства.

4. Завершение регистрации:

   - Нажмите «Create Device», чтобы завершить регистрацию устройства.

   - После регистрации найдите устройство в меню Devices и кликните, чтобы перейти на страницу деталей устройства.

5. Получение конфигурации API:

   - На странице деталей устройства во вкладке «API-Configuration» получите следующую информацию:

     - Хост брокера MQTT: Обычно mqtt.akenza.io.

     - Имя пользователя MQTT: Username.

     - Пароль MQTT: Password.

     - Топик восходящей связи: /up/{secret}/id/{deviceId}.

     - Топик нисходящей связи (опционально): /down/{secret}/id/{deviceId}. 

Шаг 4: Настройка устройства для подключения к MQTT

Используя устройство, такое как датчик Niubol или другое устройство с поддержкой MQTT, настройте его для подключения к брокеру MQTT akenza. Следующие инструкции предполагают использование сборщика данных Niubol.

Шаг 5: Проверка данных 

1. Просмотр логов сообщений:

   - В рабочем пространстве платформы akenza найдите устройство и перейдите на страницу его деталей.

   - Во вкладке «Message Logs» просмотрите данные восходящей связи, отправленные устройством.

   - Данные должны отображаться в формате JSON, например, {"sensor":"temperature","value":25.5}.

2. Визуализация данных:

   - Во вкладке Dashboard Builder просмотрите KPI устройства и графики исторических данных.

   - Если настроен топик нисходящей связи, вы можете протестировать отправку команд на устройство.

Шаг 6: Включение TLS (опционально) 

Для повышения безопасности рекомендуется использовать шифрование TLS:

1. Используйте порт 8883 вместо 1883 для зашифрованного общения.

Примечания: 

1. Методы аутентификации:

- akenza поддерживает два метода аутентификации:

- Uplink Secrets: Использование общего ключа в качестве пароля MQTT.

- JWT: Использование приватного ключа устройства для генерации JWT в качестве пароля (более безопасно, требует дополнительной настройки).

- Выберите тип аутентификации при создании потока данных. 

2. Структура топика:

- Формат топика восходящей связи: /up/{secret}/id/{deviceId}.

- Формат топика нисходящей связи: /down/{secret}/id/{deviceId}.

- Убедитесь, что топики соответствуют настройкам устройства. 

3. Устранение неисправностей:

- Если подключение не удаётся, проверьте:

- Правильность имени пользователя MQTT, пароля и топика.

- Стабильность сетевого соединения (Wi-Fi или мобильная сеть).

- Отсутствие блокировки портов брандмауэром (1883 или 8883).

- Используйте монитор последовательного порта или логи для просмотра кодов ошибок.

4. Поддерживаемые форматы:

- akenza принимает сообщения MQTT в формате JSON, поэтому убедитесь, что данные, отправляемые устройством, имеют правильный формат.

Ресурсы для справки:

- Официальная документация akenza: MQTT Connectivity:

https://docs.akenza.io/akenza.io/get-started/your-data-flow/device-connector/mqtt

- Руководство: Как интегрировать устройство Arduino через MQTT на akenza:

https://docs.akenza.io/akenza.io/tutorials/add-devices/how-to-integrate-an-arduino-device-via-mqtt-on-akenza