dominic/Tactility
1
0
Fork 0
mirror of https://github.com/ByteWelder/Tactility.git synced 2026-04-18 09:25:06 +00:00
Code Issues Packages Projects Releases Wiki Activity
Tactility/Modules/lvgl-module
History
Shadowtrance e64f4ff16b
M5Stack StickS3 - New Tab5 - driver modules (#516) 
Font size set to 18 for 800x480 displays
Fix web server dashboard not rendering when sdcard isn't present

Added new driver modules
-  BM8563 RTC
- RX8130CE RTC
- MPU6886 IMU
- QMI8658 IMU
- M5PM1 Power Management Chip

Applied the above modules to applicable devicetrees.

Added new device: M5Stack StickS3

Added new M5Stack Tab5 St7123 variant.

ButtonControl changed to use interupts and xQueue, added AppClose action.

And some bonus symbols of course, the apps are hungry for symbols.
2026-03-20 10:07:57 +01:00
..
assets
Rename icons, fix T-Lora Pager config and more (#502)
2026-02-15 13:32:52 +01:00
include/tactility
Tab5 audio, I2C improvements, UiDensity moved to lvgl-module and cleanup (#506)
2026-02-15 19:45:12 +01:00
source
M5Stack StickS3 - New Tab5 - driver modules (#516)
2026-03-20 10:07:57 +01:00
source-fonts
Implement UI scaling and more (#501)
2026-02-15 01:41:47 +01:00
CMakeLists.txt
Tab5 audio, I2C improvements, UiDensity moved to lvgl-module and cleanup (#506)
2026-02-15 19:45:12 +01:00
LICENSE-Apache-2.0.md
Rename icons, fix T-Lora Pager config and more (#502)
2026-02-15 13:32:52 +01:00
README.md
Rename icons, fix T-Lora Pager config and more (#502)
2026-02-15 13:32:52 +01:00

README.md

lvgl-module

This module manages the lifecycle of the LVGL library within the Tactility ecosystem.

What the library does

The lvgl-module provides:

  • Lifecycle Management: Handles initialization and termination of the LVGL library.
  • Task Management: Manages the LVGL main loop task.
  • Thread-Safety: Provides mutex-based locking mechanisms (lvgl_lock, lvgl_unlock) to ensure safe access to LVGL APIs from multiple tasks.
  • Font Access: Provides a unified interface to access pre-configured text and icon fonts.

Different types of fonts

The module supports two main categories of fonts:

Text Fonts

Standard text rendering uses the Montserrat font. Three sizes are pre-configured:

  • FONT_SIZE_SMALL
  • FONT_SIZE_DEFAULT
  • FONT_SIZE_LARGE

Icon Fonts

Icons are provided by the Material Symbols font, divided into three usage-specific sets:

  • Statusbar Icons: Optimized for the system status bar.
  • Launcher Icons: Sized for application launchers.
  • Shared Icons: General purpose icons used across the system.

How to update the fonts

Font sizes and symbols are configurable:

  • On ESP32 (IDF): Sizes can be updated via menuconfig or by editing sdkconfig. Look for CONFIG_TT_LVGL_FONT_SIZE_* and CONFIG_TT_LVGL_*_ICON_SIZE parameters.
  • On Simulator/POSIX: Default sizes are defined in Modules/lvgl-module/CMakeLists.txt.

If you change an icon font size, ensure that a corresponding C file exists in source-fonts/ (e.g., material_symbols_shared_24.c). These files are generated from TTF/OTF fonts using the LVGL font converter.

License

This module is licensed under the Apache v2.0 license.