1. Introduction
The LILYGO T3S3 V1.0 is a versatile development board featuring the ESP32-S3 main control chip and a LoRa module. It supports the LoRa 2.4G frequency band, enabling long-range wireless communication suitable for a wide array of IoT applications. This board also includes a TF card slot for expanded storage and various onboard functions for enhanced flexibility.

Key Features:
- Powerful LoRa Communication: Equipped with a LoRa module for excellent long-range, low-power communication.
- Global 2.4G LoRa Support: Operates on the LoRa 2.4G frequency band, ensuring global compatibility.
- Advanced ESP32-S3 MCU: Features the ESP32-S3 main control chip for high performance and flexible interface options.
- Expandable Storage: Includes a TF card slot for data storage and management.
- Versatile Applications: Ideal for smart agriculture, smart cities, industrial IoT, and other long-range communication projects.
2. Specifications
2.1 General Specifications
| Feature | Detail |
|---|---|
| MCU | ESP32S3FH4R2 |
| Flash | 4MB |
| PSRAM | 2MB |
| Wireless Connectivity | 2.4Ghz Wi-Fi, Bluetooth 5.0 |
| Programming Platform | Arduino-IDE, Micropython |
| Onboard Functions | TF Card Slot, USB/3.7V Lipo Battery Power Supply, Battery Switch |
| Onboard Buttons | Reset, Boot |
| Dimensions (WxHxD) | 79*22mm (Board only), 66mm (L) x 27mm (W) x 15mm (H) (MVSRS version) |
2.2 Screen Specifications
| Feature | Detail | Feature | Detail |
|---|---|---|---|
| Type | OLED | Resolution | 128 x 64 |
| Driver | SSD1306 | Size | 0.96-inch Diagonal |
| Interface | I2C | I2C Interface Pins | SDA--IO18, SCL--IO17 |
| Text Color | White | Background Color | Blue |
2.3 Voice Communication Kitiver (MVSRS Version)
| Feature | Detail | Feature | Detail |
|---|---|---|---|
| Speaker | MAX98357A | Microphone | MSM261S4030H0R |
| Onboard Functions | Vibration Motor | USB Charging | 5V 500mA |
2.4 Low Power LoRa Transceiver
| LoRa Module | SX1280 | SX1276 | SX1262 |
|---|---|---|---|
| Frequency Bands | 2.4 Ghz | 868/915MHz | 868/915MHz |
| High-efficiency PA | +12dB | +14dBm | +22dBm/+15dBm |
| Low RX Current | 9.9mA | 9.9mA | 4.6mA |


2.5 LoRa Module Pin Assignments
| SX1262 PIN | SX1280 PIN | ||
|---|---|---|---|
| CS | IO7 | TX | IO10 |
| RST | IO8 | RX | IO21 |
| SCLK | IO5 | CS | IO7 |
| MOSI | IO6 | RST | IO8 |
| MISO | IO3 | SCLK | IO5 |
| DIO1 | IO33 | MOSI | IO6 |
| BUSY | IO34 | MISO | IO3 |
| DIO1 | IO9 | ||
| BUSY | IO3 | ||
3. Package Contents
Upon opening your LILYGO T3S3 package, please verify that all the following items are included:
- 1 x T3S3 Development Board
- 2 x 2.54mm Male PIN (1*13P)
- 1 x Battery Cable
- 1 x LoRa Antenna

4. Product Overview and Pinout Diagrams
Familiarize yourself with the layout and pin assignments of your LILYGO T3S3 board. This section provides detailed diagrams for various versions of the board.





Antenna Version Visuals:



