GPIO ESP32-CAM: quali pin sono davvero liberi
Quali GPIO della ESP32-CAM puoi usare: GPIO13 e GPIO12 con SD a 1 bit, GPIO4 LED flash, GPIO16 PSRAM, strapping pin, dallo schema AI Thinker.
- Autore
Mauro Brambilla- Pubblicato
- Tempo di lettura
- 9 min
- Categoria
- Guide

In breve
Sulla ESP32-CAM AI Thinker la fotocamera, lo slot microSD, il LED flash e la PSRAM occupano quasi tutti i pin. Senza SD hai GPIO2, 12, 13, 14 e 15; con SD a 1 bit, GPIO12 e GPIO13.
La ESP32-CAM AI Thinker espone pochissimi GPIO, e quasi tutti sono già presi da qualcosa sulla scheda. I pin dell'header GPIO2, 4, 12, 13, 14 e 15 sono lo slot microSD, il GPIO16 è il chip select della PSRAM, e GPIO0, 1 e 3 servono per il boot e la seriale. Se non usi la scheda SD, GPIO2, 12, 13, 14 e 15 sono tuoi. Con la scheda in modalità a 1 bit, solo GPIO12 e GPIO13.
Avevi in mente un sensore, un relè o un display I2C per la tua ESP32-CAM e poi hai scoperto che il pin scelto fa già altro? Questa guida dà un verdetto per ogni pin. Si basa sullo schema AI Thinker, sulla mappa dei pin della fotocamera negli esempi di Arduino-ESP32 e sui pin che il firmware di Gizmo Camera usa davvero. Non ho misurato nulla sul banco, e dove le fonti non concordano (il caso principale è il GPIO16) lo dico.
Una fotocamera Wi-Fi con ESP32-CAM che scatta una foto JPEG a ogni richiesta, con una web app per configurarla dal telefono e un server MCP per gli agenti AI.
- Foto JPEG fino a 1600 × 1200
- API HTTP semplice
- Server MCP per agenti AI
Quali GPIO della ESP32-CAM puoi usare?
Puoi usare i pin che fotocamera, slot microSD, LED flash e PSRAM non usano. Tutto il resto è cablato sulla scheda. La fotocamera usa 15 GPIO e solo uno di questi, il GPIO0, arriva all'header, quindi la domanda riguarda soltanto i dieci GPIO che l'header porta fuori.
La tabella si basa sullo schema della ESP32-CAM AI Thinker (versione V1.6, ospitato da Seeed Studio), dove i segnali della microSD si chiamano da HS2_DATA0 a HS2_DATA3, HS2_CMD e HS2_CLK, e sulla guida al pinout di Random Nerd Tutorials per il riepilogo pin per pin. L'ultima colonna è il mio verdetto per un progetto che non usa la scheda SD.
| GPIO | Usato da | Strapping pin | Verdetto senza scheda SD |
|---|---|---|---|
| GPIO0 | Clock della fotocamera (XCLK), modalità di boot | Sì | Occupato: serve alla fotocamera |
| GPIO1, GPIO3 | UART0 TX e RX (seriale USB) | No | Liberi dopo il flashing, ma monitor seriale e scheda MB li condividono |
| GPIO2 | microSD D0 | Sì | Libero, ma tienilo basso o flottante al reset |
| GPIO4 | LED flash, microSD D1 | No | Uscita del LED flash: utilizzabile solo per il LED |
| GPIO12 | microSD D2 | Sì | Libero, ma tienilo basso al reset (vedi la sezione sugli strapping pin) |
| GPIO13 | microSD D3 | No | Libero |
| GPIO14 | Clock microSD | No | Libero |
| GPIO15 | Comando microSD | Sì | Libero, ma se è basso al reset il log di boot tace |
| GPIO16 | Chip select della PSRAM | No | Occupato finché la PSRAM è in uso |

