Pines de strapping del ESP32: S3, C3, C6 y clásico

Todos los pines de strapping del ESP32 clásico, S3, C3 y C6 con su nivel por defecto y función, según los datasheets, más reglas para usarlos bien.

Publicado
Tiempo de lectura
8 min
Categoría
Guías
Un maker con gafas redondas señala tres pines resaltados en naranja sobre el dibujo de un chip cuadrado, junto a un pulsador y una etiqueta que dice Strapping pins.

En resumen

Los pines de strapping se leen en el reset para elegir el modo de arranque. ESP32 clásico: GPIO0, 2, 5, 12, 15. S3: GPIO0, 3, 45, 46. C3: GPIO2, 8, 9. C6: GPIO4, 5, 8, 9, 15.

Un pin de strapping es un GPIO que el ESP32 lee en el reset para decidir cómo arrancar. El ESP32 clásico tiene cinco: GPIO0, 2, 5, 12 y 15. El ESP32-S3 tiene cuatro: GPIO0, 3, 45 y 46. El ESP32-C3 tiene tres: GPIO2, 8 y 9. El ESP32-C6 tiene cinco: GPIO4, 5, 8, 9 y 15.

Conectas un sensor a un pin, la placa deja de arrancar, y el mismo sensor funciona en otro pin. Esa es casi siempre la historia de los pines de strapping. Los pines cambian en cada chip, así que un tutorial escrito para una placa puede llevarte a una trampa en otra. Esta guía pone los cuatro chips lado a lado. Cada pin, nivel por defecto y función sale de los datasheets del ESP32 (v5.3), ESP32-S3 (v2.2), ESP32-C3 (v2.5) y ESP32-C6 (v1.6), en sus capítulos Boot Configurations, y te enseño cómo se las arreglan dos firmwares de OpenGizmo.

¿Qué es un pin de strapping y cuándo lo lee el chip?

Un pin de strapping es un GPIO cuya tensión muestrea la lógica de reset del chip para elegir una opción de arranque, como el arranque normal o el modo de descarga. Cada uno tiene un latch: según los datasheets, "at chip reset, the latches sample the bit values of their respective strapping pins and store them until the chip is powered down or shut down", y después los pines quedan "freed up to be used as regular IO pins".

De aquí salen dos consecuencias.

  • El nivel solo importa alrededor del reset. Un botón en GPIO0 puede ser un botón de usuario cuando el firmware ya está en marcha, y así es como el Gizmo Ticker usa el botón BOOT de la XIAO ESP32-S3 para su restablecimiento de fábrica de 10 segundos.
  • Si dejas un pin de strapping sin conectar, su nivel lo decide una resistencia interna débil. Los datasheets dicen que los valores por defecto "are determined by pins' internal weak pull-up/pull-down resistors at reset if the pins are not connected to any circuit, or connected to an external high-impedance circuit". Un componente que maneje el pin con fuerza, o una resistencia de pull que añadas tú, anula ese valor por defecto.

Cada datasheet da además un tiempo de hold (tH) para el nivel de strapping después de que el pin de reset sube: mínimo 1 ms en el ESP32 clásico y 3 ms en el S3, C3 y C6. Todo lo que conectes debe tener su nivel estable para entonces.

¿Cuáles son los pines de strapping del ESP32, S3, C3 y C6?

Aquí tienes todos los pines de strapping, con el valor por defecto que les da el chip cuando nada más los maneja. Flotante significa que no hay ninguna resistencia de pull interna, así que el nivel lo marca tu circuito (o el ruido).

