The ESP32-CAM is a specialized, ultra-small camera board that combines Espressif's ESP32 chip with an OV2640 camera module, an onboard microSD card slot, and a high-brightness flash LED.
1. Hardware Specifications
- Processor: Dual-core Tensilica LX6 running at 240 MHz.
- Logic Level: 3.3V.
- Memory Limits: 4 MB Flash, 520 KB SRAM, and 4 MB external PSRAM (critical for holding raw image data frames).
- Camera Module: Includes an OV2640 camera (2 Megapixel resolution).
2. Detailed Pinout & GPIO Map
Due to the camera sensor occupying the majority of the ESP32's internal registers, only a small set of GPIOs are exposed. Below is the pinout map:
| Physical Pin Label | GPIO ID | Pin Type | Pin Functions / Mappings | Warnings & Cautions |
|---|---|---|---|---|
| GPIO 0 | 0 | Analog / GPIO | ADC2, Boot strap | Bootstrap Pin. Must be jumpered to GND to enter flashing mode. |
| GPIO 1 | 1 | Digital | TX0 (Console / Flash) | Shared with USB-to-UART serial transmit. |
| GPIO 2 | 2 | Analog / GPIO | ADC2 | Plain GPIO in OMS's simulator. On real hardware this pin is a boot-strapping pin some camera module designs pull low — worth caution, but OMS doesn't model or enforce that constraint. |
| GPIO 3 | 3 | Digital | RX0 (Console / Flash) | Shared with USB-to-UART serial receive. |
| GPIO 4 | 4 | Analog / GPIO | ADC2, High-power Flash LED | Controls the bright white front-facing LED. Runs hot; use sparingly. |
| GPIO 12 | 12 | Analog / SPI | ADC2, SPI MISO | Default SPI Master In Slave Out pin. |
| GPIO 13 | 13 | Analog / SPI | ADC2, SPI CS | Default SPI Chip Select pin. |
| GPIO 14 | 14 | Analog / I2C / SPI | ADC2, I2C SDA, SPI SCK | Default I2C data pin and default SPI clock pin (mutually exclusive uses). |
| GPIO 15 | 15 | Analog / I2C / SPI | ADC2, I2C SCL, SPI MOSI | Default I2C clock pin and default SPI data pin (mutually exclusive uses). |
| GPIO 16 | 16 | Digital | GPIO | Plain, freely usable GPIO in OMS. On real hardware this pin doubles as U2RXD/PSRAM-select on some module variants — not modeled or restricted in OMS's simulator. |
[!NOTE] Real AI-Thinker ESP32-CAM hardware also routes GPIO12–15 to an onboard microSD card slot (HS2_DATA2/DATA3/CLK/CMD) — OMS doesn't simulate the SD card at all, so in OMS these 4 pins are simply the board's default I2C/SPI buses, with no SD-card-sharing conflict to worry about.
GPIO 33 (the onboard red status LED) is not a wireable pin in OMS's simulator at all — it only exists as the built-in LED, the same way GPIO2 is excluded on the plain ESP32 DevKit V1 (Section 3.5). You can't select it in the Circuit Canvas.
3. Power Architecture & FTDI Adapter Requirements
[!WARNING] High Current Brownouts (2A Peaks): The ESP32-CAM module does not contain a built-in USB port or a USB-to-UART converter chip. To flash and run the board, you must use an external USB-to-UART FTDI programmer:
- Connect FTDI TX to ESP32-CAM RX (GPIO 3).
- Connect FTDI RX to ESP32-CAM TX (GPIO 1).
- Connect FTDI GND to ESP32-CAM GND.
- Critical: Connect FTDI 5V to ESP32-CAM 5V. Do NOT use the 3.3V pin of the FTDI adapter, as the board draws peak currents up to 2A during camera initiation and Wi-Fi handshakes, which will trigger brownout resets.
4. Compiler Settings & IDE Properties
When targeting this board, the compiler is intended to use the following parameters:
- FQBN:
esp32:esp32:esp32cam - Default Flashing Baud Rate:
921600 - Flash Mode / File Type:
esp - Flash Memory Offsets:
{ bootloader: 0x1000, partitions: 0x8000, app: 0x10000 } - Programming Runtimes: C++ (Arduino framework) only. Due to the high memory demands of holding image buffers and MicroPython's runtime structures concurrently in RAM, MicroPython is disabled for the ESP32-CAM model.
[!WARNING] Known bug: same issue as the ESP32-S2/S3/C3 (Sections 3.6-3.8) — this board's actual internal id (
esp32cam) doesn't match any key in the compiler's board-config lookup table (which only has hyphen/underscore forms likeesp32-cam), so compiling currently silently falls back to plain ESP32's FQBN (esp32:esp32:esp32) instead of the CAM-specific one above. See Known_Bugs.md §2.0.

