# Activez votre appareil MQTT sur Navixy
MQTT est un protocole de messagerie léger conçu pour une communication efficace entre des appareils distants avec une consommation minimale de bande passante réseau. C’est un excellent choix pour la communication Machine-to-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 à l’aide de MQTT.
## Fonctionnement de MQTT
MQTT fonctionne selon le principe « client et broker » et utilise une architecture Publier/S’abonner :
* **Client**: Tout appareil Internet des objets (IoT) qui exécute une bibliothèque MQTT, tel qu’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 publieurs (appareils envoyant des données) et les clients abonnés (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. Cependant, ils nécessitent un processus de configuration spécifique par rapport 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 selon le modèle Publieur/Abonné, qui diffère du modèle client-serveur traditionnel.
**Modèle Publieur/Abonné vs. Modèle client-serveur**
Dans le modèle client-serveur traditionnel, l’appareil (client) envoie directement des paquets de données 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 Publieur/Abonné utilisé par les appareils MQTT permet une communication plus flexible et évolutive. Voici comment cela fonctionne :
* **Publieur**: L’appareil envoie des paquets de données à un broker MQTT.
* **Broker**: Le broker stocke ces paquets de données.
* **Abonné**: Le serveur Navixy s’abonne aux paquets de données de certains appareils à l’aide de leurs numéros IMEI et de l’adresse du broker.
## Étapes de configuration d’un appareil MQTT
Nous allons 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.
* Accédez à Connectivity → Telemetry Server → MQTT Broker Address Settings.
* Saisissez les paramètres suivants :\
Plateforme US : `mqtt.us.navixy.com` port `1883`\
Plateforme UE : `mqtt.eu.navixy.com` port `1883`
Dans MQTT Security → Authorization, ajoutez un utilisateur avec les paramètres suivants :
* **Client ID**: `%IMEI%`
* **Nom d’utilisateur**: `bce_device`
* **Mot de passe**: `secretword`
Assurez-vous que la configuration de votre topic est correcte :
* Tous les topics, à l’exception de 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 fonctionne comme publieur dans ces cas. Pour les données télématiques, les événements, les fichiers et les données en temps réel, l’appareil agit comme publieur et envoie ces paquets au broker. Le serveur Navixy peut ensuite extraire ces paquets de données du broker. La communication entre abonnés et publieurs est gérée via des topics, chaque topic correspondant à un type de message spécifique.
Pour les commandes qui activent la sortie de l’appareil, celui-ci fonctionne comme abonné. Il s’attend à recevoir des commandes du serveur Navixy, envoyées via le broker à l’aide de l’IMEI de l’appareil. Dans ce cas, l’appareil comprend qu’il doit activer la sortie.
Lors de la configuration d’un appareil compatible MQTT, l’utilisateur doit préciser le nom d’utilisateur et le mot de passe attendus par le serveur. Ces paramètres sont présentés dans les captures d’écran ci-dessus.
#### Ajouter l’appareil à la plateforme Navixy
1. **Connectez-vous à votre compte utilisateur**: Connectez-vous à votre compte utilisateur Navixy.
2. **Sélectionner l’appareil**: Choisissez l’appareil compatible MQTT Xirgo Global (BCE) (marqué comme IOTM).
3. **Passez à l’étape suivante**: Cliquez sur le bouton « Next Step ».
4. **Spécifier l’IMEI**: Saisissez l’IMEI de l’appareil.
5. **Activer l’appareil**: Cliquez sur le bouton « Activate ».
### Exemple 2. Appareils Globalmatix xTCU
#### Configurer l’appareil
* Saisissez les paramètres suivants :\
Plateforme US : `mqtt.us.navixy.com:1883`\
Plateforme UE : `mqtt.eu.navixy.com:1883`
* **Topic**: `globalmatix/in`
* **Connexion/Mot de passe**: `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`
4. **Vérifiez les paramètres du nom du topic MQTT.**
5. **Configurez les paramètres du broker MQTT :**
* Nom de domaine / IP : *Domaine configuré dans Navixy Admin Panel*
* Port : `1883`
* Protocole : `TCP`
**Configuration de l’APN**
**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**
* **Connectez-vous à votre compte utilisateur :** Connectez-vous à votre compte utilisateur Navixy.
* **Sélectionner l’appareil :** Choisissez l’appareil compatible MQTT Xirgo XG37/XG40/GX47 (marqué comme IOTM).
* **Passez à l’étape suivante :** Cliquez sur le bouton « Next Step ».
* **Spécifier l’IMEI :** Saisissez l’IMEI de l’appareil.
* **Activer l’appareil :** Cliquez sur le bouton « Activate ».
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://navixy.com/docs/expert-center/fr/faq-and-troubleshooting/gps-devices/add-and-manage-devices/activate-your-mqtt-device-on-navixy.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.