ChipPin de strappingValor por defecto en el resetQué selecciona
ESP32GPIO0Pull-up (1)Modo de arranque, junto con GPIO2
ESP32GPIO2Pull-down (0)Modo de arranque, junto con GPIO0
ESP32GPIO12 (MTDI)Pull-down (0)Tensión de alimentación de la flash VDD_SDIO
ESP32GPIO15 (MTDO)Pull-up (1)Log de arranque en U0TXD; timing de SDIO esclavo
ESP32GPIO5Pull-up (1)Timing de SDIO esclavo
ESP32-S3GPIO0Pull-up débil (1)Modo de arranque, junto con GPIO46
ESP32-S3GPIO46Pull-down débil (0)Modo de arranque; impresión de mensajes de la ROM
ESP32-S3GPIO45Pull-down débil (0)Tensión VDD_SPI
ESP32-S3GPIO3FlotanteFuente de la señal JTAG
ESP32-C3GPIO9Pull-up débil (1)Modo de arranque, junto con GPIO8
ESP32-C3GPIO8FlotanteModo de arranque; impresión de mensajes de la ROM
ESP32-C3GPIO2FlotanteModo de arranque (pull-up recomendado)
ESP32-C6GPIO9Pull-up débil (1)Modo de arranque, junto con GPIO8
ESP32-C6GPIO8FlotanteModo de arranque; impresión de mensajes de la ROM
ESP32-C6GPIO15FlotanteFuente de la señal JTAG
ESP32-C6GPIO4 (MTMS), GPIO5 (MTDI)FlotanteFlanco del reloj SDIO

Pines de strapping del ESP32, ESP32-S3, ESP32-C3 y ESP32-C6 como etiquetas de colores: verde para pull-up por defecto, rojo para pull-down, azul para flotante

Hay tres detalles fáciles de pasar por alto. Primero, en el ESP32-S3 y el ESP32-C6, el pin JTAG (GPIO3 y GPIO15) no tiene resistencia de pull interna, y los datasheets dicen que su nivel "must be controlled by the external circuit that cannot be in a high impedance state". Eso solo importa si se han cambiado los eFuses JTAG del chip respecto a su valor por defecto de 0: con los valores por defecto, la tabla JTAG del datasheet dice que el pin se ignora. Segundo, en el ESP32-C3 el datasheet añade que GPIO2 "actually does not determine SPI Boot and Joint Download Boot mode", pero recomienda ponerle un pull-up por los glitches. Tercero, en el C6, GPIO4 y GPIO5 aparecen en el datasheet con sus nombres JTAG, MTMS y MTDI. Solo eligen el flanco del reloj SDIO, una función que la mayoría de los sketches de Arduino nunca toca, y ambos quedan flotantes por defecto.

¿Cómo se entra en modo de descarga en cada chip?

El modo de descarga es el estado en el que el bootloader de la ROM espera a esptool o a una herramienta de flasheo en el navegador en lugar de ejecutar tu firmware. Los niveles de los pines de arranque en el reset lo eligen, y son distintos en cada familia, por eso el consejo de "mantén BOOT pulsado" que funciona en una placa puede fallar en otra.

Niveles del modo de descarga en el reset: GPIO0 y GPIO2 en bajo en el ESP32, GPIO0 y GPIO46 en bajo en el S3, GPIO9 en bajo y GPIO8 en alto en el C3 y el C6

ChipArranque normal (SPI boot)Modo de descargaNotas del datasheet
ESP32GPIO0 = 1, GPIO2 cualquieraGPIO0 = 0 y GPIO2 = 0GPIO2 tiene un pull-down, así que dejarlo sin conectar funciona
ESP32-S3GPIO0 = 1, GPIO46 cualquieraGPIO0 = 0 y GPIO46 = 0GPIO46 tiene un pull-down débil por defecto
ESP32-C3GPIO9 = 1, GPIO8 cualquiera, GPIO2 = 1GPIO9 = 0, GPIO8 = 1, GPIO2 = 1GPIO8 queda flotante por defecto. GPIO2 no es decisivo, pero el datasheet recomienda ponerle un pull-up
ESP32-C6GPIO9 = 1, GPIO8 cualquieraGPIO9 = 0 y GPIO8 = 1GPIO8 = 0 con GPIO9 = 0 es una combinación no válida que provoca un comportamiento inesperado

La página de esptool sobre el modo de arranque de Espressif dice lo mismo para el chip clásico: "The ESP32 will enter the serial bootloader when GPIO0 is held low on reset", y GPIO2 "must also be either left unconnected/floating, or driven Low". En la práctica, un botón BOOT en GPIO0 es todo lo que necesitan el ESP32 clásico y el S3, porque GPIO2 y GPIO46 ya tienen un pull-down por defecto. El C3 y el C6 son distintos: GPIO8 no tiene pull interno, así que el modo de descarga solo funciona si GPIO8 está en alto en el reset, con una resistencia que ya venga en la placa o una que añadas tú. No he leído los esquemas de ninguna placa C3 o C6, así que revisa la tuya.

