LILYGO T8 ESP32 Development Board

Contents

LILYGO T8 ESP32 Development Board User Manual

Models: T8 V1.7.1, T8 V1.8, T8-C3, T8-S3

1. Introduction

The LILYGO T8 series comprises versatile ESP32-based development boards designed for a wide range of IoT, prototyping, and embedded applications. These boards integrate powerful microcontrollers with Wi-Fi, Bluetooth, and various peripherals, making them suitable for complex projects requiring connectivity, processing power, and memory. This manual provides detailed instructions for setup, operation, and troubleshooting for the different T8 models.

Overview of LILYGO T8 series development boards
Figure 1: LILYGO T8 Series Development Boards Overview

2. Key Features

The LILYGO T8 series offers a robust set of features for embedded development:

  • Microcontroller: ESP32-WROVER dual-core Xtensa LX6 @ 240 MHz (for T8 V1.7.1, T8 V1.8) or ESP32-S3 Xtensa® 32-bit LX7 MCU (for T8-S3), or ESP32-C3 RISC-V single-core (for T8-C3).
  • Memory: Up to 16MB Flash and 8MB PSRAM (specifics vary by model).
  • Wireless Connectivity: 2.4 GHz Wi-Fi (802.11 b/g/n) and Bluetooth (v4.2 BR/EDR + BLE or Bluetooth 5 + Bluetooth Mesh).
  • Storage: MicroSD (TF) card slot for expandable storage.
  • Power Management: Battery management with Li-Po charging (JST-GH 1.25mm or MX 1.25 2-PIN connector).
  • USB Interface: Micro USB or USB Type-C for power and data (USB-to-UART via CH9102F or CP2104).
  • Antenna: Integrated 3D antenna or PCB antenna, with options for external IPEX connector.
  • Programming Support: Compatible with Arduino-IDE, VS Code, ESP-IDF, and MicroPython.
  • Operating Voltage: 2.3-3.6 V.
  • Expansion: Some models include STEMMA QT / Qwiic expansion ports.

3. Setup Guide

3.1. Hardware Connections

Before programming or using your LILYGO T8 board, ensure proper hardware connections:

  1. Power Supply: Connect the board to a computer via the Micro USB or USB Type-C port. Alternatively, connect a compatible Li-Po battery to the designated battery connector (JST-GH 1.25mm or MX 1.25 2-PIN).
  2. TF Card: Insert a MicroSD (TF) card into the card slot if your application requires external storage.
  3. External Antenna (Optional): If your board version supports an external antenna and your application requires it, connect an IPEX antenna to the IPEX connector. Note that some versions may require a jumper resistor for external antenna use.
  4. Expansion Ports (Optional): For models like the T8-S3, utilize the STEMMA QT / Qwiic JST-SH 1.0mm 4-PIN connector for compatible peripherals.
LILYGO T8 board connected to a battery and SD card
Figure 2: Example of T8 board with battery and SD card connected

3.2. Software Environment Setup

The LILYGO T8 boards can be programmed using various environments. Here's a general guide for Arduino IDE:

  1. Install Arduino IDE: Download and install the Arduino IDE from the official Arduino website.
  2. Install ESP32 Board Support: Follow the instructions to install the ESP32 board package for Arduino IDE. This typically involves adding the ESP32 board manager URL in preferences and then installing the package via the Boards Manager.
  3. Configure Board Settings:

    In the Arduino IDE, navigate to Tools → Board and select the appropriate ESP32 Wrover Module. Configure the following settings:

    Arduino IDE SettingValue
    BoardESP32 Wrover Module
    Upload Speed921600
    Flash Frequency80 MHz
    Flash ModeQIO
    Flash Size4MB (32Mb)
    Partition SchemeHuge APP (3MB No OTA/1MB SPIFFS)
    PSRAMEnabled
  4. Upload Code: Write your code and click the "Upload" button to flash it to the board.

For more detailed instructions and examples, refer to the official LILYGO GitHub repositories:

If you plan to use MicroPython, flash the MicroPython firmware from micropython.org.

4. Operation

Once your LILYGO T8 board is set up with the desired firmware, you can begin operating it for your projects. The specific operation will depend on the code you've uploaded.

  • Power On: Connect the board via USB or battery. The power LED should illuminate.
  • Programming: Use your chosen IDE (Arduino IDE, VS Code with PlatformIO, ESP-IDF) to write and upload your code.
  • Reset Button: Press the 'RST' button to restart the microcontroller.
  • Boot Button: The 'BOOT' button is typically used to put the ESP32 into flashing mode. Hold 'BOOT', press 'RST', release 'RST', then release 'BOOT'.
  • TF Card Usage: Access the TF card for reading/writing data within your program.
  • Wi-Fi/Bluetooth: Utilize the integrated Wi-Fi and Bluetooth capabilities for network communication and device pairing.
