Activer votre dispositif MQTT sur Navixy

MQTT est un protocole de messagerie léger conçu pour une communication efficace entre des appareils distants avec une bande passante réseau minimale. Il constitue un excellent choix pour la communication Machine-à-Machine (M2M), ce qui le rend idéal pour les projets de télématique véhicule. Ce document décrit comment vous pouvez connecter un appareil GPS à Navixy en utilisant MQTT.

Comment fonctionne MQTT

MQTT fonctionne selon le principe « client et broker » et utilise une architecture Publish/Subscribe :

• Client: Tout appareil Internet des objets (IoT) qui exécute une bibliothèque MQTT, comme un serveur dédié, un microcontrôleur, une application ou un capteur.

• Broker: Un serveur passif qui assure la médiation de la communication entre les clients. Il gère l'authentification, les connexions, les sessions et les abonnements.

Dans cette configuration, les clients se connectent au broker, qui facilite ensuite la communication entre les clients publishers (appareils envoyant des données) et les clients subscribers (appareils ou serveurs recevant des données).

Activation de votre appareil MQTT sur Navixy

Les appareils MQTT deviennent de plus en plus répandus dans le suivi GPS et la télématique en raison de leur grande flexibilité et de leur capacité à répondre à des besoins métier divers. Toutefois, ils nécessitent un processus de configuration spécifique comparé aux appareils traditionnels.

Points clés :

• Les appareils MQTT ne peuvent pas être enregistrés automatiquement et doivent être configurés manuellement.

• Ces appareils fonctionnent en utilisant le modèle Publisher/Subscriber, qui diffère du modèle client-serveur traditionnel.

Modèle Publisher/Subscriber vs. Modèle client-serveur

Dans le modèle client-serveur traditionnel, l'appareil (client) envoie des paquets de données directement au serveur, qui traite ensuite les données et renvoie des réponses à l'appareil. Ce modèle est simple mais limité à une communication un-à-un.

En revanche, le modèle Publisher/Subscriber utilisé par les appareils MQTT permet une communication plus flexible et évolutive. Voici comment il fonctionne :

• Publisher: L'appareil envoie des paquets de données à un broker MQTT.

• Broker: Le broker stocke ces paquets de données.

• Subscriber: Le serveur Navixy s'abonne aux paquets de données provenant d'appareils spécifiques en utilisant leurs numéros IMEI et l'adresse du broker.

Étapes de configuration d'un appareil MQTT

Nous allons démontrer comment configurer votre appareil MQTT sur la plateforme Navixy à travers quelques exemples.

Exemple 1. Appareils Xirgo Global (ex BCE)

Configurer l'appareil dans FMSET

• Connectez-vous à votre compte FMSET.

• Allez dans Connectivity → Telemetry Server → MQTT Broker Address Settings.

• Entrez les paramètres suivants : Plateforme US : mqtt.us.navixy.com port 1883 Plateforme EU : mqtt.eu.navixy.com port 1883

Dans MQTT Security → Authorization, ajoutez un utilisateur avec les paramètres suivants :

• Client ID: %IMEI%

• Username: bce_device

• Password: secretword

Assurez-vous que votre configuration de topic est correcte :

• Tous les topics sauf Output Control Topic Name sont définis sur les valeurs par défaut.

• Output Control Topic Name : %IMEI%/OUTC

Enregistrez votre configuration.

Chaque topic commençant par « BCE » indique que l'appareil agit en tant que publisher dans ces cas. Pour les données de télémétrie, les événements, les fichiers et les données en temps réel, l'appareil agit en tant que publisher, envoyant ces paquets au broker. Le serveur Navixy peut ensuite extraire ces paquets de données depuis le broker. La communication entre subscribers et publishers est gérée via des topics, chaque topic correspondant à un type spécifique de message.

Pour les commandes qui commutent la sortie de l'appareil, l'appareil fonctionne en tant que subscriber. Il s'attend à recevoir des commandes du serveur Navixy, envoyées via le broker en utilisant l'IMEI de l'appareil. Dans ce cas, l'appareil comprend qu'il doit commuter la sortie.

Lors de la configuration d'un appareil compatible MQTT, l'utilisateur doit spécifier le nom d'utilisateur et le mot de passe attendus par le serveur. Ces paramètres sont indiqués dans les captures d'écran fournies ci-dessus.

Ajouter l'appareil à la plateforme Navixy

1. Accédez à votre compte utilisateur: Connectez-vous à votre compte utilisateur Navixy.

2. Sélectionner l'appareil: Choisissez l'appareil MQTT-compatible Xirgo Global (BCE) (marqué comme IOTM).

3. Passer à l'étape suivante: Cliquez sur le bouton « Next Step ».

4. Spécifier l'IMEI: Entrez l'IMEI de l'appareil.

5. Activer l'appareil: Cliquez sur le bouton « Activate ».

Exemple 2. Appareils Globalmatix xTCU

Configurer l'appareil

• Entrez les paramètres suivants : Plateforme US : mqtt.us.navixy.com:1883 Plateforme EU : mqtt.eu.navixy.com:1883

• Topic: globalmatix/in

• Login/Password: globalmatix_device/secretword

• Enregistrez la configuration.

Ajouter l'appareil sur la plateforme Navixy

• Connectez-vous à votre compte utilisateur.

• Sélectionnez l'appareil Globalmatix dans la liste.

• Cliquez sur le bouton « Next Step ».

• Spécifiez l'IMEI de l'appareil.

• Cliquez sur le bouton « Activate ».

Exemple n°3 Appareils Xirgo Global XG37/XG40/GX47

#Configurer l'appareil

1. Configurez l'APN.

2. Vérifiez les paramètres de session.

3. Configurez l'adresse du serveur :

• Serveur : devices.xgfleet.eu

• Port : 1888

• Protocole : TCP

1. Vérifiez les paramètres du nom du topic MQTT.

2. Configurez les paramètres du broker MQTT :

• Nom de domaine / IP : Domaine configuré dans le panneau d'administration Navixy

• Port : 1883

• Protocole : TCP

APN configuré

Paramètres de session.

Adresse du serveur de configuration.

Paramètres des noms de topics MQTT

Paramètres de l'adresse du broker MQTT.

Ajouter l'appareil à la plateforme Navixy

• Accédez à votre compte utilisateur : Connectez-vous à votre compte utilisateur Navixy.

• Sélectionnez l'appareil : Choisissez l'appareil Xirgo XG37/XG40/GX47 compatible MQTT (marqué comme IOTM).

• Passez à l'étape suivante : Cliquez sur le bouton « Next Step ».

• Spécifiez l'IMEI : Entrez l'IMEI de l'appareil.

• Activer l'appareil : Cliquez sur le bouton « Activate ».