1. Getting Started
1.1 Package Contents
Verify that all items are present in your package:
- 1 x T-Display-S3-Long-3.4-V1.0 Development Board
- 2 x STEMMA QT/Qwiic Interface Cables [P352]
- 1 x Battery Cable

1.2 Board Overview
The LILYGO T-Display-S3-Long is a compact development board featuring the ESP32-S3R8 microcontroller and a 3.4-inch capacitive touch TFT LCD. It integrates wireless connectivity and various interfaces for versatile projects.


1.3 Key Features
- MCU: ESP32-S3R8 Dual-core LX7 microprocessor
- Wireless Connectivity: Wi-Fi 802.11, BLE 5 + BT mesh
- Programming Platforms: Arduino-IDE, VS Code
- Onboard Functions: Boot Button, Reset Button, Battery Switch
- Display: 3.4-inch Capacitive Touch TFT LCD, Resolution: 180(H)RGB x 640(V), Interface: QSPI
1.4 Board Layout and Connectors
The board features several connectors and buttons for power, expansion, and control.

- USB-C Port: Used for power, data transfer, and programming. Supports OTG 5V output.
- JST-GH 1.25mm LiPo Bat Connector: For connecting an external LiPo battery.
- Qwiic Connectors: Two connectors for I2C peripheral expansion.
- 1.27 Pitch IO Extension: Pin headers for extending GPIO functionality.
- Boot Button: Used for entering bootloader mode for firmware flashing.
- Reset Button: Resets the microcontroller.
- Battery Switch: Controls power from the connected battery.
1.5 Product Introduction Video
Watch this video for a visual introduction to the LILYGO T-Display-S3-Long development board and its features.
Video 1.1: Introduction to the LILYGO T-Display-S3-Long development board, showcasing its display and various components.
2. Setup
2.1 Powering the Board
The T-Display-S3-Long can be powered via its USB-C port or an external LiPo battery.
- USB-C Power: Connect the board to a computer or a 5V USB power adapter using a USB-C cable.
- Battery Power: Connect a compatible LiPo battery to the JST-GH 1.25mm connector. Ensure the battery switch is in the ON position.
2.2 Software Setup
To program the board, you will need to set up a development environment.
- Install Arduino IDE or VS Code: Download and install your preferred programming environment.
- ESP32-S3 Board Support: Add ESP32-S3 board support to your chosen IDE. Refer to the Espressif documentation or LILYGO's GitHub for detailed instructions.
- Drivers: Ensure necessary USB-to-serial drivers are installed for your operating system.
- GitHub Resources: Access example code and detailed documentation at the official LILYGO GitHub repository: github.com/Xinyuan-LilyGO/T-Display-S3-Long
3. Operating Instructions
3.1 Basic Operation
- Power On: Connect the board to a power source (USB-C or battery). The display should initialize.
- Reset: Press the Reset button to restart the current program running on the ESP32-S3.
- Bootloader Mode: To flash new firmware, hold down the Boot button, then press and release the Reset button, and finally release the Boot button. The board will now be in bootloader mode, ready to receive new code from your IDE.
3.2 Display Usage
The 3.4-inch capacitive touch TFT LCD allows for interactive applications.
- Touch Input: Utilize the capacitive touch functionality for user interaction within your applications.
- Graphics: Program the display to show text, images, and graphical interfaces at its 180x640 resolution.
3.3 Wireless Connectivity
The integrated Wi-Fi and Bluetooth capabilities enable network and device communication.
- Wi-Fi: Connect to 802.11 Wi-Fi networks for internet access or local network communication.
- Bluetooth: Use BLE 5 or classic Bluetooth mesh for short-range wireless communication with other devices.
4. Maintenance
4.1 General Care
- Storage: Store the board in a dry, anti-static environment when not in use.
- Cleaning: Use a soft, dry cloth to clean the display and board. Avoid liquid cleaners.
- Handling: Handle the board by its edges to minimize contact with electronic components and prevent static discharge.
- Temperature: Operate and store the board within recommended temperature ranges to ensure optimal performance and longevity.
5. Troubleshooting
5.1 Common Issues
- Board Reboots Unexpectedly:
- Ensure a stable power supply. A 5V/3A power source is recommended to prevent power-related reboots.
- Review your code for potential memory leaks, infinite loops, or unhandled exceptions that could cause system instability.
- Check for loose connections or shorts on the board.
- Display Not Working:
- Verify that the board is powered correctly.
- Ensure your program includes the correct display initialization code and libraries.
- Check for any physical damage to the display or its connection to the main board.
- Unable to Upload Code:
- Confirm that the correct board and port are selected in your IDE.
- Ensure the board is in bootloader mode (refer to Section 3.1).
- Check USB cable integrity and try a different USB port.
- Verify that necessary drivers are installed.
6. Specifications
6.1 Technical Specifications
| Feature | Detail |
|---|---|
| Processor | ESP32-S3R8 Dual-core LX7 microprocessor (240 MHz) |
| RAM | PSRAM |
| Flash Memory | 16 MB |
| Wireless Type | Wi-Fi 802.11, BLE 5 + BT mesh |
| Display | 3.4-inch Capacitive Touch TFT LCD |
| Display Resolution | 180(H)RGB x 640(V) |
| Operating System Support | FreeRTOS, Linux |
| Manufacturer | LILYGO |
| Model Name | T-Display-S3-Long |

7. Support and Resources
7.1 Further Assistance
For detailed technical documentation, code examples, and community support, visit the official LILYGO GitHub repository:
LILYGO T-Display-S3-Long GitHub Repository
7.2 Warranty Information
For specific warranty details regarding your LILYGO T-Display-S3-Long development board, please refer to the LILYGO official website or contact your point of purchase. Keep your proof of purchase for any warranty claims.





