Waveshare ESP32-S3-TOUCH-LCD-1.69 crash on tft.init() / PlatformIO - Arduino framework SOLVED! #3641

Cat30Mk3 · 2025-01-29T20:22:46Z

Cat30Mk3
Jan 29, 2025

Im wondering if someone can take a look at my code.
I've hit a brick wall with getting basic TFT_eSpi 'Hello World' to display on this board.
https://www.waveshare.com/wiki/ESP32-S3-Touch-LCD-1.69
This is an ST7789 & ESP32-S3. I cant get past tft_init().
Im using PlatformIO and the Arduino framework. My on-line research has not been successful.
"Guru Meditation Error: Core 1 panic'ed (LoadProhibited). Exception was unhandled."

PlatformIO.ini follows:

`; PlatformIO Project Configuration File
;
; Build options: build flags, source filter
; Upload options: custom upload port, speed and extra flags
; Library options: dependencies, extra library storages
; Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[platformio]
src_dir = src\printAndTFT_test
;src_dir = src\printTest

[env:esp32-s3-devkitc-1]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
upload_speed = 921600
monitor_speed = 115200

lib_deps =
; lvgl/lvgl @ 8.4.0
bodmer/TFT_eSPI @ ^2.5.43
SPI
FS
SPIFFS

build_flags =
-Os
;-DBOARD_HAS_PSRAM //PSRAM chip not found or not supported, or wrong PSRAM line mode
;-DCORE_DEBUG_LEVEL=ARDUHAL_LOG_LEVEL_DEBUG

-DARDUINO_USB_MODE=1
-DARDUINO_USB_CDC_ON_BOOT=1

; Define the TFT driver, pins etc. here:
-DUSER_SETUP_LOADED=1
-DST7789_2_DRIVER=1   ;also tried -DST7789_DRIVER=1
-DTFT_RGB_ORDER=TFT_RGB
-DTFT_WIDTH=240
-DTFT_HEIGHT=280
-DTFT_MISO=-1
-DTFT_MOSI=7
-DTFT_SCLK=6
-DTFT_CS=5
-DTFT_DC=4
-DTFT_RST=8
-DTFT_BL=15
-DTFT_BACKLIGHT_ON=HIGH
-DLOAD_GLCD=1
-DLOAD_FONT2=1
-DLOAD_FONT4=1
-DLOAD_FONT6=1
-DLOAD_FONT7=1
-DLOAD_FONT8=1
-DLOAD_GFXFF=1
-DSMOOTH_FONT=1
-DSPI_FREQUENCY=27000000
-DSPI_READ_FREQUENCY=20000000
-DSPI_TOUCH_FREQUENCY=2500000

`
main.cpp follows

`#include <Arduino.h>
#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
Serial.begin(115200);
Serial.printf("ms since start: %d\n",millis());
delay(7000);
Serial.printf("Setup.. %s\n\n",FILENAME);

tft.init();
tft.setRotation(1);
tft.fillScreen(TFT_BLACK);
tft.setCursor(0,0,4);
tft.setTextColor(TFT_WHITE);
tft.drawString("Hello World!...", 10, 10);

Serial.println ("Hello World!");
}

int count=0;
void loop() {
Serial.printf("%03d - tick - %d\n",count,millis());
count++;
delay(1000);
}`

Basitadam · 2025-01-30T05:19:39Z

Basitadam
Jan 30, 2025

Add this to your flags:

-DUSE_HSPI_PORT

or

-DUSE_HSPI_PORT=1

5 replies

AnRich26 Jan 30, 2025

I agree with Basitadam esp32-s3 only seports HSPI
VSPI used with flash and psram. Had same problem and changing from VSPI to HSPI dit the trick.

Cat30Mk3 Jan 30, 2025
Author

Thanks for your suggestion. Unfortunately still no joy.
Here is my latest PlatformIO.ini -- I tried both DST7789_DRIVER=1 and -DST7789_2_DRIVER=1
Any other ideas? Ive been at this for 5 days solid and no luck.

