Blog
Instalação do ESP32: placas, IDEs e bibliotecas
Instalar o pacote de placas do ESP32 e as bibliotecas na Arduino IDE e no VS Code — as dúvidas de configuração que travam a galera antes do primeiro blink.
Como instalar o ESP32?
Instale o pacote de placas e a IDE passa a conhecer o chip. Na Arduino IDE: File → Preferences, cole https://dl.espressif.com/dl/package_esp32_index.json em “Additional Boards Manager URLs”, depois Tools → Board → Boards Manager, procure por “esp32” e instale o “esp32 by Espressif Systems”. Um pacote só cobre o WROOM-32D, o S3 e o C3. Na minha máquina Windows a primeira instalação levou uns quatro minutos; as seguintes são mais rápidas porque o compilador fica em cache. Reinicie a IDE depois — a lista de placas atualiza no reinício, e pular isso é o motivo de gente achar que a instalação falhou. O FAQ da Arduino IDE tem o mesmo passo a passo com as pegadinhas apontadas.
Como adicionar o ESP32 ao Arduino?
“Adicionar” e “instalar” são a mesma operação: você adiciona uma placa instalando o pacote dela pelo Boards Manager. Cole a URL JSON da Espressif em Additional Boards Manager URLs, instale e reinicie — esse reinício resolve metade dos relatos de “ainda não apareceu”.
Como instalar o ESP32 no Arduino?
Tem o mesmo sentido de “adicionar”: o pacote de placas da Espressif define todas as variantes do ESP32. Depois de instalado, confira em Tools → Board → ESP32 Arduino → ESP32 Dev Module. Submenu sumiu? Reinstale e reinicie antes de qualquer outra coisa.
Como instalar o ESP32 no Arduino 2.0?
A Arduino IDE 2.x mantém o mesmo campo de Additional Boards Manager URLs em File → Preferences. A 2.x mostra o progresso por pacote e instala pacotes lado a lado. Pacotes antigos fazem sombra aos novos, então desinstale a entrada ESP32 antiga antes de migrar da 1.8.x. Funciona bem na maioria dos casos, uma vez que você sabe disso.
Como instalar bibliotecas do ESP32?
Sketch → Include Library → Manage Libraries, procure, instale — bibliotecas são instaladas por IDE, não por placa. O core do ESP32 já vem com embutidas (WiFi, BLE, esp32-hal), então erros de “library not found” geralmente são caminho de include faltando, não instalação faltando. Bibliotecas de terceiros aparecem assim que o pacote de placas está presente.
Como fazer o VSCode funcionar com o ESP32?
Dois caminhos. Extensão PlatformIO: instale, crie um projeto, escolha “Espressif ESP32 Dev Module” como placa, e a toolchain baixa no primeiro build — é o caminho que eu uso todo dia; bibliotecas são por projeto. Ou a extensão do Arduino mais o pacote de placas que você já instalou. O primeiro build puxa uns ~500 MB de toolchain, o que parece travamento em conexões lentas; não é, espere terminar. O FAQ do PlatformIO cobre a estrutura de projeto.
Por que a instalação falha em “Downloading packages”?
Geralmente é a rede, não os arquivos — proxies e VPNs cortam o download no meio, e a IDE recomeça do zero. Correções: limpe a pasta de staging e tente de novo; troque para uma conexão cabeada; desligue o proxy; ou instale manualmente. O caminho manual muda conforme a versão da IDE e a documentação oficial é vaga sobre ele, então a maioria tenta de novo pelo caminho da rede.
Preciso do VS Code e da Arduino IDE?
Não. Escolha um. A Arduino IDE é o caminho mais suave; o PlatformIO é o caminho de engenharia, com debug melhor e bibliotecas por projeto. O código é o mesmo C++ de qualquer forma.
E instalar o MicroPython no lugar?
Instalação diferente, mesmo hardware: apague o flash com o esptool e grave o binário do firmware MicroPython no endereço 0x1000. O pacote de placas do Arduino é irrelevante a partir daí — o MicroPython não usa a toolchain do Arduino de jeito nenhum. Bom se você prefere Python, com a cobertura mais fraca de bibliotecas de sensor como troca. Depende do seu projeto, sinceramente.
A instalação funcionou — e agora?
Pisque. Envie o sketch Blink, observe o serial monitor e depois ligue um LED no GPIO2. Esse loop — instalar, gravar, imprimir — é quase tudo que “instalar” significa na prática, e o FAQ de gravação é o caminho de recuperação quando parar de funcionar depois.