LILYGO T-Display-P4 get it now

概述

T-Display-P4 是一款基于 ESP32-P4 高性能核心的多功能开发板，专为复杂图形处理、多媒体交互与物联网应用设计。主要特点包括：

1. 高性能处理：搭载 ESP32-P4 处理器，支持复杂图形与视频任务处理。
2. 高清显示：配备 4.05 英寸 MIPI 接口屏幕（TFT 或 AMOLED 两个版本），支持触控。
3. 双核协同：板载 ESP32-C6 辅助处理器，支持 Wi-Fi 6 与蓝牙 5.3。
4. 丰富外设：集成扬声器、麦克风、线性振动马达、LoRa、GPS、摄像头、电池监测等模块。
5. 扩展性强：提供丰富 GPIO 接口，支持键盘扩展板（T-Display-P4-Keyboard）。

硬件注意事项

T-Display-P4 的 RST 按键复位的是 ESP32-P4 主控，并不是整板电源复位。板上的部分外设电源由 XL9535 等 IO 扩展器控制，单独复位 ESP32-P4 后，这些外设不一定会重新完成一次完整的断电上电流程。

如果设备开机后进入下载模式、无法正常启动，或按下 RST 后仍不能恢复，请先将电源开关关闭，等待板上电容放电后再重新开机。开机过程中不要按住 BOOT；BOOT 可能会让 ESP32-P4 进入下载模式，设备看起来会像没有正常启动。

USB-C 端口使用限制

T-Display-P4 底部有两个 USB-C 端口，但功能不同：

端口	用途	注意事项
右侧 P4.U	ESP32-P4 数据传输、固件烧录、串口终端	使用串口终端程序时请关闭 RTS / 硬件流控。RTS 线会触发 P4 复位，可能导致设备复位后卡死或无法正常运行。
左侧 USB-C	充电 / 供电	不用于数据传输或固件烧录。

LoRa 外置天线切换警告

在软件中将 LoRa 从内置天线切换到外置天线前，必须先将附带的偶极天线连接到 MMCX 1 接口。不要在未连接外置天线的情况下启用外置天线模式，否则可能损坏 SX1262 LoRa 芯片。

键盘扩展板安装注意事项

T-Display-P4-Keyboard 通过小尺寸子板和 Pogo Pin 与 P4 主机连接。安装前请先断电，并使用镊子、放大镜等工具辅助对位。安装时重点检查子板针脚是否垂直、是否弯曲、是否真正进入插座孔内，避免针脚滑到插座外侧。

如果屏幕出现 xl9555 init fail 或大量 init fail 初始化失败提示，通常应先检查键盘子板和侧边 QWIIC / 扩展接口是否对准并完全接触，再重新上电测试。

快速开始

示例支持

T-Display-P4 示例

示例	ESP-IDF	描述
afe	✓	音频前端
aw86224	✓	振动马达
bq27220	✓	电量监测
deep_sleep	✓	深度睡眠
es8311	✓	音频编解码器
l76k	✓	GPS 定位
lvgl_9_ui	✓	出厂示例
screen_camera	✓	摄像头屏幕显示
sx1262_lora_send_receive	✓	LoRa 收发
icm20948	✓	惯性传感器
pcf8563	✓	RTC 时钟
xiaozhi	✓	小智 AI

T-Display-P4-Keyboard 扩展板示例

示例	ESP-IDF	描述
radiolib_cc1101_send_receive	✓	CC1101 收发
radiolib_nrf24l01_send_receive	✓	NRF24L01 收发
st25r3916	✓	NFC 测试
tca8418	✓	键盘测试

ESP-IDF（VS Code）

1. 安装 Visual Studio Code，在扩展中搜索并安装 "ESP-IDF"。
2. 克隆仓库：

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

3. 下载安装 ESP-IDF v5.4.1，在扩展中选择 "USE EXISTING SETUP" 配置路径。
4. 在 "SDK 配置编辑器" 中搜索 "Select the example to build" 选择要编译的示例。
5. 选择设备目标 ESP32P4，构建并烧录。

开发平台

1. VS Code + ESP-IDF
2. Arduino IDE
3. Platform IO

视频

主要特点

T-Display-P4 主板：

• ESP32-P4：16 MB Flash，高性能处理器
• ESP32-C6-MINI-1U：4 MB PSRAM，Wi-Fi 6 + 蓝牙 5.3（SDIO 接口）
• 4.05" MIPI TFT（540×1168，HI8561）或 4.1" MIPI AMOLED（568×1232，RM69A10），10 点电容触控
• OV2710 MIPI 摄像头，ICM20948 六轴 IMU
• ES8311 音频编解码器 + NS4150B 功放 + 麦克风
• SX1262 LoRa 模块（HPD16A），L76K GPS，PCF8563 RTC
• AW86224AFCR 线性振动马达，BQ27220 电量监测，LGS4056H 充电管理
• XL9535 IO 扩展器

T-Display-P4-Keyboard 扩展板（可选）：

