1. Introduction
The LILYGO T5-4.7-S3 is a versatile development board designed for a wide range of applications, from low-power sensor networks to demanding tasks requiring efficient power usage and compact design. It can operate independently and is manufactured by Shenzhen Xin Yuan Electronic Technology Co., Ltd.
At its core, the module features an ESP32-S3 MCU, which supports Wi-Fi (2.4 GHz band) and Bluetooth 5.0 communication protocols. The board integrates a 4.7-inch e-paper display and includes TF Card features for expanded functionality. LILYGO provides the necessary hardware and software resources, including a software development framework, to facilitate rapid development of Internet-of-Things (IoT) applications.


2. Setup
2.1. Preparation
To develop applications for the ESP32-S3, you will need the following:
- A PC running Windows, Linux, or macOS. Windows 10 is recommended for illustration purposes.
- A toolchain to build applications for ESP32-S3.
- Arduino IDE, which provides the API for ESP32-S3 and scripts to operate the toolchain.
- CH9102 serial port driver.
- The ESP32-S3 board itself and a USB cable to connect it to your PC.
2.2. Download and Install Arduino Software
The Arduino Software (IDE) is essential for programming the T5-4.7-S3 board. Follow these steps:
- **Download Arduino IDE**: Visit the official Arduino website for the latest version.
- **Install Prerequisites**: Ensure all necessary drivers and dependencies are installed.
- **Install Arduino Software**: Run the installer. During installation, ensure you select to install the Arduino software, USB driver, and create desktop/start menu shortcuts.
2.3. Download and Configure Git
Git is required for cloning the ESP32 Arduino core. Download the Git installation package (Git.exe) from the official Git website.
2.4. Cloning a Remote Repository
Open a terminal or Git Bash and execute the following commands to set up the ESP32 Arduino core:
$ mkdir espressif
$ cd espressif
$ git clone --recursive https://github.com/espressif/arduino-esp32.git esp322.5. Connect the Board
Connect your ESP32-S3 board to your PC using a USB cable. Verify that the board is recognized under a serial port and that serial communication is functional.

