Placas

El ESP32-S3-DevKitC-1

El ESP32-S3 sobre un Xtensa LX7 a 240 MHz: la DevKitC-1 de Espressif, con su LED RGB en el RMT, dos puertos USB, PWM con LEDC y un ADC de doce bits.

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 pinMode enciende el búfer de entrada, que es el estado de reinicio del chip. pinMode siempre 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