Conectar o gateway Index AMI a um broker MQTT: TCP e SSL/TLS passo a passo

MQTT é o protocolo de mensagens que o Index AMI usa para publicar leituras de medidores e receber comandos de configuração das Plataformas AMI. O Index AMI suporta MQTT sobre TCP (sem criptografia, porta 1883) e MQTT sobre SSL/TLS (criptografia AES-256, porta 8883). Use sempre SSL para ambientes de produção.

Onde configurar

• App Android: App Android: Menu Principal → Configuração de Conectividade → habilitar caixa de seleção MQTT
• Herramienta de escritorio: Ferramenta de desktop: editor de modelos → seção MQTT.

Habilitar MQTT

MQTT está deshabilitado por defecto.

• App Android: App Android: ative a caixa «Habilitar configuração MQTT» para que todos os campos apareçam.
• Herramienta de escritorio: Ferramenta de desktop: a seção MQTT está sempre visível no editor de modelos.

Parâmetros básicos

Esses campos são obrigatórios independentemente do modo de transporte (TCP ou SSL).

• Host MQTT (broker): Endereço do servidor MQTT. Pode ser hostname (broker.exemplo.com) ou IP (192.168.1.100). Máx. 128 caracteres.
• Porta: 1883 para MQTT sobre TCP. 8883 para MQTT sobre SSL. Intervalo: 0–4.294.967.295.
• ID do cliente: Identificador único deste Index AMI no broker. Deve ser único por dispositivo. Máx. 64 caracteres. Exemplo: index-ami-001, device-MED-NORTE-001.
• Usuário (opcional): Credencial de acesso ao broker. Deixe vazio se o broker não exigir autenticação. Máx. 64 caracteres.
• Senha (opcional): Credencial de acesso ao broker. Deixe vazia se o broker não exigir autenticação. Máx. 64 caracteres.

Tipo de transporte

O campo Transporte determina se a comunicação é criptografada ou não. Este campo também controla quais campos adicionais aparecem na tela.

• MQTT sobre TCP (porta 1883): Conexão sem criptografia. Os campos de certificados são ocultados automaticamente. Use apenas em redes internas controladas ou para testes.
• MQTT sobre SSL (porta 8883): Conexão criptografada com TLS. Os campos de certificados aparecem automaticamente. Recomendado para produção em campo.

Alterar o tipo de transporte atualiza automaticamente a porta sugerida. Se o seu broker usar uma porta não padrão, altere-a manualmente após selecionar o transporte.

Certificados TLS (somente em modo SSL)

No modo MQTT sobre SSL, o Index AMI precisa de três arquivos para autenticar a conexão. Solicite-os ao administrador do broker MQTT.

• Certificado CA (.pem / .crt): Certificado da autoridade certificadora que assinou o certificado do servidor. Sem este arquivo, o Index AMI não pode verificar a identidade do broker.
• Certificado cliente (.pem / .crt): Certificado que identifica este Index AMI perante o broker. Cada dispositivo deve ter seu próprio certificado cliente.
• Chave privada do cliente (.key / .pem): Chave privada correspondente ao certificado cliente. Mantenha-a segura — nunca a compartilhe em texto simples.
• Omitir verificação de CN: Se habilitado, o Index AMI não verifica se o Common Name do certificado do broker coincide com o hostname configurado. Útil para certificados autoassinados ou internos. Desabilitado = máxima segurança.
• Nome comum (CN): Common Name do certificado do servidor, necessário apenas quando a verificação de CN está habilitada. Consulte o administrador do broker.

Carregue os certificados pelo app Android usando o botão de busca de cada campo. O app aceita arquivos com sufixo de download (ex. ca.pem, ca.pem (1)). Na ferramenta de desktop, pressione o botão de busca e selecione o arquivo. Os arquivos são escritos primeiro no Index AMI e a configuração é aplicada ao pressionar «Aplicar alterações».

Tópicos MQTT

O Index AMI publica e assina os seguintes tópicos. O prefixo base é definido pelas Plataformas AMI de acordo com a convenção da sua instalação.

Defina os tópicos de acordo com a convenção das suas Plataformas AMI. Use uma estrutura que inclua o ID do dispositivo para facilitar o roteamento: device/{id}/info, device/{id}/config/set.

Passos — MQTT sobre TCP

1. Conecte o Index AMI via BLE e vá para Configuração de Conectividade.
2. Ative a caixa «Habilitar configuração MQTT».
3. Insira o Host MQTT (endereço do broker), porta 1883, ID de cliente único e usuário/senha se o broker exigir.
4. Selecione «MQTT sobre TCP» no campo Transporte. Configure o Keepalive (60 s recomendado) e os tópicos.
5. Pressione «← Voltar» e depois «Aplicar alterações no dispositivo». O Index AMI reiniciará e se conectará ao broker.

Passos — MQTT sobre SSL

1. Certifique-se de ter os três arquivos de certificado: CA (.pem), cliente (.pem) e chave privada (.key).
2. Conecte o Index AMI via BLE e vá para Configuração de Conectividade.
3. Ative «Habilitar configuração MQTT», insira Host, porta 8883, ID de cliente, usuário e senha.
4. Selecione «MQTT sobre SSL» no campo Transporte — os campos de certificados aparecerão.
5. Carregue os três arquivos usando o botão de busca de cada campo. Pressione o botão de carregamento para gravá-los no Index AMI.
6. Configure os tópicos, o Keepalive e se precisa omitir verificação de CN. Pressione «← Voltar» e «Aplicar alterações no dispositivo».

Verificar a conexão MQTT

No app Android vá a Descrição Geral → aba Estado de Conectividade → seção MQTT Details. Confirme que o campo «Estado» mostra «Conectado» e que «Última Conexão» tem uma data recente. Se o status for «Desconectado», verifique o hostname do broker, a porta e as credenciais.

Se algo não está funcionando

Documentos de apoio

• Instalar broker Mosquitto com TLS no Linux ou Windows

Próximas etapas

Com o MQTT ativo o Index AMI pode publicar telemetria nas Plataformas AMI. Configure os alertas para receber notificações de eventos críticos. Consulte o guia de configuração de notificações para ativar Last Gasp, alertas de temperatura e interruptor.