3. Operating Instructions
3.1. Test Demo
To test basic functionality, you can use the WiFiScan example in the Arduino IDE:
- Open Arduino IDE.
- Go to `File` > `Examples` > `WiFi` > `WiFiScan`.
3.2. Upload Sketch
To upload your code to the board:
- In Arduino IDE, go to `Tools` > `Board` > Select `ESP32S3 Dev Module`.
- Go to `Sketch` > `Upload`.
3.3. Serial Monitor
To view serial output from your board:
- In Arduino IDE, go to `Tools` > `Serial Monitor`.
- Ensure the baud rate matches your sketch (e.g., 115200 baud).
3.4. SSC Command Reference (Serial Shell Commands)
The module supports various serial shell commands for testing and configuration:
3.4.1. op Command
Used to set and query the Wi-Fi mode of the system.
- Example Query:
op -Q - Example Set:
op -S -o wmode
| Parameter | Description |
|---|---|
| -Q | Query Wi-Fi mode. |
| -S | Set Wi-Fi mode. |
| wmode | Defines Wi-Fi mode:
|
3.4.2. sta Command
Used to scan the STA network interface, connect or disconnect from an Access Point (AP), and query the connection status.
- Example Scan:
sta -S [-s ssid] [-b bssid] [-n channel] [-h] - Example Query Status:
sta -Q - Example Connect:
sta -C [-s ssid] [-p password] - Example Disconnect:
sta -D
| Parameter | Description |
|---|---|
| -S scan | Scan Access Points. |
| -s ssid | Scan or connect Access Points with the specified SSID. |
| -b bssid | Scan the Access Points with the specified BSSID. |
| -n channel | Scan the specified channel. |
| -h | Show scan results with hidden SSID Access Points. |
| -Q | Show STA connection status. |
| -D | Disconnect from current Access Points. |
3.4.3. ap Command
Used to set the parameters of the AP network interface.
- Example Set:
ap -S [-s ssid] [-p password] [-t encrypt] [-n channel] [-h] [-m max_sta] - Example Query:
ap -Q - Example List Parameters:
ap -L
| Parameter | Description |
|---|---|
| -S | Set AP mode. |
| -s ssid | Set AP SSID. |
| -p password | Set AP password. |
| -t encrypt | Set AP encryption mode. |
| -h | Hide SSID. |
| -m max_sta | Set AP max connections. |
| -Q | Show AP parameters. |
| -L | Show MAC Address and IP Address of connected stations. |
3.4.4. mac Command
Used to query the MAC address of the network interface.
- Example Query:
mac -Q [-o mode]
| Parameter | Description |
|---|---|
| -Q | Show MAC address. |
| -o mode | Defines MAC address mode:
|
3.4.5. dhcp Command
Used to enable or disable the DHCP server/client.
- Example Start DHCP:
dhcp -S [-o mode] - Example End DHCP:
dhcp -E [-o mode] - Example Query Status:
dhcp -Q [-o mode]
| Parameter | Description |
|---|---|
| -S | Start DHCP (Client/Server). |
| -E | End DHCP (Client/Server). |
| -Q | Show DHCP status. |
| -o mode | Defines DHCP mode:
|
3.4.6. ip Command
Used to set and query the IP address of the network interface.
- Example Query:
ip -Q [-o mode] - Example Set:
ip -S [-i ip] [-o mode] [-m mask] [-g gateway]
| Parameter | Description |
|---|---|
| -Q | Show IP address. |
| -o mode | Defines IP address mode:
|
| -S | Set IP address. |
| -i ip | IP address. |
| -m mask | Subnet address mask. |
| -g gateway | Default gateway. |
3.4.7. reboot Command
Used to reboot the board.
- Example:
reboot
3.4.8. ram Command
Used to query the size of the remaining heap in the system.
- Example:
ram
4. Maintenance
To ensure optimal performance and longevity of your LILYGO T5-4.7-S3 board, consider the following maintenance tips:
- Keep the firmware updated to the latest stable versions from official LILYGO repositories or trusted community sources.
- Handle the board with care, especially the e-paper display, to avoid physical damage.
- Store the board in a dry, dust-free environment.
5. Troubleshooting
5.1. General Issues
- Interference: If you experience harmful interference, try reorienting or relocating the receiving antenna, increasing the separation between the equipment and receiver, or connecting the equipment to an outlet on a different circuit. Consult a dealer or an experienced radio/TV technician for help if needed.
- Software Compatibility: Some users have reported issues compiling with the latest versions of ESPHome. If you encounter similar problems, consider using slightly older, proven versions of development tools or consulting community forums for compatible configurations.
- Fragile Screen Connection: The screen is connected to the board via tape, which can be fragile. Handle the device with care to prevent damage to this connection.
5.2. FCC Compliance
This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Any changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment. This equipment should be installed and operated with a minimum distance of 20cm between the radiator and your body.
6. Specifications
| Feature | Detail |
|---|---|
| Model Number | T5 4.7 Inch E-paper V2.3 |
| Brand Name | LILYGO |
| Origin | Mainland China |
| Chipset | ESP32-S3-WROOM-1-N16R8 |
| Wireless Connectivity | Wi-Fi (2.4 GHz), Bluetooth V5.0 |
| Programming Environment | Arduino-IDE, VS Code |
| Onboard Flash | 16MB |
| Onboard PSRAM | 8MB |
| Real-Time Clock (RTC) | Support PCF8563 RTC |
| Battery Support | Li-Po Battery (JST-PH 2.0mm connector), Battery capacity detection |
| Display Type | E-paper |
| Screen Size | 4.7 inch |
| Driver IC | ED047TC1 |
| Gray Levels | 16 |
| Resolution | 540 x 960 pixels |
| Viewing Angle | Ultra wide |
| Power Consumption | Low |
| Dimensions (WxHxD) | 64mm x 119mm (4.7 inch screen) |
| Compatible with | Raspberry Pi Bus interface |
| Support | TF Card |
| Package Dimensions | 13cm (L) x 7cm (W) x 3cm (H) |
| Package Weight | 0.12 kg |
| Version Optional | Without Touch / With Touch Glass |



7. User Tips
- Pre-loaded Test Firmware: The board often comes with pre-loaded test firmware. Power it on first to verify basic functions like the display and touch (if applicable) are working before diving into custom code. This can save significant debugging time.
- Community Resources: While official projects might become outdated, the ESP32 community is very active. Look for other users' repositories and projects for updated examples and solutions.
- Battery Connector: The board uses a JST-PH 2.0mm connector for Li-Po batteries. Ensure your battery is compatible.
- Touch Screen Option: Remember that the T5 4.7 Inch E-paper V2.3 comes in both 'Without Touch' and 'With Touch Glass' versions. Confirm which version you have for appropriate software development.
8. Warranty and Support
8.1. Customer Service
If you have any questions or encounter issues with your product, please contact LILYGO customer service. They are available to provide satisfactory solutions for product-related inquiries.
8.2. Documentation and Resources
- Official User Manual (PDF): A detailed user manual is available in PDF format for further reference: LILYGO T5-4.7-S3 User Guide (PDF)
- GitHub Repositories: Access official code examples and 3D printing files for the board:
- LilyGo-EPD47
- LilyGo-EPD-4-7-OWM-Weather-Display
- 3D Printing Files: LilyGo-EPD47 3D Files
- YouTube Resources: For visual guides and demonstrations, you may find helpful videos on YouTube. Search for 'LILYGO T5 4.7 E-paper' or similar terms.