Blog
Porta do ESP32: achar a porta COM e o número de série
Sem porta, porta errada, porta que sumiu — a porta serial é onde a maioria dos dias de ESP32 descarrilha. Como achar a porta COM, por que o texto do erro diz o que diz e o que “ID” significa de verdade nessas placas.
Não consigo abrir a porta dev ttyUSB0 no ESP32?
No Linux esse erro é quase sempre permissão ou nome de dispositivo errado. Confira o dmesg para o chip USB do cabo, depois ls /dev/tty* — sua placa pode ser ttyACM0, não ttyUSB0. Corrija permissões com sudo usermod -aG dialout $USER, saia e entre de novo, e a linha “could not open port” desaparece. Se nunca aparece, a tabela de drivers da base de conhecimento é o próximo passo.
Como achar a porta do ESP32?
Windows: Gerenciador de Dispositivos → Portas (COM & LPT), plugue a placa e veja qual COM aparece. Linux: ls /dev/ttyUSB* /dev/ttyACM*. macOS: ls /dev/cu.usbserial-*. A porta pertence ao chip USB-serial, não ao ESP32 — placas CH340 aparecem como “USB-SERIAL CH340”, CP2102 como “Silicon Labs CP210x”.
Como ler o ID do ESP32?
O “ID” prático é o endereço MAC — único por chip, impresso pelo esptool.py chip_id, ou no código via ESP.getEfuseMac(). Modelo e revisão do chip vêm de ESP.getChipModel(). A maioria das devkits não tem número de série; o MAC é o ID que importa para MQTT, BLE e OTA.
Por que minha porta sumiu depois da gravação?
O chip USB-serial reinicia junto com a placa — essa parte é normal. Se ela nunca volta, o cabo é só de carga, o driver sumiu, ou a placa está presa num boot loop onde a porta pisca entrando e saindo. Observe o Gerenciador de Dispositivos durante o loop; uma COM piscando é o sinal. Resets persistentes pertencem ao FAQ de debug.
A porta existe, mas o Serial Monitor diz “Failed to Open”?
Algo mais está segurando a porta — geralmente um segundo monitor ou a própria IDE. Feche toda janela serial, desconecte, reconecte e tente de novo. No Windows, o driver pode deixar locks de porta velhos depois de um crash; reiniciar o PC limpa. Eu mantenho um post-it “feche os outros monitores primeiro” na mesa.
Por que vejo duas portas?
Placas ESP32-S3 e C3 expõem duas interfaces USB: USB CDC nativa e a ponte UART — daí duas portas COM. Escolha a que combina com o rótulo da serigrafia da placa, geralmente “UART”. A gravação funciona na porta UART; a CDC serve para sketches que usam USB nativo.
Como acho a porta sem driver?
Não acha — o driver é o passo um. No Windows, um dispositivo desconhecido no Gerenciador de Dispositivos significa que o driver CH340 ou CP2102 está faltando; o nome amigável “USB-SERIAL” só aparece depois de instalar. Se nenhum dispositivo aparece nunca, o cabo não passa dados; troque antes de culpar a placa. Essa ordem resolve a maioria dos casos de “sem porta nenhuma”.
O número da porta importa?
Não — COM5 hoje, COM12 amanhã; o Windows atribui números livremente. A armadilha são ferramentas lembrando o número antigo: depois de reconectar, a Arduino IDE mostra uma porta nova e você precisa reselecionar. Monitores seriais e o PlatformIO detectam sozinhos, e é por isso que raramente batem em “port not found”. Mesma regra no Linux: o número depois de ttyUSB é arbitrário.
Dá para gravar sem saber a porta?
Na maioria, sim. O esptool.py tenta portas comuns quando você omite -p, o PlatformIO varre automaticamente, e o OTA ignora a porta por completo. Saber a porta ainda importa para o trabalho com o serial monitor, então os 30 segundos para achá-la nunca são desperdiçados. O FAQ de gravação cobre os caminhos sem porta em ordem.
E se nenhuma porta aparecer nunca?
Checklist, em ordem: outro cabo (de dados, não de carga), outra porta USB — portas do painel frontal são instáveis — depois outra máquina, e então o driver de novo. Uma placa com o chip USB morto ainda roda quando alimentada: se o LED pisca mas nenhuma porta aparece, o chip USB-serial é a vítima. Isso aconteceu com um dos meus módulos; a placa gravou liso num adaptador USB-TTL de US$ 4 depois.
Os projetos deste tópico rodam direto no simulador gratuito do sensbench: circuito pré-montado, firmware incluído, sem conta e sem instalação.