Usando Sublime Text + Terminal


Intro

Abordagem mais rápida e limpa se você busca máxima velocidade e zero interfaces pesadas. Esta combinação usa o terminal para o trabalho pesado e o Sublime apenas para edição de texto.

Passo 1: Abrir o projeto no Sublime Text

  1. Abra o Sublime Text.
  2. Vá em File > Open Folder e selecione a pasta do seu código exemplo.
  3. Pronto, o Sublime está configurado para editar seus arquivos .c, .cpp ou .h.

Passo 2: Abrir o terminal integrado da Espressif

Para compilar, você deve usar o terminal que já possui as variáveis de ambiente do ESP32 carregadas:

Passo 3: Comandos de Terminal para controlar a placa

No terminal que você acabou de abrir, navegue até a pasta do seu projeto exemplo (cd caminho/da/pasta) e use os três comandos principais da ferramenta idf.py:

Exemplo de comando de flash no macOS: % idf.py -p /dev/cu.usbserial-1410 flash monitor

 

Obs.: Substitua COMX pela porta real do seu ESP32, como COM3 no Windows ou /dev/ttyUSB0 no Linux. O comando monitor mostra os printf do código em tempo real. Para sair do monitor, pressione Ctrl + ]).


Resumo (Sublime + Terminal)

Se você optar pelo método rápido, 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

Exemplo no macOS

  1. Montando manualmente a estrutura requerida da pastas:

  2. Abrindo o terminal próprio para uso do ESP-IDF: Abra o App eim (localizado em /Applications) e na janela do ESP_IDF Version Management, dentro deInstalled Versions (no caso v6.1-beta1, localizada na pasta: ~/.espressif/v6.1-beta1/esp-idf), selecione o primeiro ícone referente à IDF Terminal. Espere abrir uma nova janela de terminal bash (alguns ajustes serão executados) e deve aparecer algo como:

  3. "Caminhando" até a pasta do seu projeto. Basta digitar cd e arrastar a pasta do Projeto até este terminal. Deve resultar algo como:

  4. Definindo a placa (target):

    Note uma curiosidade:

    Obs.: Neste computador está instalando o conda + Python:

     

  5. Compilando o projeto:

    Note: a primeira compilação pode tardar um pouco (neste caso tardou +8 minutos)...

  6. Fazer o flash (sem o monitor neste caso):

    Obs.: Se tivéssemos ativado o monitor, a única maneira de voltar a ter controle no bash é pressionando: Cmd+].

  7. Finalizando atividades. Por fim, como estamos no terminal IDF, melhor voltar o sistema do host:

     


Fernando Passold, em 29-30/08/2026