Le capteur NiuBoL s'interface avec la plateforme akenza.io via le protocole MQTT

Le processus d'intégration avec la plateforme akenza.io via le protocole MQTT nécessite de compléter des étapes telles que la configuration de l'appareil, la création du flux de données, l'enregistrement de l'appareil et l'implémentation du code. Ci-dessous se trouve un guide détaillé, basé sur la documentation officielle d'akenza et les fonctionnalités du protocole MQTT, expliquant comment réaliser l'intégration étape par étape.

Étape 1 : Créer un compte akenza.io 

1. Enregistrer un compte :

   - Visitez la page d'inscription à https://akenza.io et créez un compte. Si vous avez déjà un compte, connectez-vous directement.

   - Après la connexion, vous serez dirigé vers le tableau de bord de la plateforme akenza. 

2. Comprendre la plateforme :

   - La plateforme akenza prend en charge le protocole MQTT et utilise Eclipse Mosquitto comme broker MQTT. La plateforme agit en tant que broker, et les appareils agissent en tant que clients MQTT.  

Étape 2 : Créer un flux de données MQTT 

Un flux de données définit comment les appareils communiquent avec la plateforme akenza via MQTT. 

1. Naviguer vers Flux de données :

   - Dans le tableau de bord akenza, cliquez sur « Data Flow » dans le menu de gauche.

   - Cliquez sur le bouton « Create Data Flow ».

2. Sélectionner la connexion MQTT :

   - Dans le type de connexion, sélectionnez « Connect a device over MQTT ».

   - Type d'appareil : Sélectionnez « Passthrough » pour recevoir les formats de données brutes (le format JSON est recommandé).

   - Connecteur de sortie : Choisissez la destination de stockage des données, telle que la base de données akenza (base de données par défaut) ou d'autres connecteurs pris en charge comme InfluxDB ou Webhook.

3. Générer un secret (clé) :

   - Après la création du flux de données, le système générera automatiquement un secret (clé) pour l'authentification de l'appareil.

   - Enregistrez ce secret, car il sera utilisé dans la structure du topic MQTT et la connexion de l'appareil. 

4. Enregistrer le flux de données :

   - Après avoir confirmé vos paramètres, cliquez sur « Create » pour enregistrer le flux de données. 

Étape 3 : Enregistrer un appareil 

1. Naviguer vers Espace de travail :

   - Dans le menu de gauche, cliquez sur « Workspace ».

   - Cliquez sur le bouton « Create Device ».

2. Remplir les informations de l'appareil :

   - Nom de l'appareil : Nommez votre appareil, par ex. « Weather sensor » ou « Soil sensor ».

   - Description (facultative) : Ajoutez une description pour l'appareil.

   - Tags/Champs personnalisés (facultatifs) : Ajoutez des tags ou des champs personnalisés pour la catégorisation.

   - Flux de données : Sélectionnez le flux de données MQTT créé à l'étape précédente.

3. Générer l'ID de l'appareil :

   - Cliquez sur « Generate ID » pour générer un ID unique pour l'appareil.

4. Terminer l'enregistrement :

   - Cliquez sur « Create Device » pour terminer l'enregistrement de l'appareil.

   - Après l'enregistrement, trouvez l'appareil dans le menu Devices et cliquez pour accéder à la page des détails de l'appareil.

5. Obtenir la configuration API :

   - Dans la page des détails de l'appareil sous l'onglet « API-Configuration », obtenez les informations suivantes :

     - Hôte du broker MQTT : Typiquement mqtt.akenza.io.

     - Nom d'utilisateur MQTT : Nom d'utilisateur.

     - Mot de passe MQTT : Mot de passe.

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

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

Étape 4 : Configurer l'appareil pour se connecter à MQTT

En utilisant un appareil tel que le capteur Niubol ou un autre appareil compatible MQTT, configurez-le pour se connecter au broker MQTT akenza. Les instructions suivantes supposent que vous utilisez le collecteur de données Niubol.

Étape 5 : Vérifier les données 

1. Afficher les journaux de messages :

   - Dans l'espace de travail de la plateforme akenza, trouvez votre appareil et accédez à sa page de détails.

   - Sous l'onglet « Message Logs », affichez les données uplink envoyées par l'appareil.

   - Les données devraient apparaître au format JSON, par ex. {"sensor":"temperature","value":25.5}.

2. Visualisation des données :

   - Dans l'onglet Dashboard Builder, affichez les KPI de l'appareil et les graphiques de données historiques.

   - Si un topic downlink est configuré, vous pouvez tester l'envoi de commandes à l'appareil.

Étape 6 : Activer TLS (Facultatif) 

Pour une sécurité renforcée, il est recommandé d'utiliser le chiffrement TLS :

1. Utilisez le port 8883 au lieu de 1883 pour une communication chiffrée.

Remarques : 

1. Méthodes d'authentification :

- akenza prend en charge deux méthodes d'authentification :

- Secrets Uplink : Utilisez une clé partagée comme mot de passe MQTT.

- JWT : Utilisez la clé privée de l'appareil pour générer un JWT comme mot de passe (plus sécurisé, nécessite une configuration supplémentaire).

- Choisissez le type d'authentification lors de la création du flux de données. 

2. Structure des topics :

- Format du topic Uplink : /up/{secret}/id/{deviceId}.

- Format du topic Downlink : /down/{secret}/id/{deviceId}.

- Assurez-vous que les topics correspondent à la configuration de l'appareil. 

3. Dépannage :

- Si la connexion échoue, vérifiez :

- Assurez-vous que le nom d'utilisateur MQTT, le mot de passe et le topic sont corrects.

- Vérifiez que la connexion réseau est stable (Wi-Fi ou réseau cellulaire).

- Assurez-vous que les ports ne sont pas bloqués par un pare-feu (1883 ou 8883).

- Utilisez un moniteur série ou des journaux pour afficher les codes d'erreur.

4. Formats pris en charge :

- akenza accepte les messages MQTT formatés en JSON, assurez-vous donc que les données envoyées par l'appareil sont au format correct.

Ressources de référence :

- Documentation officielle d'akenza : Connectivité MQTT :

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

- Tutoriel : Comment intégrer un appareil Arduino via MQTT sur akenza :

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