Si una placa no entra en modo de descarga, la lista completa de comprobaciones está en Failed to connect to ESP32: no serial data received.

¿Qué pasa si usas GPIO12, GPIO0 o GPIO2 en el ESP32 clásico?

El ESP32 clásico es donde ocurre la mayoría de los problemas de strapping, porque sus placas de desarrollo sacan los cinco pines de strapping y los tutoriales los usan sin pensarlo.

  • GPIO12 en alto en el reset pone la flash a 1,8 V. GPIO12 es MTDI. El datasheet dice que con MTDI = 0 (el valor por defecto) VDD_SDIO se alimenta desde VDD3P3_RTC, normalmente 3,3 V, y con MTDI = 1 se alimenta desde un LDO interno de 1,8 V. La página de esptool advierte que ponerlo en alto "may prevent flashing and/or booting if 3.3V flash is used and this pin is pulled high, causing the flash to brownout". Un sensor o un pull-up de un bus que mantenga GPIO12 en alto en el reset es la forma de caer en esto.
  • GPIO0 en bajo en el reset significa modo de descarga, no tu sketch. Cualquier cosa que mantenga GPIO0 en bajo durante el reset, como un driver que arranca en bajo o un botón que se quedó pulsado, hace que el chip espere a una herramienta de flasheo. La página de esptool señala que el ESP32 tiene una resistencia de pull interna de 45 kΩ en GPIO0, así que un circuito externo que tenga que imponerse necesita una resistencia fuerte, "for example a 10k resistor to GND".
  • GPIO2 en alto con GPIO0 en bajo deja al chip fuera del modo de descarga. El modo de descarga necesita ambos pines en bajo (o GPIO2 flotante, ya que por defecto tiene un pull-down), así que un componente que ponga GPIO2 en alto mientras mantienes BOOT deja esperando a la herramienta de flasheo, y te sale un error de conexión.
  • GPIO15 en bajo silencia el log de arranque. El datasheet dice que MTDO = 0 desactiva la impresión de la ROM por U0TXD. No es grave, pero parece un monitor serie muerto.

Nada de esto es motivo para evitar esos pines por completo. Es motivo para saber qué parte de tu circuito los manejará en el momento del reset, que no es lo mismo que lo que hace cuando el firmware ya está corriendo. Para el resto de restricciones del chip clásico (GPIO6 a GPIO11 normalmente conectados a la flash SPI, GPIO34 a GPIO39 solo de entrada), consulta la guía de GPIO de ESP-IDF y, para la ESP32-CAM en concreto, ESP32-CAM GPIO pins: which are really free.

¿Cómo evitan los proyectos de OpenGizmo los pines de strapping?

Los dos proyectos con la XIAO ESP32-S3 se mantienen lejos del único pad de strapping de la placa, y el Gizmo Camera muestra lo que pasa cuando un pin de strapping se usa para otra cosa.

Una maker señala en la pizarra el dibujo de una XIAO con un pad rodeado como GPIO3, junto al dibujo de una ESP32-CAM

El Gizmo Reolink Switch pone el botón en GPIO1, el zumbador en GPIO2 y la pantalla LCD en GPIO5 y GPIO6. El comentario de su config.cpp explica por qué: "clear of D2 (GPIO3, a boot strapping pin) and of the serial pads D6 and D7". De los cuatro pines de strapping del S3, solo GPIO3 está en un pad de la XIAO ESP32-S3, según el mapa de pines de XIAO ESP32-S3 pinout: which pins are safe to use. GPIO0 es el botón BOOT, y GPIO45 y GPIO46 no tienen etiqueta D en el mapa de Seeed.

El Gizmo Camera funciona con la ESP32-CAM de AI Thinker, un ESP32 clásico, y la cámara se queda con el pin de strapping para ella. Su camera_pins.h dice:

