T-Circle 快速开始

依赖库

将项目 libraries/ 目录复制到 Arduino 库目录，或通过库管理器安装：

库名	来源
TFT_eSPI	GitHub
CST816D（触摸）	GitHub

---

Arduino

Arduino IDE

1. 安装 ESP32 开发板支持

1. 打开 Arduino IDE → 文件 → 首选项
2. 在「附加开发板管理器网址」中添加：

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

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

2. 安装依赖库

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

3. 开发板设置

设置项	值
开发板	ESP32 Dev Module
Upload Speed	921600
CPU Frequency	240 MHz (WiFi)
Flash Mode	QIO 80 MHz
Flash Size	16 MB (128Mb)
Partition Scheme	默认
PSRAM	Enabled

4. 上传

通过 USB-C 连接，打开示例，点击「上传」。
若上传失败，按住 BOOT 再按一下 RST，先松开 RST，保持按住 BOOT 后再开始上传。

---

PlatformIO

1. 安装 VS Code 和 PlatformIO IDE 扩展
2. 克隆仓库：

   git clone https://github.com/Xinyuan-LilyGO/T-Circle.git

3. 打开 platformio.ini，取消注释目标示例环境
4. 点击 ✓ 编译，连接开发板，点击 → 上传

---

示例程序

示例	说明
Basic_Display	在圆形 LCD 上绘制文字和图形
Touch_Test	读取 CST816D 电容触摸事件

---

外设示例

Hello World（TFT_eSPI）

#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
    tft.init();
    tft.setRotation(0);
    tft.fillScreen(TFT_BLACK);

    tft.setTextColor(TFT_WHITE, TFT_BLACK);
    tft.setTextSize(2);
    tft.setCursor(20, 70);
    tft.println("T-Circle!");
}

void loop() {}

在圆形屏幕上绘图

#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
    tft.init();
    tft.fillScreen(TFT_BLACK);

    // 填充背景圆（显示屏 160×160）
    tft.fillCircle(80, 80, 60, TFT_BLUE);

    // 白色边框圆环
    tft.drawCircle(80, 80, 75, TFT_WHITE);

    // 在圆内绘制文字
    tft.setTextColor(TFT_WHITE);
    tft.setTextSize(1);
    tft.setCursor(55, 76);
    tft.print("你好！");
}

void loop() {}

读取触摸事件（CST816D，I2C）

#include <Wire.h>

#define TOUCH_SDA   5
#define TOUCH_SCL   6
#define TOUCH_ADDR  0x15

void setup() {
    Serial.begin(115200);
    Wire.begin(TOUCH_SDA, TOUCH_SCL);
}

void loop() {
    Wire.beginTransmission(TOUCH_ADDR);
    Wire.write(0x02);  // 手势寄存器
    Wire.endTransmission(false);
    Wire.requestFrom(TOUCH_ADDR, 6);

    if (Wire.available() >= 6) {
        uint8_t gesture = Wire.read();
        Wire.read();
        uint8_t xH = Wire.read() & 0x0F;
        uint8_t xL = Wire.read();
        uint8_t yH = Wire.read() & 0x0F;
        uint8_t yL = Wire.read();
        int x = (xH << 8) | xL;
        int y = (yH << 8) | yL;
        if (x || y) {
            Serial.printf("手势: 0x%02X  x=%d  y=%d\n", gesture, x, y);
        }
    }
    delay(50);
}

具体 GPIO 引脚号（SPI CS/DC/RST/BL、I2C SDA/SCL）请参考项目 pin_config.h。

触摸唤醒深度睡眠

#include <esp_sleep.h>

// 触摸中断引脚 — 参考 pin_config.h
#define TOUCH_INT_PIN  7

void setup() {
    Serial.begin(115200);
    Serial.println("唤醒，运行中...");

    // ... 执行任务 ...

    Serial.println("进入深度睡眠");
    esp_sleep_enable_ext0_wakeup((gpio_num_t)TOUCH_INT_PIN, LOW);
    esp_deep_sleep_start();
}

void loop() {}

---

常见问题

Q：板子一直烧录失败怎么办？
A：按住 BOOT，再按一下 RST，先松开 RST，保持按住 BOOT 后开始烧录。

Q：T-Circle 与 T-Circle S3 有什么区别？
A：T-Circle 使用原版 ESP32；T-Circle S3 使用更新的 ESP32-S3，具备 USB-OTG、更多 GPIO 和更强性能。两者使用相同的 0.75 英寸圆形显示屏。

Q：如何让圆形屏幕显示效果更好？
A：在以 (80, 80) 为圆心、半径 160 像素的圆形区域内绘制内容。物理镜头会裁切圆外区域，但控制器仍会渲染——建议用 tft.fillCircle() 作背景，避免露出方形边角。