Metro ESP32-S2

by Adafruit

Image of Board

What’s Metro shaped and has an ESP32-S2 WiFi module? What has a STEMMA QT connector for I2C devices, and a Lipoly charger circuit? What’s finishing up testing and nearly ready for fabrication? That’s right - its the new Adafruit Metro ESP32-S2! With native USB and a load of PSRAM this board is perfect for use with CircuitPython or Arduino, to add low-cost WiFi while keeping shield-compatibility.

Technical details

  • ESP32-S2 240 MHz Tensilica processor - the next generation of ESP32, now with native USB so it can act like a keyboard/mouse, MIDI device, disk drive, etc!
  • WROVER module has FCC/CE certification and comes with 4 MB of Flash and 2 MB of PSRAM - you can have huge data buffers
  • Lotsa power options - 6-12 VDC barrel jack or USB-C or Lipoly battery
  • Built in battery charging when powered over DC or USB
  • UNO-shape so shields can plug in
  • Reset and DFU (BOOT0) buttons to get into the ROM bootloader (which is a USB serial port so you don’t need a separate cable!)
  • Serial debug pins (optional, for checking the hardware serial debug console)
  • JTAG pads for advanced debugging access.
  • On/Off switch
  • STEMMA QT connector for I2C devices
  • On/Charge/User LEDs + status NeoPixel
  • Works with Arduino or CircuitPython

Purchase:

Contribute

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

CircuitPython 8.1.0

This is the latest stable release of CircuitPython that will work with the Metro ESP32-S2.

Use this release if you are new to CircuitPython.

Release Notes for 8.1.0

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

CircuitPython 8.2.0-beta.0

This is the latest development release of CircuitPython that will work with the Metro ESP32-S2.

Alpha development releases are early releases. They are unfinished, are likely to have bugs, and the features they provide may change. Beta releases may have some bugs and unfinished features, but should be suitable for many uses. A Release Candidate (rc) release is considered done and will become the next stable release, assuming no further issues are found.

Please try alpha, beta, and rc releases if you are able. Your testing is invaluable: it helps us uncover and find issues quickly.

Release Notes for 8.2.0-beta.0

Built-in modules available: _asyncio, _pixelmap, adafruit_bus_device, adafruit_pixelbuf, aesio, alarm, analogbufio, analogio, array, atexit, audiobusio, audiocore, audiomixer, binascii, bitbangio, bitmaptools, board, builtins, busio, canio, collections, countio, digitalio, displayio, dualbank, errno, espcamera, espidf, espnow, espulp, fontio, framebufferio, frequencyio, getpass, gifio, hashlib, i2ctarget, ipaddress, json, keypad, math, mdns, memorymap, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, paralleldisplay, ps2io, pulseio, pwmio, qrio, rainbowio, random, re, rgbmatrix, rotaryio, rtc, sdcardio, select, sharpdisplay, socketpool, ssl, storage, struct, supervisor, synthio, sys, 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. These releases are even newer than the development release listed above. Try them if you want the absolute latest and are feeling daring or want to see if a problem has been fixed.

Previous Versions of CircuitPython

All previous releases of CircuitPython are available for download from Amazon S3 through the button below. For very old releases, look in the OLD/ folder for each board. Release notes for each release are available at GitHub button below.

Older releases are useful for testing if you something appears to be broken in a newer release but used to work, or if you have older code that depends on features only available in an older release. Otherwise we recommend using the latest stable release.

Install, Repair, or Update UF2 Bootloader

Latest version: 0.13.0

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 or ESP32-S3 boards.

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

The instructions here are general. We recommend you consult the manufacturer's board documentation for detailed instructions, which may be different.

  • 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 installing the UF2 bootloader, enter the bootloader by double-clicking the reset button. On boards with an RGB status LED, tap reset once, wait for the LED to turn purple, and tap again before the purple goes away. On other boards, consult the board documentation.

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.