# Active su dispositivo MQTT en Navixy
MQTT es un protocolo de mensajería ligero diseñado para una comunicación eficiente entre dispositivos remotos con un uso mínimo de ancho de banda de red. Es una excelente opción para la comunicación Máquina a Máquina (M2M), lo que lo hace ideal para proyectos de telemática vehicular. Este documento describe cómo puede conectar un dispositivo GPS a Navixy utilizando MQTT.
## Cómo funciona MQTT
MQTT opera según el principio de «cliente y broker» y utiliza una arquitectura de Publicación/Suscripción:
* **Cliente**: Cualquier dispositivo del Internet de las Cosas (IoT) que ejecute una biblioteca MQTT, como un servidor dedicado, microcontrolador, aplicación o sensor.
* **Broker**: Un servidor pasivo que media la comunicación entre clientes. Gestiona la autenticación, las conexiones, las sesiones y las suscripciones.
En esta configuración, los clientes se conectan al broker, que luego facilita la comunicación entre los clientes publicadores (dispositivos que envían datos) y los clientes suscriptores (dispositivos o servidores que reciben datos).
## Activación de su dispositivo MQTT en Navixy
Los dispositivos MQTT se están volviendo cada vez más comunes en el seguimiento GPS y la telemática debido a su gran flexibilidad y a su capacidad para satisfacer diversas necesidades empresariales. Sin embargo, requieren un proceso de configuración único en comparación con los dispositivos tradicionales.
**Puntos clave:**
* Los dispositivos MQTT no pueden registrarse automáticamente y deben configurarse manualmente.
* Estos dispositivos funcionan utilizando el modelo Publicador/Suscriptor, que es diferente del modelo tradicional cliente-servidor.
**Modelo Publicador/Suscriptor vs. Modelo Cliente-Servidor**
En el modelo tradicional cliente-servidor, el dispositivo (cliente) envía paquetes de datos directamente al servidor, que luego procesa los datos y envía respuestas de vuelta al dispositivo. Este modelo es sencillo, pero limitado a una comunicación uno a uno.
En cambio, el modelo Publicador/Suscriptor utilizado por los dispositivos MQTT permite una comunicación más flexible y escalable. Así funciona:
* **Publicador**: El dispositivo envía paquetes de datos a un broker MQTT.
* **Broker**: El broker almacena estos paquetes de datos.
* **Suscriptor**: El servidor de Navixy se suscribe a los paquetes de datos de dispositivos específicos usando sus números IMEI y la dirección del broker.
## Pasos de configuración del dispositivo MQTT
Mostraremos cómo configurar su dispositivo MQTT en la plataforma Navixy mediante algunos ejemplos.
### Ejemplo 1. Dispositivos Xirgo Global (ex BCE)
#### Configurar el dispositivo en FMSET
* Inicie sesión en su cuenta de FMSET.
* Vaya a Connectivity → Telemetry Server → MQTT Broker Address Settings.
* Introduzca los siguientes parámetros:\
Plataforma de EE. UU.: `mqtt.us.navixy.com` puerto `1883`\
Plataforma de la UE: `mqtt.eu.navixy.com` puerto `1883`
En MQTT Security → Authorization, añada un usuario con la siguiente configuración:
* **Client ID**: `%IMEI%`
* **Username**: `bce_device`
* **Password**: `secretword`
Asegúrese de que la configuración de su topic sea correcta:
* Todos los topics excepto Output Control Topic Name están establecidos con los valores predeterminados.
* Output Control Topic Name: `%IMEI%/OUTC`
Guarde su configuración.
Cada topic que comienza con «BCE» indica que el dispositivo funciona como publicador en estos casos. Para datos de telemetría, eventos, archivos y datos en tiempo real, el dispositivo actúa como publicador, enviando estos paquetes al broker. El servidor de Navixy puede entonces extraer estos paquetes de datos del broker. La comunicación entre suscriptores y publicadores se gestiona mediante topics, y cada topic corresponde a un tipo específico de mensaje.
Para los comandos que conmutan la salida del dispositivo, el dispositivo funciona como suscriptor. Espera recibir comandos del servidor de Navixy, enviados a través del broker utilizando el IMEI del dispositivo. En este caso, el dispositivo entiende que debe conmutar la salida.
Al configurar un dispositivo compatible con MQTT, el usuario debe especificar el nombre de usuario y la contraseña que espera el servidor. Estos ajustes se muestran en las capturas de pantalla proporcionadas arriba.
#### Añada el dispositivo a la plataforma Navixy
1. **Ingrese en su cuenta de usuario**: Inicie sesión en su cuenta de usuario de Navixy.
2. **Seleccione el dispositivo**: Elija el dispositivo compatible con MQTT Xirgo Global (BCE) (marcado como IOTM).
3. **Continúe con el siguiente paso**: Haga clic en el botón “Next Step”.
4. **Especifique el IMEI**: Introduzca el IMEI del dispositivo.
5. **Active el dispositivo**: Haga clic en el botón “Activate”.
### Ejemplo 2. Dispositivos Globalmatix xTCU
#### Configure el dispositivo
* Introduzca la siguiente configuración:\
Plataforma de EE. UU.: `mqtt.us.navixy.com:1883`\
Plataforma de la UE: `mqtt.eu.navixy.com:1883`
* **Topic**: `globalmatix/in`
* **Login/Password**: `globalmatix_device/secretword`
* Guarde la configuración.
#### Añadir dispositivo en la plataforma Navixy
* **Ingrese en su cuenta de usuario.**
* **Seleccione el dispositivo Globalmatix en la lista.**
* **Haga clic en el botón “Next Step”.**
* **Especifique el IMEI del dispositivo.**
* **Haga clic en el botón “Activate”.**
### Ejemplo #3 Dispositivos Xirgo Global XG37/XG40/GX47
#### #Configure el dispositivo
1. **Configure el APN.**
2. **Verifique la configuración de la sesión.**
3. **Configure la dirección del servidor:**
* Servidor: `devices.xgfleet.eu`
* Puerto: `1888`
* Protocolo: `TCP`
4. **Verifique la configuración del nombre del topic MQTT.**
5. **Configure los ajustes del broker MQTT:**
* Nombre de dominio / IP: *Dominio configurado en el Navixy Admin Panel*
* Puerto: `1883`
* Protocolo: `TCP`
**APN configurado**
**Configuración de la sesión.**
**Dirección del servidor de configuración.**
**Configuración de los nombres de topic MQTT**
**Configuración de la dirección del broker MQTT.**
#### **Añada el dispositivo a la plataforma Navixy**
* **Ingrese en su cuenta de usuario:** Inicie sesión en su cuenta de usuario de Navixy.
* **Seleccione el dispositivo:** Elija el dispositivo compatible con MQTT Xirgo XG37/XG40/GX47 (marcado como IOTM).
* **Continúe con el siguiente paso:** Haga clic en el botón “Next Step”.
* **Especifique el IMEI:** Introduzca el IMEI del dispositivo.
* **Active el dispositivo:** Haga clic en el botón “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/es/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.