> 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/es/faq-and-troubleshooting/gps-devices/add-and-manage-devices/activate-your-mqtt-device-on-navixy.md).

# Activar su dispositivo MQTT en Navixy

Conecte un dispositivo MQTT a Navixy configurando el protocolo de publicación/suscripción. Incluye ejemplos de configuración para Xirgo, Globalmatix y dispositivos similares.

MQTT es un protocolo de mensajería ligero diseñado para una comunicación eficiente entre dispositivos remotos con un ancho de banda de red mínimo. Es una excelente opción para la comunicación máquina a máquina (M2M), lo que lo convierte en ideal para proyectos de telemática vehicular. Este documento describe cómo puede conectar un dispositivo GPS a Navixy mediante MQTT.

## Cómo funciona MQTT

MQTT funciona según el principio de «cliente y broker» y utiliza una arquitectura de publicación/suscripción:

* **Cliente**: Cualquier dispositivo de Internet de las cosas (IoT) que ejecute una biblioteca MQTT, como un servidor dedicado, un microcontrolador, una aplicación o un sensor.
* **Broker**: Un servidor pasivo que media la comunicación entre clientes. Gestiona la autenticación, administra 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 son cada vez más comunes en el rastreo GPS y la telemática debido a su alta flexibilidad y capacidad para satisfacer diversas necesidades de negocio. 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 operan mediante el modelo de publicación/suscripción, que es diferente del modelo cliente-servidor tradicional.

**Modelo de publicación/suscripción vs. modelo cliente-servidor**

En el modelo cliente-servidor tradicional, el dispositivo (cliente) envía paquetes de datos directamente al servidor, que luego procesa los datos y envía respuestas de regreso al dispositivo. Este modelo es sencillo, pero se limita a una comunicación uno a uno.

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-e380430cb6f8b3fd11095dc56d710a310ef014c5%2Fimage-20240717-170644.png?alt=media\&token=3a1a668f-2a6a-4309-b7dc-f6de9d3d6b45)

En cambio, el modelo de publicación/suscripción utilizado por los dispositivos MQTT permite una comunicación más flexible y escalable. Así es como 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 utilizando sus números IMEI y la dirección del broker.

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-1752cdba20614e231763035834e9051d79fa8d79%2Fimage-20240717-170707.png?alt=media\&token=988e6363-2e1d-4d47-a2a4-ed22f1c36de0)

## Pasos de configuración de un dispositivo MQTT

Los siguientes ejemplos muestran cómo configurar su dispositivo MQTT en la plataforma Navixy.

### Ejemplo 1. Dispositivos Xirgo Global (ex BCE)

#### Configure el dispositivo en FMSET

* Inicie sesión en su cuenta de FMSET.
* Vaya a Connectivity → Telemetry Server → MQTT Broker Address Settings.
* Ingrese los siguientes parámetros:\
  Plataforma de EE. UU.: `mqtt.us.navixy.com` puerto `1883`\
  Plataforma de la UE: `mqtt.eu.navixy.com` puerto `1883`

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-8ee95de1987bc8e74cc0aa1830b701a75b74b461%2Fimage-20240717-165930.png?alt=media\&token=527fee00-192f-4ed6-a153-f4775067d2c1)

En MQTT Seguridad → Autorización, agregue un usuario con la siguiente configuración:

* **ID de cliente**: `%IMEI%`
* **Nombre de usuario**: `bce_device`
* **Contraseña**: `secretword`

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-47b7bf65136dc3e5446ad460f811e958e84a72f3%2Fimage-20240717-170022.png?alt=media\&token=a3e7a084-5313-4389-a059-1467ddfb7576)

Asegúrese de que la configuración de su tópico sea correcta:

* Todos los tópicos, excepto Nombre del tópico de control de salida, están configurados con los valores predeterminados.
* Nombre del tópico de control de salida: `%IMEI%/OUTC`

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-25ef4469acb315efde6d3bad1f55f0b8e9f90222%2Fimage-20240717-170207.png?alt=media\&token=06a40d27-56bc-49cd-92e5-c21d0a50da31)

Guarde su configuración.

Cada tópico que comienza con «BCE» indica que el dispositivo opera como publicador en estas instancias. 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 tópicos, y cada tópico corresponde a un tipo específico de mensaje.

Para los comandos que cambian la salida del dispositivo, el dispositivo funciona como suscriptor. Espera recibir comandos del servidor de Navixy, enviados a través del broker usando el IMEI del dispositivo. En este caso, el dispositivo entiende que debe cambiar 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. Esta configuración se muestra en las capturas de pantalla proporcionadas arriba.

#### Agregar 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 Xirgo Global (BCE) compatible con MQTT (marcado como IOTM).
3. **Continúe con el siguiente paso**: Haga clic en el **Siguiente paso** botón.
4. **Especifique el IMEI**: Ingrese el IMEI del dispositivo.
5. **Active el dispositivo**: Haga clic en el **Activar** botón.

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-b0a0c92f244c5f17953e78a98db864cb2c5c8691%2Fimage-20240717-170552.png?alt=media\&token=45610265-7809-490b-9fce-ec72759404ec)

### Ejemplo 2. Dispositivos Globalmatix xTCU

#### Configure el dispositivo

* Ingrese la siguiente configuración:\
  Plataforma de EE. UU.: `mqtt.us.navixy.com:1883`\
  Plataforma de la UE: `mqtt.eu.navixy.com:1883`
* **Tema**: `globalmatix/in`
* **Nombre de usuario/contraseña**: `globalmatix_device/secretword`
* Guarde la configuración.

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-db01d37cf9e73fbbe98890e07e2cbd6ab196dde5%2Fimage-20240717-170804.png?alt=media\&token=553e865b-f9c8-49a9-969c-4f0bd987f35a)

#### Agregue el dispositivo en la plataforma Navixy

* Ingrese en su cuenta de usuario.
* Seleccione el dispositivo Globalmatix de la lista.
* Haga clic en el **Siguiente paso** botón.
* Especifique el IMEI del dispositivo.
* Haga clic en el **Activar** botón.

![](https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-83d406f918ac4bad13c57b88cf515c6650823d52%2Fimage-20240717-170828.png?alt=media\&token=e47e5ef4-c512-4293-bffd-b3908c85b52f)

### 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 tópico MQTT.**
5. **Configure los ajustes del broker MQTT:**

* Nombre de dominio / IP: *Dominio configurado en el Panel de administración de Navixy*
* Puerto: `1883`
* Protocolo: `TCP`

**APN configurado**

<figure><img src="https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-1ad90ec7b8985e900c7dc010d62a1f3168b4cae0%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Configuración de la sesión.**

<figure><img src="https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-16d2c3726c3224ca8db70134d17ec95801864164%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Dirección del servidor de configuración.**

<figure><img src="https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-58347c2f1145a161969da24837534b2f7a3997df%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Configuración de los nombres de los tópicos MQTT**

<figure><img src="https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-ad1ca3b59c925c6e8d89280438e8ecea98018f0e%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Configuración de la dirección del broker MQTT.**

<figure><img src="https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-1b11c826464f90e8782bb2c567b10d96818bb66f%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Agregar 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 Xirgo XG37/XG40/GX47 compatible con MQTT (marcado como IOTM).
* **Continúe con el siguiente paso:** Haga clic en el **Siguiente paso** botón.
* **Especifique el IMEI:** Ingrese el IMEI del dispositivo.
* **Active el dispositivo:** Haga clic en el **Activar** botón.

<figure><img src="https://3386484127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-d78df1bca6f03201aa34541e304004b6352aba12%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
