LILYGO T-Circle S3

Note: T-Circle S3 is the ESP32-S3 version. Click here to switch to the ESP32 version T-Circle.

Version History:

Purchase Link

Table of Contents

• Description
• Preview
• Modules
• Quick Start
• Pin Overview
• Related Tests
• FAQ
• Projects
• Resources
• Dependent Libraries

Description

LILYGO T-Circle S3 is a versatile development board based on the ESP32-S3 wireless microcontroller, integrating a 0.75-inch circular LCD touch screen (160x160 pixels), MAX98357A digital audio amplifier, MSM261 audio acquisition module (presumably microphone), APA102 LED control interface, and QWIIC expansion interface. Its core configuration includes 16MB flash memory, 8MB Octal SPI PSRAM, supports Wi-Fi/Bluetooth communication, and features a capacitive touch screen controller CST816D for interactive operation. Through precise pin mapping, it integrates graphic display, audio input/output, touch interaction, and high-speed storage functions, suitable for IoT terminals, smart wearable devices, or prototype development of embedded audio visualization projects.

Preview

Physical Images

Pinout Diagram

Modules

1. MCU

• Chip: ESP32-S3-R8
• PSRAM: 8M (Octal SPI)
• FLASH: 16M
• Related Information:

  Espressif Official ESP32-S3 Datasheet

2. Screen

• Size: 0.75-inch LCD circular screen
• Resolution: 160x160px
• Type: TFT, LCD
• Driver IC: GC9D01N
• Bus Protocol: Standard SPI
• Related Information:

  GC9D01N
  
  TFT_eSPI-2.5.43

• Dependent Libraries:

  Arduino_GFX-1.3.7

3. Touch

• Chip: CST816D
• Bus Protocol: I2C
• Related Information:

  GC9D01N

• Dependent Libraries:

  Arduino_DriveBus-1.1.16

4. Speaker

• Driver IC: MAX98357A
• Bus Protocol: I2S
• Related Information:

  MAX98357A

• Dependent Libraries:

  Arduino_DriveBus-1.1.16
  
  ESP32-audioI2S-3.0.6

5. Microphone

T-Circle-S3_V1.0 Version

• Chip: MSM261S4030H0R
• Bus Protocol: I2S
• Related Information:

  MSM261S4030H0R

• Dependent Libraries:

  Arduino_DriveBus-1.1.16
  DFRobot_MSM261

T-Circle-S3_V1.1 Version

• Chip: MP34DT05-A
• Bus Protocol: PDM
• Related Information:

  MP34DT05-A

• Dependent Libraries:

  Arduino_DriveBus-1.1.16

6. LED Lights

• Chip: APA102
• Related Information:

  APA102_2020_LED

• Dependent Libraries:

  FastLED-3.6.0

Overview

Quick Start

Example Support

PlatformIO

1. Install Visual Studio Code according to your system.
2. Open the "Extensions" sidebar in Visual Studio Code (or press Ctrl+Shift+X), search for the "PlatformIO IDE" extension and install it.
3. While the extension is installing, download the project from GitHub. You can click the green "<> Code" button to download the main branch, or download a "Releases" version from the sidebar.
4. After the extension installation is complete, open the Explorer sidebar (or press Ctrl+Shift+E), click "Open Folder", find the project code you just downloaded (the entire folder), click "Add", and the project files will be added to your workspace.
5. Open the "platformio.ini" file in the project folder (PlatformIO should automatically open it after adding the folder). Under the "[platformio]" section, uncomment the line selecting the example program you want to upload (starting with "default_envs = xxx"). Then click the "√" at the bottom left to compile. If the compilation is successful, connect the board to your computer and click the "→" at the bottom left to upload.

Arduino

1. Install Arduino IDE according to your system.
2. Open the "example" directory in the project folder, select the example project folder, and open the file ending with ".ino" to open the Arduino IDE project workspace.
3. Open the "Tools" menu -> "Board" -> "Boards Manager", find or search for "esp32", and install the board files by "Espressif Systems". Then return to the "Board" menu and select the board type under "ESP32 Arduino". The board type to choose is determined by the "board = xxx" header in the "[env]" section of the "platformio.ini" file. If the corresponding board is not available, you need to manually add the board from the "board" directory in the project folder.
4. Open the "[File]" -> "[Preferences]" menu, find the "[Sketchbook location]" field. Copy and paste all library files and folders from the "libraries" directory in the project folder into the "libraries" folder at this location.
5. Select the correct settings in the "Tools" menu as shown in the table below.

ESP32-S3

6. Select the correct port.
7. Click the "√" in the top right corner to compile. If the compilation is successful, connect the board to your computer and click the "→" to upload.

Development Platforms

1. Micropython
2. Arduino IDE
3. Platform IO

Pin Overview

T-Circle-S3_V1.0 Version

T-Circle-S3_V1.1 Version

Related Tests

(Power consumption and other test data to be added)

FAQ

• Q. I still don't know how to set up the programming environment after reading the above tutorial. What should I do?
  A. If you still don't understand how to set up the environment after reading the above tutorial, you can refer to the LilyGo-Document documentation for setup instructions.

• Q. Why does Arduino IDE prompt me to upgrade library files when I open it? Should I upgrade or not?
  A. Choose not to upgrade library files. Different versions of library files may not be compatible with each other, so upgrading is not recommended.

• Q. Why is there no serial data output from the "Uart" interface on my board? Is it broken?
  A. Because the project file is configured by default to use the USB interface as Uart0 serial output for debugging, and the "Uart" interface is connected to Uart0, it won't output any data without configuration.
  PlatformIO users: Open the project file "platformio.ini", change the option "-DARDUINO_USB_CDC_ON_BOOT=true" under "build_flags = xxx" to "-DARDUINO_USB_CDC_ON_BOOT=false" to use the external "Uart" interface normally.
  Arduino users: Open the "Tools" menu, select USB CDC On Boot: "Disabled" to use the external "Uart" interface normally.

• Q. Why does my board keep failing to upload programs?
  A. Please hold down the "BOOT-0" button and try uploading again.

Projects

• T-Circle-S3_V1.0

Resources

• GC9D01N
• MAX98357A
• MSM261S4030H0R
• MP34DT05-A

Dependent Libraries

• 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