dc8wan/esphome-lvgl
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Esphome touch screen setup
1,110 commits 1 branch 3 tags 4.2 MiB
Find a file
Exact
jtenniswood 9fd14d0cf6 Refactor device.yaml to reorganize ESP32-C6 configuration and restore display settings. Reintroduce video memory configuration and ensure proper structure for secondary device connectivity. This update enhances clarity and maintains compatibility with the latest ESPHome features.
2026-02-22 14:42:40 +00:00
archived/waveshare-esp32-s3-touch-lcd-7 Refactor README and configuration files for Guition ESP32 devices. Update image paths to a centralized directory and rename template files to esphome.yaml for consistency. Remove obsolete template.yaml files from multiple device directories, enhancing clarity and organization in the project structure. 2026-02-19 20:35:07 +00:00
guition-esp32-p4-jc1060p470 Refactor README and configuration files for Guition ESP32 devices. Update image paths to a centralized directory and rename template files to esphome.yaml for consistency. Remove obsolete template.yaml files from multiple device directories, enhancing clarity and organization in the project structure. 2026-02-19 20:35:07 +00:00
guition-esp32-p4-jc4880p443 Refactor README and configuration files for Guition ESP32 devices. Update image paths to a centralized directory and rename template files to esphome.yaml for consistency. Remove obsolete template.yaml files from multiple device directories, enhancing clarity and organization in the project structure. 2026-02-19 20:35:07 +00:00
guition-esp32-p4-jc8012p4a1 Refactor device.yaml to reorganize ESP32-C6 configuration and restore display settings. Reintroduce video memory configuration and ensure proper structure for secondary device connectivity. This update enhances clarity and maintains compatibility with the latest ESPHome features. 2026-02-22 14:42:40 +00:00
guition-esp32-s3-4848s040 Refactor README and configuration files for Guition ESP32 devices. Update image paths to a centralized directory and rename template files to esphome.yaml for consistency. Remove obsolete template.yaml files from multiple device directories, enhancing clarity and organization in the project structure. 2026-02-19 20:35:07 +00:00
images Refactor README and configuration files for Guition ESP32 devices. Update image paths to a centralized directory and rename template files to esphome.yaml for consistency. Remove obsolete template.yaml files from multiple device directories, enhancing clarity and organization in the project structure. 2026-02-19 20:35:07 +00:00
.DS_Store Revert "Adjust button placement and temps" 2026-02-03 16:01:21 +00:00
README.md Refactor README and configuration files for Guition ESP32 devices. Update image paths to a centralized directory and rename template files to esphome.yaml for consistency. Remove obsolete template.yaml files from multiple device directories, enhancing clarity and organization in the project structure. 2026-02-19 20:35:07 +00:00

README.md

ESPHome LVGL Configuration Repository

Welcome to my ESPHome LVGL configuration repository! This project provides a modular setup for ESP32 touch LCD devices using the LVGL graphics library, designed specifically for home automation and sensor monitoring.

7-inch touch LCD display running ESPHome with LVGL interface, showing home automation controls including temperature display, printer status, air conditioning controls, and various smart home features.

Purpose

This repository contains ESPHome configurations for creating beautiful, touch-enabled displays for home automation. The setup is organized into modular components that can be mixed and matched to create custom interfaces for different rooms and use cases.

Features

  • ESP32 Touch LCD Support: Optimized for multiple ESP32-based touch LCD displays
  • Modular Design: Organized components for easy customization
  • LVGL Interface: Modern, responsive touch interface
  • Sensor Integration: Built-in support for various sensors
  • Custom Themes: Styled buttons and UI components
  • Network & Time: Automatic network connectivity and time synchronization
  • Backlight Control: Intelligent display brightness management

Supported Devices

Guition ESP32-P4 JC1060P470 (7", ~£40)

Guition ESP32-P4 JC1060P470

Guition ESP32-S3 4848S040 (4.0", ~£16)

Guition ESP32-S3 4848S040

Waveshare ESP32-S3 Touch LCD 7" (~£40)

Waveshare ESP32-S3 Touch LCD 7

Where to Buy

Device Configuration Where to Buy
Guition ESP32-P4 JC1060P470 (7") esphome.yaml AliExpress
Guition ESP32-S3 4848S040 (4.0") esphome.yaml AliExpress
Waveshare ESP32-S3 Touch LCD 7" esphome.yaml AliExpress

Stands

Desk/desktop stands (3D printable models on MakerWorld):

Device Stand
Guition ESP32-P4 JC1060P470 (7") Link
Guition ESP32-S3 4848S040 (4.0") Link
Waveshare ESP32-S3 Touch LCD 7" Link

How to get it working

Follow these steps in order. The first flash is the only fiddly part; after that you can usually update over WiFi (OTA).

  1. Fork this repo (recommended) and clone it. The configs are meant to be customized for your own setup rather than used as-is.

  2. Install ESPHome
    Use the ESPHome installation guide. Run the ESPHome dashboard (e.g. esphome dashboard or your usual method) and open it in Chrome — you’ll need Chrome for USB flashing later.

  3. Add your device config
    For your panel, open the esphome.yaml in that device's folder (see the table above). Use the full contents of that file as your ESPHome config: in the dashboard, create a new device (or edit an existing one) and paste in the template contents.

  4. Set WiFi and secrets
    In the ESPHome dashboard, open Secrets (top right) and add at least:

    wifi_ssid: "Your_WiFi_SSID"
wifi_password: "Your_WiFi_Password"

  5. First flash over USB
    Connect the board with a USB cable. In the dashboard, compile and choose Install (flash). Pick the serial port when asked.

    • If the board isn’t found, install the USB drivers (CP210x, CH340, etc.) — ESPHome will prompt you and give links.
    • If the board has factory demo firmware and the flash fails, put it in flashing mode once: hold boot, press reset, then try flashing again. You usually only need to do this once.
    • Disconnect the USB and reconnect it to power each time you flash over USB. This isn't required for updates over WiFi.

  6. Done
    After a successful flash, the device should appear in the ESPHome dashboard and in Home Assistant as a discovered device. Later you can update it over WiFi (OTA) from the dashboard.

  7. Allow Home Assistant actions
    For the screen to be able to control things in Home Assistant (e.g. toggle lights, activate scenes), you need to enable this per-device. In Home Assistant go to Settings → Devices & Services → ESPHome, click Configure on your device, and turn on "Allow the device to perform Home Assistant actions". Without this, any homeassistant.action calls from the display will be silently ignored.

Optional: To change what’s on the display, edit the YAML in the device folder: device/device.yaml, device/sensors.yaml, device/lvgl.yaml, plus addon/, assets/, and theme/ as needed.

Resources

Home Assistant Stateful Scenes

The lighting scene examples in this project assume you are using the Stateful Scenes integration for Home Assistant so scene state can be inferred reliably (for example, keeping a scene switch "on" when all scene entities match). Install and configure the add-on here: https://github.com/hugobloem/stateful_scenes.

Remember: This repository contains my personal home automation setup. Please fork and customize it for your own environment.