El sensor NiuBoL se conecta con la plataforma akenza.io a través del protocolo MQTT

El proceso de integración con la plataforma akenza.io mediante el protocolo MQTT requiere completar pasos como la configuración del dispositivo, la creación del flujo de datos, el registro del dispositivo y la implementación del código. A continuación, se presenta una guía detallada, basada en la documentación oficial de akenza y las características del protocolo MQTT, explicando cómo lograr la integración paso a paso.

Paso 1: Crear una cuenta en akenza.io 

1. Registrar una cuenta:

   - Visite la página de registro en https://akenza.io y cree una cuenta. Si ya tiene una cuenta, inicie sesión directamente.

   - Después de iniciar sesión, será dirigido al dashboard de la plataforma akenza. 

2. Comprender la plataforma:

   - La plataforma akenza soporta el protocolo MQTT y utiliza Eclipse Mosquitto como broker MQTT. La plataforma actúa como broker, y los dispositivos actúan como clientes MQTT.  

Paso 2: Crear un flujo de datos MQTT 

Un flujo de datos define cómo los dispositivos se comunican con la plataforma akenza mediante MQTT. 

1. Navegar a Flujo de datos:

   - En el dashboard de akenza, haga clic en “Data Flow” en el menú izquierdo.

   - Haga clic en el botón “Create Data Flow”.

2. Seleccionar conexión MQTT:

   - En el tipo de conexión, seleccione “Connect a device over MQTT”.

   - Tipo de dispositivo: Seleccione “Passthrough” para recibir formatos de datos crudos (se recomienda el formato JSON).

   - Conector de salida: Elija el destino de almacenamiento de los datos, como la DB de akenza (base de datos predeterminada) u otros conectores compatibles como InfluxDB o Webhook.

3. Generar un secreto (clave):

   - Después de crear el flujo de datos, el sistema generará automáticamente un secreto (clave) para la autenticación del dispositivo.

   - Registre este secreto, ya que se usará en la estructura del topic MQTT y en la conexión del dispositivo. 

4. Guardar el flujo de datos:

   - Después de confirmar sus configuraciones, haga clic en “Create” para guardar el flujo de datos. 

Paso 3: Registrar un dispositivo 

1. Navegar a Espacio de trabajo:

   - En el menú izquierdo, haga clic en “Workspace”.

   - Haga clic en el botón “Create Device”.

2. Completar información del dispositivo:

   - Nombre del dispositivo: Nombre su dispositivo, por ej. “Weather sensor” o “Soil sensor”.

   - Descripción (opcional): Agregue una descripción para el dispositivo.

   - Etiquetas/Campos personalizados (opcional): Agregue etiquetas o campos personalizados para categorización.

   - Flujo de datos: Seleccione el flujo de datos MQTT creado en el paso anterior.

3. Generar ID del dispositivo:

   - Haga clic en “Generate ID” para generar un ID único para el dispositivo.

4. Completar el registro:

   - Haga clic en “Create Device” para completar el registro del dispositivo.

   - Después del registro, encuentre el dispositivo en el menú Devices y haga clic para ingresar a la página de detalles del dispositivo.

5. Obtener configuración API:

   - En la página de detalles del dispositivo bajo la pestaña “API-Configuration”, obtenga la siguiente información:

     - Host del broker MQTT: Típicamente mqtt.akenza.io.

     - Nombre de usuario MQTT: Nombre de usuario.

     - Contraseña MQTT: Contraseña.

     - Topic Uplink: /up/{secret}/id/{deviceId}.

     - Topic Downlink (opcional): /down/{secret}/id/{deviceId}. 

Paso 4: Configurar el dispositivo para conectarse a MQTT

Usando un dispositivo como el sensor Niubol u otro dispositivo compatible con MQTT, configúrelo para conectarse al broker MQTT de akenza. Las siguientes instrucciones asumen que está usando el colector de datos Niubol.

Paso 5: Verificar datos 

1. Ver registros de mensajes:

   - En el Espacio de trabajo de la plataforma akenza, encuentre su dispositivo y vaya a su página de detalles.

   - Bajo la pestaña “Message Logs”, vea los datos uplink enviados por el dispositivo.

   - Los datos deben aparecer en formato JSON, por ej. {"sensor":"temperature","value":25.5}.

2. Visualización de datos:

   - En la pestaña Dashboard Builder, vea los KPI del dispositivo y los gráficos de datos históricos.

   - Si se configura un topic downlink, puede probar el envío de comandos al dispositivo.

Paso 6: Habilitar TLS (Opcional) 

Para una mayor seguridad, se recomienda usar encriptación TLS:

1. Use el puerto 8883 en lugar de 1883 para comunicación encriptada.

Notas: 

1. Métodos de autenticación:

- akenza soporta dos métodos de autenticación:

- Secretos Uplink: Use una clave compartida como contraseña MQTT.

- JWT: Use la clave privada del dispositivo para generar un JWT como contraseña (más seguro, requiere configuración adicional).

- Elija el tipo de autenticación al crear el flujo de datos. 

2. Estructura de topics:

- Formato de topic Uplink: /up/{secret}/id/{deviceId}.

- Formato de topic Downlink: /down/{secret}/id/{deviceId}.

- Asegúrese de que los topics coincidan con la configuración del dispositivo. 

3. Solución de problemas:

- Si la conexión falla, verifique:

- Asegúrese de que el nombre de usuario MQTT, la contraseña y el topic sean correctos.

- Verifique que la conexión de red sea estable (Wi-Fi o red celular).

- Asegúrese de que los puertos no estén bloqueados por un firewall (1883 o 8883).

- Use un monitor serie o logs para ver códigos de error.

4. Formatos soportados:

- akenza acepta mensajes MQTT formateados en JSON, así que asegúrese de que los datos enviados por el dispositivo estén en el formato correcto.

Recursos de referencia:

- Documentación oficial de akenza: Conectividad MQTT:

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

- Tutorial: Cómo integrar un dispositivo Arduino mediante MQTT en akenza:

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