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
Ken Van Hoeylandt aa7530e515
New kernel drivers, filesystem API, and more (#513) 
* **New Features**
  * BMI270 6-axis IMU driver added; new unified filesystem abstraction for mounted filesystems.
  * Public Wi‑Fi API surface (no implementation yet)
  * SDMMC driver added (kernel drive$)
  * expanded GPIO interrupt/callback support
* **Improvements**
  * M5Stack Tab5: revamped GPIO/power initialization and IMU integration.
  * LVGL updates including device fontSize configuration.
  * Updated all code related to SD card device/fs handling
  * Rename LilyGO T-HMI S3 to LilyGO T-HMI
* **Bug Fixes**
  * Simplified and consolidated SD card handling and mount discovery.
2026-03-07 16:13:39 +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
New kernel drivers, filesystem API, and more (#513)
2026-03-07 16:13:39 +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.