O MQTT (Message Queuing Telemetry Transport) é o protocolo que conecta sua rede Meshtastic à internet, permitindo monitoramento remoto, integrações e o Mapa MeshBrasil.

MQTT é um protocolo leve de pub/sub projetado para dispositivos IoT. No contexto Meshtastic:

• Publish: O nó envia dados (posição, mensagens, telemetria) para um broker
• Subscribe: O nó recebe dados de outros nós via broker
• Broker: Servidor central que roteia mensagens entre publicadores e assinantes

1. Acesse Configurações > MQTT
2. Ative o MQTT
3. Configure:

O tópico raiz agrupa todos os dados do seu nó. Padrão: msh/br/2/c/

Exemplo de tópicos completos:

msh/br/2/c/LongFast/!a1b2c3d4/position
msh/br/2/c/LongFast/!a1b2c3d4/text
msh/br/2/c/LongFast/!a1b2c3d4/telemetry

Quando ativado, os dados são enviados em formato JSON legível:

{
  "from": "!a1b2c3d4",
  "type": "position",
  "payload": {
    "latitude": -23.5505,
    "longitude": -46.6333,
    "altitude": 750
  }
}

Útil para integrações com Home Assistant, Grafana, etc.

Ative para criptografar dados enviados via MQTT. Recomendado se você não usa o broker público.

Ative para que sua posição seja enviada ao Mapa MeshBrasil. Configurações:

• Intervalo: Tempo entre atualizações de posição (padrão: 1 hora)
• Precisão: Precisão da posição transmitida

• Acesso: mqtt.meshtastic.org:1883
• Username: ''
• Password: ''
• Atenção: Dados são públicos! Não envie informações sensíveis

Para maior privacidade e controle, configure seu próprio broker:

• Mosquitto: Broker MQTT leve e popular

  sudo apt install mosquitto mosquitto-clients
  sudo systemctl enable mosquitto

• EMQX: Broker MQTT de alta performance
• HiveMQ: Broker MQTT para ambientes corporativos

Use o plugin MQTT do Home Assistant:

mqtt:
  sensor:
    - name: "Meshtastic Node"
      state_topic: "msh/br/2/c/LongFast/!a1b2c3d4/telemetry"
      value_template: "{{ value_json.battery_level }}"
      unit_of_measurement: "%"

Visualize dados do mesh em dashboards:

1. Configure o MQTT como data source no Grafana
2. Crie dashboards com métricas de posição, bateria, etc.

Automatize fluxos de trabalho com dados Meshtastic:

1. Instale o plugin node-red-contrib-mqtt
2. Conecte ao broker MQTT
3. Processe e encaminhe dados conforme necessário

• Use TLS: Porta 8883 em vez de 1883
• Autenticação: Sempre defina username e password
• ACLs: Configure listas de controle de acesso no broker
• Não exponha o broker: Use firewall e VPN quando necessário

• Não conecta: Verifique porta, firewall e credenciais
• Dados não aparecem no mapa: Ative Map Reporting e aguarde
• Mensagens perdidas: Verifique a qualidade da conexão WiFi
• Lentidão: Reduza a frequência de envio de遥测

• Guia de Configuração
• Mapa MeshBrasil
• Configuração de Redes