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 uma 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 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 devem ser configurados manualmente.

• Esses dispositivos operam usando o modelo publicador/assinante, que é diferente do modelo cliente-servidor tradicional.

Modelo publicador/assinante vs. modelo cliente-servidor

No modelo cliente-servidor tradicional, 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 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 os números de 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)

Configure o dispositivo no FMSET

• Entre 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%

• Usuário: bce_device

• Senha: secretword

Certifique-se de que a configuração dos tópicos 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 um 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 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

• Usuário/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

1. Verifique as configurações dos nomes dos tópicos MQTT.

2. Configure as configuraçõ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 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 Xirgo XG37/XG40/GX47 compatível com MQTT (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.