> 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 no Navixy
Conecte um dispositivo MQTT à Navixy configurando o protocolo de publicação/assinatura. Inclui exemplos de configuração para Xirgo, Globalmatix e dispositivos semelhantes.
MQTT é um protocolo de mensagens leve projetado para comunicação eficiente entre dispositivos remotos com largura de banda de rede mínima. É uma excelente escolha para comunicação máquina a máquina (M2M), tornando-o ideal para projetos de telemática veicular. Este documento descreve como você pode conectar um dispositivo GPS à 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, 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 que publicam (dispositivos que enviam dados) e os clientes assinantes (dispositivos ou servidores que recebem dados).
## Ativando seu dispositivo MQTT na 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:**
* Os 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 ao servidor, que então processa os dados e envia respostas de volta ao dispositivo. Esse modelo é simples, mas limitado à comunicação um para um.
Em contraste, o modelo 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 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
Os exemplos a seguir demonstram 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 do FMSET.
* Vá para Conectividade → Servidor de telemetria → Configurações do endereço do broker MQTT.
* Informe 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 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 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 pelo 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 na plataforma Navixy
1. **Informe sua conta de usuário**: Faça login na sua conta de usuário da 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 **botão Próxima etapa** .
4. **Especifique o IMEI**: Insira o IMEI do dispositivo.
5. **Ative o dispositivo**: Clique no **Ativar** .
### Exemplo 2. Dispositivos Globalmatix xTCU
#### Configure o dispositivo
* Informe 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 na plataforma Navixy
* Informe sua conta de usuário.
* Selecione o dispositivo Globalmatix na lista.
* Clique no **botão Próxima etapa** .
* Especifique o IMEI do dispositivo.
* Clique no **Ativar** .
### 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 o 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 na plataforma Navixy
* **Informe sua conta de usuário:** Faça login na sua conta de usuário da 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 **botão Próxima etapa** .
* **Especifique o IMEI:** Insira o IMEI do dispositivo.
* **Ative o dispositivo:** Clique no **Ativar** .
---
# 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.
