The schematic shows the "boot" button connected to pin 32 / GPIO0 and the "Key" button connected to pin 11 / IO35 with a 100k pull-up. The pin numbers don't correspond to the pin numbers on the ESP32-S3 so I don't know what they're in reference to.

GPIO0 does work for using the boot button, but GPIO35 does not seem to work for using the other button.

Is 35 the correct pin to use that button? My PCBs are marked V1.2 on the silk screen.

Hi,

I am trying to run - https://github.com/Xinyuan-LilyGO/T-Display-S3/tree/main/example/arduino/tft

I have updated the TFT_eSPI library and using Arduino IDE, however not getting anything on the display at all.

What line should be uncommented in User_Setup_Select.h please for this display to work.

Many thanks,

Hi! I'm sorry to say this, but as an experienced Arduino maker, the "Tips" section of READMe is not understandable.
Firstly when the board is first plugged in there is a grey screen saying connection to Xinyuan... ... ...
what does this do?
Second the Tips are more confusing than helpful.
Once set up, the board behaves like a normal Arduino or ES32!
I really like the product but the new users deserve more support.
(Also I started my own GitHub repo for new users of T-Display S3 here:
https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples)

Everyone is free to help improve this resource!
-Terry

I am having an issue uploading the factory example to the board, it is saying that the sketch is too big.

Am I missing any settings?

It is possible to support ESPHome with this device/display?

Hello LilyGO,

How can I use USB OTG mode?
I mean there is no switch as in your previous ESP32-S2 T-Display for OTG.

Hi ..

As the battery charger is connected to VBUS, but VBUS is not connected to a IO pin, it is not possible to use other power sources than USB. I would like to use a solar panel to charge the battery!

br J.

The device is not visible in device manager with a com port.
Windows see it as a drive which has inside one file called Firmware.bin
i Have two with exactly the same problem

I can't get display to work with ESPHome. Does anyone have any advice? here's my config

esphome:
  name: s3

spi:
  clk_pin: GPIO12
  mosi_pin: GPIO11

esp32:
  board: esp32-s3-devkitc-1
  variant: esp32s3
  framework:
    type: arduino
    version: 2.0.4
    platform_version: 5.1.1

# Enable logging
logger:

# Enable Home Assistant API
api:

ota:
  password: "123123"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "S3 Fallback Hotspot"
    password: "123"

color:
  - id: gray
    red: 50%
    green: 50%
    blue: 50%

font:
  - file: "fonts/iosevka.ttf"
    id: iosvetta
    size: 24

display:
  - platform: st7789v
    model: Custom
    offset_height: 0
    offset_width: 0
    height: 170
    width: 320
    backlight_pin: GPIO38
    cs_pin: GPIO6
    dc_pin: GPIO7
    reset_pin: GPIO5
    lambda: |-
      it.print(50, 50, id(iosvetta), "Hello World!");
      it.rectangle(64, 64, 192, 112, id(gray));

Hello,

how is the easiest way to config the demo clock on the device?

In README.md
Arduino:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pagespackage_esp32_index.json

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

/gh-pages/package_esp32_index.json instead of /gh-pagespackage_esp32_index.json

Whenever I try to upload some code via Arduino IDE it shows me the following error

We added today support for this device. Nice LVGL performance.

Greetings from Tasmota crew.

Overview

Adding the fix from the PR #3 in this sample, for fix similar issue than #2, I have the next output:

Advanced Memory Usage is available via "PlatformIO Home > Project Inspect"
RAM:   [=         ]  12.2% (used 39972 bytes from 327680 bytes)
Flash: [======Error: The program size (1323221 bytes) is greater than maximum allowed (1310720 bytes)
*** [checkprogsize] Explicit exit, status 1
====]  101.0% (used 1323221 bytes from 1310720 bytes)

If I comment this lines:

platform_packages =
    framework-arduinoespressif32@https://github.com/espressif/arduino-esp32.git#2.0.3

the compiling disapear, but the factory don't works, and the output is:

 ESP-ROM:esp32s3-20210327
Build:Mar 27 2021
rst:0xc (RTC_SW_CPU_RST),boot:0x8 (SPI_FAST_FLASH_BOOT)
Saved PC:0x42098d1e
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fcd0108,len:0x39c
load:0x403b6000,len:0x9a4
load:0x403ba000,len:0x2868
SHA-256 comparison failed:
Calculated: 9127e332554622857d5c753c9ffbb9862bfb72e81ded80db80617d5974000cec
Expected: 867c0d6cb8d08f5a22bebcb1e4a5d457c2700a1c6b76abeb4d778eadcc3446e2
Attempting to boot anyway...
entry 0x403b61c0
E (308) psram: PSRAM ID read error: 0x00ffffff

