T-Display S3 AMOLED 1.64 快速开始

依赖库

在编译之前，请通过 Arduino IDE 库管理器安装以下库，或将 libraries/ 目录中的文件夹复制到 Arduino 库目录：

库名	版本	来源
Arduino_GFX	1.3.7	GitHub
Arduino_DriveBus	1.1.16	GitHub
JPEGDEC	1.2.8	GitHub
LVGL	8.3.5	GitHub
SensorLib	0.2.x	GitHub

注意： 请使用上方指定版本，更新版本可能导致兼容性问题。

Arduino

Arduino IDE

1. 安装 ESP32 开发板支持

打开 Arduino IDE → 文件 → 首选项

在「附加开发板管理器网址」中添加：

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

前往工具 → 开发板 → 开发板管理器，搜索 esp32，安装 esp32 by Espressif Systems

2. 安装依赖库

将项目 libraries/ 目录中的所有文件夹复制到 Arduino 库目录（例如 C:\Users\YourName\Documents\Arduino\libraries）。

3. 开发板设置

设置项	值
开发板	ESP32S3 Dev Module
端口	你的 COM 口
USB CDC On Boot	Enabled
USB Mode	Hardware CDC and JTAG
USB Firmware MSC On Boot	Disabled
USB DFU On Boot	Disabled
CPU Frequency	240 MHz (WiFi)
Flash Mode	QIO 80 MHz
Flash Size	16 MB (128Mb)
Partition Scheme	16M Flash (3 MB APP / 9.9 MB FATFS)
PSRAM	OPI PSRAM
Upload Speed	921600

提示： 使用电池供电时，请将 USB CDC On Boot 设为 Disabled。

4. 上传

通过 USB-C 连接开发板
打开示例程序
点击「上传」

如果上传失败，按住 BOOT 按钮后重试。

PlatformIO

1. 环境配置

安装 Visual Studio Code 和 PlatformIO IDE 扩展

克隆仓库：

bash

git clone https://github.com/Xinyuan-LilyGO/T-Display-S3-AMOLED-1.43-1.75.git

在 VS Code 中打开克隆的文件夹

2. 选择示例

打开 platformio.ini，取消注释你想运行的 src_dir 行，确保同时只有一行生效。

3. 编译与上传

点击 ✓ 编译
通过 USB-C 连接开发板
点击 → 上传

示例程序

示例	说明
`GFX`	图形库演示
`FT3168`	电容触摸示例
`SY6970`	电源管理示例
`PCF8563`	RTC 示例
`Light_Sleep_Wake_Up`	轻睡眠唤醒
`Deep_Sleep_Wake_Up`	深度睡眠唤醒
`SD`	SD 卡读写
`lvgl_benchmark`	LVGL 性能测试
`screen_touch_lvgl_9`	LVGL 9 触摸示例（ESP-IDF）

外设示例

Hello World（Arduino_GFX）

cpp

#include <Arduino_GFX_Library.h>
#include <Arduino_DriveBus_Library.h>

extern Arduino_GFX *gfx;

void setup() {
    gfx->begin();
    gfx->fillScreen(BLACK);
    gfx->setTextColor(WHITE);
    gfx->setTextSize(2);
    gfx->setCursor(40, 200);
    gfx->println("Hello 1.64!");
}

void loop() {}

完整的板级初始化流程请打开仓库 T-Display-S3-AMOLED-1.43-1.75 中的 GFX 示例。

绘制图形

cpp

gfx->fillCircle(140, 228, 80, BLUE);
gfx->drawRect(60, 148, 160, 160, GREEN);
gfx->fillTriangle(140, 80, 60, 380, 220, 380, RED);

触摸输入（FT3168）

cpp

#include <SensorLib.h>

SensorFT3168 touch;

void setup() {
    touch.begin(Wire, FT3168_SLAVE_ADDRESS, TOUCH_SDA, TOUCH_SCL);
}

void loop() {
    if (touch.isAvailable()) {
        touch.read();
        Serial.printf("Touch: x=%d, y=%d\n", touch.getX(), touch.getY());
    }
}

深度睡眠唤醒

cpp

