# Ative seu dispositivo MQTT no Navixy
MQTT é um protocolo de mensagens leve, projetado para uma comunicação eficiente entre dispositivos remotos com largura de banda mínima de rede. É uma excelente escolha para comunicação Machine-to-Machine (M2M), tornando-o ideal para projetos de telemática veicular. Este documento descreve como você pode conectar um dispositivo GPS ao Navixy usando MQTT.
## Como o MQTT Funciona
O MQTT opera com o princípio de “cliente e broker” e usa uma arquitetura de Publicação/Assinatura:
* **Cliente**: Qualquer dispositivo da Internet das Coisas (IoT) que execute uma biblioteca MQTT, como um servidor dedicado, microcontrolador, aplicação ou sensor.
* **Broker**: Um servidor passivo que intermedeia a comunicação entre clientes. Ele trata a autenticação e gerencia conexões, sessões e assinaturas.
Nesse cenário, os clientes se conectam ao broker, que então viabiliza a comunicação entre os clientes publicadores (dispositivos que enviam dados) e os clientes assinantes (dispositivos ou servidores que recebem dados).
## Ativando Seu Dispositivo MQTT no Navixy
Os dispositivos MQTT estão se tornando cada vez mais comuns em rastreamento GPS e telemática devido à sua alta flexibilidade e capacidade de atender a diversas necessidades de negócios. No entanto, eles exigem um processo de configuração exclusivo em comparação com dispositivos tradicionais.
**Pontos principais:**
* Dispositivos MQTT não podem ser registrados automaticamente e devem ser configurados manualmente.
* Esses dispositivos operam usando o modelo Publicador/Assinante, que é diferente do modelo tradicional cliente-servidor.
**Modelo Publicador/Assinante vs. Modelo Cliente-Servidor**
No modelo tradicional cliente-servidor, o dispositivo (cliente) envia pacotes de dados diretamente para o servidor, que então processa os dados e envia respostas de volta ao dispositivo. Esse modelo é simples, mas limitado à comunicação um a um.
Em contraste, o modelo Publicador/Assinante usado por dispositivos MQTT permite uma comunicação mais flexível e escalável. Veja como funciona:
* **Publicador**: O dispositivo envia pacotes de dados para um broker MQTT.
* **Broker**: O broker armazena esses pacotes de dados.
* **Assinante**: O servidor Navixy assina os pacotes de dados de dispositivos específicos usando seus números IMEI e o endereço do broker.
## Etapas de Configuração do Dispositivo MQTT
Vamos demonstrar como configurar seu dispositivo MQTT na plataforma Navixy por meio de alguns exemplos.
### Exemplo 1. Dispositivos Xirgo Global (ex BCE)
#### Configurar o Dispositivo no FMSET
* Faça login em sua conta FMSET.
* Acesse Connectivity → Telemetry Server → MQTT Broker Address Settings.
* Insira os seguintes parâmetros:\
plataforma US: `mqtt.us.navixy.com` porta `1883`\
plataforma EU: `mqtt.eu.navixy.com` porta `1883`
Em MQTT Security → Authorization, adicione um usuário com as seguintes configurações:
* **Client ID**: `%IMEI%`
* **Nome de usuário**: `bce_device`
* **Senha**: `secretword`
Certifique-se de que a configuração do seu tópico esteja correta:
* Todos os tópicos, exceto Output Control Topic Name, estão definidos com os valores padrão.
* Output Control Topic Name: `%IMEI%/OUTC`
Salve sua configuração.
Cada tópico que começa com “BCE” indica que o dispositivo opera como publicador nesses casos. Para dados de telemetria, eventos, arquivos e dados em tempo real, o dispositivo atua como publicador, enviando esses pacotes para o broker. O servidor Navixy pode então extrair esses pacotes de dados do broker. A comunicação entre assinantes e publicadores é gerenciada por meio de tópicos, sendo que cada tópico corresponde a um tipo específico de mensagem.
Para comandos que alternam a saída do dispositivo, o dispositivo funciona como assinante. Ele espera receber comandos do servidor Navixy, enviados por meio do broker usando o IMEI do dispositivo. Nesse caso, o dispositivo entende que deve alternar a saída.
Ao configurar um dispositivo compatível com MQTT, o usuário deve especificar o nome de usuário e a senha esperados pelo servidor. Essas configurações são mostradas nas capturas de tela fornecidas acima.
#### Adicionar o Dispositivo à plataforma Navixy
1. **Entre em sua Conta de Usuário**: Faça login em sua conta de usuário Navixy.
2. **Selecione o Dispositivo**: Escolha o dispositivo compatível com MQTT Xirgo Global (BCE) (marcado como IOTM).
3. **Avance para a Próxima Etapa**: Clique no botão “Next Step”.
4. **Especifique o IMEI**: Insira o IMEI do dispositivo.
5. **Ative o Dispositivo**: Clique no botão “Activate”.
### Exemplo 2. Dispositivos Globalmatix xTCU
#### Configurar o Dispositivo
* Insira as seguintes configurações:\
plataforma US: `mqtt.us.navixy.com:1883`\
plataforma EU: `mqtt.eu.navixy.com:1883`
* **Tópico**: `globalmatix/in`
* **Login/Senha**: `globalmatix_device/secretword`
* Salve a configuração.
#### Adicionar Dispositivo na Plataforma Navixy
* **Entre em sua conta de usuário.**
* **Selecione o dispositivo Globalmatix na lista.**
* **Clique no botão “Next Step”.**
* **Especifique o IMEI do dispositivo.**
* **Clique no botão “Activate”.**
### Exemplo #3 Dispositivos Xirgo Global XG37/XG40/GX47
#### #Configure o dispositivo
1. **Configure o APN.**
2. **Verifique as configurações da sessão.**
3. **Configure o endereço do servidor:**
* Servidor: `devices.xgfleet.eu`
* Porta: `1888`
* Protocolo: `TCP`
4. **Verifique as configurações do nome do tópico MQTT.**
5. **Configure as definições do broker MQTT:**
* Nome de domínio / IP: *Domínio configurado no Navixy Admin Panel*
* Porta: `1883`
* Protocolo: `TCP`
**APN configurado**
**Configurações da sessão.**
**Endereço do servidor de configuração.**
**Configurações dos nomes de tópico MQTT**
**Configurações de endereço do broker MQTT.**
#### **Adicionar o Dispositivo à plataforma Navixy**
* **Entre em Sua Conta de Usuário:** Faça login em sua conta de usuário Navixy.
* **Selecione o Dispositivo:** Escolha o dispositivo compatível com MQTT Xirgo XG37/XG40/GX47 (marcado como IOTM).
* **Avance para a Próxima Etapa:** Clique no botão “Next Step”.
* **Especifique o IMEI:** Insira o IMEI do dispositivo.
* **Ative o Dispositivo:** Clique no botão “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/pt-br/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.