# ⚙️ Configuração do Node Meshtastic

Guia completo de configuração para cada tipo de node. Para configuração do zero, veja a seção legado no final.

> **🇧🇷 Este guia é para Brasil (915 MHz).** Se você está em outro país, verifique a [[meshtastic:frequencias|frequência correta para sua região]] antes de continuar.

---

## 📋 Pré-requisitos

* 📱 Um node Meshtastic recém-flasheado
* 📲 Um smartphone Android
* 📦 O aplicativo Meshtastic instalado da Google Play Store

> ⚠️ **Notas Importantes:**
> * Comece com um node completamente novo (redefinição de fábrica recomendada)
> * Seu node reiniciará várias vezes durante a configuração — isso é normal
> * Aguarde o node se reconectar antes de continuar cada passo
> * Este tutorial é para Android — iOS tem procedimentos diferentes

---

## 🔵 Passo 1: Pareamento via Bluetooth

1. 📲 **Abrir App Meshtastic** no seu telefone
2. 📡 **Acessar Dispositivos** (ícone de nuvem no canto inferior direito)
3. 🔍 **Escanear** e aguarde aparecer `Meshtastic_XXXX`
4. 🔐 **Parear** com senha padrão: `123456` (ou veja na tela do node)
5. ✅ **Aguarde** o app carregar as configurações

---

## ⚙️ Passo 2: Acessar Configurações

1. ⋮ **Toque nos três pontos** (canto superior direito)
2. ⚙️ **Selecione** "Configurações do dispositivo"

---

## 👤 Passo 3: Configuração do Usuário

Navegue até **USUÁRIO:**

| Configuração | Descrição | Exemplo |
| :--- | :--- | :--- |
| **Long name** | Nome descritivo | Seu nome ou função (ex: "REPETIDOR Centro-Sul") |
| **Short name** | 4 caracteres ou emoji | Abreviação reconhecível (ex: "RPTD", 🔁, 🔀) |

✅ **Salvar:** Toque em "Enviar" → "OK" → Aguarde reiniciar

---

## 📡 Passo 4: Configuração do Canal

Selecione **CANAIS** → **0 LongFast:**

| Configuração | Valor | Observação |
| :--- | :--- | :--- |
| **Nome do canal** | LongFast | Não alterar |
| **PSK** | AQ== | Não alterar |
| **Uplink enable** | ✅ | Habilitar |
| **Downlink enable** | ✅ | Habilitar |
| **Posição habilitada** | ✅ ou ❌ | Para aparecer no mapa |
| **Precise location** | ✅ ou ❌ | Localização precisa |

✅ **Salvar:** Toque em "Salvar" → "Enviar" → "OK" → Aguarde reiniciar

---

## 🕐 Passo 5: Ajustar o Relógio

Selecione **DISPOSITIVO:**

1. ⏰ **Toque** em "Fuso horário POSIX"
2. 🇧🇷 **Escreva** `BRT3`
3. ✅ **Salvar:** "Enviar" → "OK"

---

## 📶 Passo 6: Configuração LoRa

Selecione **LORA:**

| Configuração | Valor | Observação |
| :--- | :--- | :--- |
| **Region** | Australia/New Zealand | Correto para 915 MHz Brasil |
| **OK to MQTT** | ✅ | Habilitar |

> 💡 **Por que Australia/New Zealand?** Essa é a região que usa 915 MHz, a mesma faixa do Brasil.

✅ **Salvar:** "Enviar" → "Fechar" → Aguarde reiniciar

---

## ⚡ Configuração por Tipo de Node

Escolha a configuração ideal para o seu tipo de node:

### 📱 Nó Móvel / Companion

| Configuração | Valor | Justificativa |
| :--- | :--- | :--- |
| **Client Proxy** | ✅ ATIVADO | Usa o celular como ponte para internet |
| **Wi-Fi** | ❌ DESATIVADO | Economiza bateria |
| **Bluetooth** | ✅ ATIVADO | Necessário para conectar ao celular |
| **GPS** | ✅ ATIVADO | Para compartilhar posição (se tiver) |

### 🏠 Nó Fixo / Router

| Configuração | Valor | Justificativa |
| :--- | :--- | :--- |
| **Client Proxy** | ❌ DESATIVADO | Opera autonomamente |
| **Wi-Fi** | ✅ ATIVADO | Conecta à internet via roteador |
| **Bluetooth** | ✅ ATIVADO | Para configuração inicial (desativar depois) |
| **MQTT** | ✅ ATIVADO | Conecta à rede global |

### ☀️ Nó Solar

| Configuração | Valor | Justificativa |
| :--- | :--- | :--- |
| **Client Proxy** | ❌ DESATIVADO | Opera autonomamente |
| **Wi-Fi** | ❌ DESATIVADO | Economiza bateria |
| **Bluetooth** | ❌ DESATIVADO | Desativar após configuração inicial |
| **Modo ECO** | ✅ ATIVADO | Reduz consumo significativamente |

> ⚠️ **Importante:** Desative o Bluetooth após a configuração inicial. Para reconfigurar, use o Admin LoRa.

### 🌐 Gateway MQTT

| Configuração | Valor | Justificativa |
| :--- | :--- | :--- |
| **Client Proxy** | ❌ DESATIVADO | Opera autonomamente |
| **Wi-Fi** | ✅ ATIVADO | Conecta à internet |
| **MQTT** | ✅ ATIVADO | Conecta à rede global |
| **Map Reporting** | ✅ ATIVADO | Aparece no mapa da plataforma |