Maybe we need arduino-esp32 2.0.3 version but with different partition scheme?

i am setting up Arduino IDE and the setting for "Core Debug Level" is shown as a pictogram in the README

which debug level does this represent?

Hi,
when board is powered via USB all things are fine (display and so on), but when powerd via LiPo (1.1Ah) display won't work and LEDs on the board aren't on, but voltage on 3V pin is fine.
I have the older T-Display board to, same LiPo works fine there.

Any suggestions?

The board clearly has 16MiB flash, however the given arduino examples only work with 8MiB. When I manually change to 16MiB in platformio.ini the board report flash error on boot.

Hello! How can I rotate the screen? I need to set portrait orientation.

The file t_display_s3.stp fails to open with either FreeCAD or Onshape. What software was used to create this file? Maybe there is a problem with the export. Maybe the source for this file could be uploaded?

I downloaded and opened your 3D file but there was only the ESP32S3 board and no screen, hence it's difficult for me to design a case for it. It would be great if you can provide 3D file with screen included.

Hello,

I am wondering what the proper way to power this board is.
I have a 3s battery that I regulate to 5v with an lm7805 and am wondering how to properly power the board without getting a conflict when the USB is plugged in and delivering power.

Is a diode between my lm7805 and the 5v of the board enough?

Thank you for your response.

Any hints to turning off the display? Tried this and no luck:

  pinMode(15, OUTPUT);
  digitalWrite(15, LOW);

Could you please put which voltage it could send on signal outputs and which load is acceptable on main page?

Is there any corresponding example about TouchLib，thanks.

There doesn't seem to be an LED so that I might run the classic "blinking LED" demo. It seems almost every introduction video of many boards use that as a least-common-denominator example. Maybe a colorful LED that lights up the LILYGO logo under the acrylic would be useful, attractive and also highlight your brand.

Are any of the lights I see programmable (green power, red solid, LCD, LCD backlight)? If so, can you provide the GPIO Port or perhaps a small code example to turn it on and off. A blinky example that flashed the entire LCD between black and white might also be a reasonable substitute.

Trying to run the NES example. I get error that nes header file is missing.

Hey, having read the requesting PID issue on adafruit, adafruit/circuitpython#6037 (comment) , it seems someone got an email reply from raspberryPi, and forwarded it to two of the issue participants, so maybe the process can proceed? And then also for this board, the T-Display-S3, and the T-QT-Pro.

When I got the board I plugged it in and the LilyGO animation played.

So I decided to upload the simple GetChipID sketch and now it crashes repeatedly.

I downloaded the Arduino Espressif library but it doesn't have an T-Display S3 choice.
So chose ESP32S3 Dev module.

Writing at 0x000438b5... (100 %)
Wrote 234800 bytes (130780 compressed) at 0x00010000 in 2.5 seconds (effective 743.6 kbit/s)...
Hash of data verified.

Leaving...
Hard resetting via RTS pin...

But it just hangs on the Hard resetting.

The ttyACM serial terminal prints

ESP-ROM:esp32s3-20210327
Build:Mar 27 2021
rst:0x7 (TG0WDT_SYS_RST),boot:0x8 (SPI_FAST_FLASH_BOOT)
Saved PC:0x400454d5
SPIWP:0xee
mode:QIO, clock div:2
load:0x3fce3808,len:0x43c
ets_loader.c 78 

I think is crashing over and over

dmesg -w shows that the board keeps rebooting.

Now I can't upload anything because it keeps crashing.

What do I do? How do I get the board to stop crashing? Thanks.

I tried running the example code in T-Display-S3\example but it seems the board ID in the platform IO isn't recognized even though I was able to find it in Platform IO board sections.

[env:ESP32-S3-DevKitC-1]

platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino

Hi, I connected small LiPo battery but it is not powering the device. Is any configuration needed to support power by LiPo?

Hi,

I connected a LiPo battery and disconnect the USB-C cable then the board turns off.
Do I have to program anything?

best regards

Issue
Factory example fails to compile with Espressif Arduino releases > 2.0.3.

Description
Your factory example as of commit ebec56d02c5e87aa1f4cf522d27f678849e3dafe uses the Espressif Arduiono library version 2.0.3, as defined in platformio.ini:

platform_packages = framework-arduinoespressif32@https://github.com/espressif/arduino-esp32.git#2.0.3

You state that it should work above these versions, but the factory example project fails to compile with #2.0.4, #2.0.5 or #master, and fails with the following error:

lv_conf_kconfig.h:15:14: fatal error: sdkconfig.h: No such file or directory

The LvlGL version tested in platformio.ini is:

