# ⚡ Firmware

O firmware é o "sistema operacional" do seu dispositivo Meshtastic. Este guia explica como instalar (flashar) o firmware no seu hardware.

---

## 🤔 O que é Firmware?

Firmware é o software que roda diretamente no hardware do seu dispositivo. Ele transforma um módulo LoRa bruto em um node Meshtastic funcional.

| Conceito | Analogia |
| :--- | :--- |
| **Hardware** | O celular (físico) |
| **Firmware** | O Android (sistema) |
| **App** | O aplicativo de mensagens |

---

## 📋 Pré-requisitos

| Item | Onde Conseguir |
| :--- | :--- |
| 📱 Dispositivo LoRa | Ver [[meshtastic:hardware\|Hardware]] |
| 🔌 Cabo USB | Geralmente vem com o dispositivo |
| 🌐 Navegador web | Chrome, Edge ou Firefox (versão recente) |
| 💻 OU Python | https://python.org/ (para outras métodos) |

---

## 🌐 Método 1: Web Flasher (Recomendado)

O **Web Flasher** é o método mais fácil — funciona direto no navegador, sem instalar nada.

### Passo 1: Acessar o Web Flasher

🌐 https://flasher.meshtastic.org

### Passo 2: Conectar o Dispositivo

1. 🔌 **Conecte** o dispositivo via cabo USB
2. 🖥️ **Abra** o Web Flasher no navegador
3. 📡 **Selecione** a porta serial (geralmente aparece automaticamente)
4. 📲 **Clique** em "Connect"

### Passo 3: Selecionar o Dispositivo

| Seu Dispositivo | Selecione |
| :--- | :--- |
| Heltec V3 | "Heltec WiFi LoRa 32 V3" |
| Heltec V4 | "Heltec WiFi LoRa 32 V4" |
| T-Beam v1.2 | "TTGO T-Beam" |
| RAK4631 | "RAK WisBlock Core RAK4631" |

### Passo 4: Selecionar o Firmware

| Opção | Descrição |
| :--- | :--- |
| **Stable** | Versão estável (recomendado para iniciantes) |
| **Beta** | Versão de teste (funcionalidades novas) |
| **Alpha** | Versão experimental (pode ter bugs) |

> 💡 **Dica:** Comece com a versão **Stable**. É a mais testada e confiável.

### Passo 5: Flashar

1. ✅ **Confirme** as opções selecionadas
2. ⚡ **Clique** em "Flash"
3. ⏳ **Aguarde** o processo (1-3 minutos)
4. ✅ **Pronto!** O dispositivo reiniciará automaticamente

---

## 💻 Método 2: Meshtastic Flasher (Python)

Para quem prefere linha de comando ou tem problemas com o Web Flasher.

### Instalação

```bash
# Instalar o flasher
pip install --upgrade meshtastic-flasher

# Verificar instalação
meshtastic-flasher --version
```

### Uso

```bash
# Listar dispositivos conectados
meshtastic-flasher --list

# Flashar (substitua pela porta correta)
meshtastic-flasher --port /dev/ttyUSB0 --firmware stable
```

---

## 🔧 Método 3: VS Code + PlatformIO

Para avançados que querem compilar o firmware do código-fonte.

### Pré-requisitos

| Item | Onde Conseguir |
| :--- | :--- |
| VS Code | https://code.visualstudio.com/ |
| PlatformIO | Extensão no VS Code |
| Git | https://git-scm.com/ |

### Passos

1. 📥 **Clone** o repositório:
```bash
git clone https://github.com/meshtastic/firmware.git
cd firmware
```

2. 🔧 **Abra** no VS Code com PlatformIO

3. ⚙️ **Selecione** o target (seu dispositivo)

4. ⚡ **Compile** e **upload**

---

## 🔄 Atualizar Firmware

Se já tem um node funcionando e quer atualizar:

### Via Web Flasher

1. 🌐 Acesse https://flasher.meshtastic.org
2. 📡 Conecte o dispositivo
3. ⚡ Selecione a nova versão
4. ✅ Clique em "Flash"

### Via App (OTA)

1. 📲 Abra o app Meshtastic
2. ⚙️ Vá em "Configurações do dispositivo"
3. 🔧 Selecione "Atualizar firmware"
4. ⏳ Aguarde o download e instalação

---

## ⚠️ Solução de Problemas

### Dispositivo não é detectado

| Possível Causa | Solução |
| :--- | :--- |
| 🔌 Cabo USB ruim | Teste com outro cabo |
| 🔌 Cabo só carrega (sem dados) | Use cabo com dados |
| 🖥️ Driver não instalado | Instale CP2102 ou CH340 |
| 💻 Porta errada | Verifique no Gerenciador de Dispositivos |

### Flash falha

| Possível Causa | Solução |
| :--- | :--- |
| ⏱️ Tempo esgotado | Reconecte e tente novamente |
| 🔄 Dispositivo reiniciou | Aguarde 30 segundos e tente |
| ⚡ Bateria baixa | Conecte na energia USB |
| 📦 Firmware errado | Verifique o modelo do dispositivo |

### Dispositivo não liga após flash

| Possível Causa | Solução |
| :--- | :--- |
| 🔌 Cabo desconectado | Reconecte o cabo USB |
| ⏱️ Aguarde | Pode demorar até 1 minuto para o primeiro boot |
| 🔄 Reflash | Repita o processo de flash |

---

## 📚 Recursos

| Recurso | Link |
| :--- | :--- |
| 🌐 Web Flasher Oficial | https://flasher.meshtastic.org |
| 📖 Documentação Meshtastic | https://meshtastic.org/docs/getting-started |
| 🎥 Vídeo Tutorial (YT) | https://youtu.be/f8zv2qso7G8 |
| 💬 Comunidade | https://t.me/meshtastic_br |

---

## 🔗 Próximos Passos

| Você flashou... | Próximo passo |
| :--- | :--- |
| ✅ Firmware instalado | [[meshtastic:configuracao\|Configurar o Node]] |
| 🔄 Atualizou firmware | Verifique as configurações |
| ❓ Teve problemas | Consulte a seção de solução acima |

---

## 📝 Créditos

Guia baseado na documentação oficial do Meshtastic.
Fonte: https://meshtastic.org/docs/getting-started/flash-firmware