Skip to content

Xinyuan-LilyGO/T-Display-P4

Repository files navigation

T-Display-P4

English | 中文

VersionIteration:

Version Update date Update description
T-Display-P4_V1.0 2025-06-13 Original version

PurchaseLink

Product SOC FLASH PSRAM Link
T-Display-P4_V1.0 NULL NULL NULL NULL

Directory

Describe

The T-Display-P4 is a versatile development board based on the ESP32-P4 core. Its features include:

  1. High Processing Power: Equipped with the high-performance ESP32-P4 core processor, it can handle more complex graphics and video tasks, delivering smoother display performance.
  2. Low Power Design: Offers multiple selectable power modes to effectively reduce energy consumption and extend battery life.
  3. High-Resolution Display: Supports high resolution (default with a large MIPI interface screen at 540x1168px), providing sharp and clear visuals.
  4. Rich Peripheral Support: Onboard peripherals include an HD MIPI touchscreen, ESP32-C6 module, speaker, microphone, LoRa module, GPS module, Ethernet, a linear vibration motor, an independent battery gauge for monitoring battery health and percentage, and an MIPI camera. Multiple GPIOs of both the ESP32-P4 and ESP32-C6 are exposed, enhancing the device's expandability.

Preview

Beta version test images


Actual Product Image

Module

1. Core Processor

  • Chip: ESP32-P4
  • FLASH: 16M
  • Related Documents:

    Espressif

2. Auxiliary Processor

3. Display & Touch

Model: H0405S002T002-V0

  • Display Size (Diagonal): 4.05 inch
  • LCD Type: α-Si TFT
  • Resolution: 540(H) Ă— 1168(V) px
  • Active Area: 41.9904(H) Ă— 91.1040(V) mm
  • Module Dimensions: 44(H) Ă— 95.5(V) Ă— 1.46(T) mm
  • Display Colors: 16.7M
  • Display Interface: MIPI
  • Touch Interface: IIC
  • Display & Touch Driver IC: HI8561
  • Maximum touch points: 10-point touch
  • Luminance on surface: 550 cd/m²
  • View Direction: All
  • Contrast ratio: 1200:1
  • Color gamut: 70%
  • PPI: 326
  • Window effect: No all-black
  • Cover plate surface effect: No AF/AG
  • Operating Temperature: -20~70 ÂşC
  • Storage Temperature: -30~80 ÂşC
  • Related Documents:

    H0405S002T002-V0
    HI8561

Model: H0410S001AMT001-V0

  • Display Size (Diagonal): 4.1 inch
  • LCD Type: α-Si AMOLED
  • Resolution: 568(H) Ă— 1232(V) px
  • Active Area: 43.55(H) Ă— 94.47(V) mm
  • Module Dimensions: 45.6(H) Ă— 97.22(V) Ă— 0.7(T) mm
  • Display Colors: 16.7M
  • Display Interface: MIPI
  • Touch Interface: IIC
  • Display Driver IC: RM69A10
  • Touch Driver IC: GT9895
  • Maximum touch points: 10-point touch
  • Luminance on surface: 500 cd/m²
  • View Direction: All
  • Contrast ratio: 20000:1
  • Color gamut: 100%
  • PPI: 190
  • Window effect: No all-black
  • Cover plate surface effect: No AF/AG
  • Operating Temperature: -20~70 ÂşC
  • Storage Temperature: -30~80 ÂşC
  • Related Documents:

    H0410S001AMT001-V0
    RM69A10
    GT9895

4. Speaker & Microphone

  • DAC Chip: ES8311
  • Amplifier Chip: NS4150B
  • Microphone: Electret Condenser Mic
  • Communication Protocol: IIS
  • Related Documents:

    ES8311
    NS4150B

  • Dependent Libraries:

    cpp_bus_driver

5. Vibration

  • Driver IC: AW86224AFCR
  • Communication Protocol: IIC
  • Related Documents:

    AW86224

  • Dependent Libraries:

    cpp_bus_driver

6. LoRa

7. GPS

  • Module: L76K
  • Communication Protocol: Uart
  • Related Documents:

    L76K

  • Dependent Libraries:

    cpp_bus_driver

8. RTC

  • Chip: PCF8563
  • Communication Protocol: IIC
  • Related Documents:

    PCF8563

  • Dependent Libraries:

    cpp_bus_driver