lib_deps = lvgl/lvgl@^8.3.2

Mitigation
Use version 2.0.3 but it's not ideal.

How to power board from external 5v source? Tried battery connector but no succes. It only powering from type-c

since core 2.0.3 is outdated and is not supported anymore.

Hi,

I made the board definition file for T-Display-S3 with following contents:

$HOME/.platformio/platforms/espressif32/boards/t-display-s3.json

{
  "build": {
    "arduino": {
      "ldscript": "esp32s3_out.ld",
      "partitions": "default_8MB.csv",
      "memory_type": "qio_opi"
    },
    "core": "esp32",
    "extra_flags": [
      "-DARDUINO_ESP32S3_DEV",
      "-DBOARD_HAS_PSRAM",
      "-DARDUINO_USB_MODE=1",
      "-DARDUINO_USB_CDC_ON_BOOT=1",
      "-DARDUINO_RUNNING_CORE=1",
      "-DARDUINO_EVENT_RUNNING_CORE=1"
    ],
    "f_cpu": "240000000L",
    "f_flash": "80000000L",
    "flash_mode": "qio",
    "hwids": [
      [
        "0x303A",
        "0x1001"
      ]
    ],
    "mcu": "esp32s3",
    "variant": "esp32s3"
  },
  "connectivity": [
    "wifi",
    "bluetooth"
  ],
  "debug": {
    "default_tool": "esp-builtin",
    "onboard_tools": [
      "esp-builtin"
    ],
    "openocd_target": "esp32s3.cfg"
  },
  "frameworks": [
    "arduino",
    "espidf"
  ],
  "name": "T-Display-S3",
  "upload": {
    "flash_size": "8MB",
    "maximum_ram_size": 327680,
    "maximum_size": 8388608,
    "require_upload_port": true,
    "speed": 921600
  },
  "url": "https://github.com/Xinyuan-LilyGO/T-Display-S3",
  "vendor": "LilyGO"
}

And this is my project configuration file:

$PROJECT_ROOT/.platformio.ini

[env:T-Display-S3]
platform = espressif32
board = t-display-s3
framework = arduino

monitor_speed = 115200

lib_deps =
  lvgl/lvgl @ ^8.3.2

build_flags =
  -DLV_CONF_INCLUDE_SIMPLE
  -Iinclude

Everything seems to work fine but notice that the flash size is defined as 8MB, so I tried making following changes:

"partitions": "default_16MB.csv"
"flash_size": "16MB"
"maximum_size": 16777216

Now the flash size is recognized as 16MB but "Upload Filesystem Image" option fails with following output:

 *  Executing task: $HOME\.platformio\penv\Scripts\platformio.exe run --target uploadfs --environment T-Display-S3 

Processing T-Display-S3 (platform: espressif32; board: t-display-s3; framework: arduino)
--------------------------------------------------------------------------------------------------------------------------------------Verbose mode can be enabled via `-v, --verbose` option
CONFIGURATION: https://docs.platformio.org/page/boards/espressif32/t-display-s3.html
PLATFORM: Espressif 32 (5.2.0) > T-Display-S3
HARDWARE: ESP32S3 240MHz, 320KB RAM, 16MB Flash
DEBUG: Current (esp-builtin) On-board (esp-builtin) External (cmsis-dap, esp-bridge, esp-prog, iot-bus-jtag, jlink, minimodule, olimex-arm-usb-ocd, olimex-arm-usb-ocd-h, olimex-arm-usb-tiny-h, olimex-jtag-tiny, tumpa)
PACKAGES:
 - framework-arduinoespressif32 @ 3.20005.220925 (2.0.5)
 - tool-esptoolpy @ 1.40201.0 (4.2.1)
 - tool-mkfatfs @ 2.0.1
 - tool-mklittlefs @ 1.203.210628 (2.3)
 - tool-mkspiffs @ 2.230.0 (2.30)
 - toolchain-riscv32-esp @ 8.4.0+2021r2-patch3
 - toolchain-xtensa-esp32s3 @ 8.4.0+2021r2-patch3
LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf
LDF Modes: Finder ~ chain, Compatibility ~ soft
Found 35 compatible libraries
Scanning dependencies...
Dependency Graph
|-- lvgl @ 8.3.2
|-- TFT_eSPI @ 2.4.71
|   |-- SPI @ 2.0.0
|   |-- SPIFFS @ 2.0.0
|   |   |-- FS @ 2.0.0
|   |-- FS @ 2.0.0
|   |-- LittleFS @ 2.0.0
|   |   |-- FS @ 2.0.0
Building in release mode
Building FS image from 'data' directory to .pio\build\T-Display-S3\spiffs.bin
/file00.txt
/file01.txt
/folder00/file00.txt
/folder00/file01.txt
/folder01/file00.txt
/folder01/file01.txt
Looking for upload port...
Auto-detected: COM6
Uploading .pio\build\T-Display-S3\spiffs.bin
esptool.py v4.2.1
Serial port COM6
Connecting...
Chip is ESP32-S3
Features: WiFi, BLE
Crystal is 40MHz
MAC: 68:b6:b3:21:87:dc
Uploading stub...
Running stub...
Stub running...
Changing baud rate to 921600
Changed.
Configuring flash size...
Flash will be erased from 0x00c90000 to 0x00ffffff...
Compressed 3604480 bytes to 6805...
Writing at 0x00c90000... (100 %)

A fatal error occurred: Invalid head of packet (0x6F): Possible serial noise or corruption.
*** [uploadfs] Error 2
==================================================== [FAILED] Took 29.88 seconds ====================================================

 *  The terminal process "$HOME\.platformio\penv\Scripts\platformio.exe 'run', '--target', 'uploadfs', '--environment', 'T-Display-S3'" terminated with exit code: 1. 
 *  Terminal will be reused by tasks, press any key to close it. 

Does any one know what is going on here?
Any kind of help is sincerely appreciated. 🙏

is it possible to convert the cpp to c for the touch libary?

Dear all,
I have a very strange behavior with my board. Running my code with the usb-cable pluged in works fine. But as soon as I try to power the board from my LiPo the display stays black. Thats very strange because it seems as if the power regulator (RT9013) does work. On the pinheader I can measure the expected 3.3V on the 5V outputs the power of the LiPo (little bit less than 4V). I've absolutely no idea what is going wrong there. Any ideas????
Best,
Martin

There are 2 physical connectors on this board. The JST and another connector near the reset button.
What are these connectors for?
i want to power the board from a Li-ion battery. Which connector should i use? and how can i read the battery voltage?

I haven't found the schematic anywhere.

I am having difficulties adding/recognizing the libraries to the path.
Could you please show how to add those for the new Arduino IDE 2.0?

The factory example doesn't work. Is there a correct version?

I bought a unit a couple weeks ago and there is a red led on top of the RST print on the back of the board it's constantly blinking. Is this normal?

Overview

Into the current tft directory sample, pio fails with this output:

(main) avp:tft$ pio run
Warning! Ignore unknown configuration option `board.psram_type` in section [env:ESP32-S3-DevKitC-1]
Warning! Ignore unknown configuration option `board.code_debug` in section [env:ESP32-S3-DevKitC-1]
Warning! Ignore unknown configuration option `board.memory_type` in section [env:ESP32-S3-DevKitC-1]
Processing ESP32-S3-DevKitC-1 (platform: espressif32; board: ESP32-S3-DevKitC-1; framework: arduino)
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Error: Unknown board ID 'ESP32-S3-DevKitC-1'

Hi,

I have done all settings in readme, and trying to upload an example to the board.

But I was failed to compile the example in Arduino IDE(2.0.1), getting the message
"... example\lv_demos\lv_demos.ino:3:10: fatal error: TouchLib.h: No such file or directory "

I'm sure I have copeid all files in lib to the Arduino libraries folder, is there any suggestion? thanks.

Hi!
The only I get is the red and green LED. I cannot boot it at all. Seems like it needs total firmware upload. I'm on the Mac M1.
Please advise.

Is it possible to have an example added to this repo which shows the best way to read and display the battery voltage since this is a built-in feature of the T-Display?

Hello,

You instructions are clear, except the core debug level is shown with what looks like a Chinese character that is hard to translate. Can you add the setting in English?

The example found here: https://github.com/Xinyuan-LilyGO/T-Display-S3/tree/main/example/tft
is suppose to display information on the screen of the T-Display-S3.

However, while the example compiles, when it is run it results in a blank screen - that is to say no output is displayed on the screen of the T-Display-S3.

Also, the file https://github.com/Xinyuan-LilyGO/T-Display-S3/blob/main/example/tft/pin_config.h
has these two lines:
#define WIFI_SSID "xinyuandianzi"
#define WIFI_PASSWORLD "AA15994823428"

which are not used by the tft example - as the tft example does not have code to make a wifi connection.

The example at:
https://github.com/Xinyuan-LilyGO/T-Display-S3/tree/main/example/factory
works fine.

Missing documentation on external antenna.

Is it ok to use the t-display without an external antenna attached?

Other than plugging in an external antenna do you have to do anything to use it? For example, setting a jumper?

on reset of the board - USB Serial Port Com4 shows up

couple second-later it disappears

cannot load the ESP