Preparar a IDE

1. Verificar e Carregar. O visto traduz o programa e aponta erros sem tocar na placa. A seta traduz e envia. É assim que a documentação da Arduino descreve os dois botões.
2. Seletor de placa e porta. Duas escolhas, não uma. Ele costuma reconhecer sozinho o que está ligado; quando não reconhece, o caminho manual é Tools > Board e Tools > Port.
3. Monitor Serial. O botão que abre o caminho de volta, por onde a placa escreve para você. Na IDE 2 ele não abre em janela separada: aparece embaixo.
4. Coluna de ícones. Pasta de sketches, Gerenciador de Placas, gerenciador de bibliotecas, depurador e busca. O segundo ícone é o que você usa para instalar o suporte ao ESP32-S3.
5. Área do sketch. Onde o programa é escrito. É o caderno.
6. Área de saída. A faixa escura embaixo. É onde a tradução conta o que fez, onde os erros aparecem e onde o Monitor Serial se instala quando é aberto.

1. Ligue a placa direto no computador.

   Sem hub USB no meio. Um LED da placa acende assim que ela recebe energia; se nenhum acende, o problema é cabo ou porta, e não adianta seguir.

2. Abra um programa que já vem pronto.

   No menu, File > Examples > 01.Basics > Blink. É o programa mais simples que existe: acende e apaga o LED da própria placa. Ninguém precisa digitar nada aqui.

3. Diga qual placa e qual porta.

   O seletor no alto da janela costuma reconhecer sozinho o que está ligado. Se não reconhecer, o caminho manual é Tools > Board e Tools > Port.

4. Confira antes de enviar.

   Clique no visto. Ele traduz o programa e aponta erros sem tocar na placa. É o teste barato.

5. Envie.

   Clique na seta. A tradução aparece na área escura embaixo e, no fim, o aviso de que terminou.

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(1000);
  digitalWrite(LED_BUILTIN, LOW);
  delay(1000);
}

Este é o exemplo que a própria ferramenta traz. Você não precisa digitá-lo; a versão comentada desta aula, com as constantes nomeadas, está em codigo/blink.ino.

1. Abra as preferências.

   No Windows e no Linux, File > Preferences. No macOS, Arduino IDE > Settings.

2. Cole o endereço do Espressif.

   É este, o da versão estável, tal como o próprio Espressif publica: https://espressif.github.io/arduino-esp32/package_esp32_index.json. Confirme com OK.

3. Abra o Gerenciador de Placas.

   Na IDE 2, o ícone da plaquinha na coluna da esquerda — o segundo de cima para baixo —, ou Tools > Board > Boards Manager.

4. Instale o pacote esp32.

   Procure por esp32 e instale o que aparece como esp32 by Espressif Systems. É um download grande; deixe terminar sem fechar a janela.

5. Reinicie a ferramenta

   e volte em Tools > Board: agora existe um grupo esp32 na lista.

void setup() {
  Serial.begin(115200);
}

void loop() {
  Serial.println("O S3 fala");
  delay(1000);
}

// aqui em cima: constantes e variáveis do programa inteiro

void setup() {
  // prepara: pinMode, Serial.begin…
}

void loop() {
  // trabalha: ler, decidir, escrever, esperar…
}

Não existe terceira parte obrigatória. Tudo o que um sketch faz cabe nessas duas funções ou em funções suas, chamadas por elas.

Os artigos do Arduino Help Center recusam requisição automatizada e respondem 403 para robôs; no navegador eles abrem normalmente. É um aviso conhecido do gate de links desta casa, não um link quebrado.

IDE

Integrated Development Environment, ambiente integrado de desenvolvimento: o programa que reúne, numa janela só, o editor de texto, o tradutor, o gravador e o monitor. O desta aula é o Arduino IDE 2.

Sketch

O nome que o Arduino dá a um programa: o arquivo .ino com setup() e loop().

Compilar

Traduzir o texto do sketch para a linguagem de máquina do chip. Acontece no seu computador, antes de qualquer envio; é o que o botão do visto faz.

Upload (carregar)

Enviar o programa já traduzido para dentro da placa pelo cabo. É o que o botão da seta faz — e ela compila antes de enviar.

Porta serial (COM)

O canal de comunicação que o sistema cria quando a placa é reconhecida. No Windows tem nome COM3, COM7; no Linux, /dev/ttyUSB0 ou /dev/ttyACM0; no macOS, /dev/cu.…. É por ela que o programa entra e o texto volta.

Serial

A conversa em uma via de cada vez entre a placa e o computador, feita ligando e desligando a tensão de um fio numa cadência combinada. Serial.begin abre a conversa; Serial.println escreve uma linha nela.

Baud

A cadência dessa conversa, em símbolos por segundo — nos casos desta aula, bits por segundo. É o número do Serial.begin e o do seletor do Monitor Serial. Diferentes, o texto vira lixo sem nenhuma mensagem de erro.

Monitor Serial

A janela (na IDE 2, um painel embaixo) que mostra o que a placa escreve e permite mandar texto para ela.

Bootloader

Um programa pequeno que já vive dentro da placa e que, na hora certa, escuta a porta serial esperando um programa novo para gravar no lugar do antigo. É ele que faz o upload funcionar sem gravador externo.

Modo de gravação

O estado em que o chip espera firmware em vez de rodar o programa que já tem. No ESP32-S3 quase sempre ele entra sozinho; quando não entra, o gesto é segurar BOOT, apertar e soltar RESET e soltar BOOT.

Driver

O pedaço de software do sistema operacional que sabe conversar com um chip de hardware. Aqui interessa o driver do chip que faz a ponte USB da placa: sem ele, a porta não aparece na lista.

Ponte USB-serial

O chip que traduz o USB do computador na serial que o microcontrolador entende. No Uno original é o ATmega16U2; em clones, um CH340 ou um CP2102.

USB CDC

Communications Device Class: a parte do padrão USB que faz um aparelho se apresentar ao computador como porta serial. O ESP32-S3 sabe fazer isso sozinho, sem ponte; é o que a opção USB CDC On Boot liga.

Core (pacote de placas)

O conjunto de arquivos que ensina a IDE a compilar e gravar para uma família de placas: compilador, bibliotecas básicas e a lista de opções do menu Tools. O do Uno já vem instalado; o do ESP32-S3 é o pacote esp32, do Espressif.

Gerenciador de Placas

O catálogo de cores dentro da IDE: lista, instala e atualiza pacotes de placas. Só enxerga catálogos que ele conhece — daí o campo de endereços adicionais.

Flash

A memória onde o programa fica guardado, e que não se apaga quando a placa desliga. O N16 do N16R8 são 16 MB dela.

PSRAM

Memória RAM extra, fora do núcleo e dentro do módulo, para dados grandes: imagens, buffers de rede, telas. O R8 do N16R8 são 8 MB dela, em modo octal (OPI).

AppImage

Formato de aplicativo do Linux em arquivo único, que roda sem instalação. É como o Arduino IDE 2 é distribuído para Linux; precisa ser marcado como executável e depende do FUSE no sistema.

udev / dialout

No Linux, udev é o subsistema que dá nome e permissão aos dispositivos ligados; dialout é, na maioria das configurações, o grupo de usuários com acesso direto às portas seriais.

LED_BUILTIN

Apelido que o pacote da placa define para o pino do LED que já vem soldado nela. Escrever LED_BUILTIN em vez do número faz o mesmo sketch funcionar em placas diferentes.