Sulla scheda ci sono altri due GPIO senza pin sull'header. Il GPIO33 pilota il piccolo LED rosso, che secondo Random Nerd Tutorials funziona con logica invertita: LOW lo accende. Il GPIO17 è il clock della PSRAM nello schema. La mappa dei pin della fotocamera di Arduino-ESP32 per la scheda AI Thinker elenca i pin propri della fotocamera, che riporto in tabella più avanti.
Perché il GPIO4 è sia il LED flash sia un pin dati della SD?
I progettisti di AI Thinker hanno assegnato due compiti allo stesso pin. Nello schema il GPIO4 va allo zoccolo SD come HS2_DATA1 e, tramite una resistenza da 1 kΩ, a un transistor S8050 che pilota il LED flash. È la mia lettura del testo dello schema, quindi controllala sulla revisione della tua scheda. Random Nerd Tutorials dice la stessa cosa dal punto di vista di chi la usa: il LED flash si accende quando usi la microSD, e usare le due cose insieme può dare problemi.

Cosa significa per il tuo progetto?
- SD a 4 bit: il GPIO4 trasporta dati SD, e il LED flash può lampeggiare o accendersi durante l'accesso alla scheda.
- SD a 1 bit: la scheda non usa D1, quindi il GPIO4 pilota solo il LED. Makerguides dice la stessa cosa: non puoi usare il GPIO4 per altro, ma puoi accendere e spegnere il LED flash, e avverte di non tenerlo acceso per più di un secondo. Un lettore citato da Random Nerd Tutorials ha visto sparire l'effetto flash in questa modalità, ma il LED restava acceso a bassa luminosità: imposta il GPIO4 come uscita e portalo tu a livello basso, come fa Gizmo Camera. Non l'ho provato.
- Senza scheda SD: il GPIO4 è solo l'uscita del LED flash. Gizmo Camera lo imposta come uscita, a livello basso, all'avvio, e lo porta alto solo per le foto scattate con
flash=1.
Se vuoi il LED spento mentre la scheda lavora, usa la modalità a 1 bit. Se cerchi un pin libero, il GPIO4 non è quello giusto.
Come liberi GPIO12 e GPIO13 con la SD a 1 bit?
Lo slot microSD può parlare con l'ESP32 su una linea dati (modalità a 1 bit) o su quattro (modalità a 4 bit). A 1 bit la scheda usa solo il clock (GPIO14), la linea di comando (GPIO15) e la linea dati D0 (GPIO2). Restano inutilizzati D2 sul GPIO12 e D3 sul GPIO13, ed è così che secondo Random Nerd Tutorials puoi liberarli.
In Arduino-ESP32 la libreria SD_MMC dichiara begin(mountpoint, mode1bit, ...) con mode1bit impostato di default a false. Passa true:
#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;
}
}Se begin() restituisce true, la scheda è montata e GPIO12 e GPIO13 non sono più usati dall'host SD, quindi il tuo codice può configurarli con pinMode. Non chiamare SD_MMC.setPins() sull'ESP32: la pagina SD_MMC di Arduino-ESP32 dice che l'ESP32 non permette di cambiare i pin e setPins() fallirà sempre, perché l'host SD usa pin fissi.