`
; PlatformIO Project Configuration File
;
[platformio]
src_dir = src\printAndTFT_test
;src_dir = src\printTest

[env:esp32-s3-devkitc-1]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
upload_speed = 921600
monitor_speed = 115200

lib_deps =
; lvgl/lvgl @ 8.4.0
bodmer/TFT_eSPI @ ^2.5.43
SPI
FS
SPIFFS

build_flags =
-Os
;-DBOARD_HAS_PSRAM //PSRAM chip not found or not supported, or wrong PSRAM line mode
;-DCORE_DEBUG_LEVEL=ARDUHAL_LOG_LEVEL_DEBUG

-DARDUINO_USB_MODE=1
-DARDUINO_USB_CDC_ON_BOOT=1

; Define the TFT driver, pins etc. here:
-DUSER_SETUP_LOADED=1
-DST7789_DRIVER=1   ;also tried -DST7789_2_DRIVER=1
-DTFT_RGB_ORDER=TFT_RGB
-DUSE_HSPI_PORT=1
-DTFT_WIDTH=240
-DTFT_HEIGHT=280
-DTFT_MISO=-1
-DTFT_MOSI=7
-DTFT_SCLK=6
-DTFT_CS=5
-DTFT_DC=4
-DTFT_RST=8
-DTFT_BL=15
-DTFT_BACKLIGHT_ON=HIGH
-DLOAD_GLCD=1
-DLOAD_FONT2=1
-DLOAD_FONT4=1
-DLOAD_FONT6=1
-DLOAD_FONT7=1
-DLOAD_FONT8=1
-DLOAD_GFXFF=1
-DSMOOTH_FONT=1
-DSPI_FREQUENCY=27000000
-DSPI_READ_FREQUENCY=20000000
-DSPI_TOUCH_FREQUENCY=2500000


; -DTOUCH_CS=-1
; -DTOUCH_SCL=10
; -DTOUCH_SDA=11
; -DTOUCH_RST=13
; -DTOUCH_INT=14

`

Cat30Mk3 Jan 30, 2025
Author

Partial Success!

I discovered that following your recommendation of
-DUSE_HSPI_PORT=1
PLUS
-DTFT_RST=-1 (an odd requirement of ESP32 even though there is a known RST pin assignment)
the program no longer crashes on tft.init().
The program cycles through the loop() and I even see backlighting now, however I'm still not getting displayed text.

I'm getting close .. thanks again for the suggestion that lead to partial success!
Any suggestions on what else is wrong would be appreciated.
-John

Basitadam Jan 31, 2025

RST issue is wired. Anyway. Can you run this:

*
2024.10.22
-Simple fill screen test
*/

#include <TFT_eSPI.h>       // Include the graphics library

TFT_eSPI tft = TFT_eSPI();  // Create object "tft"

void setup(void) 
{
  Serial.begin(115200);
  delay(1000);
  Serial.println("Boot...");
  tft.init();
  tft.setRotation(1);
  tft.fillScreen(TFT_DARKGREY);
  tft.setTextFont(2);


  for(uint8_t ch=0; ch<3;ch++)
    {
     digitalWrite(TFT_BL,LOW);
     Serial.println("BL OFF");
     delay(150);
     digitalWrite(TFT_BL,HIGH);
     Serial.println("BL ON");
     delay(150);
    }
}

void loop()
{
  Serial.print("\n\n\n");
  Serial.println("Looping...");

  Serial.println("RED");
  tft.fillScreen(TFT_RED);
  tft.setCursor(TFT_HEIGHT/2,TFT_WIDTH/2);
  tft.print("RED");
  delay(2000); 

  Serial.println("GREEN");
  tft.fillScreen(TFT_GREEN);
  tft.setCursor(TFT_HEIGHT/2,TFT_WIDTH/2);
  tft.print("GREEN");
  delay(2000); 

  Serial.println("BLUE");
  tft.fillScreen(TFT_BLUE);
  tft.setCursor(TFT_HEIGHT/2,TFT_WIDTH/2);
  tft.print("BLUE");
  delay(2000); 
}

