Board and module pinouts

195 boards and modules. A pin on the diagram shows its functions, limits and where that is known from.

ESP32

ESP32-S2 and S3

ESP32-C and H

ESP8266

Arduino

Raspberry Pi

STM32

Resistors and potentiometers

Capacitors

LEDs

Diodes and Zener diodes

Transistors

Buttons and switches

Buzzers

ICs

Programmers

Radio modules

Sensors

Displays and LEDs

Audio

Motors and actuators

Power: batteries and cells

Power: regulators

Power: DC-DC converters

Power: charging, protection, USB-C

Memory cards

How to read a pinout

On a board page, clicking a pin opens its card: functions (ADC, PWM, I2C, SPI, UART), limitations and the source it was checked against. The buttons above the drawing highlight pins: "boot" shows strapping pins, "do not use" the flash and PSRAM pins, "unverified" the pins not confirmed by the manufacturer's documents. Below the drawing are the "Important" block, a table of all pins and a "Download PNG" button.

The chip reads strapping pins at power-up and uses them to choose the boot mode and some settings: on an ESP32 these are GPIO0, 2, 5, 12 and 15, on an ESP8266 GPIO0, 2 and 15, on an ESP32-C3 GPIO2, 8 and 9. The "input only" mark on an ESP32 sits on GPIO34-39, which have no output driver and no pulls. The mark "ADC2 does not work with Wi-Fi on" sits on the ESP32 ADC2 pins; with Wi-Fi, take ADC1 on GPIO32-39 for analog readings.

Examples

  • On the 30-pin ESP32 DOIT DevKit V1, GPIO0 and the flash pins GPIO6-11 are not brought out to the header. D2, D5, D12 and D15 are marked as strapping, D34, D35, VP and VN as input only.
  • ESP32-C3 SuperMini: the LED is on GPIO8 and the BOOT button on GPIO9, both strapping pins. In Arduino they are also the default SDA and SCL, so the LED blinks while I2C is running.

Common mistakes

  • People hang a module on GPIO12 of an ESP32 that pulls the pin high at power-up. The chip then sets the flash supply to 1.8 V, and a module with 3.3 V flash won't boot.
  • People read the ADC on GPIO25-27 with Wi-Fi on. Those pins belong to ADC2, and the reading doesn't work.

FAQ

Which ESP32 pins can I use without restrictions?
On the DevKitC and DOIT DevKit V1, according to the site's data, GPIO4, 13, 14, 16-19, 21-23, 25-27, 32 and 33 work without caveats; on 4, 13, 14 and 25-27 only the ADC doesn't work with Wi-Fi. GPIO0, 2, 5, 12 and 15 work after boot if they are at the right level at power-up. GPIO6-11 are used by flash, GPIO1 and 3 by the USB-UART port.
Can I put 5 V on the pins of an ESP32, ESP8266 or Pico?
Not on an ESP32 or ESP8266. According to the Espressif datasheet the ESP32's input limit is VDD + 0.3 V, which is 3.6 V with a 3.3 V supply, and the ESP8266's limit is also 3.6 V. The Raspberry Pi Pico with the RP2040 does not tolerate 5 V on GPIO; on the Pico 2 with the RP2350 the inputs tolerate 5 V when the chip is powered, except the ADC pins GP26-GP28. Take a 5 V signal through a divider or a level shifter.
What is the difference between the 30-pin and 38-pin ESP32 DevKit?
The chip and most GPIOs are the same. The 38-pin version brings out GPIO0, the flash pins GPIO6-11 (which you don't use) and one more GND to the header. The 30-pin DOIT DevKit V1 doesn't have them, and GPIO0 there is only on the BOOT button. Both have rows 25.4 mm apart.
What do the "verified" and "partly verified" labels mean?
"Verified" is set on a board all of whose pins are confirmed by the manufacturer's documents. On "partly verified", some pins are confirmed by other sources; the card of such a pin says what confirms it and where the sources disagree. The date of the check is shown next to the label.

You might also need