La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de la ESP32-S3 (todos los registros).
Qué es
La ESP32-S3-DevKitC-1, la placa de Espressif para la ESP32-S3, funcionando con nuestro propio núcleo Xtensa. El firmware es un ELF de Xtensa que habla con las direcciones reales de la ESP32-S3, y casi todas esas direcciones se verificaron contra el manual de referencia técnica de Espressif.
La placa mide 62.7 por 25.4 mm y sus dos filas de 22 pines están separadas 0.9 pulgadas, asà que abraza el canal central de una protoboard dejando libre una fila de agujeros a cada lado, como la clásica ESP32 DevKit.
Los pines
Veintidós pines a lo largo de cada lado largo, los dos conectores micro USB abajo, el módulo y su antena arriba. La serigrafÃa nombra cada GPIO por su número.
J1, la columna izquierda, de arriba abajo: 3V3, 3V3, RST, 4, 5, 6, 7, 15, 16, 17, 18, 8, 3, 46, 9, 10, 11, 12, 13, 14, 5V, G.
J3, la columna derecha, de arriba abajo: G, TX, RX, 1, 2, 42, 41, 40, 39, 38, 37, 36, 35, 0, 45, 48, 47, 21, 20, 19, G, G.
TX y RX son los GPIO 43 y 44, el UART0. RST es la habilitación del chip. 5V es la lÃnea de USB. Esta es una placa de 3.3 voltios y sus pines no toleran 5 V.
Cosas que el pinout te hace
- Los GPIO 35, 36 y 37 pertenecen a la PSRAM en las placas con PSRAM octal (la N8R8 que compra la mayorÃa). Están en el header, y en esas placas no debes usarlos. Mokxi no tiene PSRAM, asà que aquà funcionan, cosa que puede no pasar en un escritorio.
- Los GPIO 19 y 20 son el D- y el D+ del puerto USB. Si los activas, el conector "USB" deja de funcionar en una placa real. Aquà el puerto serie USB sigue funcionando, lo cual es más amable que el silicio.
- Los GPIO 0, 3, 45 y 46 son pines de configuración (strapping), asà que lo que esté conectado a ellos al encender importa. El GPIO 0 también es el botón BOOT.
- Algunos pines arrancan con su entrada apagada. Los GPIO 4 a 8, 15, 16 y 19 a 21 leen 0 hasta que
pinModeenciende el búfer de entrada, que es el estado de reinicio del chip.pinModesiempre lo hace, asà que un sketch nunca lo nota.
The RGB LED
La placa no tiene un LED sencillo. Tiene un LED RGB direccionable, un componente tipo WS2812, en el GPIO 48 en las primeras placas y en el GPIO 38 en la v1.1, que Espressif indica como la única diferencia entre las dos revisiones. La propiedad revision de la placa elige cuál está en tu protoboard.
LED_BUILTIN en esta placa no es un número de GPIO: como en el núcleo de Arduino, es la cantidad de GPIO más el pin del LED, y digitalWrite(LED_BUILTIN, HIGH) le envÃa al LED una trama que lo enciende en blanco a un cuarto del brillo. Para color, rgbLedWrite(RGB_BUILTIN, red, green, blue). Ambas salen por el periférico RMT del chip, 24 bits con el verde primero, cada bit dentro de los tiempos de la hoja de datos del WS2812B, y el LED de la placa se enciende con el color que lleve la trama.
Los ejemplos están hechos para el GPIO 48, igual que la definición de placa del núcleo de Arduino. En una placa v1.1 el LED está en el GPIO 38, asà que el mismo sketch lo deja apagado, que es lo que pasarÃa en un escritorio. El pin también está en el header, asà que una tira de ws2812 conectada a 48 ve las mismas tramas.
analogRead: diez canales, y 2.9 V es el máximo
Los diez canales del ADC1 son los GPIO 1 a 10: el canal n es el GPIO n + 1. Doce bits. Con la atenuación predeterminada de 12 dB, el rango de medición de la hoja de datos termina en 2.9 V, y Mokxi lee 4095 desde ahà hacia arriba, asà que un potenciómetro entre los rieles de 3.3 V lee 4095 en el octavo superior de su recorrido. El ejemplo del potenciómetro imprime el número crudo para que no sea un misterio.
Esa lÃnea recta hasta 2.9 V es una aproximación: un S3 real guarda un poco de margen por encima del rango y se curva en ambos extremos, corregido con una calibración grabada en el chip. El ADC2 no está modelado.
analogWrite es LEDC, y no le cuesta nada al núcleo
analogWrite(pin, 0..255) conecta uno de los ocho canales de LEDC al pin: ocho bits a 1 kHz, en cualquier GPIO, a través de la matriz GPIO. ledcAttach(pin, frequency, bits) y ledcWrite(pin, duty) están ahà para cuando la frecuencia importa. En la S3, los ajustes de LEDC solo surten efecto cuando se escribe un bit de actualización, y el runtime lo escribe; un LED con desvanecimiento no le cuesta nada al núcleo.
Serial, y los dos conectores USB
Una DevKitC-1 real tiene dos conectores micro USB. "UART" pasa por un puente USB a UART hacia el UART0: ese es Serial, como en el núcleo de Arduino con USB CDC On Boot desactivado, su valor predeterminado para esta placa. "USB" es el propio controlador USB Serial/JTAG del chip: ese es USBSerial, que envÃa paquetes de 64 bytes a la vez, al final de cada lÃnea.
El monitor serie de aquà escucha ambos a la vez, asà que cualquiera de los dos imprime en el mismo lugar, y lo que escribes va a los dos.
Un núcleo, no dos
Una S3 real tiene dos núcleos Xtensa LX7, y un sketch de Arduino aquà corre en uno. Un sketch escrito en torno a setup() y loop() nunca lo nota. Cualquier cosa que inicie una tarea en el núcleo 1 no se ejecutará.
Un firmware que compilaste tú mismo es distinto: MicroPython y una compilación de ESP-IDF corren sobre un modelo del chip completo, donde ambos núcleos sà funcionan (abajo).
What is modeled
La Xtensa LX7, que para todo lo que un compilador genera a partir de C es el conjunto de instrucciones LX6 de la clásica ESP32: el mismo ABI de ventanas, y la salida del compilador de la S3 se verificó byte por byte contra la del compilador de la ESP32. Alrededor: 416 KB de SRAM vistos por ambos buses, la matriz GPIO y el IO MUX con las resistencias de reinicio del manual en cada pin, el UART0, el puerto serie USB Serial/JTAG, el SYSTIMER detrás de millis() y micros(), el ADC1, el LEDC, los cuatro canales de transmisión del RMT, las compuertas de reloj y tanta parte de la matriz de interrupciones como hace falta para cuatro fuentes.
WiFi, simulated
No hay radio. Lo que hay es la red simulada, la misma que tienen la clásica ESP32 y la ESP32-C3, detrás de un bloque que es de Mokxi y no del chip, en una dirección que la S3 deja sin mapear. WiFi.h,
HTTPClient.h y WebServer.h funcionan como espera un tutorial: la placa se une a un punto de acceso cuyo nombre y contraseña son propiedades de la placa, obtiene una página de una dirección inventada bajo .mokxi, o sirve una al panel Web. No hay 802.11, ni TCP, ni TLS y no hay internet real. La única excepción es el Internet real interruptor del panel Cloud, que envÃa las peticiones de otros nombres a través de la puerta de enlace de Mokxi. El Bluetooth LE se simula igual, con un celular en el panel de Bluetooth del editor (Bluetooth, simulado).
WiFi, simulado es cómo usarlo; Simulated WiFi es el contrato.
Lo que no está
Una radio de cualquier tipo: el WiFi y el Bluetooth LE se simulan, sin radio debajo. El segundo núcleo. La FPU y las instrucciones vectoriales del S3: ambas generan una falla en lugar de devolver un número incorrecto, y el entorno de ejecución usa coma flotante por software. SRAM0, la caché, la flash y la PSRAM. El RTC, los coprocesadores ULP y el sueño profundo. ADC2, el sensor táctil y el sensor de temperatura. Los temporizadores de los grupos de temporizadores (sus perros guardianes sà se modelan, para el perro guardián de tareas). UART1 y UART2, los controladores I2C y SPI, I2S, la interfaz de cámara, TWAI y USB OTG. Wire y SPI en el entorno de ejecución son por software en pines ordinarios, como en todas las placas de aquÃ: SDA en 8, SCL en 9, y SPI de 10 a 13.
Los binarios de ESP-IDF y del núcleo de Arduino de los fabricantes no correrán aquÃ: el entorno de ejecución es nuestro.
Compilar tu sketch
Edita el sketch y presiona Ejecutar: se compila en la pestaña con el clang de Espressif para Xtensa, la misma cadena de herramientas del ESP32 clásico y del ESP8266 (clang-v3, unos 80 MB, se descarga una sola vez). No se carga nada. Un ejemplo sin modificar ejecuta su programa precompilado, compilado con el GCC de Espressif para el S3; nada de GCC queda enlazado en él.
La aritmética de punto flotante funciona: este modelo no tiene FPU, asà que la compilación hace las sumas de float y double por software, como en las placas sin FPU. Compilar en el navegador tiene el relato completo.
Los ejemplos
Blink, Rainbow, Button, Serial, USB serial, Fade, Knob y los cuatro de WiFi: WiFi: join the network, WiFi: fetch the weather, API lab: fetch JSON y WiFi: a lamp on a web page.
Un firmware que compilaste tú mismo
Aquà se compila un sketch de Arduino, y se ejecuta en un núcleo. Un programa compilado en otra parte, con ESP-IDF o en Rust (esp-hal, esp-idf-hal), también funciona, sobre un modelo del chip completo con ambos núcleos: sube su .bin o .elf en el panel de Firmware, y la placa arranca con él como después de idf.py flash. El Wi-Fi y el Bluetooth son la asignatura pendiente, porque sus controladores son bibliotecas cerradas de Espressif: un firmware que inicia cualquiera de los dos se detiene con un mensaje que lo indica. Los pasos y la lista completa están en
Ejecutar un firmware ya compilado.
MicroPython y CircuitPython
Elige MicroPython (main.py) en el panel Firmware de la placa y Ejecutar arranca el firmware oficial de MicroPython v1.29.0 para el ESP32-S3 con tu main.py, sobre un modelo del chip completo arrancado desde la propia ROM de Espressif. machine.Pin,
PWM, ADC, I2C, SPI, UART(1) y neopixel funciona, y network.WLAN
se une a la red simulada. Consulta
MicroPython en el 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 en la Pico, que también cubre esta placa.
En otras partes
- La página de la placa: /boards/esp32-s3
- The contract document: el modelo del ESP32-S3, whose section 6 lists the few numbers that are believed rather than checked
- Las otras placas Xtensa: la ESP32 DevKit y la ESP8266 NodeMCU
- El mismo chip en otras placas: la XIAO ESP32-S3 y la Arduino Nano ESP32