Video 1: Demonstration of servo control using a TTGO T8 board.

5. Specifications

Detailed specifications for the LILYGO T8 series development boards:

General Specifications

ParameterValue
Dimensions (WxHxD)63.3*26.8*4.7mm (General)
Weight9.5g
Operating Voltage2.3-3.6 V
PackageYes

Model-Specific Specifications

Comparison table of LILYGO T8 series specifications
Figure 3: LILYGO T8 Series Model Comparison

For detailed pinout diagrams, please refer to the following figures:

LILYGO T8 V1.7.1 Pinout Diagram
Figure 4: LILYGO T8 V1.7.1 PinMAP
LILYGO T8-S3 Pinout Diagram
Figure 5: LILYGO T8-S3 PinMAP

For other models, refer to the respective GitHub repositories for pinout details.

6. Maintenance

  • Storage: Store the development board in a dry, anti-static environment when not in use.
  • Handling: Handle the board by its edges to avoid touching sensitive components, especially the antenna area.
  • Cleaning: Use a soft, dry brush or compressed air to remove dust. Avoid liquids or harsh chemicals.
  • Firmware Updates: Regularly check the official LILYGO GitHub repositories for firmware updates and bug fixes to ensure optimal performance and security.

7. Troubleshooting

Q: The board is not recognized by my computer / Upload fails.
A: Ensure you have installed the correct USB-to-UART drivers (CH9102F or CP2104, depending on your board version). Check your USB cable and port. Try a different cable or port. Make sure the board is in bootloader mode if required for flashing (hold BOOT button, press RST, release RST, then release BOOT).
Q: How do I enable PSRAM?
A: In Arduino IDE, set PSRAM to "Enabled" in the Tools menu. In ESP-IDF, enable SPIRAM support in menuconfig.
Q: Does it support MicroPython?
A: Yes. You need to flash the MicroPython firmware from micropython.org to the board.
Q: Does it work with Arduino IDE by default?
A: Yes, after installing the ESP32 board support package in the Arduino IDE, you can program the LILYGO T8 boards using Arduino IDE.

8. User Tips

  • This board is an excellent all-in-one solution for various IoT projects due to its integrated features like Wi-Fi, Bluetooth, PSRAM, and TF card support.
  • Always double-check your wiring and connections before powering on the board to prevent damage.
  • Explore the extensive community resources and examples available for ESP32 development to get the most out of your board.

9. Warranty and Support

For technical support, documentation, and community resources, please refer to the official LILYGO GitHub repositories:

For general inquiries or issues with your product, please contact the seller directly. If a user manual PDF is available, it can be found at: LILYGO T8 Item Guides & Documents (PDF).

10. Shipping List

The contents of your package will vary depending on the specific LILYGO T8 model purchased. Please verify the contents upon receipt.

T8 V1.7.1 Option

Shipping list for LILYGO T8 V1.7.1: 1x T8 board, 1x power cable, 2x pin headers
Figure 6: T8 V1.7.1 Package Contents
  • 1x T8 V1.7.1 ESP32 Module (CH9102)
  • 1x Power Cable
  • 2x Pin Headers

T8 V1.8 Option

Shipping list for LILYGO T8 V1.8: 1x T8 board, 2x pin headers
Figure 7: T8 V1.8 Package Contents
  • 1x T8 V1.8 ESP32 Module (CH9102)
  • 2x Pin Headers

T8-C3 Option

Shipping list for LILYGO T8-C3: 1x T8-C3 board, 1x power cable, 2x pin headers
Figure 8: T8-C3 Package Contents
  • 1x T8-C3 ESP32-C3 Module
  • 1x Power Cable
  • 2x Pin Headers

T8-S3 Option

Shipping list for LILYGO T8-S3: 1x T8-S3 board, 1x power cable, 2x pin headers, 1x LED flexible light strip
Figure 9: T8-S3 Package Contents
  • 1x T8-S3 ESP32-S3 Module
  • 1x Power Cable
  • 2x Pin Headers
  • 1x LED flexible light strip 130mm

Ask a question about this manual

Ask about setup, troubleshooting, compatibility, parts, safety, or missing instructions. Manuals+ will review the question and use this page’s manual context to help answer it.

After a successful submission, we securely hash the supplied account or form email before sending it to Microsoft Advertising for conversion attribution. Privacy details.