camera_pins.h
camera_pins.h
#define XCLK_GPIO_NUM 0 // Also the BOOT strapping pin, so the firmware never reads it as a button
Lín. 1, col. 1UTF-8cpp

Por eso el firmware de la cámara no tiene restablecimiento de fábrica con el botón BOOT, mientras que el Ticker sí: en la ESP32-CAM, GPIO0 lleva el reloj de la cámara después del arranque, y el Wi-Fi se olvida desde la aplicación web. El botón IO0 de la placa sigue siendo la vía para entrar en modo de descarga, como muestra la guía de programación con la ESP32-CAM-MB.

¿Cómo usar un pin de strapping con seguridad?

Elige primero un pin que no sea de strapping. Cuando no puedas, repasa esta lista:

  • Busca el pin en la tabla de arriba para tu chip exacto, no para la familia que recuerdas.
  • Averigua qué ve el pin en el reset: el nivel en reposo del componente, un pull-up de un bus, o un driver que arranca antes que el chip.
  • Compara ese nivel con el valor por defecto del chip. Si coincide, o si la función no importa (un strap de timing SDIO que no usas), no hay problema.
  • Si no coincide, mueve el componente a otro pin o añade una resistencia que restablezca el nivel por defecto. Que sea fuerte: las resistencias de pull internas del chip son de unos 45 kΩ en el ESP32 clásico, y la página de esptool usa 10 kΩ a GND como ejemplo.
  • Prueba tanto pulsar el botón de reset como un encendido en frío: los datasheets dicen que los straps se muestrean al encender y en un reset por hardware.
  • Nunca cuentes con que un pin flotante por defecto (GPIO3 del S3, GPIO2 y GPIO8 del C3, GPIO4, 5, 8 y 15 del C6) se mantenga solo en un nivel.

Una regla más: no copies un mapa de pines entre chips. El config.h del Gizmo Ticker detiene la compilación con un #error si no se está compilando para la XIAO ESP32-S3, así que una placa equivocada no puede conectar en silencio la pantalla a un pin que significa otra cosa. Para elegir placa desde el principio, which ESP32 should you buy compara los chips, y XIAO ESP32-S3 vs C3 vs C6 cubre las tres placas XIAO.

¿Qué pines de strapping importan más en tu placa?

En un ESP32 clásico, fíjate primero en GPIO12 (puede impedir el arranque de una placa con flash de 3,3 V) y después en GPIO0 y GPIO2. En una XIAO ESP32-S3, solo GPIO3 llega a un pad, y con los eFuses por defecto se ignora en el arranque. Otras placas S3 pueden sacar más de los cuatro. En el ESP32-C3 y el C6, GPIO8 y GPIO9 deciden entre ejecutar tu firmware y el modo de descarga, y GPIO9 es el botón BOOT en las placas que lo tienen.

Conviene dejar claros los límites. Comprobé cada pin, valor por defecto y función con las cuatro versiones de datasheet citadas arriba, y las elecciones de pines de OpenGizmo con los repositorios, pero no medí con el osciloscopio ninguna placa en el reset ni leí los esquemas de placas C3 o C6. Los datasheets se revisan, así que mira la versión actual antes de mandar a fabricar un PCB. Si acabas de llegar a esta familia de chips, empieza por what is the ESP32; si un flasheo falla, la siguiente parada es la lista de comprobaciones de failed to connect.

Preguntas frecuentes

Encuentra respuestas rápidas a las preguntas más comunes sobre este tema.

El datasheet del ESP32-S3 enumera cuatro pines de strapping: GPIO0 y GPIO46 eligen el modo de arranque, GPIO45 elige la tensión VDD_SPI y GPIO3 elige la fuente de la señal JTAG. GPIO0 tiene por defecto un pull-up débil, GPIO45 y GPIO46 un pull-down débil, y GPIO3 queda flotante, sin pull interno.

Publicado

¿Listo para montar tu propio gizmo?

Elige un proyecto open source con ESP32 y sigue su guía paso a paso, desde la lista de componentes y el cableado hasta el firmware y el primer arranque.

Lee también

Explora las categorías