GPIO de la ESP32-CAM: qué pines están libres de verdad

Qué GPIO de la ESP32-CAM puedes usar: GPIO13 y GPIO12 con SD de 1 bit, GPIO4 LED flash, GPIO16 PSRAM, pines de strapping, según el esquema AI Thinker.

Publicado
Tiempo de lectura
10 min
Categoría
Guías
Un maker con gafas examina una placa ESP32-CAM con una lupa, con los pines del header brillando en naranja y una etiqueta ESP32-CAM en una esquina.

En resumen

En la ESP32-CAM AI Thinker la cámara, la ranura microSD, el LED flash y la PSRAM ocupan casi todos los pines. Sin SD tienes GPIO2, 12, 13, 14 y 15; con SD de 1 bit, GPIO12 y GPIO13.

La ESP32-CAM AI Thinker expone solo un puñado de GPIO, y casi todos están reclamados por algo de la placa. Los pines del header GPIO2, 4, 12, 13, 14 y 15 son la ranura microSD, el GPIO16 es el chip select de la PSRAM, y GPIO0, 1 y 3 sirven para el arranque y el puerto serie. Si no usas la tarjeta SD, GPIO2, 12, 13, 14 y 15 son tuyos. Con la tarjeta en modo de 1 bit, solo GPIO12 y GPIO13.

¿Habías planeado un sensor, un relé o una pantalla I2C para tu ESP32-CAM y luego descubriste que el pin que elegiste ya hace otra cosa? Esta guía da un veredicto por pin. Sale del esquema de AI Thinker, del mapa de pines de la cámara en los ejemplos de Arduino-ESP32 y de los pines que el firmware de Gizmo Camera usa de verdad. No medí nada en el banco, y donde las fuentes no coinciden (el caso principal es el GPIO16) lo digo.

Proyecto open source ESP32-CAM
Gizmo Camera

Cámara Wi-Fi con ESP32-CAM que saca una foto JPEG por petición, con una app web para configurarla desde el teléfono y un servidor MCP para agentes de IA.

  • Fotos JPEG de hasta 1600 × 1200
  • API HTTP sencilla
  • Servidor MCP para agentes de IA
Echar un vistazo

¿Qué GPIO de la ESP32-CAM puedes usar?

Puedes usar los pines que la cámara, la ranura microSD, el LED flash y la PSRAM no usan. Todo lo demás está cableado en la placa. La cámara usa 15 GPIO y solo uno de ellos, el GPIO0, llega al header, así que la pregunta solo importa para los diez GPIO que saca el header.

La tabla se basa en el esquema de la ESP32-CAM AI Thinker (versión V1.6, alojado por Seeed Studio), donde las señales de la microSD se llaman de HS2_DATA0 a HS2_DATA3, HS2_CMD y HS2_CLK, y en la guía de pinout de Random Nerd Tutorials para el resumen pin por pin. La última columna es mi veredicto para un proyecto que no usa la tarjeta SD.

GPIOLo usaPin de strappingVeredicto sin tarjeta SD
GPIO0Reloj de la cámara (XCLK), modo de arranqueSíOcupado: la cámara lo necesita
GPIO1, GPIO3UART0 TX y RX (serie por USB)NoLibres tras flashear, pero el monitor serie y la placa MB los comparten
GPIO2microSD D0SíLibre, pero mantenlo en bajo o flotante en el reset
GPIO4LED flash, microSD D1NoSalida del LED flash: solo sirve para el LED
GPIO12microSD D2SíLibre, pero mantenlo en bajo en el reset (mira la sección de strapping)
GPIO13microSD D3NoLibre
GPIO14Reloj de la microSDNoLibre
GPIO15Comando de la microSDSíLibre, pero en bajo durante el reset silencia el log de arranque
GPIO16Chip select de la PSRAMNoOcupado mientras uses la PSRAM

Veredicto para cada pin del header de la ESP32-CAM: GPIO0 y GPIO16 ocupados, GPIO12 y GPIO13 libres con SD de 1 bit, los demás libres solo si no usas la tarjeta SD ni el puerto serie

