LILYGO T5 E-Paper

版本迭代:

购买链接

目录

• 描述
• 版本差异
• 预览
• 模块
• 快速开始
• 引脚总览
• 相关测试
• 常见问题
• 项目
• 资料
• 依赖库

描述

LILYGO T5-4.7-S3 系列是基于 ESP32-S3-WROOM-1-N16R8 芯片（内置 8MB PSRAM 和 16MB Flash）的 4.7 英寸电子墨水屏（E-Paper）开发方案，分为 Pro 版 和 Lite 版 两个型号：

Pro 版

集成电容式触摸功能（支持两点触控），配备 PCF8563 实时时钟芯片，Type-C USB 接口以及 Li-Po 电池接口（JST-PH 2.0mm），支持电池电压监测（Bat ADC）。提供兼容树莓派 40-PIN 的 GPIO 扩展接口，板载 TF 卡槽，具备专用的屏幕驱动信号（STV/LE）和 SPI 接口（CS/SCLK/MOSI/MISO），采用 2.5D 弧面设计，适合全功能低功耗墨水屏应用开发。

Lite 版

专为低成本墨水屏应用优化，移除了 GPS 与 LoRa 模块，大幅降低硬件成本，更适合电子书、墨水屏相册、气象站等纯显示类应用开发。核心升级：

• 屏幕玻璃采用 AG 防眩光工艺，户外可视性大幅提升
• 背光改为 暖色调，长时间阅读更护眼
• 保留 ESP32-S3 核心性能、电子墨水屏、触控、RTC 等核心功能

版本差异

预览

实物图

引脚图

产品信息图

模块

MCU

• 芯片：ESP32-S3-WROOM-1-N16R8
• PSRAM：8MB
• FLASH：16MB
• 无线：Wi-Fi 802.11 b/g/n; Bluetooth 5.0 (BLE)
• 其他说明：更多资料请访问乐鑫官方ESP32-S3数据手册

电子墨水屏

• 型号：EDO47TC1
• 尺寸：4.7英寸
• 分辨率：540×960像素
• 类型：低功耗电子墨水屏
• 接口：SPI + 专用驱动信号（STV/LE）
• Lite 版升级：AG 防眩光玻璃 + 暖色调背光

触摸屏

• 芯片：GT911
• 类型：电容式触摸屏
• 支持：两点触控
• 接口：I²C

实时时钟

• 芯片：PCF8563
• 功能：实时时钟，时间保持
• 接口：I²C

电源管理

• 电池接口：JST-PH 2.0mm Li-Po电池接口
• 电压监测：电池电压ADC监测
• USB供电：Type-C接口

概述

快速开始

示例支持

examples/
├── button              ; Keystroke example
├── demo                ; Comprehensive test example including sleep current test
├── drawExample         ; Simple examples of drawing lines and circles
├── drawImages          ; Show image example
├── grayscale_test      ; Grayscale example
├── screen_repair       ; Full screen refresh example
├── spi_driver          ; Display as slave device
├── touch               ; Touch example
└── wifi_sync           ; WiFi Comprehensive Example

PlatformIO

1. 安装VisualStudioCode，根据你的系统类型选择安装。
2. 打开VisualStudioCode软件侧边栏的"扩展"（或者使用Ctrl+Shift+X打开扩展），搜索"PlatformIO IDE"扩展并下载。
3. 在安装扩展的期间，你可以前往GitHub下载程序，你可以通过点击带绿色字样的"<> Code"下载主分支程序，也通过侧边栏下载"Releases"版本程序。
4. 扩展安装完成后，打开侧边栏的资源管理器（或者使用Ctrl+Shift+E打开），点击"打开文件夹"，找到刚刚你下载的项目代码（整个文件夹），点击"添加"，此时项目文件就添加到你的工作区了。
5. 打开项目文件中的"platformio.ini"（添加文件夹成功后PlatformIO会自动打开对应文件夹的"platformio.ini"）,在"[platformio]"目录下取消注释选择你需要烧录的示例程序（以"default_envs = xxx"为标头），然后点击左下角的"√"进行编译，如果编译无误，将单片机连接电脑，点击左下角"→"即可进行烧录。

Arduino

1. 安装Arduino，根据你的系统类型选择安装。
2. 打开项目文件夹的"example"目录，选择示例项目文件夹，打开以".ino"结尾的文件即可打开Arduino IDE项目工作区。
3. 打开右上角"工具"菜单栏->选择"开发板"->"开发板管理器"，找到或者搜索"esp32"，下载作者名为"Espressif Systems"的开发板文件。接着返回"开发板"菜单栏，选择"ESP32 Arduino"开发板下的开发板类型。
4. 打开菜单栏"文件"->"首选项"，找到"项目文件夹位置"这一栏，将项目目录下的"libraries"文件夹里的所有库文件连带文件夹复制粘贴到这个目录下的"libraries"里边。
5. 在"工具"菜单中选择正确的设置，如下表所示。

ESP32-S3

6. 选择正确的端口。
7. 点击右上角"√"进行编译，如果编译无误，将单片机连接电脑，点击右上角"→"即可进行烧录。

开发平台

1. ESP-IDF
2. Arduino IDE
3. VS Code
4. Micropython

引脚总览

• 标有 ✅ 的 GPIO 可以自由使用。GPIO10 可用于模拟输入，但不能用于其他用途。
• SD 引脚 如果您不使用 SD 卡，这些 GPIO（16、15、11、42）可以自由使用。
• 由于设计中 RTC_GPIO 未连接到触摸中断，ESP 无法通过触摸中断唤醒。不过，可以将 GPIO10 连接到 GPIO47 以实现触摸唤醒功能。详情请见此处 issues/93

相关测试

常见问题

• Q. 看了以上教程我还是不会搭建编程环境怎么办？
  A. 如果看了以上教程还不懂如何搭建环境的可以参考LilyGo-Document文档说明来搭建。

• Q. 为什么打开Arduino IDE时他会提醒我是否要升级库文件？我应该升级还是不升级？
  A. 选择不升级库文件，不同版本的库文件可能不会相互兼容所以不建议升级库文件。

• Q. 电子墨水屏的刷新率如何？
  A. 电子墨水屏具有极低的功耗特性，但刷新率相对较低，适合显示静态或更新不频繁的内容。

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

• Q. Lite 版和 Pro 版的代码可以通用吗？
  A. 核心显示、触控、RTC 等功能代码完全通用；

• Q. 为什么我的板子一直烧录失败呢？
  A. AG 防眩光玻璃可大幅减少屏幕反光，户外阳光下可视性提升明显；暖色调背光更接近纸质书观感，长时间阅读更护眼，适合电子书、阅读器类应用。

项目

• T5-ePaper-S3-V2.4

资料

• ESP32-S3 Datasheet
• ED047TC1 Screen Datasheet

依赖库

• Button2
• SensorLib@0.19
• GxEPD2
• Adafruit_GFX