This application shows how to use lv-binding-rust crate on a ESP32S3 device along with the touchscreen. The program will display weather and time information for 4 cities.
Aliexpress ESP32-8048S070 - 7 inch 800x400 TN RGB with ESP32S3, 8M PSRAM, 16M Flash, 512KB SRAM
I used a class 10, 4GB SDcard for storage.
The Weather Forecaster App shows current time and date, current weather conditions and forecasted weather for 4 cities in the Home pane. Any or all of the four cities can be changed by going to the Cities Settings and clicking the Edit button. The App uses the zipcode to download weather data from weatherapi.com every 10 minutes. The user must register with weatherapi.com to get a key to allow downloading the weather data.
The Wifi Settings pane allows the user to change the wifi network (SSID) and the wifi password after clicking the Edit button.
The Wifi settings, the four Cities settings and the Weather API key are each stored in seperate text files on the SDCard. Wifi settings are stored in WIFI.TXT file, the Cities settings are stored in CITIES.TXT file and the Weather API key is stored in KEY.TXT file. These file need to be the correct information before starting the APP as the APP reads the SDCard at startup to to obtain the information for the APP.
If the user changes a Wifi Setting or a Cities Setting the changes will be saved to the SDCard so when the device is powered down and then powered up it will show the latest changes.
The partition-table folder contains a file called partitons.csv. This file increases the default factory/app partiton from the default of 1M to 3M. This allows us more space for our program and since the flash size is 16M this should not be a problem. This file will be called when we flash the device.
I left the custom-fonts folder in the project but currenly I am not using a custom but but instead using various LV_FONT_MONTSERRAT_xx enabled in the lv_conf.h file.
The custom-fonts folder contains our custom fonts. The customs fonts are converted from TTF fonts using lvgl online font converter at https://lvgl.io/tools/fontconverter. I used https://ttfonts.net to find a font I liked and then downloaded the font. In the lvgl-online-font-converter I used the font name plus the font size for the name of the font. I chose Bpp of 2 bit-per-pixel and set the range of 0x30-0x3A since I only need numbers and the ":" character. After clicking on "Convert" the file will be downloaded. I placed this downloaded file (*.c) into the custom-fonts folder. Then I created a header file which has an extern to my *.c file, along with changing the ifndef and define names.
To use this custom font, I added LVGL_FONTS_DIR = {relative = true, value = "custom-fonts"} to my config.toml under [env]. This allows our font to be compiled when lvgl is compiled.
The lvgl-configs folder holds the lv_config.h and lv_drv_conf.h files which are required by lvgl to compile. Everything in lv_drv_conf.h file is set to 0 as I am not using the lvgl drivers. The following changes were made to the lv_conf.h file.
- Enabled LV_FONT_MONTSERRAT_10, LV_FONT_MONTSERRAT_12, LV_FONT_MONTSERRAT_14, LV_FONT_MONTSERRAT_16, LV_FONT_MONTSERRAT_24, LV_FONT_MONTSERRAT_36 fonts
- To show memory usage and cpu utilization on display I set #define LV_USE_PERF_MONITOR 1 (line 246) and #define LV_USE_MEM_MONITOR 1 (line 253).
- Changed LV_MEM_SIZE to (80U * 1024U)
The LCD RGB panel driver.
The GT911 touchscreen controller driver.
Increased the main stack size
CONFIG_ESP_MAIN_TASK_STACK_SIZE=16000
Enabled tick frequency to 1000 Hz
CONFIG_FREERTOS_HZ=1000
Added to get mbedtls to validate
# Required otherwise esp-x509-crt-bundle: fails to validate
CONFIG_MBEDTLS_DEFAULT_MEM_ALLOC=y
The added the following to use PSRAM.
CONFIG_SPIRAM=y
CONFIG_SPIRAM_MODE_OCT=y
CONFIG_SPIRAM_SPEED_80M=y
# Enabling the following configurations can help increase the PCLK frequency in the case when
# the Frame Buffer is allocated from the PSRAM and fetched by EDMA
CONFIG_SPIRAM_FETCH_INSTRUCTIONS=y
CONFIG_SPIRAM_RODATA=y
Set CPU frequency to run at 240Mhz
CONFIG_ESP_DEFAULT_CPU_FREQ_MHZ_240=y
I changed the following to the "dependencies" section.
[dependencies]
# Logging
log = "0.4"
# ESP specifics
esp-idf-svc = "0.51"
# LVGL
lvgl = { version = "0.6.2", default-features = false, features = [
"embedded_graphics",
"unsafe_no_autoinit",
#"lvgl_alloc",
#"alloc"
] }
lvgl-sys = { version = "0.6.2" }
# Hardware IO Abstraction Layer
embedded-hal = { version = "1.0.0" }
embedded-svc = "0.28"
embedded-graphics-core = "0.4.0"
# Error
anyhow = "1.0"
# Serde
serde = { version = "1.0.195", features = ["derive"] }
serde_json = "1.0"
# Date and Time
chrono = "0.4.31"
chrono-tz = { version = "0.6.2", features = [ "filter-by-regex" ] }
# C String
cstr_core = "0.2.1"
I also included patch.crates-io section to patch lvgl and lvgl-sys
[patch.crates-io]
lvgl = { git = "https://github.com/enelson1001/lv_binding_rust" }
lvgl-sys = { git = "https://github.com/enelson1001/lv_binding_rust" }
# Need to use Master branch if using esp-idf greater than version 5.2 (ie v5.4.2, v5.5.1)otherwise esp_lcd_panel_rgb.h is not included
esp-idf-sys = { git = "https://github.com/esp-rs/esp-idf-sys.git"}
# Need to use Master branch if using esp-idf v5.5.1 or else you will get the following 2 errors
# error[E0422]: cannot find struct, variant or union type `twai_timing_config_t__bindgen_ty_1` in this scope
# error[E0560]: struct `esp_idf_sys::twai_timing_config_t` has no field named `__bindgen_anon_1`
esp-idf-hal = { git = "https://github.com/esp-rs/esp-idf-hal.git"}
esp-idf-svc = { git = "https://github.com/esp-rs/esp-idf-svc.git"}
To get lv-bindings-rust to comple and build I made the following changes to the config.toml file.
[build]
target = "xtensa-esp32s3-espidf"
[target.xtensa-esp32s3-espidf]
linker = "ldproxy"
runner = "espflash flash --monitor"
rustflags = [ "--cfg", "espidf_time64",]
[unstable]
build-std = ["std", "panic_abort"]
[env]
MCU="esp32s3"
# Note: this variable is not used by the pio builder (`cargo build --features pio`)
ESP_IDF_VERSION = "v5.5.1"
# The directory that has the lvgl config files - lv_conf.h, lv_drv_conf.h
DEP_LV_CONFIG_PATH = { relative = true, value = "lvgl-configs" }
# Required to make lvgl build correctly otherwise get wrong file type (ie compiled for a big endian system and target is little endian)
CROSS_COMPILE = "xtensa-esp32s3-elf"
# Required for lvgl otherwise the build would fail with the error -> dangerous relocation: call8: call target out of range
# for some lvgl functions
CFLAGS_xtensa_esp32s3_espidf="-mlongcalls"
# Directory for custom fonts (written in C) that Lvgl can use
LVGL_FONTS_DIR = {relative = true, value = "custom-fonts"}
# Filter timezones so only US get installed
CHRONO_TZ_TIMEZONE_FILTER="(US/.*)"
# Required for lvgl to build otherwise you will get string.h not found.
# Verfiy path and toolchain version being used on your PC (esp-14.2.0_20240906)
TARGET_C_INCLUDE_PATH = "/home/ed/.rustup/toolchains/esp/xtensa-esp-elf/esp-15.2.0_20250920/xtensa-esp-elf/xtensa-esp-elf/include"
I used my fork of lv-binding-rust to build this project
I used the following command to flash the ESP32S3 device.
$ cargo espflash flash --partition-table=partition-table/partitions.csv --monitor
The application used 71.25% of the flash as shown in the bootup message: App/part. size: 2,241,232/3,145,728 bytes, 71.25%
The board has 8M of flash but I set partition to use 3M for factory.
- I use button matrix for the navigation buttons and it is used by the virtual lvgl keyboard. The virtual keyboard response to a clicked key seems slow and I could not find a way to improve this.
- The AQI reading from weatherapi.com seems to be inaccurate as compared to AirNow.
- I believe I am really close to maxing out the available RAM on the ESP32S3.
- Setting
#define LV_DISP_DEF_REFR_PERIOD 10 (line 81) in lv_conf.hincreased FPS from 66 to 100. - Setting
lcd_panel_config = RgbPanelConfigBuilder::new().clk_src_ppl240m(true)andCONFIG_ESP_DEFAULT_CPU_FREQ_MHZ_240=yreduce CPU utilization. - Setting
lcd_panel_config = RgbPanelConfigBuilder::new().bounce_buffer_size_px(3200)to a larger value did not seem to make any difference. But if you see the display shift you may want to adjust this value. - Also if display shifts then setting
CONFIG_SPIRAM_XIP_FROM_PSRAM=y CONFIG_LCD_RGB_RESTART_IN_VSYNC=yin sdconfig.defaults may help. - Lvgl memory monitor displayed 60.7kB used (76%), 2% frag. If memory fragmentation was high (greater than 60%) the I would increase LV_MEM_SIZE.
- Lvgl cpu utilization displayed 100 FPS, 2-12% CPU
I purchased the case from vendor on Etsy - The3dPrintedNerd. https://www.etsy.com/listing/1498992104/esp-32-7-case-with-stand-perfect-for
I liked that the case can be either wall-mounted or includes bracket to allow it to sit on desk.
video_weather_forecaster.mp4
This is an old picture. The CPU was not running at 240MHz and the #define LV_DISP_DEF_REFR_PERIOD was set to 30 so that is why FPS is 33 and CPU utilization is 14%
- initial release
Oct 13, 2025
- Update lcd_panel.rs to use builder for easier user implementation for different LCD displays
- Used esp-idf-svc SdCardDriver and FatFS for FileStore instead of embedded-sdmmc = "0.7.0"
- Tested with the following versions
- Rust: rustc 1.90.0 (1159e78c4 2025-09-14)
- espup: espup 0.16.0
- esp-idf: v5.42 or v5.5.1
March 01, 2025
- Use latest lv_binding_rust commit d83b374, use https instead of http (seems more reliable)
- use esp-idf-svc v0.51,
- use https instead of http
- check if wifi is up before doing http request and try multiple times to reconnect
- improve wifi error handling