9. Charging IC

  • Chip: LGS4056H
  • Additional Notes: The NTC pin of the 3-wire battery is connected to the LGS4056H charging IC. Over-temperature protection during charging is automatically controlled by the chip.
  • Related Documents:

    LGS4056H

10. Battery Gauge

  • Chip: BQ27220
  • Communication Protocol: IIC
  • Related Documents:

    BQ27220

  • Dependent Libraries:

    cpp_bus_driver

11. Camera

Model: OV2710

  • Interface: MIPI
  • Related Documents:

    OV2710

12. IMU

SoftwareDeployment

Examples Support

example [vscode][esp-idf-v5.4.0] description picture
aw86224

alt text

bq27220

alt text

deep_sleep

alt text

es8311

alt text

es8311_sd_wav

alt text

esp32c6_at_host_sdio_uart

alt text

esp32c6_at_host_sdio_wifi

alt text

screen_camera

alt text

screen_lvgl

alt text

screen_lvgl_touch_draw

alt text

icm20948

alt text

iic_scan

alt text

l76k

alt text

lvgl_9_ui

alt text

factory example
pcf8563

alt text

sgm38121

alt text

sx1262_gfsk_send_receive

alt text

sx1262_lora_send_receive

alt text

sx1262_tx_continuous_wave

alt text

tusb_serial_device

alt text

xl9535

alt text

afe

alt text

firmware description picture
lvgl_9_ui factory program
esp32c6_at esp32c6-at factory program

ESP-IDF Visual Studio Code

  1. Install Visual Studio Code by selecting the appropriate version for your operating system.

  2. Open the "Extensions" sidebar in 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  
    

    Ensure you include the --recursive flag during cloning. If you forget to include it, you will need to initialize the submodules later by running:

     git submodule update --init --recursive  
    
  4. Download and install ESP-IDF v5.4.1. Take note of the installation path. Open the previously installed "ESP-IDF" extension and select "Configure ESP-IDF Extension." Choose the "USE EXISTING SETUP" menu, then select "Search ESP-IDF in system." Correctly configure the installation path you noted earlier:

    • Enter ESP-IDF directory (IDF_PATH): Your installation path xxx\Espressif\frameworks\esp-idf-v5.4
    • Enter ESP-IDF Tools directory (IDF_TOOLS_PATH): Your installation path xxx\Espressif
      Click the "Install" button at the bottom right to proceed with the framework installation.
  5. Click the "SDK Configuration Editor" in the ESP-IDF extension menu at the bottom of Visual Studio Code. In the search bar, look for the field "Select the example to build" and choose the project you want to compile. Then, search for "Select the camera type" and select the camera model integrated on your board. Save the settings.

  6. Click "Set Espressif Device Target" in the bottom menu bar of Visual Studio Code and select ESP32P4. Next, click "Build Project" in the bottom menu bar and wait for the build to complete. Then, click "Select Port to Use," followed by "Flash Project" to upload the program.

example

firmware download

  1. Open the project file "tools" and locate the ESP32 burning tool. Open it.

  2. Select the correct burning chip and burning method, then click "OK." As shown in the picture, follow steps 1->2->3->4->5 to burn the program. If the burning is not successful, press and hold the "BOOT-0" button and then download and burn again.

  3. Burn the file in the root directory of the project file "firmware" file,There is a description of the firmware file version inside, just choose the appropriate version to download.

example example

PinOverview

For pin definitions, please refer to the configuration file: t_display_p4_config.h

RelatedTests

Power Consumption

firmware program description picture
deep_sleep(single_board) deep_sleep Average current consumption: 1.2mA. For more details, please refer to the Power Consumption Test Log.

Camera

program description picture
uvc_sc2336 Original image and screenshot effect of taking a picture on the screen.

example

uvc_ov2710 Original image and screenshot effect of taking a picture on the screen.

example

FAQ

  • Q. After reading the above tutorials, I still don't know how to build a programming environment. What should I do?
  • A. If you still don't understand how to build an environment after reading the above tutorials, you can refer to the LilyGo-Document document instructions to build it.

  • Q. Why is my board continuously failing to download the program?
  • A. Please hold down the "BOOT-0" button and try downloading the program again.

Project

About

The T-Display-P4 is a versatile development board based on the ESP32-P4 core.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages