GUITION 4" 480x480 ESP32-S3-4848S040 Smart Display with LVGL

andrew_NH · January 7, 2026, 7:39pm

Looks great! Use a smaller font so the names don’t go off the side of the buttons.

Artypete · January 16, 2026, 5:44pm

Hi all, I received my Guition 4" display yesterday, and when I switched it on I had the expected welcome screen, it scanned for wifi but I was just unable to connect at all (tried it many times). So decided to go direct to flashing it with one of the examples here, but now it is COMPLETELY DEAD I’ve since tried many, many other versions to flash it with, all flash totally fine, but every single time the unit is 100% dead after flashing. Can anyone help with what I’m getting wrong?

EDIT: I’ve managed to flash with Tamosata and it worked ok. But every attempt at ESPhome fails. I’ve come to the conclusion that it must need a different ESP32 board, but no luck finding it yet. My S3 chip is not a Vwroom but ‘Sparkle XH-S3E’. Anyone help with the board to use?

andrew_NH · January 19, 2026, 3:47pm

I have a lot of these screens and this code works well.

github.com/agillis/esphome-modular-lvgl-buttons

example_code/guition-esp32-s3-4848s040-display_modular.yaml

7abfa5745

# Substitution variables used through the codebase
substitutions:
  icon_font: mdi_icons_40
  text_font: nunito_20
  text_color: white
  bg_color: black
  button_on_color: "ep_orange"
  button_off_color: "very_dark_gray"
  icon_on_color: "yellow"
  icon_off_color: "gray"
  label_on_color: "white"
  label_off_color: "gray"
  button_text_color: "white"
  touchscreen_idle_timeout: "30s"
  touchscreen_daytime_brightness: "100%"
  touchscreen_nighttime_brightness: "50%"
  # Boot screen configuration
  boot_screen_delay: 60s

  # LCD backlight modes - Code in backlight.yaml

This file has been truncated. show original

Use the “factory” image not any of the other images that are made during the build.

andrew_NH · January 21, 2026, 5:15am

I updated the weather part of my library to pull the full daily weather forecast from Home Assistant directly.

rtorrente · January 21, 2026, 3:45pm

Does anyone find a EU version of a similar screen that can be fitted in a EU Rounded box ?

I have seen https://french.alibaba.com/product-detail/2025-New-Home-Automation-Smart-Home-1601204231654.html (Supported by OpenHASP Golden Security - openHASP) but it seems that now the chip has changed and is not ESP Based anymore (T3E v2 (pcb rev. v2.3) · HASwitchPlate/openHASP · Discussion #458 · GitHub)

genau_der · January 24, 2026, 8:57pm

@andrew_NH I like the idea of you library/expansion to make things easier. Is there already some kind of documentation?

In example, I don’t quite get it how to adjust the font size of the clock button.

Can the weather forecast also be used with other weather providers like OpenWeatherMap?

Since I’m from Germany, I’d like to have the labels in German, the day names, months, and so on. Can I translate them manually? Same for temperatures, which I need in Celsius, not Fahrenheit.

Thanks in advance for your help!

andrew_NH · January 26, 2026, 3:53am

Did you looks at the readme file in the same folder as the weather code? I has a lot of info on how it works.

When you include the libary you set the varable “weather_entity:” this can be any weahter entry on HA.

You would need to make your own version of the code to change the language.

All the weahter data is pulled from your settings in HA. I sould be pulling the units from there as well but I’m not. I’ll make that change.

most of the fonts and colors etc are in the style file. You could use your own style insted of mone and change almost anything.

ferbulous · January 30, 2026, 2:35am

Hi, using your example here

github.com/agillis/esphome-modular-lvgl-buttons

example_code/guition-esp32-s3-4848s040-display_modular.yaml

a1fc1edfd

# Substitution variables used through the codebase
substitutions:
  icon_font: mdi_icons_40
  text_font: nunito_24
  text_color: white
  bg_color: black
  button_on_color: "ep_orange"
  button_off_color: "very_dark_gray"
  icon_on_color: "yellow"
  icon_off_color: "gray"
  label_on_color: "white"
  label_off_color: "gray"
  button_text_color: "white"
  button_height_single: '109px'
  button_height_double: '228px'
  button_width: '150px'
  touchscreen_idle_timeout: "30s"
  touchscreen_daytime_brightness: "100%"
  touchscreen_nighttime_brightness: "50%"
  # Boot screen configuration

