Atalhos Windows do ESP-IDF Tools

Quando se utiliza o instalador executável oficial da Espressif no Windows (ESP-IDF Tools Installer), o próprio instalador cria de forma totalmente automatizada dois atalhos no sistema operacional.

Não é necessário configurar nenhuma variável de ambiente manualmente no Windows.

Como encontrar o atalho no Windows

Para abrir o terminal correto, fazer o seguinte:

1. Pressionar a tecla Windows no teclado (ou clicar na barra de pesquisa iniciar).

2. Digitar exatamente: ESP-IDF

3. O Windows irá mostrar duas opções de atalhos principais:

   • ESP-IDF 5.x PowerShell (Ícone com fundo azul)
   • ESP-IDF 5.x Command Prompt (Ícone clássico de prompt preto)

Recomendação: abra o ESP-IDF PowerShell, pois ele é mais moderno, aceita comandos do Linux (como ls e clear) e costuma dar menos problemas de compatibilidade com caminhos de arquivos.

Ao clicar nesse atalho, uma janela de terminal vai abrir e processar algumas linhas de código sozinhas. Quando ela estabilizar, exibirá uma mensagem de sucesso dizendo que o ambiente está pronto para uso (ex: "You can now run idf.py to build and flash your projects").

Como fica o fluxo de trabalho no terminal do Windows?

Com o terminal do ESP-IDF PowerShell aberto, a sequência de comandos que será digitada para rodar um código exemplo com FreeRTOS fica:

1. Navegar até a pasta do projeto (onde fica o arquivo principal CMakeLists.txt

   cd "C:\Caminho\Para\A\Pasta\MeuProjeto"
   

2. Definir que o código é para o ESP32 clássico (necessário apenas na primeira compilação):

   idf.py set-target esp32
   

3. Compilar, gravar na placa e abrir o monitor serial (tudo em uma linha):

   idf.py -p COM3 flash monitor
   

   Obs.: substituir o COM3 pela porta real encontrada no Gerenciador de Dispositivos, como explicado em Descobrindo a porta do ESP32.

Para fechar o Monitor Serial no terminal deles e voltar a digitar novos comandos, basta pressionar o atalho Ctrl + ].

Fernando Passold, em 30/08/2026