LILYGO T-Circle S3

注意：T-Circle S3 为 ESP32-S3 版本，点这里切换到 ESP32 版本 T-Circle 版本。

版本迭代:

购买链接

目录

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

描述

LILYGO T-Circle S3 是一款基于ESP32-S3无线微控制器的多功能开发板，集成0.75英寸圆形LCD触摸屏（160x160像素）、MAX98357A数字音频放大器、MSM261音频采集模块（推测为麦克风）、APA102 LED控制接口及QWIIC扩展接口。其核心配置包括16MB闪存、8MB Octal SPI PSRAM，支持Wi-Fi/蓝牙通信，并搭载电容式触摸屏控制器CST816D实现交互操作。通过精密引脚映射，整合了图形显示、音频输入输出、触控交互与高速存储功能，适用于物联网终端、智能穿戴设备或嵌入式音频可视化项目的原型开发。

预览

实物图

引脚图

模块

1. MCU

• 芯片：ESP32-S3-R8
• PSRAM：8M (Octal SPI)
• FLASH：16M
• 相关资料：

  乐鑫官方ESP32-S3数据手册

2. 屏幕

• 尺寸：0.75英寸LCD圆屏幕
• 分辨率：160x160px
• 屏幕类型：TFT、LCD
• 驱动芯片：GC9D01N
• 总线通信协议：标准SPI
• 相关资料：

  GC9D01N
  
  TFT_eSPI-2.5.43

• 依赖库：

  Arduino_GFX-1.3.7

3. 触摸

• 芯片：CST816D
• 总线通信协议：IIC
• 相关资料：

  GC9D01N

• 依赖库：

  Arduino_DriveBus-1.1.16

4. 扬声器

• 驱动芯片：MAX98357A
• 使用总线通信协议：IIS
• 相关资料：

  MAX98357A

• 依赖库：

  Arduino_DriveBus-1.1.16
  
  ESP32-audioI2S-3.0.6

5. 麦克风

T-Circle-S3_V1.0 版本

• 芯片：MSM261S4030H0R
• 总线通信协议：IIS
• 相关资料：

  MSM261S4030H0R

• 依赖库：

  Arduino_DriveBus-1.1.16
  DFRobot_MSM261

T-Circle-S3_V1.1 版本

• 芯片：MP34DT05-A
• 总线通信协议：PDM
• 相关资料：

  MP34DT05-A

• 依赖库：

  Arduino_DriveBus-1.1.16

6. LED灯

• 芯片：APA102
• 相关资料：

  APA102_2020_LED

• 依赖库：

  FastLED-3.6.0

概述

快速开始

示例支持

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"开发板下的开发板类型，选择的开发板类型由"platformio.ini"文件中以[env]目录下的"board = xxx"标头为准，如果没有对应的开发板，则需要自己手动添加项目文件夹下"board"目录下的开发板。
4. 打开菜单栏"文件"->"首选项"，找到"项目文件夹位置"这一栏，将项目目录下的"libraries"文件夹里的所有库文件连带文件夹复制粘贴到这个目录下的"libraries"里边。
5. 在"工具"菜单中选择正确的设置，如下表所示。

ESP32-S3

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

开发平台

1. Micropython
2. Arduino IDE
3. Platform IO

引脚总览

T-Circle-S3_V1.0 version

T-Circle-S3_V1.1 version

相关测试

（功耗及其他测试数据待补充）

常见问题

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

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

• Q. 为什么我的板子上“Uart”接口没有输出串口数据，是不是坏了用不了啊？
• A. 因为项目文件默认配置将USB接口作为Uart0串口输出作为调试，“Uart”接口连接的是Uart0，不经配置自然是不会输出任何数据的。
  PlatformIO用户请打开项目文件“platformio.ini”，将“build_flags = xxx”下的选项“-DARDUINO_USB_CDC_ON_BOOT=true”修改成“-DARDUINO_USB_CDC_ON_BOOT=false”即可正常使用外部“Uart”接口。
  Arduino用户打开菜单“工具”栏，选择USB CDC On Boot: “Disabled”即可正常使用外部“Uart”接口。

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

项目

• T-Circle-S3_V1.0

资料

• GC9D01N
• MAX98357A
• MSM261S4030H0R
• MP34DT05-A

依赖库

• TFT_eSPI-2.5.43
• Arduino_DriveBus-1.1.16
• Arduino_GFX-1.3.7
• ESP32-audioI2S-3.0.6
• DFRobot_MSM261
• FastLED-3.6.0