Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- meshtastic:mqtt [2026/09/02 12:56] – criada - edição externa 127.0.0.1
+++ meshtastic:mqtt [2026/09/08 19:27] (atual) – removida - edição externa (Data desconhecida) 127.0.0.1
@@ Linha 1: / Linha 1: @@
-====== 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 ===
-. Acesse **Configurações > MQTT**
-. Ative o MQTT
-. Configure:
-^ Parâmetro ^ Valor Padrão ^ Descrição ^
-| Servidor | ''mqtt.meshtastic.org'' | Broker público Meshtastic |
-| Porta | ''1883'' | Porta padrão (''8883'' para TLS) |
-| Username | (vazio) | Seu nome de usuário no broker |
-| Password | (vazio) | Sua senha no broker |
-=== 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:
-. Configure o MQTT como data source no Grafana
-. Crie dashboards com métricas de posição, bateria, etc.
-=== Node-RED ===
-Automatize fluxos de trabalho com dados Meshtastic:
-. Instale o plugin ''node-red-contrib-mqtt''
-. Conecte ao broker MQTT
-. 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]]