TTGO T8 ESP32-S2 ST7789 by LILYGO
The TTGO T8 ESP32-S2 development board has a ST7789 display and other useful features which allows one to create a variety of projects.
The display has native CircuitPython support.
Features & Specifications
- ESP32-S2 240 MHz Tensilica processor
- Wi-Fi 802.11 b/g/n 2.4 GHz
- 4 MB FLASH
- 8 MB PSRAM
- 1.14” ST7789 Display (Resolution: 240 x 135)
- microSD card slot
- built in battery charging, 2-pin 1.25 mm JST connector
- on/off power switch
- reset and boot button
- onboard 32.768 kHz crystal oscillator
- USB-C connector
Schematic
Setup
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-X.Y.Z.bin
After flashing change the DIP switches (the ones closer to the USB-C connector) to OTG mode, when reconnected you should see the CIRCUITPY drive.
USB OTG
On On
o o o o
o o o o
1 2 3 4 1 2 3 4
Purchase
Contribute
Have some info to add for this board? Edit the source for this page here.
CircuitPython 9.2.8
This is the latest stable release of CircuitPython that will work with the TTGO T8 ESP32-S2 ST7789. Use this release if you are new to CircuitPython.
Modules included in this download
_asyncio _pixelmap adafruit_bus_device adafruit_pixelbuf aesio alarm analogbufio analogio array atexit audiobusio audiocore audioio audiomixer audiomp3 binascii bitbangio bitmaptools board builtins builtins.pow3 busdisplay busio busio.SPI busio.UART canio codeop collections countio digitalio displayio epaperdisplay errno espcamera espidf espnow espulp fontio fourwire framebufferio frequencyio getpass gifio hashlib i2cdisplaybus io ipaddress jpegio json keypad keypad.KeyMatrix keypad.Keys keypad.ShiftRegisterKeys keypad_demux keypad_demux.DemuxKeyMatrix locale math max3421e mdns memorymap microcontroller msgpack neopixel_write nvm onewireio os os.getenv paralleldisplaybus ps2io pulseio pwmio qrio rainbowio random re rgbmatrix rotaryio rtc sdcardio select sharpdisplay socketpool socketpool.socketpool.AF_INET6 ssl storage struct supervisor synthio sys terminalio tilepalettemapper time touchio traceback ulab usb usb_cdc usb_hid usb_midi vectorio warnings watchdog wifi zlibFeatures: Wi-Fi, Display, Battery Charging, USB-C, Breadboard-Friendly
CircuitPython 10.0.0-beta.0
This is the latest development release of CircuitPython that will work with the TTGO T8 ESP32-S2 ST7789.
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 10.0.0-beta.0
Modules included in this download
_asyncio _eve _pixelmap adafruit_bus_device adafruit_pixelbuf aesio alarm analogbufio analogio array atexit audiobusio audiocore audiomixer audiomp3 binascii bitbangio bitmapfilter bitmaptools board builtins builtins.pow3 busdisplay busio busio.SPI busio.UART canio codeop collections countio digitalio displayio epaperdisplay errno espcamera espidf espnow espulp fontio fourwire framebufferio frequencyio getpass gifio hashlib i2cdisplaybus io ipaddress jpegio json keypad keypad.KeyMatrix keypad.Keys keypad.ShiftRegisterKeys keypad_demux keypad_demux.DemuxKeyMatrix locale lvfontio math max3421e mdns memorymap microcontroller msgpack neopixel_write nvm onewireio os os.getenv paralleldisplaybus ps2io pulseio pwmio qrio rainbowio random re rgbmatrix rotaryio rtc sdcardio select sharpdisplay socketpool socketpool.socketpool.AF_INET6 ssl storage struct supervisor synthio sys terminalio tilepalettemapper time touchio traceback ulab usb usb_cdc usb_hid usb_midi vectorio warnings watchdog wifi zlibFeatures: Wi-Fi, Display, Battery Charging, USB-C, Breadboard-Friendly
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.35.0
The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs. The bootloader itself is not CircuitPython. On Espressif boards, the UF2 bootloader is called TinyUF2. If the TinyUF2 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.)
In general, it is not necessary to update TinyUF2 at every version change. You can read the release notes on GitHub to see what has been changed. Update if you've been told about a necessary change or a bug fix.
Note: CircuitPython 10 and later, on Espressif boards with 4MB flash, requires TinyUF2 0.33.0 or later. The flash partition layout has changed (details).
If TinyUF2 has never been installed on the board, or it was removed by erasing or overwriting the flash, it must be installed in order to flash .uf2 files onto the board. But you don't need the TinyUF2 bootloader to upload .bin files. They can be uploaded using the built-in ROM bootloader, with the Adafruit WebSerial ESPTool or esptool.py.
Warning: Installing the TinyUF2 bootloader will erase everything that was previously on the board. Save any files in CIRCUITPY for which you don't have backups.
There are several ways to install the TinyUF2 bootloader on your board. Check to see if your board's manufacturer provides specific instructions. For Adafruit boards, consult the Factory Reset page in the Learn Guide for your particular board (example).
The easiest way to install TinyUF2 is to use the OPEN INSTALLER button (see above, in the CiruitPython sections). You can also use the Adafruit WebSerial ESPTool, or esptool.py, as described in the Factory Reset page.
- 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 the BOOT button (sometimes marked "B0").
- Press and release the RESET button (sometimes marked "RST").
- Release the BOOT button. This starts the ROM bootloader.
After installing TinyUF2, enter the UF2 bootloader by double-clicking the RESET button. On boards with an RGB status LED, you usually 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.
If you are updating TinyUF2, look at INFO_UF2.TXT to verify the new version of TinyUF2, by checking the version number. Then you will need to copy the CircuitPython.uf2 file to the BOOT drive.