This file has been truncated. show original

But I keep bumping to this error, how do I fix it?

Failed config

Source for extension of ID 'main_page' was not found.

andrew_NH · January 30, 2026, 4:42pm

That is not an error I am getting here and I have quite a few of these screens in my house.

Try this make sure you have the latest esphome (should be 2026.1.3)

Get a clean copy of my library

git clone https://github.com/agillis/esphome-modular-lvgl-buttons.git

Clean your build

esphome clean guition-esp32-s3-4848s040-display_modular.yaml

build

 esphome run guition-esp32-s3-4848s040-display_modular.yaml

ferbulous · February 3, 2026, 2:06pm

Thanks, quick question

Is it possible to use custom image as background?
I need a button with slider on the main page like the dimming button but it’s for controlling fan speed instead. Any example for this? Or maybe a dropdown option (slow, medium, fast)
For the SDL display, since I run linux on headless machine. Is there a way to remotely connect to that display?

andrew_NH · February 3, 2026, 4:42pm

Yes it would be easy to modify the yaml file to do this. Check the disp_bg_image
tag here LVGL Graphics - ESPHome - Smart Home Made Simple

Yes this is possible. I recommend making a copy of the slider then modifying it for your needs.

I use headless Linux for all my development. I use an RDP client from a Windows machine to connect to my desktop on the headless box

ferbulous · February 4, 2026, 12:58am

Thanks, I think I’m gonna have to ask chatgpt to reedit the codes for slider page since i’m not really great with coding.
Is it possible to have to 2 sliders on the same button on the home page (1 for brightness and 2nd one for color temperature)
I don’t see climate/air conditioner control page, do you mind showing where that is?

How do you configure rdp client to connect to the SDL display?

andrew_NH · February 4, 2026, 3:35pm

Sure you can do anything you want with coding. I personally think this is to much for a small button so that is why this functionally is in the sub page.

I don’t have one of these but it should be easy to build.

Yeah me neither. Use the free Microsoft code studio. It’s great!

I just have it connect to my GNOME desktop. That way I can have the SDL test app, a bash prompt to compile code and Code Studio all running at once.

You could probably use SDL-VNC to make a VNC connection direct to the app but getting the whole desktop is so much easier.

ferbulous · February 6, 2026, 12:35am

Hi @Zenia do you mind sharing your latest yaml?
Getting some errors when compiling

andrew_NH · February 6, 2026, 4:24am

I just added a sensor button that can display data from a sensor info on a button. It also handles updating the button text from the sensor automatically.

Here is a demo that pulls solar data from HA and displays it.

github.com/agillis/esphome-modular-lvgl-buttons

example_code_advanced/SDL-solar-info.yaml

48c1041a9

# Substitution variables used through the codebase
substitutions:
  # Envoy serial number
  envoy_id: !secret envoy_id
  enpower_id: !secret enpower_id
  
  icon_font: mdi_icons_40
  text_font: nunito_18
  sensor_font: nunito_36
  text_color: white
  bg_color: black
  button_on_color: "ep_orange"
  button_off_color: "very_dark_gray"
  icon_on_color: "yellow"
  icon_off_color: "gray"
  label_on_color: "white"
  label_off_color: "gray"
  button_text_color: "white"

  # LCD back light modes - Code in backlight_time.yaml

This file has been truncated. show original

JeeCee · February 7, 2026, 1:19pm

Off-topic: why do you prefer this method over WSL2?

stijnb · February 8, 2026, 6:37pm

Please keep me posted in case you find a version that fits EU rounded boxes. I am also unable to find it.

ferbulous · February 9, 2026, 3:58am

hi, how do I enable backlight controls? I noticed the backlight.yaml but it only needs the coordinates from secret file
i mean could I add some control like sliders to reduce or increase the timeout

andrew_NH · February 9, 2026, 4:39pm

I find Linux easier to use and more flexible. The Linux vs Windows debate may be better for another thread.

andrew_NH · February 9, 2026, 4:41pm

There are already controls in Home Assistant and on the ESPHome web page for the device. But some LVGL controls would be cool if you are interested in building them.