example

Example of the component espp/ws-s3-touch v1.0.16
# Waveshare ESP32-S3 TouchLCD Example

This example shows how to use the `espp::WsS3Touch` hardware abstraction
component to automatically detect and initialize components on the Waveshare
ESP32-S3 TouchLCD board, and use the LVGL graphics library to draw on the
display. It also plays a sound when you touch the screen using the buzzer on the
system, and it changes the frequency of the sound based on the position of the
touch.

<img width="1260" height="949" alt="image" src="https://github.com/user-attachments/assets/06403f4d-ffe4-4ed8-8eca-f6d1d85a878c" />

Older images from when the color / size was incorrectly set:
<img width="1260" height="949" alt="image" src="https://github.com/user-attachments/assets/17e8def4-0d64-4e9e-8cee-dc2753a657a6" />
<img width="1260" height="949" alt="image" src="https://github.com/user-attachments/assets/512ca611-1ab0-4941-b4a3-4ef22d65e567" />

https://github.com/user-attachments/assets/e1905efc-d7cf-448a-86e8-a15c3f294f8c

## How to use example

### Hardware Required

This example is designed to run on the Waveshare ESP32-S3 TouchLCD board.

### Build and Flash

Build the project and flash it to the board, then run monitor tool to view
serial output:

```
idf.py -p PORT flash monitor
```

(Replace PORT with the name of the serial port to use.)

(To exit the serial monitor, type ``Ctrl-]``.)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

## Example Output

<img width="777" height="604" alt="CleanShot 2025-07-13 at 22 01 56" src="https://github.com/user-attachments/assets/02ea3513-7af9-43bb-96e4-10706f31f831" />

<img width="1260" height="949" alt="image" src="https://github.com/user-attachments/assets/06403f4d-ffe4-4ed8-8eca-f6d1d85a878c" />

Older images from when the color / size was incorrectly set:
<img width="1260" height="949" alt="image" src="https://github.com/user-attachments/assets/17e8def4-0d64-4e9e-8cee-dc2753a657a6" />
<img width="1260" height="949" alt="image" src="https://github.com/user-attachments/assets/512ca611-1ab0-4941-b4a3-4ef22d65e567" />

https://github.com/user-attachments/assets/e1905efc-d7cf-448a-86e8-a15c3f294f8c

To create a project from this example, run:

idf.py create-project-from-example "espp/ws-s3-touch=1.0.16:example"

or download archive (~6.84 KB)