Adafruit QT Py ESP32

Development Board

Code name: ADAFRUIT_QTPY_ESP32_PICO

ESP32 ADAFRUIT

Adafruit QT Py ESP32 is a development board based on the ESP32 microcontroller using XTENSA architecture.

This board features a maximum CPU frequency of 240 MHz and 8MB flash memory.

About Adafruit QT Py ESP32

Ultra-compact ESP32 board with STEMMA QT - perfect for plug-and-play sensor projects and tight-space builds.

Technical Specifications

Complete technical specification details for Adafruit QT Py ESP32

Connectivity

WiFi 802.11 b/g/n (2.4 GHz)

Bluetooth 4.2

BLE 4.2

Microcontroller

Model esp32

Clock Speed 240 MHz

Flash Size 8MB

Architecture xtensa

✨ Features & Pins

Digital IO 40

Analog Input 16

PWM 16

Interrupts 16

Download Full Datasheet

Quick Setup

Copy-paste configs for Adafruit QT Py ESP32 - auto‑generated from this board's exact hardware specs.

ESP32 240 MHz 8MB DIO Xtensa

In Arduino IDE 2 select Adafruit Qtpy Esp32 Pico from the esp32 by Espressif package. In PlatformIO use board = esp32dev. ESP32 · 240 MHz · 8MB · DIO.

Tools menu settings

Board (select in Arduino IDE) Adafruit Qtpy Esp32 Pico

CPU Frequency 240 MHz

Flash Size 8MB

Flash Mode DIO

Upload Speed 921600

Architecture Xtensa

In Arduino IDE 2, open Boards Manager, search "esp32" by Espressif and install it. Then go to Tools → Board and select "Adafruit Qtpy Esp32 Pico" for the Adafruit QT Py ESP32.

platformio.ini


[env:adafruit_qtpy_esp32_pico]
platform  = espressif32
board     = esp32dev
framework = arduino

; Exact hardware config for Adafruit QT Py ESP32
board_build.mcu        = esp32
board_build.f_cpu      = 240000000L
board_build.flash_size = 8MB
board_build.flash_mode = dio
board_upload.flash_size = 8MB

The board value is a close generic match - check PlatformIO board registry for an exact fit.

esp32: block (YAML)


esp32:
  board: esp32dev
  framework:
    type: arduino   # or "esp-idf"

# Adafruit QT Py ESP32 - 240 MHz ESP32
# Flash: 8MB | USB: N/A

Paste into your device's .yaml. See ESPHome ESP32 docs for full options.

esptool.py - flash command


esptool.py \
  --chip esp32 \
  --baud 921600 \
  write_flash \
    --flash_mode dio \
    --flash_size 8MB \
    0x1000 bootloader.bin \
    0x8000    partitions.bin \
    0xe000    boot_app0.bin \
    0x10000   firmware.bin

Install: pip install esptool - replace firmware.bin with your binary - bootloader at 0x1000

Adafruit QT Py ESP32 Pinout Diagram

Complete pin reference for Adafruit QT Py ESP32

Useful Links

Datasheets and resources for Adafruit QT Py ESP32

Board Datasheet

Technical specifications

ESP32 Datasheet

Microcontroller reference

Pin Mappings

Complete pinout and GPIO mapping for Adafruit QT Py ESP32

Digital I/O Pins

Interrupt Pins

Analog Inputs

PWM Pins

Pin	Analog	Touch	PWM	Other
0				BUTTON
1			PWM	WIRE1_PIN_DEFINED
4	A4	T0	PWM	SDA
5			PWM
7	A7		PWM	RX RX1
8			PWM	NEOPIXEL_POWER
12	A9	T5	PWM	MISO
13	A10	T4	PWM	MOSI
14	A8	T6	PWM	SCK
15	A3	T3	PWM
19			PWM	SCL1
22			PWM	SDA1
25	A1		PWM	DAC1
26	A0		PWM	DAC2
27	A2	T7	PWM	SS
32	A6	T9	PWM	TX TX1
33	A5	T8	PWM	SCL

Legend

A0 Analog input

T0 Touch sensor

PWM PWM capable

RX/TX Serial pins

LED Built-in LED

# Pin number

Default Tools & Configuration

Build and upload settings for Adafruit QT Py ESP32

Setting	Value
Bootloader tool	esptool_py
Uploader tool	esptool_py
Network uploader tool	esp_ota
Bootloader address	`0x1000`
Flash mode	dio
Boot mode	dio
Maximum upload size	1280 KB (1310720 bytes)
Maximum data size	320 KB (327680 bytes)