Blog
Board Manager do ESP32: placas sumidas e correções
O ESP32 não aparece no Board Manager, a lista está vazia ou a placa errada foi selecionada. As correções de cinco minutos, em ordem.
Não consigo encontrar o ESP32 no Board Manager?
Então o pacote nunca foi instalado — o Board Manager só lista pacotes disponíveis nas URLs que você configurou. Confira File → Preferences → Additional Boards Manager URLs; precisa conter https://dl.espressif.com/dl/package_esp32_index.json. Campo vazio: cole e reabra o Board Manager. URL presente mas a busca vazia: o download do índice falhou — tente de novo, ou use a instalação manual por zip. Eu perdi uma tarde com isso uma vez, e a causa era um cache de pacotes velho de uma instalação antiga — apagar o cache em %LOCALAPPDATA%Arduino15 e reinstalar resolveu. Mas nove em cada dez vezes, a URL faltando é a história inteira.
Como instalar a placa ESP32 na Arduino IDE?
Preferences → cole a URL JSON da Espressif → Boards Manager → procure por esp32 → instale o “esp32 by Espressif Systems” — existem clones de terceiros, pegue o da Espressif. Depois reinicie a IDE — o menu de placas carrega os pacotes no reinício, o passo que quase todo relato de “ainda não apareceu” pulou.
Como adicionar a placa ESP32 na Arduino IDE?
Adicionar uma placa é instalar o pacote dela — mesma operação, palavra diferente. Já instalou e a placa continua sumida? Desinstale pelo Boards Manager, reinicie e reinstale. O pacote é pequeno; uma reinstalação de cinco minutos vale mais que uma hora procurando.
Qual placa selecionar para o ESP32 na Arduino IDE?
Para uma placa de desenvolvimento ESP32 genérica — WROOM-32, WROOM-32D, DevKitC — selecione “ESP32 Dev Module”. O padrão seguro: clock e tratamento de flash corretos para placas de 4 MB. Os chips S3, C3 e S2 têm entradas próprias, e escolher a família errada compila normalmente, mas falha no upload com um erro de chip mismatch na saída do esptool.
Por que meu ESP32 não aparece na Arduino IDE?
Dois problemas diferentes são chamados de “não aparece”, com correções opostas. Placa faltando em Tools → Board: problema de pacote, veja as respostas de instalação acima. Placa lá, mas lista de portas vazia: driver ou cabo — chips CH340 e CP2102 precisam de driver do fabricante (principalmente no Windows), e cabos USB só de carga levam energia, mas não dados. O Gerenciador de Dispositivos mostra? Não → cabo ou driver. Sim, mas sem porta no Arduino → driver errado ou conflito. O lado da porta é o que eu vejo mais mal diagnosticado — a galera reinstala o pacote de placas pelo que no fim das contas era um cabo.
O que devo selecionar no Arduino para ESP32?
“ESP32 Dev Module” para placas padrão; a variante exata para S3, C3 e S2. Tamanho do flash, PSRAM e esquema de partição ficam no mesmo menu; os padrões estão certos para a maioria dos sketches. Na dúvida, selecione ESP32 Dev Module e não mude mais nada.
O Board Manager mostra o pacote, mas a instalação dá erro?
Erros de download do índice são rede; erros de extração são disco ou antivírus. No Windows, o antivírus às vezes quarentena a toolchain no meio da extração — exclua a pasta Arduino15 e tente de novo. O FAQ de gravação cobre os mesmos erros quando eles aparecem na hora do upload.
Instalei um segundo pacote e agora nada funciona?
Pacotes antigos fazem sombra aos novos; o Boards Manager mantém versões lado a lado. Remova a entrada antiga, reinicie e reinstale. Uma placa por família de chip é a regra.
Dá para instalar as placas ESP32 sem internet?
Sim, com esforço: a instalação manual JSON-mais-zip que a Espressif documenta, ou copiar a pasta Arduino15 inteira de uma máquina onde funciona. Copiar a pasta é o que eu realmente faço em máquinas sem rede — é cru e funciona.
Ainda travado? Rode o código mesmo assim.
Enquanto a toolchain briga com você, o mesmo sketch roda num simulador de navegador — app.sensbench.com modela o WROOM-32D, então valide o código agora e grave quando a IDE cooperar. O FAQ de primeiros passos amarra a seleção de placa e o primeiro upload de ponta a ponta.