TTGO T8 ESP32-S2 ST7789

by LILYGO

Image of Board

Features & Specifications:

  • ESP32-S2 240MHz Tensilica processor
  • Wi-Fi 802.11 b/g/n 2.4GHz
  • 4MB FLASH
  • 8MB PSRAM
  • 1.14” ST7789 Display
  • microSD card slot
  • built in battery charging, 2-pin 1.25mm JST connector
  • on/off power switch
  • reset and boot button
  • onboard 32.768kHz crystal oscillator
  • USB type-C connector

Schematic:

Board compatibility:

This image is working on the TTGO T8 ESP32-S2 V1.1 as well. It’s basically the same board as the st7789 just without the display.

To flash this image use this command:

esptool.py –chip esp32s2 –port (COMPORT) –baud 115200 write_flash 0x000 “adafruit-circuitpython-lilygo_ttgo_t8_s2_st7789-xx_XX-6.2.0.bin”

After flashing change the dip switches to OTG mode, when reconnected you should see the CIRCUITPY drive.

Contribute

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

CircuitPython 6.3.0

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

Start here if you are new to CircuitPython.

Release Notes for 6.3.0

DOWNLOAD .BIN NOW DOWNLOAD .UF2 NOW

Built-in modules available: _bleio, _pixelbuf, alarm, analogio, audiobusio, audiocore, binascii, bitbangio, bitmaptools, board, busio, canio, countio, digitalio, displayio, dualbank, errno, framebufferio, frequencyio, gamepad, ipaddress, json, math, microcontroller, msgpack, neopixel_write, nvm, os, ps2io, pulseio, pwmio, random, re, rotaryio, rtc, sdcardio, sharpdisplay, socketpool, ssl, storage, struct, supervisor, terminalio, time, touchio, ulab, usb_hid, vectorio, watchdog, wifi

CircuitPython 7.0.0-rc.3

This is the latest unstable release of CircuitPython that will work with the TTGO T8 ESP32-S2 ST7789.

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

Release Notes for 7.0.0-rc.3

DOWNLOAD .BIN NOW DOWNLOAD .UF2 NOW

Built-in modules available: _bleio, 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, imagecapture, ipaddress, json, keypad, math, 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

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 UF2 Bootloader

Latest version: 0.5.2

The bootloader allows you to load CircuitPython, Makecode, and Arduino programs. The bootloader is not CircuitPython.

It is not necessary to reinstall the bootloader unless a BOOT drive is not visible when in UF2 bootloader mode (FTHRS2BOOT, MAGTAGBOOT, HOUSEBOOT, etc.), in which case the UF2 bootloader may need to be repaired.

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 should be installed in order to flash .uf2 files onto the board.

Important: this will erase previously flashed firmware & 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 Adafruit WebSerial ESPTool 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 BOARDBOOT (where BOARD is an abbreviation of your board's name) 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.

Update UF2 Bootloader

Latest version: 0.5.2

The bootloader allows you to load CircuitPython, Makecode, and Arduino programs. The bootloader is not CircuitPython. You can check the current version of your bootloader by looking in the INFO_UF2.TXT file when the BOOT drive is visible (FEATHERBOOT, CPLAYBOOT, etc.).

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

  • Save the contents of CIRCUITPY, just in case.
  • Follow instructions in the Install/Repair UF2 Bootloader section above.
  • Check INFO_UF2.TXT to verify that the bootloader version has been updated.
  • Reload CircuitPython.