Hay otros dos GPIO en la placa sin pin en el header. El GPIO33 maneja el pequeño LED rojo, que según Random Nerd Tutorials funciona con lógica invertida: LOW lo enciende. El GPIO17 es el reloj de la PSRAM en el esquema. El mapa de pines de la cámara de Arduino-ESP32 para la placa AI Thinker lista los pines propios de la cámara, que pongo en una tabla más abajo.

¿Por qué el GPIO4 es a la vez el LED flash y un pin de datos de la SD?

Los diseñadores de AI Thinker cablearon un pin para dos tareas. En el esquema, el GPIO4 va al zócalo SD como HS2_DATA1 y, a través de una resistencia de 1 kΩ, a un transistor S8050 que maneja el LED flash. Esa es mi lectura del texto del esquema, así que compruébala con la revisión de tu placa. Random Nerd Tutorials dice lo mismo desde el lado del usuario: el LED flash se enciende cuando usas la tarjeta microSD, y usar ambos a la vez puede dar problemas.

Un maker desliza una tarjeta microSD en una ESP32-CAM con el LED flash encendido, con una indicación que muestra que ambos comparten el GPIO4

¿Qué significa esto para tu proyecto?

  • Modo SD de 4 bits: el GPIO4 transporta datos de la SD, y el LED flash puede parpadear o encenderse durante el acceso a la tarjeta.
  • Modo SD de 1 bit: la tarjeta no usa D1, así que el GPIO4 solo maneja el LED. Makerguides dice lo mismo: no puedes usar el GPIO4 para otra cosa, pero sí encender y apagar el LED flash, y avisa de no dejarlo encendido más de un segundo. Un lector citado por Random Nerd Tutorials vio que el efecto flash desaparecía en este modo pero el LED se quedaba encendido con poco brillo, así que configura el GPIO4 como salida y ponlo tú en bajo, como hace Gizmo Camera. No lo probé.
  • Sin tarjeta SD: el GPIO4 es solo la salida del LED flash. Gizmo Camera lo configura como salida, en bajo, al arrancar, y solo lo pone en alto para las fotos tomadas con flash=1.

Si quieres el LED apagado mientras la tarjeta trabaja, usa el modo de 1 bit. Si buscas un pin libre, el GPIO4 no es el sitio.

¿Cómo liberas GPIO12 y GPIO13 con el modo SD de 1 bit?

La ranura microSD puede hablar con el ESP32 por una línea de datos (modo de 1 bit) o por cuatro (modo de 4 bits). En modo de 1 bit la tarjeta usa solo el reloj (GPIO14), la línea de comandos (GPIO15) y la línea de datos D0 (GPIO2). Eso deja sin usar D2 en el GPIO12 y D3 en el GPIO13, que es como Random Nerd Tutorials dice que se pueden liberar.

En Arduino-ESP32, la biblioteca SD_MMC declara begin(mountpoint, mode1bit, ...) con mode1bit en false por defecto. Pasa true:

1-bit SD mount
1-bit SD mount
#include "SD_MMC.h"

void setup() {
    // "/sdcard" is the default mount point, true selects 1-bit mode
    if (!SD_MMC.begin("/sdcard", true)) {
        Serial.println("Card mount failed");
        return;
    }
}
Lín. 9, col. 1UTF-8cpp

Si begin() devuelve true, la tarjeta está montada y GPIO12 y GPIO13 ya no los usa el host SD, así que tu código puede configurarlos con pinMode. No llames a SD_MMC.setPins() en el ESP32: la página de SD_MMC de Arduino-ESP32 dice que el ESP32 no permite cambiar los pines y setPins() siempre fallará, porque el host SD usa pines fijos.

Qué pines de la ESP32-CAM ocupa la ranura microSD en modo de 4 bits, de 1 bit y sin tarjeta: GPIO13 libre en modo de 1 bit, GPIO12 libre pero es un pin de strapping

Antes de celebrar, lee la trampa: el GPIO12 es un pin de strapping, y su nivel en el reset importa (la siguiente sección explica cómo). El esquema también muestra resistencias de 47 kΩ (R8 a R11) en las líneas SD. No pude rastrear qué le hacen a un pin que liberas, así que mide con un multímetro el nivel en reposo de GPIO12 y GPIO13 antes de conectarles un componente.

¿Qué pines de la ESP32-CAM son pines de strapping?

