LILYGO T5 4.7 Inch E-paper V2.3

Contents

LILYGO T5 4.7 Inch E-paper V2.3 ESP32-S3 Development Driver Board User Manual

Model: T5 4.7 Inch E-paper V2.3

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.

LILYGO T5-S3 4.7 inch E-paper board with display showing weather data
LILYGO T5-S3 4.7 inch E-paper board with display showing weather data.
Top and bottom view of the LILYGO T5-S3 4.7 inch E-paper board
Top and bottom view of the LILYGO T5-S3 4.7 inch E-paper board.

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:

  1. **Download Arduino IDE**: Visit the official Arduino website for the latest version.
  2. **Install Prerequisites**: Ensure all necessary drivers and dependencies are installed.
  3. **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 esp32

2.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.

LILYGO T5-S3 4.7 inch E-paper board with components labeled
LILYGO T5-S3 4.7 inch E-paper board with key components labeled.

3. Operating Instructions

3.1. Test Demo

To test basic functionality, you can use the WiFiScan example in the Arduino IDE:

  1. Open Arduino IDE.
  2. Go to `File` > `Examples` > `WiFi` > `WiFiScan`.

3.2. Upload Sketch

To upload your code to the board:

  1. In Arduino IDE, go to `Tools` > `Board` > Select `ESP32S3 Dev Module`.
  2. Go to `Sketch` > `Upload`.

3.3. Serial Monitor

To view serial output from your board:

  1. In Arduino IDE, go to `Tools` > `Serial Monitor`.
  2. 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
Table: op Command Parameters
ParameterDescription
-QQuery Wi-Fi mode.
-SSet Wi-Fi mode.
wmodeDefines Wi-Fi mode:
  • 1: STA mode
  • 2: AP mode
  • 3: STA+AP 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
Table: sta Command Parameters
ParameterDescription
-S scanScan Access Points.
-s ssidScan or connect Access Points with the specified SSID.
-b bssidScan the Access Points with the specified BSSID.
-n channelScan the specified channel.
-hShow scan results with hidden SSID Access Points.
-QShow STA connection status.
-DDisconnect 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
Table: ap Command Parameters
ParameterDescription
-SSet AP mode.
-s ssidSet AP SSID.
-p passwordSet AP password.
-t encryptSet AP encryption mode.
-hHide SSID.
-m max_staSet AP max connections.
-QShow AP parameters.
-LShow 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]
Table: mac Command Parameters
ParameterDescription
-QShow MAC address.
-o modeDefines MAC address mode:
  • 1: MAC address in STA mode.
  • 2: MAC address in AP 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]
Table: dhcp Command Parameters
ParameterDescription
-SStart DHCP (Client/Server).
-EEnd DHCP (Client/Server).
-QShow DHCP status.
-o modeDefines DHCP mode:
  • 1: DHCP client of STA interface.
  • 2: DHCP server of AP interface.
  • 3: Both.

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]
Table: ip Command Parameters
ParameterDescription
-QShow IP address.
-o modeDefines IP address mode:
  • 1: IP address of interface STA.
  • 2: IP address of interface AP.
  • 3: Both.
-SSet IP address.
-i ipIP address.
-m maskSubnet address mask.
-g gatewayDefault 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

Table: LILYGO T5 4.7 Inch E-paper V2.3 Specifications
FeatureDetail
Model NumberT5 4.7 Inch E-paper V2.3
Brand NameLILYGO
OriginMainland China
ChipsetESP32-S3-WROOM-1-N16R8
Wireless ConnectivityWi-Fi (2.4 GHz), Bluetooth V5.0
Programming EnvironmentArduino-IDE, VS Code
Onboard Flash16MB
Onboard PSRAM8MB
Real-Time Clock (RTC)Support PCF8563 RTC
Battery SupportLi-Po Battery (JST-PH 2.0mm connector), Battery capacity detection
Display TypeE-paper
Screen Size4.7 inch
Driver ICED047TC1
Gray Levels16
Resolution540 x 960 pixels
Viewing AngleUltra wide
Power ConsumptionLow
Dimensions (WxHxD)64mm x 119mm (4.7 inch screen)
Compatible withRaspberry Pi Bus interface
SupportTF Card
Package Dimensions13cm (L) x 7cm (W) x 3cm (H)
Package Weight0.12 kg
Version OptionalWithout Touch / With Touch Glass
LILYGO T5-4.7-S3 E-Paper Board Pinmap
LILYGO T5-4.7-S3 E-Paper Board Pinmap (Non-Touch Version).
LILYGO T5-4.7-S3 Capacitive Touch Version E-Paper Board Pinmap
LILYGO T5-4.7-S3 Capacitive Touch Version E-Paper Board Pinmap.
Detailed specifications for LILYGO T5-4.7-S3 Capacitive Touch
Detailed specifications for LILYGO T5-4.7-S3 Capacitive Touch.

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

Ask a question about this manual

Ask about setup, troubleshooting, compatibility, parts, safety, or missing instructions. Manuals+ will review the question and use this page’s manual context to help answer it.

After a successful submission, we securely hash the supplied account or form email before sending it to Microsoft Advertising for conversion attribution. Privacy details.