Adafruit QT Py ESP32-S2 (including uFL version)

by Adafruit

Image of Board

What has your favorite Espressif WiFi microcontroller, comes with our favorite connector - the STEMMA QT, a chainable I2C port, and has lots of Flash and RAM memory for your next IoT project? What will make your next IoT project flyyyyy? What a cutie pie! Or is it… a QT Py? This diminutive dev board comes with one of our new favorite lil chips, the ESP32-S2!

The ESP32-S2 is a highly-integrated, low-power, 2.4 GHz Wi-Fi System-on-Chip (SoC) solution that now has built-in native USB as well as some other interesting new technologies like Time of Flight distance measurements. With its state-of-the-art power and RF performance, this SoC is an ideal choice for a wide variety of application scenarios relating to the Internet of Things (IoT), wearable electronics, and smart homes.

Please note the QT Py ESP32-S2 has a single-core 240 MHz chip, so it won’t be as fast as ESP32’s with dual-core. Also, there is no Bluetooth support. However, we are super excited about the ESP32-S2’s native USB which unlocks a lot of capabilities for advanced interfacing! This ESP32-S2 mini-module we are using on the QT Py comes with 4 MB flash and 2 MB PSRAM so you can buffer massive JSON files for parsing!

OLEDs! Inertial Measurement Units! Sensors a-plenty. All plug-and-play thanks to the innovative chainable design: SparkFun Qwiic-compatible STEMMA QT connectors for the I2C bus so you don’t even need to solder! Just plug in a compatible cable and attach it to your MCU of choice, and you’re ready to load up some software and measure some light. Seeed Grove I2C boards will also work with this adapter cable.

Pinout and shape are Seeed Xiao compatible, with castellated pads so you can solder it flat to a PCB. In addition to the QT connector, we also added an RGB NeoPixel (with controllable power pin to allow for ultra-low-power usage), a reset button (great for restarting your program or entering the bootloader) and a button on GPIO 0 for entering the ROM bootloader or for user input.

Runs Arduino like a dream, and CircuitPython projects are fantastically fun.

Technical details

  • Same size, form-factor, and pin-out as Seeed Xiao
  • USB-C connector - If you have only Micro B cables, this adapter will come in handy!
  • ESP32-S2 240MHz Tensilica processor - the next generation of ESP32, now with native USB so it can act like a keyboard/mouse, MIDI device, disk drive, etc!
  • 4 MB Flash & 2 MB PSRAM
  • Native USB supported by every OS - can be used in Arduino or CircuitPython as USB serial console, MIDI, Keyboard/Mouse HID, even a little disk drive for storing Python scripts.
  • Can be used with Arduino IDE or CircuitPython
  • Built-in RGB NeoPixel LED with power control to reduce quiescent power in deep sleep
  • Battery input pads on underside with diode protection for external battery packs up to 6V input
  • 13 GPIO pins:
    • 11 on breakout pads, 2 more on QT connector
    • 10 12-bit analog inputs (SPI high speed pads do not have analog inputs)
    • 8-bit analog output DAC
    • PWM outputs on any pin
    • 2 I2C ports, one on the breakout pads, and another with STEMMA QT plug-n-play connector
    • Hardware UART
    • Hardware SPI on the high speed SPI peripheral pins
    • Hardware I2S on any pins
    • 5 Capacitive Touch with no additional components required
  • 3.3 V regulator with 600 mA peak output
  • Deep sleep at 100 uA
  • Reset switch for starting your project code over, boot 0 button for entering bootloader mode
  • Really really small

Purchase

Contribute

Have some info to add for this board? Edit the source for this page here.

CircuitPython 7.3.1

This is the latest stable release of CircuitPython that will work with the Adafruit QT Py ESP32-S2 (including uFL version).

Start here if you are new to CircuitPython.

Release Notes for 7.3.1