Prima di festeggiare, leggi il trabocchetto: il GPIO12 è uno strapping pin, e il suo livello al reset conta (la prossima sezione spiega come). Lo schema mostra anche resistenze da 47 kΩ (da R8 a R11) sulle linee SD. Non sono riuscito a ricostruire cosa facciano a un pin che liberi, quindi misura con un multimetro il livello a riposo di GPIO12 e GPIO13 prima di collegarci un componente.
Quali pin della ESP32-CAM sono strapping pin?
Uno strapping pin è un GPIO che l'ESP32 legge al reset per decidere come avviarsi. Sull'ESP32 classico sono GPIO0, 2, 5, 12 e 15, secondo il datasheet dell'ESP32, che la nostra guida agli strapping pin per chip riporta in tabella. Sulla ESP32-CAM il GPIO5 è una linea dati della fotocamera e il GPIO0 è il suo clock, quindi i tre contro cui puoi inciampare sull'header sono GPIO2, 12 e 15.
| Pin | Valore predefinito al reset | Cosa va storto se il tuo componente lo pilota male |
|---|---|---|
| GPIO2 | Pull-down | Se è alto mentre il GPIO0 è basso, il chip non entra in modalità download |
| GPIO12 | Pull-down | Alto al reset seleziona l'alimentazione flash a 1,8 V, e può impedire l'avvio se la flash è a 3,3 V |
| GPIO15 | Pull-up | Basso al reset disattiva il log di boot sulla UART0 |
Le regole pratiche:
- Non mettere un bus I2C sul GPIO12. Le linee I2C hanno i pull-up, quindi il pin sarebbe alto al reset, che è proprio il caso su cui Espressif mette in guardia. La stessa pagina sui pull-up della SD dice che sulle schede con chip flash a 3,3 V il GPIO12 deve essere basso al reset, cosa che definisce incompatibile con il funzionamento della scheda SD. Se il tuo modulo sia interessato dipende da come è impostata la tensione della flash, che non ho potuto verificare.
- Non lasciare sul GPIO2 un sensore che si accende a livello alto se vuoi anche flashare a mano. La pagina Espressif sui pull-up della SD (v5.1) dice che quando il GPIO2 è tirato alto per rispettare il requisito di pull-up della SD, non puoi entrare in modalità download.
- Prova anche un reset, non solo l'accensione a freddo. Gli strap vengono letti in entrambi i casi.
Se il flashing fallisce dopo che hai collegato qualcosa al GPIO2, la checklist per "failed to connect" parte proprio da una causa di questo tipo, e la guida alla ESP32-CAM-MB spiega la sequenza IO0 e RST.
Il GPIO16 della ESP32-CAM si può usare?
Di solito no, anche se le fonti lo trattano in modo diverso. Lo schema AI Thinker collega il GPIO16 al pin chip select (CS#) del chip PSRAM. Random Nerd Tutorials dice che il GPIO16 è collegato alla PSRAM in molte schede e che, per usarlo con la fotocamera, devi disattivare la PSRAM nel codice. La pagina GPIO di ESP-IDF di Espressif dice che da GPIO6 a GPIO11 e da GPIO16 a GPIO17 sono di solito collegati alla flash SPI e alla PSRAM integrate nel modulo. Makerguides, invece, indica il GPIO16 come l'unico pin liberamente utilizzabile quando la SD gira a 4 bit, il che vale solo se rinunci alla PSRAM.
Perché dovrebbe importarti della PSRAM? Contiene il frame buffer della fotocamera. Il firmware di Gizmo Camera si rifiuta di compilare per qualsiasi scheda che non ce l'abbia: camera_pins.h nel repository gizmo-camera si ferma con un #error a meno che la scheda sia il target ESP32 dev con BOARD_HAS_PSRAM definito, e camera.cpp mette il frame buffer in PSRAM (CAMERA_FB_IN_PSRAM). Un commento lì dice che senza PSRAM entrano solo i frame più piccoli. Il mio verdetto: considera il GPIO16 occupato. Se disattivi la PSRAM per averlo, rinunci ai frame grandi. Non ho provato quale risoluzione resti.
Cosa usano la fotocamera e il firmware di Gizmo Camera?
Il firmware di Gizmo Camera usa la stessa mappa dei pin dell'esempio CAMERA_MODEL_AI_THINKER di Arduino-ESP32, che ho controllato riga per riga con camera_pins.h nel repository del firmware (checkout del branch feature). L'esempio ha un solo commento sulla scheda: GPIO4 per il LED flash, o GPIO33 per il LED normale. Il firmware usa il LED flash.
| Funzione | GPIO |
|---|---|
| Clock della fotocamera (XCLK) | 0 |
| SCCB della fotocamera, il suo I2C (SDA, SCL) | 26, 27 |
| Dati della fotocamera da D0 a D7 | 5, 18, 19, 21, 36, 39, 34, 35 |
| VSYNC, HREF, PCLK della fotocamera | 25, 23, 22 |
| Power-down della fotocamera (PWDN) | 32 |
| Reset della fotocamera | non collegato (-1) |
| LED flash | 4 |
Tutto il resto non viene toccato. Il firmware non monta nessuna scheda SD (ho cercato SD_MMC nel sorgente e non ho trovato nulla), quindi GPIO2, 12, 13, 14 e 15 non sono usati dal firmware, e il suo platformio.ini dice che il log seriale è spento nell'ambiente release. È quindi un buon quadro di cosa lascia libero un progetto con la sola fotocamera. La pagina di Gizmo Camera elenca uno slot microSD tra le aperture del case stampato.
Un'altra conseguenza del fatto che il GPIO0 è il clock della fotocamera: il firmware non lo legge mai come pulsante, quindi sulla fotocamera non c'è il factory reset con il pulsante BOOT, a differenza degli altri dispositivi OpenGizmo. La guida agli strapping pin lo confronta con il Ticker.
Quali pin puoi usare per l'I2C sulla ESP32-CAM?
Non quelli predefiniti. La documentazione I2C di Arduino-ESP32 indica GPIO21 per SDA e GPIO22 per SCL sull'ESP32 generico, e sulla ESP32-CAM sono la linea dati D3 della fotocamera e il pixel clock. La stessa documentazione mostra Wire.begin() che prende i pin come argomenti, quindi passa i tuoi:
#include <Wire.h>
// SDA on GPIO13, SCL on GPIO14: neither is a strapping pin
Wire.begin(13, 14);Funziona solo se la scheda SD non è in uso, perché GPIO13 e GPIO14 sono linee SD. Con la scheda in modalità a 1 bit ti restano GPIO12 e GPIO13, e il GPIO12 è il pin su cui ti ho detto di non mettere pull-up. Quindi un sensore I2C e una scheda SD insieme sono un vero conflitto su questa scheda. Il bus SCCB della fotocamera è su GPIO26 e GPIO27, e non ho verificato se un secondo dispositivo possa condividerlo.
Puoi leggere ingressi analogici sui pin liberi?
Forse no mentre il Wi-Fi è attivo. Random Nerd Tutorials elenca GPIO2, 4, 12, 13, 14 e 15 come pin con ADC, e la pagina GPIO di ESP-IDF di Espressif dice che i pin ADC2 non si possono usare quando il Wi-Fi è attivo. Non ho verificato a quale unità ADC appartenga ogni pin dell'header, quindi cercalo nel datasheet dell'ESP32 prima di pianificare un analogRead accanto a una fotocamera Wi-Fi.
Cosa ricordare
La ESP32-CAM ha dieci pin dell'header che sembrano utilizzabili, e quattro compiti se li contendono: lo slot microSD (GPIO2, 4, 12, 13, 14, 15), il LED flash (GPIO4), la PSRAM (GPIO16) e le linee di boot e seriale (GPIO0, 1, 3). Senza la scheda puoi usare GPIO2, 12, 13, 14 e 15; con la scheda in modalità a 1 bit, GPIO12 e GPIO13. Il GPIO4 resta il LED flash e il GPIO16 resta la PSRAM. La mappa dei pin della fotocamera e quelli di Gizmo Camera sono stati controllati con l'esempio di Arduino-ESP32 e con il repository del firmware, e i collegamenti di SD, LED e PSRAM con lo schema AI Thinker V1.6.
Cosa non ho verificato: niente su hardware reale, se altre revisioni della scheda cablano i pin in modo diverso (i cloni cambiano), cosa fanno ai pin liberati le resistenze da 47 kΩ, quanto grande sia il frame che entra ancora senza PSRAM, e l'ordine dei pin delle due file dell'header (guarda la serigrafia). Pianifica i collegamenti tenendo conto di questo, e controlla le etichette della tua scheda prima di saldare. L'alimentazione è la prossima cosa che morde una ESP32-CAM, quindi vale la pena leggere la guida al brownout, e quando la scheda gira, una sola richiesta HTTP restituisce un JPEG.
Domande frequenti
Trova risposte rapide alle domande più comuni su questo argomento.
Sulla ESP32-CAM AI Thinker i pin dell'header GPIO2, 4, 12, 13, 14 e 15 appartengono allo slot microSD, mentre GPIO16 è collegato al chip PSRAM. Senza scheda SD puoi usare GPIO2, 12, 13, 14 e 15. Con la modalità SD a 1 bit restano solo GPIO12 e GPIO13.
Autore
Mauro BrambillaPronto a costruire il tuo gizmo?
Scegli un progetto ESP32 open source e segui la sua guida passo passo, dalla lista dei componenti e dai collegamenti fino al firmware e al primo avvio.






