LILYGO T4 V1.3

LILYGO TTGO T4 V1.3 ESP32 Development Board with 2.4-inch LCD User Manual

Model: T4 V1.3

1. Introduction

The LILYGO TTGO T4 V1.3 is an ESP32-based development board integrated with a 2.4-inch ILI9341 LCD. This versatile board offers Wi-Fi and Bluetooth connectivity, making it suitable for a wide range of IoT and embedded projects requiring a display interface. It includes onboard buttons for boot and reset functions, as well as battery power detection capabilities.

2. Product Overview

The TTGO T4 V1.3 development board combines an ESP32 microcontroller with a vibrant 2.4-inch LCD, offering a compact solution for interactive projects. Key features include:

  • Microcontroller: ESP32 chip
  • Flash Memory: 4MB
  • PSRAM: 8MB
  • Display: 2.4-inch ILI9341 TFT LCD (320x240 resolution, 65K color display)
  • Wireless Connectivity: Wi-Fi (802.11 b/g/n) and Bluetooth (V4.2+BLE)
  • Onboard Functions: Boot and Reset buttons, battery power detection
  • Programming Platform: Arduino IDE, MicroPython
  • Serial Chip: CH9102
  • Power Supply: Supports USB and Li-Po battery (JST GH 1.25mm connector)
LILYGO TTGO T4 V1.3 Development Board with 2.4-inch LCD displaying LILYGO logo

Figure 2.1: Front view of the LILYGO TTGO T4 V1.3 Development Board with the 2.4-inch LCD displaying the LILYGO logo.

Back view of the LILYGO TTGO T4 V1.3 Development Board showing components and connectors

Figure 2.2: Back view of the development board, highlighting the various components and connectors.

Included components: LILYGO TTGO T4 V1.3 board, Dupont line, and power cable

Figure 2.3: The package includes one TTGO T4 V1.3 board, one Dupont line, and one power cable.

3. Specifications

FeatureSpecification
BrandLILYGO
Model NameT4 V1.3
Wireless TypeBluetooth, Wi-Fi
Operating SystemReal-Time Operating System (RTOS)
Product Dimensions (LxWxH)2.6 x 1.7 x 0.47 inches (66 x 43 x 12 mm)
Processor BrandEspressif (ESP32)
Number of Processors1
Computer Memory TypeDIMM
RAM Memory Installed Size8 MB (PSRAM)
Memory Storage Capacity4 MB (Flash)
Display TypeILI9341 TFT LCD
Display Size2.4 inch
Display Resolution320x240
Display Interface4-Wire SPI
Working Power Supply3.3V
Battery ConnectorJST GH 1.25mm
LILYGO TTGO T4 V1.3 Development Board with dimensions labeled: W:41mm, L:66mm, H:11mm

Figure 3.1: Physical dimensions of the TTGO T4 V1.3 board.

4. Setup

To begin using your LILYGO TTGO T4 V1.3 development board, follow these general setup steps:

  1. Power Connection: Connect the board to a power source using the Micro USB port. Alternatively, a Li-Po battery can be connected to the JST GH 1.25mm connector.
  2. Driver Installation: Ensure you have the necessary USB-to-Serial drivers (for CH9102 chip) installed on your computer. These are typically available from the chip manufacturer's website or through common ESP32 development environment setups.
  3. Development Environment Setup: Install your preferred development environment, such as Arduino IDE or MicroPython. For Arduino IDE, you will need to add ESP32 board support and the appropriate display libraries (e.g., TFT_eSPI).
  4. Code Upload: Connect the board to your computer via USB. Select the correct board and COM port in your IDE. Upload your code to the ESP32.
  5. Resource Access: For detailed code examples, libraries, and further information, refer to the official LILYGO GitHub repository: github.com/Xinyuan-LilyGO/TTGO-T4-TestCode.

5. Operating Instructions

The TTGO T4 V1.3 board is designed for flexible operation, supporting various programming approaches. Once programmed, the board will execute the uploaded firmware.

  • Power On/Off: The board powers on automatically when connected to USB or a battery. There is no dedicated power switch.
  • Reset Button (RST): A short press of the RST button will restart the ESP32 microcontroller, reloading the current program.
  • Boot Button: The Boot button is typically used to put the ESP32 into programming mode. Hold down the Boot button, press and release the RST button, then release the Boot button to enter flash mode for uploading new firmware.
  • Display Operation: The 2.4-inch ILI9341 LCD is controlled via the ESP32 using SPI. Your code will manage what is displayed on the screen. Ensure your display library is correctly initialized and configured for the ILI9341 driver.
  • Backlight Adjustment: The display backlight can be controlled programmatically, often via PWM, to adjust brightness. Refer to your display library documentation for specific functions.
  • Wi-Fi and Bluetooth: Utilize the ESP32's built-in Wi-Fi and Bluetooth capabilities through your code to connect to networks, communicate with other devices, or create access points.

