O computador não reconhece a placa
A causa mais comum é um cabo USB só de carga, sem fios de dados. Troque o cabo. Se continuar, instale o driver do conversor USB-serial (CP210x ou CH340, conforme a sua placa).
Modo de contingencia: las páginas públicas y las descargas siguen disponibles; el inicio de sesión, la comunidad y los datos del servidor pueden no estar disponibles.
Primeira vez com o ESP32? Dicas de ouro de hardware
Você não precisa de bancada, solda nem programador. Para começar basta uma placa de desenvolvimento ESP32 e um cabo USB. Aqui está o essencial para não perder tempo (nem placa) no começo.
Só o USB basta
Uma placa de desenvolvimento ESP32 (DevKit) é barata e já vem pronta: o cabo USB leva a energia e também carrega o programa. Para o primeiro teste você precisa só de:
- uma placa ESP32 de desenvolvimento;
- um cabo USB de dados (cabo só de carga não funciona);
- um computador com porta USB.
Fonte externa, protoboard, sensores e módulos ficam para depois. O custo de entrada é de poucas dezenas de reais.
O LED interno: o seu primeiro teste
Muitas placas trazem um LED de uso geral ligado a um dos pinos. Fazer esse LED piscar prova que o computador, o cabo, a gravação e a placa estão funcionando, tudo sem montar nenhum circuito. O pino varia conforme o modelo (em várias placas é o GPIO 2; algumas usam um LED colorido, e outras não têm LED). Confira na descrição da sua placa.
// Pisca o LED interno (Arduino Core). LED_BUILTIN vem definido na maioria das placas.
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(500);
digitalWrite(LED_BUILTIN, LOW);
delay(500);
}O delay() serve para esse primeiro teste. Em projetos reais, prefira lógica sem espera bloqueante.
O resumão do hardware
| Parte | Para que serve |
|---|---|
| Módulo ESP32 (o chip) | O cérebro: processador, Wi-Fi e Bluetooth. A placa de desenvolvimento (DevKit) já traz o módulo pronto, com os pinos em fila. |
| Memória flash | Onde o seu programa (firmware) fica gravado. Não se perde ao desligar. |
| RAM | Memória de trabalho do programa. Some quando a placa desliga. É pouca: cuidado com listas e textos grandes. |
| Pinos de uso geral (GPIO) | Entradas e saídas para sensores, LEDs e módulos. Funcionam com 3,3 V. |
| Conversor USB-serial | Chip (CP2102, CH340 ou similar) que deixa o computador conversar com a placa pelo cabo USB. Alguns modelos, como o ESP32-S3, têm USB nativo. |
| Botões BOOT e EN (RESET) | EN reinicia a placa. BOOT, segurado na hora de gravar, coloca a placa em modo de gravação. |
| Regulador de tensão | Transforma os 5 V do USB nos 3,3 V que o chip usa. |
| LEDs da placa | Um LED de energia, que fica sempre aceso, e em muitos modelos um LED de uso geral, ligado a um pino que você controla. |
Problemas comuns de quem está começando
Erro "Failed to connect" ao gravar
Segure o botão BOOT enquanto a gravação começa e solte quando aparecer o progresso. Confira também se a porta COM escolhida é a da placa.
A placa reinicia sozinha, em loop
Quase sempre é alimentação fraca (cabo fino, porta USB do computador ou de hub sem força). O Wi-Fi puxa picos de corrente. Teste com outro cabo ou uma porta direta.
O programa não inicia depois de ligar um componente
Alguns pinos (strapping, como GPIO 0, 2, 12 e 15 no ESP32 clássico) definem como a placa liga. Um componente preso a eles na hora do boot atrapalha. Troque de pino.
Pino que não funciona como esperado
No ESP32 clássico, os GPIO 34 a 39 só leem (sem saída), e os GPIO 6 a 11 são da flash e não devem ser usados. A leitura analógica ADC2 não funciona enquanto o Wi-Fi está ligado: use o ADC1.
Não conecta no Wi-Fi
A maioria dos ESP32 só usa a rede de 2,4 GHz. Se o seu roteador separa as redes, escolha a de 2,4 GHz. Confira também o nome da rede e a senha.
Perigos: o que pode queimar a placa (ou machucar você)
Nunca ligue 5 V em um pino
Os pinos trabalham com 3,3 V. Sinais de 5 V (de outras placas, por exemplo) podem queimar o chip. Use divisor de tensão ou conversor de nível.
Não puxe corrente demais de um pino
Um pino aguenta poucas dezenas de miliampères, e o limite absoluto é de 40 mA. Para LED use resistor. Para relé, motor, servo ou fita de LED, use transistor ou módulo driver, com alimentação própria.
Cuidado com a rede elétrica (110/220 V)
Choque e incêndio são reais. Para quem está começando, não mexa em rede elétrica. Se precisar comandar uma carga, use módulos prontos e certificados, em caixa fechada, e peça ajuda a quem entende.
Não conecte a placa direto em sinais industriais
O ESP32 não tem isolação elétrica. Em painéis de 24 V ou de rede, use módulos isolados (por exemplo, RS-485 isolado) e fontes adequadas. Um surto pode queimar a placa e o equipamento ligado a ela.
Baterias de lítio pedem circuito de proteção
Nunca ligue uma bateria de lítio direto na placa. Use carregador e proteção contra curto, sobrecarga e descarga profunda. Polaridade invertida também queima a placa.
Duas fontes ao mesmo tempo
Não alimente a placa pelo USB e por outra fonte nos pinos 5V ou VIN ao mesmo tempo, sem saber como a sua placa se protege. Pode devolver tensão ao computador.