dominic/Tactility
1
0
Fork 0
mirror of https://github.com/ByteWelder/Tactility.git synced 2026-02-18 19:03:16 +00:00
Code Issues Packages Projects Releases Wiki Activity
Tactility/Modules/lvgl-module
History
Ken Van Hoeylandt d860ba1f34
Tab5 audio, I2C improvements, UiDensity moved to lvgl-module and cleanup (#506) 
- UiDensity moved to lvgl-module
- Deleted tt_hal and tt_hal_gpio (breaks apps, but will fix those right after merging)
- Added I2C 8 bit register operations
- Added device.properties to simulator
- Improved Tab5 hardware init, implement audio
- Add README.md to kernel
2026-02-15 19:45:12 +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
Tab5 audio, I2C improvements, UiDensity moved to lvgl-module and cleanup (#506)
2026-02-15 19:45:12 +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.