> 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/pt-br/faq-and-troubleshooting/gps-devices/add-and-manage-devices/activate-your-mqtt-device-on-navixy.md).
# Ative seu dispositivo MQTT na Navixy
MQTT é um protocolo de mensagens leve, projetado para uma comunicação eficiente entre dispositivos remotos com uso mínimo de largura de banda de rede. É uma excelente escolha para comunicação máquina a máquina (M2M), o que o torna ideal para projetos de telemetria veicular. Este documento descreve como você pode conectar um dispositivo GPS ao Navixy usando MQTT.
## Como o MQTT funciona
O MQTT opera com base no 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, aplicativo ou sensor.
* **Broker**: Um servidor passivo que media a comunicação entre clientes. Ele lida com autenticação, gerencia conexões, sessões e assinaturas.
Nessa configuração, os clientes se conectam ao broker, que então facilita 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 telemetria devido à sua alta flexibilidade e capacidade de atender a diversas necessidades de negócios. No entanto, eles exigem um processo de configuração específico em comparação com dispositivos tradicionais.
**Pontos principais:**
* Os dispositivos MQTT não podem ser registrados automaticamente e precisam ser configurados manualmente.
* Esses dispositivos operam usando o modelo de 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 ao 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 de Publicador/Assinante usado por dispositivos MQTT permite uma comunicação mais flexível e escalável. Veja como ele funciona:
* **Publicador**: O dispositivo envia pacotes de dados para um broker MQTT.
* **Broker**: O broker armazena esses pacotes de dados.
* **Assinante**: O servidor Navixy se inscreve nos 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
Os exemplos a seguir mostram como configurar seu dispositivo MQTT na plataforma Navixy.
### Exemplo 1. Dispositivos Xirgo Global (ex BCE)
#### Configurar o dispositivo no FMSET
* Faça login na sua conta FMSET.
* Acesse Connectivity → Telemetry Server → MQTT Broker Address Settings.
* Insira os seguintes parâmetros:\
Plataforma dos EUA: `mqtt.us.navixy.com` porta `1883`\
Plataforma da UE: `mqtt.eu.navixy.com` porta `1883`
Em Segurança MQTT → Autorização, adicione um usuário com as seguintes configurações:
* **ID do cliente**: `%IMEI%`
* **Nome de usuário**: `bce_device`
* **Senha**: `secretword`
Certifique-se de que a configuração do tópico esteja correta:
* Todos os tópicos, exceto o Nome do tópico de controle de saída, estão definidos com os valores padrão.
* Nome do tópico de controle de saída: `%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 ao 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.
#### Adicione o dispositivo à plataforma Navixy
1. **Entre na sua conta de usuário**: Faça login na sua conta de usuário Navixy.
2. **Selecione o dispositivo**: Escolha o dispositivo compatível com MQTT Xirgo Global (BCE) (marcado como IOTM).
3. **Prossiga para a próxima etapa**: Clique no **Próxima etapa** botão.
4. **Especifique o IMEI**: Insira o IMEI do dispositivo.
5. **Ative o dispositivo**: Clique no **Ativar** botão.
### Exemplo 2. Dispositivos Globalmatix xTCU
#### Configure o dispositivo
* Insira as seguintes configurações:\
Plataforma dos EUA: `mqtt.us.navixy.com:1883`\
Plataforma da UE: `mqtt.eu.navixy.com:1883`
* **Tópico**: `globalmatix/in`
* **Login/Senha**: `globalmatix_device/secretword`
* Salve a configuração.
#### Adicione o dispositivo à plataforma Navixy
* Entre na sua conta de usuário.
* Selecione o dispositivo Globalmatix na lista.
* Clique no **Próxima etapa** botão.
* Especifique o IMEI do dispositivo.
* Clique no **Ativar** botão.
### 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 configurações do broker MQTT:**
* Nome de domínio / IP: *Domínio configurado no Painel de administração da Navixy*
* Porta: `1883`
* Protocolo: `TCP`
**APN configurado**
**Configurações da sessão.**
**Endereço do servidor de configuração.**
**Configurações dos nomes dos tópicos MQTT**
**Configurações do endereço do broker MQTT.**
#### Adicione o dispositivo à plataforma Navixy
* **Entre na sua conta de usuário:** Faça login na sua conta de usuário Navixy.
* **Selecione o dispositivo:** Escolha o dispositivo compatível com MQTT Xirgo XG37/XG40/GX47 (marcado como IOTM).
* **Prossiga para a próxima etapa:** Clique no **Próxima etapa** botão.
* **Especifique o IMEI:** Insira o IMEI do dispositivo.
* **Ative o dispositivo:** Clique no **Ativar** botão.
---
# 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/pt-br/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.