Do you see the colors?

Cat30Mk3 Jan 31, 2025
Author

YES!! SUCCESS!

Ok, Im not sure what was going on with the -DTFT_RST=-1 yesterday, but it definitely requires -DTFT_RST=8.
Rereading the comments in User_Setup.h, its clear that -DTFT_RST=-1 should be used when the ST7789 RST is wired directly to the ESP32 RESET PIN which, is not the case for this board.

Thank you so much for helping me out!

Im attaching the working PlatformIO.ini and your test program for future reference.

Now I'll try to get the touch going. Hopefully it will go smoother.

; PlatformIO Project Configuration File
;
[platformio]
src_dir = src\simpleFillScreenTest
;src_dir = src\printAndTFT_test
;src_dir = src\printTest

[env:esp32-s3-devkitc-1]
platform = espressif32
board = esp32-s3-devkitc-1 

framework = arduino
upload_speed = 921600
monitor_speed = 115200

lib_deps = 
    bodmer/TFT_eSPI @ ^2.5.43
    SPI
    FS
    SPIFFS

build_flags = 
    -Os
    ;-DBOARD_HAS_PSRAM  //PSRAM chip not found or not supported, or wrong PSRAM line mode

	-DARDUINO_USB_MODE=1
	-DARDUINO_USB_CDC_ON_BOOT=1

 	; Define the TFT driver, pins etc. here:
   	-DUSER_SETUP_LOADED=1
  	-DST7789_DRIVER=1   ;also tried -DST7789_2_DRIVER=1
	-DTFT_RGB_ORDER=TFT_RGB
	-DUSE_HSPI_PORT=1
  	-DTFT_WIDTH=240
  	-DTFT_HEIGHT=280
  	;-DTFT_MISO=-1    ;there is no miso pin and this define is not required
  	-DTFT_MOSI=7
  	-DTFT_SCLK=6
  	-DTFT_CS=5
  	-DTFT_DC=4
  	-DTFT_RST=8       
  	-DTFT_BL=15
  	-DTFT_BACKLIGHT_ON=HIGH
  	-DLOAD_GLCD=1
  	-DLOAD_FONT2=1
  	-DLOAD_FONT4=1
  	-DLOAD_FONT6=1
  	-DLOAD_FONT7=1
  	-DLOAD_FONT8=1
  	-DLOAD_GFXFF=1
  	-DSMOOTH_FONT=1
  	-DSPI_FREQUENCY=27000000
	-DSPI_READ_FREQUENCY=20000000
	-DSPI_TOUCH_FREQUENCY=2500000

Here's your working test program:

/* 
2024.10.22
-Simple fill screen test
*/

#include <TFT_eSPI.h>       // Include the graphics library

TFT_eSPI tft = TFT_eSPI();  // Create object "tft"

void setup(void) 
{
  Serial.begin(115200);
  delay(1000);
  Serial.println("Boot...");
  tft.init();
  tft.setRotation(1);
  tft.fillScreen(TFT_DARKGREY);
  tft.setTextFont(2);


  for(uint8_t ch=0; ch<3;ch++)
    {
     digitalWrite(TFT_BL,LOW);
     Serial.println("BL OFF");
     delay(150);
     digitalWrite(TFT_BL,HIGH);
     Serial.println("BL ON");
     delay(150);
    }
}

void loop()
{
  Serial.print("\n\n\n");
  Serial.println("Looping...");

  Serial.println("RED");
  tft.fillScreen(TFT_RED);
  tft.setCursor(TFT_HEIGHT/2,TFT_WIDTH/2);
  tft.print("RED");
  delay(2000); 

  Serial.println("GREEN");
  tft.fillScreen(TFT_GREEN);
  tft.setCursor(TFT_HEIGHT/2,TFT_WIDTH/2);
  tft.print("GREEN");
  delay(2000); 

  Serial.println("BLUE");
  tft.fillScreen(TFT_BLUE);
  tft.setCursor(TFT_HEIGHT/2,TFT_WIDTH/2);
  tft.print("BLUE");
  delay(2000); 
}

