Before you start
- Board
- Classic ESP32-WROOM-32/32E DevKit with USB-to-UART bridge, GPIO16 exposed and unused. DevKitC V4 documentation is the reference; clone vendor, bridge and exact header layout are unspecified.
- Software
- Arduino IDE 2.x; esp32 by Espressif Systems 3.x (API review baseline 3.3.2). Serial Monitor: 115200 baud. Choose the documented board profile; ESP32 Dev Module is the generic classic WROOM fallback.
- Parts
- Known USB data cable, breadboard, LED, 220 Ω series resistor and jumper wires for the optional external LED test.
- Prerequisite
- Identify the module, USB bridge and printed GND/GPIO16 labels before wiring. First verify upload with the Serial-only sketch in the installation guide.
- Expected result
- External LED alternates ON/OFF every half second with matching serial text. Documentation/API reviewed; not compiled or hardware tested.
Which ESP32 DevKit this page covers
A DevKit adds USB programming, a voltage regulator, buttons and headers around an ESP32 module. The example here uses a classic ESP32-WROOM board, not ESP32-C3, S2, S3 or a WROVER/PSRAM board. These families share branding but differ in GPIO maps, USB options and peripherals.
The supplied hardware photo shows an ESP-32-marked USB-C board. Its manufacturer and exact module revision are not established. It is not the official DevKitC V4 pictured in the header reference, and the photo does not document a test of the GPIO16 sketch.
Read the metal module marking and the exact board documentation first. A 30-pin clone and a 38-pin DevKitC do not have the same physical header positions. GPIO16 in code means chip GPIO16, not the sixteenth header pin. IO16 may mean GPIO16; an unexplained D label needs the board pin map.
Technical Specifications
Arduino library: Arduino ESP32 board package
| Specification | Value | Why it matters |
|---|---|---|
| USB power | Use USB as the sole power source for first use | USB supplies the board, whose regulator provides 3.3 V. Do not connect an external supply at the same time. |
| GPIO signal voltage | 3.3 V logic; not 5 V tolerant | USB/5V power and GPIO signal voltage are different. Level-shift incompatible signals. |
| 3V3 and VIN/5V | Power rails, not signal pins | DevKitC documents separate power inputs; clone VIN direction and regulator limits vary. Do not assume every rail can safely be back-fed. |
| Beginner digital choices | GPIO18, 19, 21, 22, 23, 25, 26, 27, 32 or 33, when free | Check attached hardware and the exact board map. GPIO21/22 are common Arduino I2C defaults, not fixed-only I2C pins. |
| GPIO16 / 17 | Available on the WROOM example; reserved on WROVER variants | The external LED diagram uses GPIO16. Do not reuse that wiring on a PSRAM module without its pin documentation. |
| ADC with Wi-Fi | Prefer available ADC1 inputs, especially GPIO32/33 | Classic ESP32 ADC2 reads conflict with Wi-Fi. This does not prohibit normal digital use of an ADC2-capable GPIO. |
Pinout
- Board-specific reference Espressif ESP32-DevKitC V4 with a WROOM module Match J2/J3 connector numbers and silkscreen to the official board documentation. The visual lists connector numbers, not a universal physical pin arrangement. Clones and other ESP32 families differ; keep the existing logical LED wiring separate.
- 3V3 3.3 V rail Compatible small sensor supply Verify total load and regulator rating; not a motor/relay-coil supply.
- 5V / VIN Board power rail No external connection in this USB-powered example Clone labels and power circuits vary.
- GND Signal/power reference LED cathode and module grounds Use a shared reference when exchanging signals.
- IO16 / GPIO16 LED output in this WROOM example 220 Ω resistor → LED anode Not a portable choice for WROVER/PSRAM boards.
- VP / VN Common classic labels for GPIO36 / GPIO39 Externally driven inputs only Input-only; no internal pull-up/down. Check the actual board pin map.
- BOOT / EN Download-mode / reset buttons Usually no wiring needed Classic BOOT holds GPIO0 low; EN resets. Use only for the appropriate board procedure.
Wiring Diagram
Use USB power only. This existing schematic is a logical WROOM example, not a physical header-position map. GPIO16 drives an external LED through 220 Ω to its anode; the cathode goes to GND. The pictured GPIO21/22 labels are common I2C choices and are not needed for this blink test.
A board power LED is not necessarily programmable. The sketch does not depend on an onboard GPIO2 LED. Do not use GPIO16 on a WROVER variant where it is reserved.
| DevKit Pin / Feature | Beginner Use | Purpose / Notes |
|---|---|---|
| USB connector | Computer USB data cable | Sole power source and upload connection. |
| GPIO16 | 220 Ω → LED anode (long leg) | Classic WROOM board with pin exposed and free. |
| GND | LED cathode (short leg / flat side) | Complete the LED return circuit. |
-
1
Identify the classic WROOM module, board pin map and USB bridge.
-
2
Leave external wiring disconnected; install IDE and esp32 package, then select board/port.
-
3
Upload the Serial-only first sketch from the installation guide and verify its message.
-
4
Unplug USB and add the external LED circuit shown here.
-
5
Reconnect, upload this sketch and set Serial Monitor to 115200 baud.
-
6
If it fails, return to the working Serial-only test before debugging the LED.
Wiring and matching Arduino code
Optional external LED test on WROOM GPIO16
USB power; GPIO16 → 220 Ω → LED anode, LED cathode → GND. Use the exact WROOM pin map.
#define LED_PIN 16
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
Serial.println("ESP32 DevKit external LED blink test started");
}
void loop() {
digitalWrite(LED_PIN, HIGH);
Serial.println("LED ON");
delay(500);
digitalWrite(LED_PIN, LOW);
Serial.println("LED OFF");
delay(500);
}
This example is for classic WROOM GPIO16. A WROVER/PSRAM board may reserve GPIO16/17. Never replace LED_PIN with an arbitrary header position or input-only pin.
Expected Output
Expected, not measured: Serial Monitor at 115200 baud alternates LED ON and LED OFF about every half second. The external LED should follow. If text works but the LED does not, check its polarity, resistor placement and actual GPIO label; a power LED staying lit is normal.
Classic ESP32 GPIO and ADC limits
For classic ESP32, GPIO34–39 are input-only and have no internal pull-up/down. Not every module exposes every pin in that range; many WROOM boards expose only 34, 35, 36 and 39. Use an external bias resistor for an otherwise floating switch input.
GPIO0, 2, 5, 12 and 15 are strapping pins sampled during reset. Avoid them for first circuits because attached pull resistors and loads can change startup behavior. GPIO6–11 are used for flash; board labels D0/D1/D2/D3/CMD/CLK in the DevKitC map refer to these flash signals. GPIO1/3 normally carry UART upload and serial output.
GPIO16/17 are available on the documented WROOM board but reserved for internal use on WROVER modules. Do not carry these restrictions over unchanged to C3/S2/S3 boards; consult their own documentation.
On classic ESP32, ADC2 conflicts with active Wi-Fi. Choose an exposed ADC1 pin such as GPIO32 or GPIO33 for a beginner Wi-Fi analog project. GPIO34/35/36/39 can also be ADC1 inputs where exposed, but need externally defined signals. ADC readings require appropriate attenuation and calibration; 3.3 V GPIO logic does not guarantee an accurate ADC range up to 3.3 V.
Troubleshooting
| Problem | Possible cause | Solution |
|---|---|---|
| No new Windows COM port | Cable, hub/connector or bridge driver problem. | Use a known data cable and direct USB port. In Device Manager unplug/replug to identify the device. Read the bridge marking or hardware ID: use Silicon Labs for CP210x, WCH for the matching CH340/CH341/other WCH chip, or the actual vendor. BOOT does not install a driver. |
| Failed to connect / stuck on Connecting | Wrong port, external wiring on boot/UART pins or missing automatic reset. | Close other serial apps and disconnect peripherals. For a classic BOOT/EN UART board only: hold BOOT, tap EN, start upload and release BOOT when writing begins. After flashing, tap EN if it stays in download mode. Consult board instructions for native USB variants. |
| LED does not blink | Wrong header, reversed LED or pin reserved by variant. | Verify WROOM GPIO16 and the series resistor. On WROVER select a documented free output and change wiring/code together. GPIO34–39 cannot drive the LED. |
| Board stops booting after wiring | Strapping/flash/UART pin conflict. | Disconnect the new circuit and retest. Avoid classic GPIO0/2/5/12/15 and flash GPIO6–11 for beginner additions. |
| Analog reads fail when Wi-Fi runs | Classic ADC2/Wi-Fi resource conflict. | Move the analog signal to available ADC1, for example GPIO32/33, and update code. Check input voltage, attenuation and calibration. |
| Unreadable serial / resets | Wrong baud or unstable supply. | Use 115200 baud for this sketch and a sound cable. Remove heavy loads. If the board becomes hot, disconnect power and inspect for shorts. |
Where you use it
- First ESP32 learning board
- Wi-Fi sensor node
- Bluetooth controller
- Robot brain
- Home automation prototype
- Classroom lab board
- MQTT device
- Low-cost IoT gateway
Continue learning
Related projects
FAQ
No. Check the chip/module family, USB bridge, pin map and power schematic. This example uses classic WROOM hardware.
No. USB power is converted to the board’s operating rail; ESP32 GPIO remains 3.3 V logic.
No. Automatic reset usually handles it. The manual BOOT/EN sequence here is a recovery step for a classic UART board, not a universal native USB procedure.
Technical references
- Open the supplied board photograph at full size — ESP-32-marked USB-C board; manufacturer and module revision unverified. Not the DevKitC V4 header reference.
- Enlarge the supplied board pin-label photograph — Original close-up of this same supplied board; compare printed labels, not physical header positions, with your own board.
- Open the full-size DevKitC V4 header reference — Site-created connector-number reference transcribed from the Espressif J2/J3 tables; enlarge it on small screens.
- ESP32-DevKitC V4 hardware — Power options, header labels, BOOT/EN and WROOM versus WROVER GPIO16/17 availability.
- Classic ESP32 GPIO — Input-only, strapping and flash pins; ADC2/Wi-Fi restrictions.
- Espressif boot mode selection — Classic UART download mode and automatic reset.
- Silicon Labs CP210x drivers — Use only when the actual bridge is CP210x.
- WCH CH340/CH341 driver — Match actual bridge and vendor-supported OS; other WCH parts may need another package.
Downloads
Espressif ESP32-WROOM datasheet for electrical limits, RF details, memory, boot pins, and module ratings.
Download Datasheet (PDF)