Built-in modules available: adafruit_bus_device, adafruit_pixelbuf, aesio, alarm, analogio, atexit, audiobusio, audiocore, audiomixer, binascii, bitbangio, bitmaptools, board, busio, canio, countio, digitalio, displayio, dualbank, errno, fontio, framebufferio, frequencyio, getpass, gifio, i2cperipheral, imagecapture, ipaddress, json, keypad, math, mdns, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, paralleldisplay, ps2io, pulseio, pwmio, qrio, rainbowio, random, re, rgbmatrix, rotaryio, rtc, sdcardio, sharpdisplay, socketpool, ssl, storage, struct, supervisor, synthio, terminalio, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, vectorio, watchdog, wifi, zlib

CircuitPython 8.0.0-alpha.1

This is the latest unstable release of CircuitPython that will work with the Adafruit QT Py ESP32-S2 (including uFL version).

Unstable builds have the latest features but are more likely to have critical bugs.

Release Notes for 8.0.0-alpha.1

Built-in modules available: adafruit_bus_device, adafruit_pixelbuf, aesio, alarm, analogio, atexit, audiobusio, audiocore, audiomixer, binascii, bitbangio, bitmaptools, board, busio, canio, countio, digitalio, displayio, dotenv, dualbank, errno, fontio, framebufferio, frequencyio, getpass, gifio, i2cperipheral, imagecapture, ipaddress, json, keypad, math, mdns, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, paralleldisplay, ps2io, pulseio, pwmio, qrio, rainbowio, random, re, rgbmatrix, rotaryio, rtc, sdcardio, sharpdisplay, socketpool, ssl, storage, struct, supervisor, synthio, terminalio, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, vectorio, watchdog, wifi, zlib

Absolute Newest

Every time we commit new code to CircuitPython we automatically build binaries for each board and language. The binaries are stored on Amazon S3, organized by board, and then by language. Try them if you want the absolute latest and are feeling daring or want to see if a problem has been fixed.

Past Releases

All previous releases are listed on GitHub, with release notes, and are available for download from Amazon S3. They are handy for testing, but otherwise we recommend using the latest stable release. Some older GitHub release pages include the same binaries for downloading. But we have discontinued including binaries as assets on newer release pages because of the large number of files for each release.

BROWSE GITHUB

Install, Repair, or Update UF2 Bootloader

Latest version: 0.9.4

The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs. The bootloader is not CircuitPython. If a UF2 bootloader is installed, you can check its version by looking in the INFO_UF2.TXT file when the BOOT drive is visible (FTHRS2BOOT, MAGTAGBOOT, HOUSEBOOT, etc.)

It is not necessary to reinstall a UF2 bootloader you unless a BOOT drive is not visible when in UF2 bootloader mode, or you know of a problem with your current UF2 bootloader.

If a UF2 bootloader has never been installed on the board, or the UF2 bootloader was removed by erasing or overwriting the flash, the UF2 bootloader must be installed in order to flash .uf2 files onto the board. .bin files can be uploaded without a UF2 bootloader, using the ESP Web Flasher or esptool.py.

Note: update.uf2 files are not currently working on ESP32-S2 boards.

Important: this will erase previously flashed firmware and sketches from the board, but needs to be perfomed only once.

  • Unzip to find the file combined.bin.
  • Place board in bootloader mode:
    • Plug board into a USB port on your computer using a data/sync cable. Make sure it is the only board plugged in, and that a charge-only cable is not being used.
    • Press and hold down the BOOT or 0 button.
    • Press and release the RESET or RST button.
    • Release the BOOT button.
  • Upload combined.bin (Google Chrome 89 or newer):
    • Open ESP Web Flasher in a new window/tab.
    • Select 460800 Baud from the pull-down menu (top-right).
    • Click Connect (top-right).
    • Select the COM or Serial port from the pop-up window.
    • After successful connection, click Erase.
    • After successful erase, click any Choose a file..., then locate and select the combined.bin file unzipped earlier.
    • After successfully choosing combined.bin, click Program.
    • After the TinyUF2 firmware update is complete, press the RESET button on the board. A new drive BOOT should be visible in your file browser.

After you update, check INFO_UF2.TXT to verify that the bootloader version has been updated. Then you will need to load or reload CircuitPython using the .uf2 file.