Cat30Mk3 · 2025-02-01T18:21:01Z

Cat30Mk3
Feb 1, 2025
Author

.. and touch works flawlessly with
#include <CST816_TouchLib.h>

1 reply

Basitadam Feb 2, 2025

HappyFace(True);

AnRich26 · 2025-02-03T06:38:17Z

AnRich26
Feb 3, 2025

Glad you got everything work as well as touch, baught me a waveshare 2.8" touch st7796 last week. Over the weekend i tryd to mod the lvgl touch driver as not finding working library for CST328 touch, still have compiler errors as compiler does not exept new struct values.

0 replies

Cat30Mk3 · 2025-02-03T12:35:54Z

Cat30Mk3
Feb 3, 2025
Author

Thanks for your input that solved my problem. the WaveShare site shows three versions of ESP32-S3-Touch-LCD-2.8 .. which one did you get ? how do you know it’s CST328 ? i can’t see that on the schematics and can only find this CST328 library online https://github.com/mmMicky/TouchLibESP32-S3-Touch-LCD-2.8 (ST7789 / waveshare.comESP32-S3-Touch-LCD-2.8 B:waveshare.comESP32-S3-Touch-LCD-2.8 C (round):waveshare.comJohnJohn Witherspoon(416) ***@***.*** Feb 3, 2025, at 1:38 AM, AnRich26 ***@***.***> wrote:waveshare 2.8" touch st7796

2 replies

AnRich26 Feb 3, 2025

A yes, i have seen that one. However it tells you to unifie the driver, i do not know how to. The display i am using is https://www.waveshare.com/2.8inch-capacitive-touch-lcd.htm connected to esp32. I have downloaded the demo code and cant seem to get lvgl working on platformio, too many compilier errors however it seems that i got the demo touch driver sort of working. Compilier no more gives errors when now using only tft_espi i had to get rud of every file and lib that used lvgl. Havent test yet am buzy making cover for the display and will get to testing afterwards. Also i dit see this aftenoon that their is an esp32s3 version of the display also availabe from waveshare.https://www.waveshare.com/esp32-s3-touch-lcd-2.8.htm and acording to that demo their is miner changes to the touch driver so whould like to see if i can also get that one to work.

AnRich26 Feb 3, 2025

new

Mostly on waveshare at the bottom of their products they gives you a list of other available products and what display and touch driver and so on is used. Also if you download your demo code for the display or dev module usually inside the downloaded folder if you open up their touch lib it also tells u witch driver is used if not on their website. Thats how i know my display usses CST328.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Waveshare ESP32-S3-TOUCH-LCD-1.69 crash on tft.init() / PlatformIO - Arduino framework SOLVED! #3641

{{title}}

Replies: 4 comments 8 replies

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{title}}

{{title}}

{{title}}

Select a reply

Waveshare ESP32-S3-TOUCH-LCD-1.69 crash on tft.init() / PlatformIO - Arduino framework SOLVED! #3641

Replies: 4 comments · 8 replies

Cat30Mk3 Jan 30, 2025 Author

Cat30Mk3 Jan 30, 2025 Author

Cat30Mk3 Jan 31, 2025 Author

Cat30Mk3 Feb 1, 2025 Author

Cat30Mk3 Feb 3, 2025 Author

Replies: 4 comments 8 replies

Cat30Mk3 Jan 30, 2025
Author

Cat30Mk3 Jan 30, 2025
Author

Cat30Mk3 Jan 31, 2025
Author

Cat30Mk3
Feb 1, 2025
Author

Cat30Mk3
Feb 3, 2025
Author