Un pin de strapping es un GPIO que el ESP32 lee en el reset para decidir cómo arrancar. En el ESP32 clásico son GPIO0, 2, 5, 12 y 15, según la hoja de datos del ESP32, que nuestra guía de pines de strapping por chip pone en una tabla. En la ESP32-CAM, el GPIO5 es una línea de datos de la cámara y el GPIO0 es su reloj, así que los tres con los que puedes tropezar en el header son GPIO2, 12 y 15.

PinValor por defecto en el resetQué falla si tu componente lo maneja mal
GPIO2Pull-downSi está en alto mientras el GPIO0 está en bajo, el chip no entra en modo de descarga
GPIO12Pull-downEn alto en el reset selecciona la alimentación de flash de 1,8 V, y puede impedir el arranque si la flash es de 3,3 V
GPIO15Pull-upEn bajo en el reset desactiva el log de arranque en la UART0

Las reglas prácticas:

  1. No pongas un bus I2C en el GPIO12. Las líneas I2C llevan pull-up, así que el pin estaría en alto en el reset, que es justo el caso del que advierte Espressif. La misma página sobre los pull-up de la SD dice que en placas con chip de flash de 3,3 V el GPIO12 debe estar en bajo en el reset, y lo califica de incompatible con el funcionamiento de la tarjeta SD. Si tu módulo se ve afectado depende de cómo esté configurada la tensión de su flash, algo que no pude comprobar.
  2. No dejes en el GPIO2 un sensor que arranque en alto si además quieres flashear a mano. La página de Espressif sobre los pull-up de la SD (v5.1) dice que cuando el GPIO2 se pone en alto para cumplir el requisito de pull-up de la SD, no puedes entrar en modo de descarga.
  3. Prueba también un reset, no solo el encendido en frío. Los straps se leen en los dos casos.

Si el flasheo falla después de conectar algo al GPIO2, la lista de comprobación de "failed to connect" empieza justo por una causa de este tipo, y la guía de la ESP32-CAM-MB cubre la secuencia IO0 y RST.

¿Se puede usar el GPIO16 en la ESP32-CAM?

