A visão geral, com exemplos rodando, está na página da placa e O modelo do ESP32-S3 (todos os registradores).
O que é
A ESP32-S3-DevKitC-1, a placa da Espressif para o ESP32-S3, rodando no nosso próprio core Xtensa. O firmware é um ELF Xtensa que fala com os endereços reais do ESP32-S3, e quase todos esses endereços foram conferidos com o manual de referência técnica da Espressif.
A placa tem 62,7 por 25,4 mm e suas duas fileiras de 22 pinos ficam a 0,9 polegada de distância, então ela atravessa o canal central da protoboard deixando uma fileira de furos livre de cada lado, como o ESP32 DevKit clássico.
Os pinos
Vinte e dois pinos em cada borda longa, os dois conectores micro-USB embaixo, o módulo e sua antena em cima. A serigrafia nomeia cada GPIO pelo seu número.
J1, a coluna da esquerda, de cima a baixo: 3V3, 3V3, RST, 4, 5, 6, 7, 15, 16, 17, 18, 8, 3, 46, 9, 10, 11, 12, 13, 14, 5V, G.
J3, a coluna da direita, de cima a baixo: G, TX, RX, 1, 2, 42, 41, 40, 39, 38, 37, 36, 35, 0, 45, 48, 47, 21, 20, 19, G, G.
TX e RX são os GPIO 43 e 44, a UART0. RST é o chip enable. 5V é o barramento do USB. Esta é uma placa de 3,3 volts e seus pinos não toleram 5 V.
Coisas que o pinout faz com você
- Os GPIO 35, 36 e 37 pertencem à PSRAM nas placas com PSRAM octal (a N8R8 que a maioria compra). Eles estão no header e, nessas placas, você não deve usá-los. O Mokxi não tem PSRAM, então aqui eles funcionam, o que numa mesa real pode não acontecer.
- Os GPIO 19 e 20 são o D- e o D+ da porta USB. Se você os acionar, o soquete "USB" para de funcionar numa placa real. Aqui a porta serial USB continua funcionando, o que é mais gentil que o silício.
- Os GPIO 0, 3, 45 e 46 são pinos de strapping, então o que estiver ligado a eles na energização importa. O GPIO 0 também é o botão BOOT.
- Alguns pinos ligam com a entrada desligada. Os GPIO 4 a 8, 15, 16 e 19 a 21 leem 0 até que
pinModeligue o buffer de entrada, que é o estado de reset do chip.pinModesempre faz isso, então um sketch nunca percebe.
The RGB LED
A placa não tem um LED simples. Ela tem um LED RGB endereçável, um componente tipo WS2812, no GPIO 48 nas primeiras placas e no GPIO 38 na v1.1, que a Espressif lista como a única diferença entre as duas revisões. A propriedade revision da placa escolhe qual está na sua protoboard.
LED_BUILTIN nesta placa não é um número de GPIO: como no core do Arduino, é a contagem de GPIOs somada ao pino do LED, e digitalWrite(LED_BUILTIN, HIGH) envia ao LED um quadro que o acende branco num quarto do brilho. Para cores, rgbLedWrite(RGB_BUILTIN, red, green, blue). Ambos saem pelo periférico RMT do chip, 24 bits começando pelo verde, cada bit dentro do tempo do datasheet do WS2812B, e o LED da placa acende com a cor que o quadro carregar.
Os exemplos foram feitos para o GPIO 48, como é a definição da placa no core do Arduino. Numa placa v1.1 o LED está no GPIO 38, então o mesmo sketch o deixa apagado, que é o que aconteceria numa mesa real. O pino também está no header, então uma fita ws2812 ligada ao 48 vê os mesmos quadros.
analogRead: dez canais, e 2,9 V é o topo
Os dez canais do ADC1 são os GPIO 1 a 10: o canal n é o GPIO n + 1. Doze bits. Com a atenuação padrão de 12 dB, a faixa de medição do datasheet termina em 2,9 V, e o Mokxi lê 4095 a partir daí para cima, então um potenciômetro pelo barramento de 3,3 V lê 4095 no oitavo final do seu curso. O exemplo knob imprime o número bruto para que isso não seja um mistério.
Aquela linha reta até 2,9 V é uma aproximação: um S3 real mantém uma pequena folga acima da faixa e se curva nas duas pontas, corrigida com calibração gravada no chip. O ADC2 não é modelado.
analogWrite é LEDC, e não custa nada ao core
analogWrite(pin, 0..255) conecta um dos oito canais do LEDC ao pino: oito bits a 1 kHz, em qualquer GPIO, pela matriz de GPIO. ledcAttach(pin, frequency, bits) e ledcWrite(pin, duty) estão lá quando a frequência importa. No S3, as configurações do LEDC só têm efeito quando um bit de atualização é escrito, e o runtime o escreve; um LED com fade não custa nada ao core.
Serial, e os dois soquetes USB
Uma DevKitC-1 real tem dois soquetes micro-USB. "UART" passa por uma ponte USB-para-UART até a UART0: esse é o Serial, como no core do Arduino com USB CDC On Boot desligado, o padrão desta placa. "USB" é o próprio controlador USB Serial/JTAG do chip: esse é o USBSerial, que envia um pacote de 64 bytes por vez, no fim de cada linha.
O monitor serial aqui escuta os dois ao mesmo tempo, então qualquer um imprime no mesmo lugar, e o que você digita vai para os dois.
Um núcleo, não dois
Um S3 real tem dois cores Xtensa LX7, e um sketch do Arduino aqui roda em um. Um sketch escrito em torno de setup() e loop() nunca percebe. Qualquer coisa que inicie uma tarefa no núcleo 1 não roda.
Um firmware que você mesmo compilou é diferente: MicroPython e uma compilação do ESP-IDF rodam em um modelo do chip inteiro, onde os dois núcleos de fato rodam (abaixo).
What is modeled
O Xtensa LX7, que para tudo que um compilador emite de C é o conjunto de instruções LX6 do ESP32 clássico: a mesma ABI com janelas, e a saída do compilador do S3 foi conferida byte a byte com a do compilador do ESP32. Ao redor dele: 416 KB de SRAM vistos pelos dois barramentos, a matriz de GPIO e o IO MUX com as pull-ups de reset do manual em cada pino, a UART0, a porta serial USB Serial/JTAG, o SYSTIMER por trás de millis() e micros(), o ADC1, o LEDC, os quatro canais de transmissão do RMT, os gates de clock e o tanto da matriz de interrupção que quatro fontes precisam.
WiFi, simulated
Não há rádio. O que existe é do Mokxi: rede simulada, a mesma que o ESP32 clássico e o ESP32-C3 têm, atrás de um bloco que é do próprio Mokxi e não do chip, num endereço que o S3 deixa sem mapear. WiFi.h,
HTTPClient.h e WebServer.h funcionam do jeito que um tutorial espera: a placa entra num ponto de acesso cujo nome e senha são propriedades da placa, busca uma página num endereço inventado sob .mokxi, ou serve uma para o painel Web. Não há 802.11, não há TCP, não há TLS e não há internet de verdade. A única exceção é o Internet de verdade interruptor no painel Cloud, que envia requisições para outros nomes pelo gateway do Mokxi. O Bluetooth LE é simulado do mesmo jeito, com um telefone no painel Bluetooth do editor (Bluetooth, simulado).
WiFi, simulado é como usá-lo; Simulated WiFi é o contrato.
O que não é
Rádio de qualquer tipo: WiFi e Bluetooth LE são simulados, sem rádio por baixo. O segundo núcleo. A FPU e as instruções de vetor do S3: ambas geram falha em vez de retornar um número errado, e o runtime é soft float. SRAM0, o cache, a flash e a PSRAM. O RTC, os coprocessadores ULP e o deep sleep. O ADC2, o sensor de toque e o sensor de temperatura. Os timers dos grupos de timer (os watchdogs deles são modelados, para o task watchdog). UART1 e UART2, os controladores I2C e SPI, I2S, a interface de câmera, TWAI e USB OTG. Wire e SPI no runtime são software em pinos comuns, como em toda placa daqui: SDA no 8, SCL no 9 e SPI de 10 a 13.
Binários do ESP-IDF e do core Arduino de fornecedor não vão rodar aqui: o runtime é nosso.
Compilando o seu sketch
Edite o sketch e aperte Rodar: ele compila na aba com o clang da Espressif para Xtensa, a mesma toolchain do ESP32 clássico e do ESP8266 (clang-v3, cerca de 80 MB, baixado uma vez). Nada é enviado. Um exemplo intocado roda seu programa pré-compilado, compilado com o GCC da Espressif para o S3; nada do GCC é ligado a ele.
A aritmética de ponto flutuante funciona: este modelo não tem FPU, então a compilação faz somas de float e double em software, como nas placas sem FPU algum. Compilando no navegador tem o relato completo.
Os exemplos
Blink, Rainbow, Button, Serial, USB serial, Fade, Knob e os quatro de WiFi: WiFi: join the network, WiFi: fetch the weather, API lab: fetch JSON e WiFi: a lamp on a web page.
Um firmware que você mesmo compilou
Um sketch de Arduino é compilado aqui e roda em um core. Um programa compilado em outro lugar, com ESP-IDF ou em Rust (esp-hal, esp-idf-hal), também roda, em um modelo do chip inteiro com ambos os cores: faça upload do seu .bin ou .elf no painel de Firmware, e a placa inicializa com ele como após idf.py flash. Wi-Fi e Bluetooth são uma lacuna, já que seus drivers são as bibliotecas fechadas da Espressif: um firmware que inicia qualquer um dos dois para com uma linha avisando isso. Os passos e a lista completa estão em
Rodar um firmware pronto.
MicroPython e CircuitPython
Escolha MicroPython (main.py) no painel de Firmware da placa, e Rodar inicializa o firmware oficial do MicroPython v1.29.0 para o ESP32-S3 com o seu main.py, em um modelo do chip inteiro inicializado a partir da própria ROM da Espressif. machine.Pin,
PWM, ADC, I2C, SPI, UART(1) e neopixel funciona, e network.WLAN
entra na rede simulada. Veja
MicroPython no ESP32.
Pick CircuitPython (code.py) instead and Run boots the official CircuitPython 10.3.1 firmware for this board, with its CIRCUITPY drive and its REPL on the S3's own USB port. WiFi is not simulated under CircuitPython here. See CircuitPython no Pico, que também cobre esta placa.
Em outros lugares
- A página da placa: /boards/esp32-s3
- The contract document: o modelo do ESP32-S3, whose section 6 lists the few numbers that are believed rather than checked
- As outras placas Xtensa: o ESP32 DevKit e o ESP8266 NodeMCU
- O mesmo chip em outras placas: o XIAO ESP32-S3 e o Arduino Nano ESP32