T-Display S3 AMOLED 1.43 Quick Start

Required Libraries

Install the following libraries via the Arduino IDE Library Manager, or place them in your libraries folder:

Library	Version	Source
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

Note: Use the exact library versions listed above. Newer versions may break compatibility.

---

Arduino

Arduino IDE

1. Install ESP32 Board Support

1. Open Arduino IDE → File → Preferences
2. Add the following URL to "Additional Boards Manager URLs":

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

3. Go to Tools → Board → Boards Manager, search esp32, install esp32 by Espressif Systems

2. Install Libraries

Copy all folders from the project libraries/ directory into your Arduino libraries folder (e.g. C:\Users\YourName\Documents\Arduino\libraries).

3. Board Settings

Setting	Value
Board	ESP32S3 Dev Module
Port	Your COM port
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

Note: If using battery power without USB, set USB CDC On Boot to Disabled.

4. Upload

1. Connect the board via USB-C
2. Open an example sketch from the repository
3. Click Upload

If the upload fails, hold the BOOT-0 button and try again.

---

PlatformIO

1. Setup

1. Install Visual Studio Code and the PlatformIO IDE extension
2. Clone the repository:

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

3. Open the cloned folder in VS Code

2. Select an Example

Open platformio.ini and uncomment the src_dir line for your example. Only one line active at a time.

3. Build and Upload

• Click ✓ to compile
• Connect via USB-C
• Click → to upload

---

Examples

Example	Description
Original_Test	Factory test for DO0143 screen
GFX	Graphics library demo
FT3168	Capacitive touch example
SY6970	Power management example
PCF8563	RTC example
Light_Sleep_Wake_Up	Light sleep / wake demo
Deep_Sleep_Wake_Up	Deep sleep / wake demo
SD	SD card read/write
screen_touch_lvgl_9	LVGL 9 touch demo (ESP-IDF)

---

Peripheral Examples

Hello World (Arduino_GFX)

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

// Display driver is initialized by the board library — see the GFX example in the repo
// Below assumes gfx is an Arduino_GFX* pointer set up by the board init helper

extern Arduino_GFX *gfx;

void setup() {
    // Initialize via the board library (see GFX example for full init code)
    gfx->begin();
    gfx->fillScreen(BLACK);
    gfx->setTextColor(WHITE);
    gfx->setTextSize(2);
    gfx->setCursor(30, 100);
    gfx->println("Hello 1.43!");
}

void loop() {}

For the complete board initialization sequence, open the GFX example from the T-Display-S3-AMOLED-1.43-1.75 repository. It contains the full display and bus setup code.

Draw Shapes

gfx->fillCircle(140, 140, 80, BLUE);           // filled circle
gfx->drawRect(60, 60, 160, 160, GREEN);        // hollow rectangle (centered)
gfx->fillTriangle(140, 40, 60, 220, 220, 220, RED); // triangle

Touch Input (FT3168)

#include <SensorLib.h>

SensorFT3168 touch;

void setup() {
    // SDA, SCL, interrupt pin — check your board schematic
    touch.begin(Wire, FT3168_SLAVE_ADDRESS, TOUCH_SDA, TOUCH_SCL);
}

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

Deep Sleep Wake-Up

#define WAKE_PIN GPIO_NUM_0   // BOOT button

void setup() {
    Serial.begin(115200);
    Serial.println("Woke up!");

    // ... display init ...

    delay(2000);

    // configure wake source and go to sleep
    esp_sleep_enable_ext0_wakeup(WAKE_PIN, LOW);
    Serial.println("Going to deep sleep...");
    esp_deep_sleep_start();
}

void loop() {}

---

LVGL

T-Display S3 AMOLED 1.43 supports LVGL 8.3.5. The display is driven via Arduino_DriveBus; LVGL uses Arduino_GFX's draw16bitRGBBitmap as the flush backend.

Setup lv_conf.h

Copy lv_conf.h from the project libraries/ folder into your Arduino libraries directory at the same level as the lvgl folder. Key settings for this board:

#define LV_COLOR_DEPTH  16
#define LV_HOR_RES_MAX  466   // 1.43-inch AMOLED: 466×466
#define LV_VER_RES_MAX  466

Minimal LVGL v8 Sketch

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

// Display is initialised by the board library helper.
// Open the GFX example from the repo to get the full init sequence,
// then replace the loop body with LVGL calls.
extern Arduino_GFX *gfx;

#define SCREEN_W 466
#define SCREEN_H 466

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) {
    // Use SensorLib FT3168 — see Touch Input example above for init
    // Replace with: touch.read(); data->point.x = touch.getX(); etc.
    data->state = LV_INDEV_STATE_REL;
}

void setup() {
    // Board + display init (copy from GFX example)
    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.43");
    lv_obj_set_style_text_font(label, &lv_font_montserrat_16, 0);
    lv_obj_center(label);
}

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

Factory Example

The screen_touch_lvgl_9 example in the repository demonstrates a full LVGL 9 touch UI running via ESP-IDF. For Arduino-based LVGL 8 development, use the sketch above as the starting point and refer to the lvgl_benchmark example for performance tuning.

---

FAQ

Board keeps failing to upload Hold the BOOT-0 button and click Upload. Release after upload starts.

No serial output from the UART interface The project defaults to USB CDC as UART0. Set USB CDC On Boot to Disabled in Arduino Tools if you need hardware UART output.

SY6970 instability without a battery The PMU output is unstable when powered by 5V without a battery connected. Always connect a battery, or disable the battery channel in software.