#define WAKE_PIN GPIO_NUM_0

void setup() {
    Serial.begin(115200);
    Serial.println("已唤醒！");
    delay(2000);
    esp_sleep_enable_ext0_wakeup(WAKE_PIN, LOW);
    esp_deep_sleep_start();
}

void loop() {}

LVGL

T-Display S3 AMOLED 1.64 支持 LVGL 8.3.5，以 Arduino_DriveBus 驱动显示屏，LVGL 通过 Arduino_GFX 的 draw16bitRGBBitmap 作为刷新后端。

配置 lv_conf.h

将项目 libraries/ 中的 lv_conf.h 复制到 Arduino 库目录中与 lvgl 文件夹同级的位置。该板卡的关键配置：

#define LV_COLOR_DEPTH  16
#define LV_HOR_RES_MAX  280   // 1.64 英寸 AMOLED：280×456
#define LV_VER_RES_MAX  456

最简 LVGL v8 示例

cpp

#include <Arduino_GFX_Library.h>
#include <Arduino_DriveBus_Library.h>
#include <lvgl.h>

// 显示屏由板卡库初始化，完整初始化代码请参考仓库中的 GFX 示例
extern Arduino_GFX *gfx;

#define SCREEN_W 280
#define SCREEN_H 456

static lv_disp_draw_buf_t draw_buf;
static lv_color_t buf[SCREEN_W * 20];

void my_disp_flush(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_p) {
    uint32_t w = area->x2 - area->x1 + 1;
    uint32_t h = area->y2 - area->y1 + 1;
    gfx->draw16bitRGBBitmap(area->x1, area->y1, (uint16_t *)color_p, w, h);
    lv_disp_flush_ready(drv);
}

void my_touchpad_read(lv_indev_drv_t *drv, lv_indev_data_t *data) {
    // 使用 SensorLib FT3168，初始化参考上方触摸示例
    data->state = LV_INDEV_STATE_REL;
}

void setup() {
    // 板卡与显示屏初始化（从 GFX 示例复制）
    gfx->begin();

    lv_init();
    lv_disp_draw_buf_init(&draw_buf, buf, NULL, SCREEN_W * 20);

    static lv_disp_drv_t disp_drv;
    lv_disp_drv_init(&disp_drv);
    disp_drv.hor_res  = SCREEN_W;
    disp_drv.ver_res  = SCREEN_H;
    disp_drv.flush_cb = my_disp_flush;
    disp_drv.draw_buf = &draw_buf;
    lv_disp_drv_register(&disp_drv);

    static lv_indev_drv_t indev_drv;
    lv_indev_drv_init(&indev_drv);
    indev_drv.type    = LV_INDEV_TYPE_POINTER;
    indev_drv.read_cb = my_touchpad_read;
    lv_indev_drv_register(&indev_drv);

    lv_obj_t *label = lv_label_create(lv_scr_act());
    lv_label_set_text(label, "AMOLED 1.64");
    lv_obj_set_style_text_font(label, &lv_font_montserrat_16, 0);
    lv_obj_center(label);
}

void loop() {
    lv_timer_handler();
    delay(5);
}

出厂示例

screen_touch_lvgl_9 示例展示了基于 ESP-IDF 的完整 LVGL 9 触摸 UI，lvgl_benchmark 示例用于测量渲染性能。Arduino LVGL 8 开发以上述示例为起点，参考这两个示例进行调优。

常见问题

板子一直烧录失败 按住 BOOT 按钮后点击上传。

UART 接口没有串口输出 在 Arduino IDE 工具中将 USB CDC On Boot 设为 Disabled。

SY6970 不接电池时工作不稳定 充电芯片在无电池 5V 供电时输出不稳定，请始终连接电池使用，或通过软件关闭电池通道。

T-Display S3 AMOLED 1.64 快速开始 ​

依赖库 ​

Arduino ​

Arduino IDE ​

1. 安装 ESP32 开发板支持 ​

2. 安装依赖库 ​

3. 开发板设置 ​

4. 上传 ​

PlatformIO ​

1. 环境配置 ​

2. 选择示例 ​

3. 编译与上传 ​

示例程序 ​

外设示例 ​