---

## 🌐 Configuração MQTT (para Gateways)

Selecione **MQTT** e configure:

| Configuração | Valor | Observação |
| :--- | :--- | :--- |
| **MQTT enable** | ✅ | Habilitar |
| **Address** | platform.meshbrasil.com:1883 | Servidor MeshBrasil |
| **Nome de usuário** | meshdev | |
| **Senha** | large4cats | |
| **Criptografia** | ✅ | Habilitar |
| **Saída JSON** | ❌ | Desabilitar |
| **TLS** | ❌ | Desabilitar |
| **Root topic** | meshdev | |
| **Proxy to client** | ✅ | Habilitar |

> ⚠️ **Contorno de Bug:**
> 1. Toque em "Enviar"
> 2. Se der erro, toque em "OK" e aguarde reinicialização
> 3. Volte às configurações de MQTT

**Map Reporting:**

| Configuração | Valor |
| :--- | :--- |
| **Map Reporting** | ✅ Habilitar |
| **Concordo** | ✅ Habilitar |
| **Precisão** | Máximo 729m |
| **Intervalo** | 3600 segundos |

✅ **Salvar:** "Enviar" → "Fechar" → Aguarde reiniciar

---

## ✅ Configuração Completa!

Volte para a tela principal (volte duas telas).

### Entendendo sua Interface

| Ícone | Função |
| :--- | :--- |
| 💬 **Balão de diálogo** | Enviar/receber mensagens |
| 👥 **Duas pessoas** | Ver nodes online |
| ⋮ **Três pontos** | Menu de configurações |

### Informações dos Nodes

| Informação | Descrição |
| :--- | :--- |
| ⏱️ Último visto | Tempo desde a última comunicação |
| 🔋 Bateria | Nível da bateria (se disponível) |
| 📍 Posição | Localização compartilhada |
| 📱 Hardware | Modelo do dispositivo |
| 🔗 Conexão | LoRa direto ou via MQTT |

---

## 🔍 Solução de Problemas

| Problema | Solução |
| :--- | :--- |
| 🔌 **Não conecta Bluetooth** | Verifique se está habilitado e perto do node |
| ⚠️ **Erros de configuração** | Geralmente inofensivos, aguarde reinicialização |
| 🛑 **Node não responde** | Aguarde os ciclos de reinicialização |
| 🔍 **Não encontra o node** | Reinicie o app ou atualize a lista |

---

## 📚 Configuração Legado: Guia Completo do Zero

> 📝 **Nota:** Esta seção contém o guia completo de configuração do zero, adaptado do post de @Renato_Tatoo. Útil para quem quer entender cada passo em detalhe.

### Passo a Passo Detalhado

#### 1. Pareamento Bluetooth

1. Abrir App Meshtastic
2. Acessar aba de dispositivos (ícone de nuvem)
3. Toque em "ESCANEAR"
4. Procure `Meshtastic_XXXX`
5. Senha padrão: `123456` (ou veja na tela do node)
6. Aguarde carregar configurações

#### 2. Configuração do Usuário

* **Long name:** Nome descritivo (pessoal ou função)
* **Short name:** Abreviação 4 caracteres/emoji
* Salve e aguarde reiniciar

#### 3. Configuração do Canal

* Acesse **CANAIS** → **0 LongFast**
* **Uplink/Downlink:** ✅ Habilitar
* **Posição:** ✅ ou ❌ (sua escolha)
* **Precise location:** ✅ ou ❌
* Salve e aguarde reiniciar

#### 4. Fuso Horário

* Acesse **DISPOSITIVO** → **Fuso horário POSIX**
* Digite: `BRT3`
* Salve

#### 5. Configuração LoRa

* Acesse **LORA**
* **Region:** Australia/New Zealand (915 MHz Brasil)
* **OK to MQTT:** ✅ Habilitar
* Salve e aguarde reiniciar

#### 6. Configuração MQTT

* Acesse **MQTT**
* **Enable:** ✅
* **Address:** platform.meshbrasil.com:1883
* **Usuário:** meshdev
* **Senha:** large4cats
* **Criptografia:** ✅
* **JSON:** ❌
* **TLS:** ❌
* **Root topic:** meshdev
* **Proxy:** ✅
* Salve (atenção ao bug: pode precisar salvar 2x)

#### 7. Map Reporting

* **Map Reporting:** ✅
* **Concordo:** ✅
* **Precisão:** até 729m
* **Intervalo:** 3600s
* Salve

---

## 🔗 Próximos Passos

| Quer... | Veja |
| :--- | :--- |
| Tipos de node | [[meshtastic:tipos_nodes\|Tipos de Node]] |
| Escolher hardware | [[meshtastic:escolher\|Escolher seu Node]] |
| Ver dispositivos | [[meshtastic:hardware\|Hardware]] |
| Usar o app | [[meshtastic:uso\|Usar]] |
| Ir além | [[meshtastic:evolua\|Evolua]] |

---

## 📝 Créditos

Configuração baseada no guia de @Renato_Tatoo (atualizado 9 Set 2025).
Fonte original: https://meshbrasil.com/comunidade/guia-completo-de-configuracao-do-node-meshtastic-do-zero-a-conexao-usa.html
Vídeo: https://youtu.be/f8zv2qso7G8?t=595