Normalmente no, aunque las fuentes lo tratan de forma distinta. El esquema de AI Thinker conecta el GPIO16 al pin chip select (CS#) del chip de PSRAM. Random Nerd Tutorials dice que el GPIO16 está conectado a la PSRAM en muchas placas y que debes desactivar la PSRAM en tu código para usarlo con la cámara. La página de GPIO de ESP-IDF de Espressif dice que de GPIO6 a GPIO11 y de GPIO16 a GPIO17 suelen ir conectados a la flash SPI y la PSRAM integradas en el módulo. Makerguides, en cambio, lista el GPIO16 como el único pin de uso libre cuando la SD funciona en modo de 4 bits, lo cual solo es cierto si renuncias a la PSRAM.

¿Por qué debería importarte la PSRAM? Guarda el búfer de fotograma de la cámara. El firmware de Gizmo Camera se niega a compilar para cualquier placa que no la tenga: camera_pins.h en el repositorio gizmo-camera se detiene con un #error a menos que la placa sea el target ESP32 dev con BOARD_HAS_PSRAM definido, y camera.cpp pone el búfer de fotograma en PSRAM (CAMERA_FB_IN_PSRAM). Un comentario ahí dice que sin ella solo caben los fotogramas más pequeños. Mi veredicto: trata el GPIO16 como ocupado. Si desactivas la PSRAM para conseguirlo, pierdes los fotogramas grandes. No probé qué resolución queda.

¿Qué usan la cámara y el firmware de Gizmo Camera?

El firmware de Gizmo Camera usa el mismo mapa de pines que el ejemplo CAMERA_MODEL_AI_THINKER de Arduino-ESP32, que comprobé línea por línea con camera_pins.h en el repositorio del firmware (checkout de la rama feature). El ejemplo tiene un solo comentario sobre la placa: GPIO4 para el LED flash, o GPIO33 para el LED normal. El firmware usa el LED flash.

FunciónGPIO
Reloj de la cámara (XCLK)0
SCCB de la cámara, su I2C (SDA, SCL)26, 27
Datos de la cámara D0 a D75, 18, 19, 21, 36, 39, 34, 35
VSYNC, HREF, PCLK de la cámara25, 23, 22
Power-down de la cámara (PWDN)32
Reset de la cámarasin conectar (-1)
LED flash4

Todo lo demás queda sin tocar. El firmware no monta ninguna tarjeta SD (busqué SD_MMC en su código fuente y no encontré nada), así que el firmware no usa GPIO2, 12, 13, 14 ni 15, y su platformio.ini dice que el log serie está desactivado en el entorno release. Eso la convierte en un buen retrato de lo que deja libre un proyecto solo con cámara. La página de Gizmo Camera lista una ranura microSD entre las aberturas de la carcasa impresa.

Otra consecuencia de que el GPIO0 sea el reloj de la cámara: el firmware nunca lo lee como botón, así que la cámara no tiene restablecimiento de fábrica con el botón BOOT, a diferencia de los otros dispositivos de OpenGizmo. La guía de pines de strapping lo compara con el Ticker.

¿Qué pines puedes usar para I2C en la ESP32-CAM?

Los de por defecto, no. La documentación de I2C de Arduino-ESP32 da el GPIO21 para SDA y el GPIO22 para SCL en el ESP32 genérico, y en la ESP32-CAM son la línea de datos D3 de la cámara y el reloj de píxel. La misma documentación muestra que Wire.begin() acepta los pines como argumentos, así que pasa los tuyos:

I2C on free pins
I2C on free pins
#include <Wire.h>

// SDA on GPIO13, SCL on GPIO14: neither is a strapping pin
Wire.begin(13, 14);
Lín. 4, col. 1UTF-8cpp

Esto solo funciona si no usas la tarjeta SD, porque GPIO13 y GPIO14 son líneas SD. Con la tarjeta en modo de 1 bit te quedan GPIO12 y GPIO13, y el GPIO12 es el pin al que te dije que no pusieras pull-up. Así que un sensor I2C y una tarjeta SD a la vez son un conflicto real en esta placa. El bus SCCB de la cámara está en GPIO26 y GPIO27, y no he comprobado si un segundo dispositivo puede compartirlo.

¿Puedes leer entradas analógicas en los pines libres?

Quizá no con el Wi-Fi activado. Random Nerd Tutorials lista GPIO2, 4, 12, 13, 14 y 15 como pines con ADC, y la página de GPIO de ESP-IDF de Espressif dice que los pines de ADC2 no se pueden usar cuando se usa el Wi-Fi. No comprobé a qué unidad ADC pertenece cada pin del header, así que búscalo en la hoja de datos del ESP32 antes de planear un analogRead junto a una cámara con Wi-Fi.

Qué recordar

La ESP32-CAM tiene diez pines de header que parecen utilizables, y cuatro funciones se los reparten: la ranura microSD (GPIO2, 4, 12, 13, 14, 15), el LED flash (GPIO4), la PSRAM (GPIO16) y las líneas de arranque y serie (GPIO0, 1, 3). Sin la tarjeta puedes usar GPIO2, 12, 13, 14 y 15; con la tarjeta en modo de 1 bit, GPIO12 y GPIO13. El GPIO4 sigue siendo el LED flash, y el GPIO16 sigue siendo la PSRAM. El mapa de pines de la cámara y los de Gizmo Camera se comprobaron con el ejemplo de Arduino-ESP32 y el repositorio del firmware, y el cableado de SD, LED y PSRAM con el esquema V1.6 de AI Thinker.

Lo que no verifiqué: nada en hardware real, si otras revisiones de la placa cablean los pines de otra forma (los clones difieren), qué hacen las resistencias de 47 kΩ a los pines que liberas, qué tamaño de fotograma cabe todavía sin PSRAM, y el orden de los pines de las dos filas del header (mira la serigrafía). Planea tu cableado con eso en mente, y revisa las etiquetas de tu placa antes de soldar. La alimentación es lo siguiente que muerde a una ESP32-CAM, así que merece la pena leer la guía de brownout, y cuando la placa ya funcione, una sola petición HTTP devuelve un JPEG.

Preguntas frecuentes

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

En la ESP32-CAM AI Thinker, los pines del header GPIO2, 4, 12, 13, 14 y 15 pertenecen a la ranura microSD, y el GPIO16 va cableado al chip de PSRAM. Sin tarjeta SD puedes usar GPIO2, 12, 13, 14 y 15. Con el modo SD de 1 bit solo quedan libres GPIO12 y GPIO13.

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