• TCA8418 键盘驱动，XL9555 IO 扩展
• T-MixRF 无线模块：CC1101 + NRF24L01 + ST25R3916 NFC

产品参数

组件	描述
MCU	ESP32-P4
Flash	16MB
协处理器	ESP32-C6-MINI-1U（4MB PSRAM）
屏幕（TFT版）	4.05 英寸 MIPI TFT (540×1168)，HI8561
屏幕（AMOLED版）	4.1 英寸 MIPI AMOLED (568×1232)，RM69A10
触摸	GT9895 / 兼容触控芯片，10 点电容触控
摄像头	OV2710 (MIPI)
IMU	ICM20948 (I²C)
LoRa	SX1262 (HPD16A, SPI)
GPS	L76K (UART)
RTC	PCF8563 (I²C)
音频	ES8311 + NS4150B + 麦克风
振动	AW86224AFCR (I²C)
充电	LGS4056H（支持 NTC 温度检测）
电量监测	BQ27220 (I²C)
IO 扩展	XL9535 (I²C)
无线	Wi-Fi 6 + 蓝牙 5.3（通过 ESP32-C6）
USB	2 × USB-C（右侧 P4.U 用于数据 / 烧录，左侧用于充电 / 供电）

引脚图

T-Display-P4 有 AMOLED、TFT 两个版本：

AMOLED 版本

TFT 版本

引脚定义请参考配置文件：

• t_display_p4_config.h
• t_display_p4_keyboard_config.h

尺寸图

原理图

• T-Display-P4 GitHub 仓库

数据手册

• ESP32-P4 Datasheet
• ESP32-C6-MINI-1U Datasheet
• SX1262 Datasheet
• ES8311 Datasheet
• ICM20948 Datasheet
• BQ27220 Datasheet
• L76K Datasheet
• PCF8563 Datasheet

软件开发

• T-Display-P4 GitHub 仓库

依赖库

• lvgl 8.3.9
• TFT_eSPI
• Arduino_GFX
• XPowersLib
• SensorLib
• TinyGPSPlus

常见问题

• Q. 看了教程还是不会搭建编程环境怎么办？
  A. 参考 LilyGo-Document 文档说明来搭建。

• Q. 为什么板子一直烧录失败？
  A. 请按住 "BOOT" 按键重新下载程序。

• Q. 使用出厂固件时找不到 GPS 定位？
  A. 确保设备在室外或信号良好处测试，并烧录最新固件。

• Q. 关机无法充电或续航严重缩水？
  A. 出厂固件最多使用 3-5 小时，未加入睡眠功能。参考睡眠示例添加深度睡眠。

• Q. OLED 屏幕出现波浪纹？
  A. 若低电量时波纹更明显，基本与电池相关；若电量充足仍出现，需检查屏幕供电回路。

• Q. 屏幕上出现很多 init fail 初始化失败提示？
  A. 通常是侧边 QWIIC / 扩展接口连接器或键盘子板没有插好导致外设初始化失败。请先断电，检查连接器是否完全插入、是否偏斜、Pogo Pin 是否对准插座孔、针脚是否弯曲或松动，再重新上电测试。

  

• Q. 使用外置 LoRa 天线时需要注意什么？
  A. 将 LoRa 设置切换到外置天线前，必须先把附带的偶极天线连接到 MMCX 1。未接外置天线时不要启用外置天线模式，否则可能损坏 SX1262 LoRa 芯片。

• Q. 两个 USB-C 端口都能烧录固件吗？
  A. 不能。右侧 P4.U 端口用于数据传输和固件烧录；左侧 USB-C 仅用于充电 / 供电。使用串口终端程序连接 P4.U 时，请关闭 RTS / 硬件流控。

• Q. 键盘测试应用中按键输出不对？
  A. 已知反馈：Shift + h 应输出逗号 ,，但部分键盘测试应用版本会输出撇号 '，且 ' 键位置异常。请更新到后续修正版本的键盘测试固件或应用。

• Q. ESP32-C6 无法连接 Wi-Fi？
  A. 请先按照快速开始中的 C6 烧录流程更新 ESP32-C6 协处理器固件，再将 ESP32-P4 主控刷回出厂固件或正常应用固件。如果最新固件仍无法连接 Wi-Fi，请记录 C6 固件版本、P4 固件版本和连接日志反馈。

• Q. 电量显示不准？
  A. 在固件中设置 set_design_capacity 参数为 1000mAh，然后完成满电→自然放电至关机→再充满电的循环，电量芯片会自动校准。

• Q. ESP-IDF 构建时报 LimitOverrunError？
  A. 这是 ESP-IDF v5.4~v5.5 的已知 bug，修改 esp-idf-v5.x\tools\idf_py_actions\tools.py 第 351 行，将 limit=1024 * 256 改为 limit=1024 * 512。

功耗测试

模式	电流
Deep Sleep	平均 1.2mA

版本历史

Version	Update date	Update description
T-Display-P4_V1.0	2025-06-13	初始版本
T-Display-P4-Keyboard_V1.0	2025-09-12	键盘扩展板初始版本