Meshbrasil Wiki

Você carregou uma revisão antiga desse documento! Se você salvá-la, irá criar uma nova versão com esses dados.

====== Configuração MQTT ======

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

===== O que é MQTT? =====

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

===== Configuração Básica =====

=== No App Meshtastic ===

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

=== Tópico Raiz ===

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
```

===== Configurações Avançadas =====

=== JSON Mode ===

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

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

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

=== Encryption ===

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

=== Map Reporting ===

Ative para que sua posição seja enviada ao [[meshtastic:mapa|Mapa MeshBrasil]]. Configurações:

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

===== Brokers Disponíveis =====

=== mqtt.meshtastic.org (Público) ===

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

=== Broker Próprio ===

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

* **Mosquitto**: Broker MQTT leve e popular
    ```bash
    sudo apt install mosquitto mosquitto-clients
    sudo systemctl enable mosquitto
    ```
  * **EMQX**: Broker MQTT de alta performance
  * **HiveMQ**: Broker MQTT para ambientes corporativos

===== Integrações =====

=== Home Assistant ===

Use o plugin [[https://www.home-assistant.io/integrations/mqtt/|MQTT]] do Home Assistant:

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

=== Grafana ===

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.

=== Node-RED ===

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

===== Segurança =====

* **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

===== Solução de Problemas =====

* **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遥测

===== Veja Também =====

* [[meshtastic:configuracao|Guia de Configuração]]
  * [[meshtastic:mapa|Mapa MeshBrasil]]
  * [[meshtastic:redes|Configuração de Redes]]

Resumo da edição

Observe: editando esta página você aceita disponibilizar o seu conteúdo sob a seguinte licença: CC Attribution-Share Alike 4.0 International