waveshare_esp32_touch_1.69inch_lvgl_template

This is a simple template project to make it easier to use the Waveshare ESP32 1.69" Touch Display with LVGL (Light and Versatile Graphics Library).

I created this template to help get started quickly with the basic setup and functions.

Features

• LVGL support
• Basic screen brightness control
• Short and double touch press callbacks
• Simple tone output support
• Periodic update via Ticker

Usage

Brightness Control

void setBrightness(uint8_t brightness);

Set screen brightness (0–255).

---

Touch Callbacks

void setShortPressCallback(ButtonCallback cb);

Set a callback for short press events.

void setDoublePressCallback(ButtonCallback cb);

Set a callback for double press events.

---

Tone Output

void toneOut(int pitch, int duration);

Play a tone using defined pitch and duration (in ms).

Example pitch constants (defined in tone.h):

#define TONE_AN 220   // A
#define TONE_AS 233   // A#
#define TONE_BN 247   // B
#define TONE_CN 261   // C
#define TONE_CS 277   // C#
#define TONE_DN 294   // D
#define TONE_DS 311   // D#
#define TONE_EN 330   // E
#define TONE_FN 349   // F
#define TONE_FS 370   // F#
#define TONE_GN 392   // G
#define TONE_GS 415   // G#

---

Periodic Ticker Callback

Use FreeRTOS tasks for periodic updates:

TaskHandle_t otherTaskHandle = NULL;

void otherTask(void *parameter)
{
    static long counter = 0;
    while (1)
    {
        counter = millis() / 1000;
        String str = "Counter" + String(counter);
        lv_label_set_text(label, str.c_str()); // Update the label text
        vTaskDelay(1000 / portTICK_PERIOD_MS); // Delay for 1 second
    }
}

xTaskCreatePinnedToCore(
    otherTask,        // Task function
    "Other Task",     // Task name
    2048,             // Stack size (words)
    NULL,             // Parameters
    1,                // Priority (1 is usually enough)
    &otherTaskHandle, // Task handle
    0                 // Core 0 or 1 (0 is good for simple tasks)
);

---

Hardware

• Display: Waveshare 1.69" Touch LCD
• Board: ESP32-based (e.g., ESP32-S3)

Product page: Waveshare ESP32-S3 Touch LCD 1.69"
Wiki/documentation: Waveshare Wiki

Getting Started

1. Clone this repo
2. Set up your ESP32 dev environment (PlatformIO or Arduino IDE)
3. Flash to your board and start building your UI!

License

MIT License – free to use and modify.

---

Support This Project

If you find this project helpful, you can buy me a coffee ☕

Contact

For work inquiries or collaborations, reach out via email: nguyenleybme@gmail.com