LILYGO T-Display-P4

Version History:

Purchase Links

Table of Contents

• Description
• Preview
• Modules
• Software Deployment
• Pin Overview
• Related Tests
• FAQ
• Projects

Description

T-Display-P4 is a multi-functional development board based on the ESP32-P4 high-performance core, designed for complex graphics processing, multimedia interaction, and IoT applications. Main features include:

1. High-Performance Processing: Equipped with ESP32-P4 processor, supports complex graphics and video task processing.
2. HD Display: Features a 4.05-inch MIPI interface screen with a resolution of 540×1168px, supporting touch.
3. Dual-Core Collaboration: Onboard ESP32-C6 auxiliary processor, supports Wi-Fi 6 and Bluetooth 5.3.
4. Rich Peripherals: Integrates speaker, microphone, linear vibration motor, LoRa, GPS, Ethernet, camera, battery monitoring, and other modules.
5. High Expandability: Provides abundant GPIO interfaces, supports keyboard expansion board (T-Display-P4-Keyboard).

Preview

Physical Image

Pin Diagram

T-Display-P4 has two versions: Amoled and TFT. Pin diagrams are as follows:

Amoled Version

TFT Version

Modules

T-Display-P4 Main Board

1. Core Processor

• Chip: ESP32-P4
• FLASH: 16MB
• Documentation: Espressif Official Documentation

2. Auxiliary Processor

• Module: ESP32-C6-MINI-1U
• Chip: ESP32-C6-FH4
• PSRAM: 4MB
• Communication Protocol: SDIO
• Documentation: ESP32-C6-MINI-1U Datasheet

3. Display and Touch

4. Audio Module

• DAC Chip: ES8311
• Amplifier Chip: NS4150B
• Microphone: Mic Head
• Communication Protocol: I2S
• Documentation: ES8311 , NS4150B

5. Vibration Motor

• Driver Chip: AW86224AFCR
• Communication Protocol: I2C
• Documentation: AW86224

6. LoRa Module

• Module: HPD16A
• Chip: SX1262
• Communication Protocol: SPI
• Documentation: SX1261-2

7. GPS Module

• Module: L76K
• Communication Protocol: UART
• Documentation: L76K

8. RTC Clock

• Chip: PCF8563
• Communication Protocol: I2C
• Documentation: PCF8563

9. Charging Management

• Chip: LGS4056H
• Description: Supports three-wire battery NTC temperature detection
• Documentation: LGS4056H

10. Battery Monitoring

• Chip: BQ27220
• Communication Protocol: I2C
• Documentation: BQ27220

11. Camera

• Model: OV2710 (MIPI interface)
• Documentation: OV2710

12. Inertial Sensor

• Chip: ICM20948
• Communication Protocol: I2C
• Documentation: ICM20948

13. IO Expansion

• Chip: XL9535
• Communication Protocol: I2C
• Documentation: XL9535

T-Display-P4-Keyboard Expansion Board

1. Keyboard Driver

• Chip: TCA8418
• Communication Protocol: I2C
• Documentation: TCA8418

2. Backlight Driver

• Chip: SY7200A
• Communication Protocol: PWM
• Documentation: SY7200A

3. IO Expansion

• Chip: XL9555
• Communication Protocol: I2C
• Documentation: XL9555

4. Wireless Module (T-MixRF)

Overview

Quick Start

Example Support

T-Display-P4 Examples

T-Display-P4-Keyboard Examples

ESP-IDF Visual Studio Code

1. Install Visual Studio Code, choose the installation according to your system type.

2. Open the "Extensions" in the sidebar of Visual Studio Code (or use Ctrl+Shift+X to open extensions), search for the "ESP-IDF" extension and install it.

3. While the extension is installing, use the git command to clone the repository:

    git clone --recursive https://github.com/Xinyuan-LilyGO/T-Display-P4.git
   
   

   You need to add "--recursive" when cloning. If not added during cloning, you need to initialize the submodules later:

    git submodule update --init --recursive
   
   

4. Download and install ESP-IDF v5.4.1, record the installation path, open the previously installed "ESP-IDF" extension and open "Configure ESP-IDF Extension", select the "USE EXISTING SETUP" menu, select the "Search ESP-IDF in system" field, correctly configure the previously recorded installation path:

   • ESP-IDF directory (IDF_PATH): Your installation path xxx\Espressif\frameworks\esp-idf-v5.4
   • ESP-IDF Tools directory (IDF_TOOLS_PATH): Your installation path xxx\Espressif

   Click the "install" button in the bottom right corner to install the framework.

5. Click the ESP-IDF extension menu "SDK Configuration Editor" in the bottom menu bar of Visual Studio Code, search for the "Select the example to build" field in the search bar, select the project you need to compile, then search for the "Select the camera type" field in the search bar, select the camera type onboard your board, and click Save.

6. Click "Set Espressif device target" in the bottom menu bar of Visual Studio Code, select ESP32P4, click "Build Project" in the bottom menu bar, wait for the build to complete, then click "Select port to use" in the bottom menu bar, then click "Flash Project" in the bottom menu bar to flash the program.

Firmware Downloads

Pin Overview

For pin definitions, please refer to the configuration files:

t_display_p4_config.h
t_display_p4_keyboard_config.h

Development Platforms

1. Micropython
2. Arduino IDE
3. Platform IO

Related Tests

Power Consumption

Camera

FAQ

• Q. I still don't know how to set up the programming environment after reading the above tutorial. What should I do?
• A. If you still don't understand how to set up the environment after reading the above tutorial, you can refer to the LilyGo-Document documentation for setup instructions.

• Q. Why does my board keep failing to upload programs?
• A. Please hold down the "BOOT" button and try uploading the program again.

• Q. Why do I fail when selecting the target compilation chip in the espidf framework or when configuring menuconfig in the SDK, reporting the following error:

    asyncio.exceptions.LimitOverrunError: Separator is found, but chunk is longer than limit
  
    ValueError: Separator is found, but chunk is longer than limit
  
  

• A. This is a bug in the espidf framework v5.4~v5.5. You need to modify line 351 of the file at path esp-idf-v5.x\tools\idf_py_actions\tools.py as follows:

    Original code:
    p = await asyncio.create_subprocess_exec(*cmd, env=env_copy, limit=1024 * 256, cwd=self.cwd, stdout=asyncio.subprocess.PIPE,stderr=asyncio.subprocess.PIPE)
    Modified code:
    p = await asyncio.create_subprocess_exec(*cmd, env=env_copy, limit=1024 * 512, cwd=self.cwd, stdout=asyncio.subprocess.PIPE,stderr=asyncio.subprocess.PIPE)
  
  
  

Projects

• T-Display S3 AMOLED Plus

Resources

• ESP32-S3 Datasheet
• LR1121 Datasheet
• (More resources please refer to GitHub repository)

Dependent Libraries

• lvgl 8.3.9
• AceButton
• TFT_eSPI
• Arduino_GFX
• XPowersLib
• SensorLib
• TinyGPSPlus
• Arduino_NeoPixel
• OneWire
• SparkFun MAX3010x Pulse and Proximity Sensor Library