> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/fr/faq-and-troubleshooting/gps-devices/add-and-manage-devices/activate-your-mqtt-device-on-navixy.md).
# 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 bande passante réseau minimale. C'est un excellent choix pour la communication de machine à machine (M2M), ce qui le rend idéal pour les projets de télématique des véhicules. Ce document décrit comment vous pouvez connecter un appareil GPS à Navixy à l'aide de MQTT.
## Comment fonctionne MQTT
MQTT fonctionne selon le principe « client et broker » et utilise une architecture de publication/abonnement :
* **Client**: Tout appareil de l'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 médiatise 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 éditeurs (appareils envoyant des données) et les clients abonnés (appareils ou serveurs recevant des données).
## Activer votre appareil MQTT sur Navixy
Les appareils MQTT deviennent de plus en plus courants 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 variés. Cependant, ils nécessitent un processus de configuration unique 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 éditeur/abonné, qui est différent du modèle client-serveur traditionnel.
**Modèle éditeur/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.
À l'inverse, le modèle éditeur/abonné utilisé par les appareils MQTT permet une communication plus flexible et plus évolutive. Voici comment il fonctionne :
* **Éditeur**: 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 en utilisant leurs numéros IMEI et l'adresse du broker.
## Étapes de configuration de l'appareil MQTT
Les exemples suivants montrent comment configurer votre appareil MQTT sur la plateforme Navixy.
### Exemple 1. Appareils Xirgo Global (ex BCE)
#### Configurer l'appareil dans FMSET
* Connectez-vous à votre compte FMSET.
* Accédez à Connectivité → Serveur de télémétrie → Paramètres d'adresse du broker MQTT.
* Saisissez les paramètres suivants :\
Plateforme US : `mqtt.us.navixy.com` port `1883`\
Plateforme UE : `mqtt.eu.navixy.com` port `1883`
Dans Sécurité MQTT → Autorisation, ajoutez un utilisateur avec les paramètres suivants :
* **ID client**: `%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 « Nom du topic de contrôle de sortie », sont définis sur les valeurs par défaut.
* Nom du topic de contrôle de sortie : `%IMEI%/OUTC`
Enregistrez votre configuration.
Chaque topic commençant par « BCE » indique que l'appareil fonctionne comme éditeur 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 comme éditeur 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 éditeurs est gérée par les topics, chaque topic correspondant à un type de message spécifique.
Pour les commandes qui commutent 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 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 montrés dans les captures d'écran fournies ci-dessus.
#### Ajouter l'appareil à la plateforme Navixy
1. **Saisissez votre compte utilisateur**: Connectez-vous à votre compte utilisateur Navixy.
2. **Sélectionnez l'appareil**: Choisissez l'appareil Xirgo Global (BCE) compatible MQTT (marqué IOTM).
3. **Passez à l'étape suivante**: Cliquez sur le **Étape suivante** bouton.
4. **Indiquez l'IMEI**: Saisissez l'IMEI de l'appareil.
5. **Activez l'appareil**: Cliquez sur le **Activer** bouton.
### Exemple 2. Appareils Globalmatix xTCU
#### Configurez l'appareil
* Saisissez les paramètres suivants :\
Plateforme US : `mqtt.us.navixy.com:1883`\
Plateforme UE : `mqtt.eu.navixy.com:1883`
* **Sujet**: `globalmatix/in`
* **Nom d'utilisateur/Mot de passe**: `globalmatix_device/secretword`
* Enregistrez la configuration.
#### Ajoutez l'appareil sur la plateforme Navixy
* Connectez-vous à votre compte utilisateur.
* Sélectionnez l'appareil Globalmatix dans la liste.
* Cliquez sur le bouton **Étape suivante** bouton.
* Indiquez l'IMEI de l'appareil.
* Cliquez sur le bouton **Activer** bouton.
### Exemple 3. Appareils Xirgo Global XG37/XG40/GX47
#### Configurez 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 des noms de topic MQTT.**
5. **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 topic MQTT**
**Paramètres d'adresse du broker MQTT.**
#### Ajouter l'appareil à la plateforme Navixy
* **Saisissez votre compte utilisateur :** Connectez-vous à votre compte utilisateur Navixy.
* **Sélectionnez l'appareil :** Choisissez l'appareil Xirgo XG37/XG40/GX47 compatible MQTT (marqué IOTM).
* **Passez à l'étape suivante :** Cliquez sur le bouton **Étape suivante** bouton.
* **Indiquez l'IMEI :** Saisissez l'IMEI de l'appareil.
* **Activez l'appareil :** Cliquez sur le bouton **Activer** bouton.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` 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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.