1. Product Introduction
The LILYGO T7 S3 is a compact and powerful development board featuring the ESP32-S3-WROOM-1 module. It is designed for a wide range of IoT applications, offering robust Wi-Fi and Bluetooth 5 connectivity. This board integrates essential components for rapid prototyping and development.

Key features include:
- ESP32-S3-WROOM-1 Module: Powered by an Xtensa® 32-bit LX7 dual-core processor.
- Wireless Connectivity: Supports Wi-Fi and Bluetooth 5 + BluetoothMesh.
- Memory: Built-in 16MB Flash and 8MB PSRAM.
- Onboard Peripherals: USB Type-C port, Reset Switch, Power (PWR) Switch, 4-PIN STEMMA QT / Qwiic JST-SH 1.0mm connector, and a 1.25mm JST connector for battery.
- Programmable LED: IO17.
- Battery Detection: IO02.

2. Specifications
| Feature | Description |
|---|---|
| Model Number | T7 S3 |
| MCU | ESP32-S3-WROOM-1 Xtensa® 32-bit LX7 Dual-core |
| Wireless Connectivity | Wi-Fi, Bluetooth 5 + BluetoothMesh |
| Flash Memory | 16MB |
| PSRAM | 8MB |
| Programming Languages | C/C++, MicroPython |
| Programming Platforms | Arduino-IDE, VS Code |
| USB Interface | USB Type-C (USB 3.0 support) |
| External Connectors | 1.25mm JST connector (for battery), 4-PIN STEMMA QT / Qwiic JST-SH 1.0mm holder |
| Programmable LED | IO17 |
| Battery Detection Pin | IO02 |
| Dimensions (L x W x H) | 3.9cm x 3.1cm x 0.6cm |
| Weight | 0.04 kg |

3. Package Contents
The standard package for the LILYGO T7 S3 Development Board includes the following items:
- 1 x LILYGO T7 S3 V1.1 Development Board
- 2 x 2.54mm Male Pin Headers (1*10P)
- 2 x 2.54mm Long Female Pin Headers (1*10P)
- 2 x 2.54mm Short Female Pin Headers (1*10P)
- 1 x JST 1.25mm 2P Cable

4. Setup Guide
To begin using your LILYGO T7 S3 development board, follow these steps:
- Connect to Computer: Use a USB Type-C cable to connect the T7 S3 board to your computer. The board should power on, indicated by the power LED.
- Install Drivers: Depending on your operating system, you may need to install the appropriate USB-to-Serial drivers (e.g., CP210x or CH340 drivers). These are often automatically installed by modern operating systems or included with development environments.
- Install Development Environment: We recommend using either the Arduino IDE or VS Code with the PlatformIO extension.
- Add ESP32 Board Support:
- For Arduino IDE: Go to File > Preferences, and add
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.jsonto the 'Additional Board Manager URLs'. Then, go to Tools > Board > Board Manager, search for 'esp32', and install the 'esp32 by Espressif Systems' package. - For PlatformIO (VS Code): Install the PlatformIO extension. Create a new project and select 'Espressif ESP32' as the board framework.
- For Arduino IDE: Go to File > Preferences, and add
- Select Board: In your chosen IDE, select the correct board model (e.g., 'ESP32S3 Dev Module' or similar) and the serial port corresponding to your connected T7 S3 board.
- Access Resources: For detailed examples, libraries, and community support, visit the official LILYGO T7 S3 GitHub repository:

5. Operating Instructions
5.1. Pinout Diagram
Understanding the pinout is crucial for connecting peripherals and programming your board. Refer to the detailed pinout diagram below:

5.2. Basic Programming
Once your development environment is set up and the board is selected:
- Write Code: Develop your application code (sketch) in C/C++ or MicroPython.
- Compile: Compile your code within the IDE to check for errors.
- Upload: Click the 'Upload' button in your IDE. The IDE will compile and then upload the firmware to the T7 S3 board via the USB-C connection.
- Monitor Serial Output: Use the Serial Monitor in your IDE to view debug messages or data from your board.
5.3. Powering the Board
- USB Type-C: The primary power source is the USB Type-C port, which also handles data communication.
- Battery (JST Connector): The 1.25mm JST 2P connector allows you to connect a compatible LiPo battery for portable applications. The board includes a blue charging indicator LED.
5.4. Buttons
- Reset Button: Press this button to restart the ESP32-S3 module.
- Boot Button: This button is typically used to put the ESP32-S3 into bootloader mode for flashing new firmware. Hold down the Boot button, press and release the Reset button, then release the Boot button.
- Power (PWR) Switch: Controls the main power supply to the board.
6. Maintenance
- Storage: Store the board in a dry, anti-static environment when not in use.
- Handling: Handle the board by its edges to avoid touching sensitive components, especially to prevent electrostatic discharge (ESD).
- Cleaning: If necessary, gently clean the board with a soft, dry brush or compressed air. Avoid using liquids or harsh chemicals.
- Firmware Updates: Regularly check the LILYGO GitHub repository for firmware updates or new examples to ensure optimal performance and access to the latest features.
7. Troubleshooting
- Board Not Detected:
- Ensure the USB Type-C cable is fully inserted and functional.
- Verify that the correct USB-to-Serial drivers are installed on your computer.
- Try a different USB port or cable.
- Upload Failed:
- Check if the correct board and serial port are selected in your IDE.
- Ensure the board is not in an unresponsive state. Try pressing the Reset button.
- Sometimes, holding the 'Boot' button while initiating the upload, then releasing it after the upload starts, can help.
- Wi-Fi/Bluetooth Issues:
- Double-check your code for correct Wi-Fi credentials or Bluetooth pairing logic.
- Ensure your antenna (if external) is properly connected.
- Verify that the Wi-Fi network is within range and operating on a supported frequency (2.4 GHz).
- Power Issues:
- If using battery, ensure it is charged and properly connected to the JST connector.
- Check the Power (PWR) Switch is in the 'ON' position.
- General Errors: Refer to the error messages provided by your IDE. Consult the LILYGO T7 S3 GitHub repository's issues section or community forums for similar problems and solutions.
8. User Tips
- Start Simple: Begin with basic examples like blinking an LED or printing to the serial monitor to confirm your setup is working correctly before moving to complex projects.
- Double-Check Wiring: Always verify your circuit connections before powering on the board to prevent accidental damage to the board or connected components.
- Utilize GitHub: The LILYGO GitHub repository is an invaluable resource for code examples, documentation, and community support. It's often the quickest way to find solutions to common problems.
- Power Management: When running projects from battery, monitor the battery level using the IO02 pin to ensure stable operation and prevent unexpected shutdowns.
9. Warranty and Support
For technical support, documentation, and community resources, please refer to the official LILYGO T7 S3 GitHub repository linked in the Setup Guide. LILYGO provides support for their products through these channels. For any manufacturing defects or hardware issues, please contact your point of purchase or the LILYGO official support channels for assistance.