6. Pinout Diagram

Understanding the pinout is crucial for connecting external components and utilizing the full functionality of the TTGO T4 V1.3 board. The following diagram illustrates the pin assignments:

LILYGO TTGO T4 V1.3 ESP32 Pinmap diagram showing GPIO assignments for display, buttons, and other peripherals

Figure 6.1: LILYGO T4 V1.3 Pinmap. This diagram details the GPIO connections for the ILI9341 LCD, buttons, and other available pins.

Key Pin Assignments:

  • ILI9341 TFT LCD: SCLK (IO18), RS (IO32), RST (IO05), SDI (IO23), CS (IO27), SDO (IO12), BL (IO04)
  • Buttons: IO38, IO37, IO39
  • Power: 3V3, 5V, GND, VBAT (for battery input)
  • Micro USB: For charging, powering, burning (uploading firmware), and debugging.
  • TF Card: MISO (IO02), SCLK (IO14), MOSI (IO15), CS (IO13)

7. Maintenance

Proper care and maintenance will ensure the longevity and reliable operation of your TTGO T4 V1.3 development board.

  • Handling: Handle the board by its edges to avoid touching sensitive components, especially the display and exposed pins.
  • Storage: Store the board in an anti-static bag when not in use to protect it from electrostatic discharge. Keep it in a dry environment, away from extreme temperatures.
  • Cleaning: If necessary, gently clean the board with a soft, dry brush or compressed air to remove dust. Avoid using liquids or abrasive materials.
  • Power Supply: Always use a stable 5V power supply via USB or a compatible Li-Po battery. Ensure correct polarity when connecting a battery.
  • Firmware Updates: Regularly check the LILYGO GitHub repository for updated firmware or library versions to benefit from improvements and bug fixes.

8. Troubleshooting

If you encounter issues with your TTGO T4 V1.3 board, consider the following troubleshooting steps:

  • Board Not Powering On:
    • Verify the USB cable is functional and properly connected to both the board and your computer/power adapter.
    • If using a battery, ensure it is charged and correctly connected to the JST connector with the correct polarity.
  • Display Remains Blank/Dark:
    • Ensure the display library is correctly initialized in your code for the ILI9341 driver.
    • Check if the backlight is enabled in your code. Some display libraries require explicit backlight activation.
    • Verify all display connections (SPI pins) are correct according to the pinout diagram.
  • Failed Firmware Upload:
    • Confirm the correct COM port is selected in your IDE.
    • Ensure the ESP32 is in flash mode (hold Boot, press/release RST, then release Boot).
    • Install or update the USB-to-Serial drivers (CH9102).
    • Try a different USB cable or port.
  • Wi-Fi/Bluetooth Connectivity Issues:
    • Double-check your network credentials (SSID, password) in your code.
    • Ensure the Wi-Fi/Bluetooth antenna (if external) is properly connected.
    • Verify that the ESP32's Wi-Fi/Bluetooth functions are correctly initialized in your program.

9. Warranty and Support

For warranty information and technical support, please refer to the official LILYGO website or contact your point of purchase. Detailed documentation, community forums, and additional resources can often be found on the LILYGO GitHub page linked in the Setup section.

Related Documents - T4 V1.3

Preview LILYGO T-Display User Guide
A user guide for the LILYGO T-Display development board, covering setup, Arduino integration, and basic commands for ESP32 module development.
Preview LILYGO T-BEAM-S3 User Guide: Setup and Development
This user guide provides comprehensive instructions for setting up the LILYGO T-BEAM-S3 development board. Learn how to configure the software environment using Arduino IDE, connect the board, and utilize its Wi-Fi, BLE, GPS, and LoRa capabilities for IoT projects.
Preview LILYGO Mini E-Paper-S3 User Guide
Comprehensive user guide for the LILYGO Mini E-Paper-S3 development board. Covers setup, Arduino IDE integration, firmware development, and Wi-Fi command reference for IoT applications.
Preview LILYGO T-WATCH-V3 User Guide
A comprehensive user guide for the LILYGO T-WATCH-V3 development board, detailing setup, software development, and SSC command reference for ESP32 applications.
Preview LILYGO T-Embed User Guide
A comprehensive user guide for the LILYGO T-Embed development board, covering setup, Arduino IDE integration, and Wi-Fi command reference.
Preview LILYGO T-QT Pro User Guide
A comprehensive user guide for the LILYGO T-QT Pro development board, detailing setup, configuration, and usage with Arduino and ESP32-S3 module.