5. Setup Instructions
- Connect the LoRa Antenna:
- For SMA Antenna versions, carefully screw the provided LoRa antenna onto the SMA connector on the board.
- For IPEX Antenna versions, connect the IPEX antenna cable to the corresponding IPEX connector on the board. Ensure a secure connection.
- Power Supply:
- USB Power: Connect the board to your computer using a Type-C USB cable. This will power the board and allow for programming.
- LiPo Battery Power: For portable applications, connect a 3.7V LiPo battery to the JST 1.25mm 2P connector. Ensure the battery switch is in the 'ON' position.
- TF Card Insertion (Optional): If your application requires data storage, gently insert a TF (microSD) card into the designated slot until it clicks into place.
- Development Environment Setup:
- Install the Arduino IDE or set up your Micropython environment on your computer.
- Add ESP32-S3 board support to your chosen IDE.
- Download the necessary libraries for LoRa communication (e.g., RadioLib) and any specific libraries for the T3S3 board from the official LILYGO GitHub repositories.
Refer to the official LILYGO GitHub repositories for detailed guides on setting up your development environment and example code:
- LILYGO LoRa Series GitHub
- T3-S3-MVSRBoard GitHub (for MVSRS version specific examples)
6. Operating Instructions
- Programming the Board:
- Connect the T3S3 board to your computer via USB.
- Select the correct board and COM port in your Arduino IDE or Micropython environment.
- Upload your compiled code to the board. Use the "Boot" button if necessary to enter programming mode (usually by holding "Boot" and pressing "Reset", then releasing "Reset" and then "Boot").
- LoRa Communication:
- Utilize the LoRa module (SX1280, SX1276, or SX1262) for long-range data transmission.
- Ensure your code configures the correct frequency band (2.4 GHz for SX1280; 868/915MHz for SX1276/SX1262) and LoRa parameters (spreading factor, bandwidth, coding rate).
- For SX1280 PA module, carefully control the output power as detailed in the "Warm Reminder" section to prevent damage.
- Wi-Fi and Bluetooth:
- The ESP32-S3 supports 2.4GHz Wi-Fi and Bluetooth 5.0. Use standard ESP-IDF or Arduino Wi-Fi/Bluetooth libraries to implement wireless connectivity in your projects.
- OLED Display:
- The onboard 0.96-inch SSD1306 OLED display (128x64 resolution) can be controlled via I2C (SDA on IO18, SCL on IO17). Use appropriate display libraries to show information.
- TF Card Usage:
- Access the TF card using standard SD card libraries in your programming environment for logging data or storing configuration files.
- MVSRS Version Specifics (Voice Communication Kit):
- This version includes a MAX98357A speaker, MSM261S4030H0R microphone, and a vibration motor.
- Refer to the
T3-S3-MVSRBoardGitHub repository for examples and libraries to implement voice communication and vibration feedback.
7. Maintenance
- Handling: Always handle the board by its edges to avoid touching sensitive components or static discharge.
- Storage: Store the board in an anti-static bag when not in use, in a dry environment away from direct sunlight and extreme temperatures.
- Cleaning: Use a soft, dry brush or compressed air to remove dust. Avoid using liquids or solvents.
- Firmware Updates: Regularly check the LILYGO GitHub repositories for firmware updates and bug fixes to ensure optimal performance and security.
8. Troubleshooting
8.1 Common Issues and Solutions:
- Board not powering on:
- Ensure the USB cable is securely connected and providing power, or that the LiPo battery is charged and the battery switch is ON.
- Check for any visible damage to the board or power connections.
- Upload errors during programming:
- Verify that the correct board type and COM port are selected in your IDE.
- Ensure all necessary drivers are installed.
- Try holding the "Boot" button while pressing and releasing "Reset" to put the board into bootloader mode before uploading.
- LoRa communication issues:
- Confirm the antenna is correctly attached and compatible with your board's frequency.
- Double-check LoRa parameters (frequency, spreading factor, bandwidth) in your code to match the receiver.
- SX1280 PA Module Output Power: When using the SX1280 PA module, it is critical to control the output power of the SX1280 chip between 2-5 dBm. Exceeding 5 dBm can damage the FEM chip. Setting it to 3 dBm will ensure a 20 dBm output power.
- OLED display not working:
- Check I2C connections (SDA to IO18, SCL to IO17) and ensure they are correct.
- Verify that the display library is correctly initialized and used in your code.
For more complex issues or specific error messages, please refer to the LILYGO GitHub repositories or community forums for assistance.
9. User Tips
- Antenna Selection: When using the IPEX connector for a WiFi antenna, no special switching is typically required; the board usually handles this automatically. However, always ensure the correct antenna type (SMA or IPEX) is used for the corresponding connector.
- Version Differences: Be aware that minor revisions (e.g., V1.0 vs V1.1) might have subtle differences in component placement or pin assignments. Always refer to the latest documentation on the LILYGO GitHub for your specific board version.
- Frequency Bands: While this board supports 2.4GHz LoRa and 868/915MHz, there is currently no 433MHz version available for this specific model. Ensure your project's frequency requirements match the board's capabilities.
- Power Management: When running on battery, optimize your code for low power consumption to extend battery life, especially for LoRa applications.
10. Warranty and Support
LILYGO is committed to providing high-quality open-source hardware. For technical assistance, documentation, and community support, please visit our official GitHub repositories:
- LILYGO GitHub Organization: https://github.com/Xinyuan-LilyGo
- T3S3 LoRa Series Repository: https://github.com/Xinyuan-LilyGO/LilyGo-LoRa-Series
- T3-S3-MVSRBoard Repository: https://github.com/Xinyuan-LilyGO/T3-S3-MVSRBoard
If you encounter any issues that cannot be resolved through the provided documentation or community support, you may contact LILYGO customer service. Please check the package and product upon receipt. If the package is damaged due to external force or transportation, or if you need to customize a product or have specific questions, feel free to contact customer service.

LILYGO also supports open-source projects. If you have developed a project using a LILYGO product, you can submit it for potential donation activities. More details can be found on the LILYGO website or GitHub.
