Como descobrir a porta do ESP32

Ao conectar a placa via USB, o sistema operacional cria um arquivo virtual para representar a porta serial. Veja como listá-los:

No Windows

1. Basta clicar com o botão direito no menu Iniciar e abrir o Gerenciador de Dispositivos.
2. Procurar pela seção Portas (COM e LPT). O ESP32 aparecerá como algo do tipo: Silicon Labs CP210x USB to UART Bridge (COM3). A porta deles será COM3, COM4, etc.

Obs.: supõe-se que a ferramenta oficial "ESP-IDF Tools Installer" da Espressif foi instalada. Se desejar saber os comandos/atalhos no terminal ver: Atalhos Windows do ESP-IDF Tools.

No Ubuntu

1. Abra o Terminal do Ubuntu (Ctrl + Alt + T).

2. Digite o comando:

   ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null
   

3. O terminal vai retornar algo como /dev/ttyUSB0.

Atenção (Importante para Ubuntu):

Por padrão, o Ubuntu bloqueia o acesso direto à porta USB por motivos de segurança. Você precisa rodar o comando abaixo uma única vez e depois reiniciar o computador para liberar a permissão:

$ sudo usermod -a -G dialout $USER

No macOS

1. Abra o Terminal do Mac.

2. Digite o seguinte comando e dê Enter:

   % ls /dev/cu.usb*
   

3. O terminal vai retornar algo como:

   /dev/cu.usbserial-1410
   

   ou

   /dev/cu.usbmodem...
   

   Esta é a sua porta.

    

Exemplo no macOS:

1. Descobrindo a placa ESP32:

   (base) fernandopassold@MacBook-Pro-de-Fernando Senoide1 % ls /dev/cu.usb*
   /dev/cu.usbserial-0001
   (base) fernandopassold@MacBook-Pro-de-Fernando Senoide1 %
   

Resumo para usuários de Sublime + Terminal

Se você optar pelo método rápido com os alunos, a receita de bolo na aula será:

1. Montar a estrutura de pastas e colar os dois arquivos CMakeLists.txt explicados acima.
2. Abrir o terminal (com o ambiente ESP-IDF carregado).
3. Navegar até a pasta raiz: cd caminho/de/MeuProjeto
4. Rodar o comando para compilar: idf.py build
5. Descobrir a porta (usando os comandos acima) e rodar: idf.py -p PORTA flash monitor

Fernando Passold, em 30/08/2026