esphome 2024.7.2__py3-none-any.whl → 2024.8.0__py3-none-any.whl

esphome/components/lvgl/defines.py

@@ -0,0 +1,508 @@
+"""
+This is the base of the import tree for LVGL. It contains constant definitions used elsewhere.
+Constants already defined in esphome.const are not duplicated here and must be imported where used.
+
+"""
+
+from esphome import codegen as cg, config_validation as cv
+from esphome.const import CONF_ITEMS
+from esphome.core import Lambda
+from esphome.cpp_generator import LambdaExpression, MockObj
+from esphome.cpp_types import uint32
+from esphome.schema_extractors import SCHEMA_EXTRACT, schema_extractor
+
+from .helpers import requires_component
+
+lvgl_ns = cg.esphome_ns.namespace("lvgl")
+
+
+def literal(arg):
+    if isinstance(arg, str):
+        return MockObj(arg)
+    return arg
+
+
+def call_lambda(lamb: LambdaExpression):
+    expr = lamb.content.strip()
+    if expr.startswith("return") and expr.endswith(";"):
+        return expr[7:][:-1]
+    return f"{lamb}()"
+
+
+class LValidator:
+    """
+    A validator for a particular type used in LVGL. Usable in configs as a validator, also
+    has `process()` to convert a value during code generation
+    """
+
+    def __init__(self, validator, rtype, retmapper=None, requires=None):
+        self.validator = validator
+        self.rtype = rtype
+        self.retmapper = retmapper
+        self.requires = requires
+
+    def __call__(self, value):
+        if self.requires:
+            value = requires_component(self.requires)(value)
+        if isinstance(value, cv.Lambda):
+            return cv.returning_lambda(value)
+        return self.validator(value)
+
+    async def process(self, value, args=()):
+        if value is None:
+            return None
+        if isinstance(value, Lambda):
+            return cg.RawExpression(
+                call_lambda(
+                    await cg.process_lambda(value, args, return_type=self.rtype)
+                )
+            )
+        if self.retmapper is not None:
+            return self.retmapper(value)
+        return cg.safe_exp(value)
+
+
+class LvConstant(LValidator):
+    """
+    Allow one of a list of choices, mapped to upper case, and prepend the choice with the prefix.
+    It's also permitted to include the prefix in the value
+    The property `one_of` has the single case validator, and `several_of` allows a list of constants.
+    """
+
+    def __init__(self, prefix: str, *choices):
+        self.prefix = prefix
+        self.choices = choices
+        prefixed_choices = [prefix + v for v in choices]
+        prefixed_validator = cv.one_of(*prefixed_choices, upper=True)
+
+        @schema_extractor("one_of")
+        def validator(value):
+            if value == SCHEMA_EXTRACT:
+                return self.choices
+            if isinstance(value, str) and value.startswith(self.prefix):
+                return prefixed_validator(value)
+            return self.prefix + cv.one_of(*choices, upper=True)(value)
+
+        super().__init__(validator, rtype=uint32)
+        self.retmapper = self.mapper
+        self.one_of = LValidator(validator, uint32, retmapper=self.mapper)
+        self.several_of = LValidator(
+            cv.ensure_list(self.one_of), uint32, retmapper=self.mapper
+        )
+
+    def mapper(self, value):
+        if not isinstance(value, list):
+            value = [value]
+        return literal(
+            "|".join(
+                [
+                    str(v) if str(v).startswith(self.prefix) else self.prefix + str(v)
+                    for v in value
+                ]
+            ).upper()
+        )
+
+    def extend(self, *choices):
+        """
+        Extend an LVconstant with additional choices.
+        :param choices: The extra choices
+        :return: A new LVConstant instance
+        """
+        return LvConstant(self.prefix, *(self.choices + choices))
+
+
+# Parts
+CONF_MAIN = "main"
+CONF_SCROLLBAR = "scrollbar"
+CONF_INDICATOR = "indicator"
+CONF_KNOB = "knob"
+CONF_SELECTED = "selected"
+CONF_TICKS = "ticks"
+CONF_CURSOR = "cursor"
+CONF_TEXTAREA_PLACEHOLDER = "textarea_placeholder"
+
+# Layout types
+
+TYPE_FLEX = "flex"
+TYPE_GRID = "grid"
+TYPE_NONE = "none"
+
+LV_FONTS = list(f"montserrat_{s}" for s in range(8, 50, 2)) + [
+    "dejavu_16_persian_hebrew",
+    "simsun_16_cjk",
+    "unscii_8",
+    "unscii_16",
+]
+
+LV_EVENT_MAP = {
+    "PRESS": "PRESSED",
+    "SHORT_CLICK": "SHORT_CLICKED",
+    "LONG_PRESS": "LONG_PRESSED",
+    "LONG_PRESS_REPEAT": "LONG_PRESSED_REPEAT",
+    "CLICK": "CLICKED",
+    "RELEASE": "RELEASED",
+    "SCROLL_BEGIN": "SCROLL_BEGIN",
+    "SCROLL_END": "SCROLL_END",
+    "SCROLL": "SCROLL",
+    "FOCUS": "FOCUSED",
+    "DEFOCUS": "DEFOCUSED",
+    "READY": "READY",
+    "CANCEL": "CANCEL",
+}
+
+LV_EVENT_TRIGGERS = tuple(f"on_{x.lower()}" for x in LV_EVENT_MAP)
+
+
+LV_ANIM = LvConstant(
+    "LV_SCR_LOAD_ANIM_",
+    "NONE",
+    "OVER_LEFT",
+    "OVER_RIGHT",
+    "OVER_TOP",
+    "OVER_BOTTOM",
+    "MOVE_LEFT",
+    "MOVE_RIGHT",
+    "MOVE_TOP",
+    "MOVE_BOTTOM",
+    "FADE_IN",
+    "FADE_OUT",
+    "OUT_LEFT",
+    "OUT_RIGHT",
+    "OUT_TOP",
+    "OUT_BOTTOM",
+)
+
+LOG_LEVELS = (
+    "TRACE",
+    "INFO",
+    "WARN",
+    "ERROR",
+    "USER",
+    "NONE",
+)
+
+LV_LONG_MODES = LvConstant(
+    "LV_LABEL_LONG_",
+    "WRAP",
+    "DOT",
+    "SCROLL",
+    "SCROLL_CIRCULAR",
+    "CLIP",
+)
+
+STATES = (
+    "default",
+    "checked",
+    "focused",
+    "focus_key",
+    "edited",
+    "hovered",
+    "pressed",
+    "scrolled",
+    "disabled",
+    "user_1",
+    "user_2",
+    "user_3",
+    "user_4",
+)
+
+PARTS = (
+    CONF_MAIN,
+    CONF_SCROLLBAR,
+    CONF_INDICATOR,
+    CONF_KNOB,
+    CONF_SELECTED,
+    CONF_ITEMS,
+    CONF_TICKS,
+    CONF_CURSOR,
+    CONF_TEXTAREA_PLACEHOLDER,
+)
+
+KEYBOARD_MODES = LvConstant(
+    "LV_KEYBOARD_MODE_",
+    "TEXT_LOWER",
+    "TEXT_UPPER",
+    "SPECIAL",
+    "NUMBER",
+)
+ROLLER_MODES = LvConstant("LV_ROLLER_MODE_", "NORMAL", "INFINITE")
+DIRECTIONS = LvConstant("LV_DIR_", "LEFT", "RIGHT", "BOTTOM", "TOP")
+TILE_DIRECTIONS = DIRECTIONS.extend("HOR", "VER", "ALL")
+CHILD_ALIGNMENTS = LvConstant(
+    "LV_ALIGN_",
+    "TOP_LEFT",
+    "TOP_MID",
+    "TOP_RIGHT",
+    "LEFT_MID",
+    "CENTER",
+    "RIGHT_MID",
+    "BOTTOM_LEFT",
+    "BOTTOM_MID",
+    "BOTTOM_RIGHT",
+)
+
+SIBLING_ALIGNMENTS = LvConstant(
+    "LV_ALIGN_",
+    "OUT_LEFT_TOP",
+    "OUT_TOP_LEFT",
+    "OUT_TOP_MID",
+    "OUT_TOP_RIGHT",
+    "OUT_RIGHT_TOP",
+    "OUT_LEFT_MID",
+    "OUT_RIGHT_MID",
+    "OUT_LEFT_BOTTOM",
+    "OUT_BOTTOM_LEFT",
+    "OUT_BOTTOM_MID",
+    "OUT_BOTTOM_RIGHT",
+    "OUT_RIGHT_BOTTOM",
+)
+ALIGN_ALIGNMENTS = CHILD_ALIGNMENTS.extend(*SIBLING_ALIGNMENTS.choices)
+
+FLEX_FLOWS = LvConstant(
+    "LV_FLEX_FLOW_",
+    "ROW",
+    "COLUMN",
+    "ROW_WRAP",
+    "COLUMN_WRAP",
+    "ROW_REVERSE",
+    "COLUMN_REVERSE",
+    "ROW_WRAP_REVERSE",
+    "COLUMN_WRAP_REVERSE",
+)
+
+OBJ_FLAGS = (
+    "hidden",
+    "clickable",
+    "click_focusable",
+    "checkable",
+    "scrollable",
+    "scroll_elastic",
+    "scroll_momentum",
+    "scroll_one",
+    "scroll_chain_hor",
+    "scroll_chain_ver",
+    "scroll_chain",
+    "scroll_on_focus",
+    "scroll_with_arrow",
+    "snappable",
+    "press_lock",
+    "event_bubble",
+    "gesture_bubble",
+    "adv_hittest",
+    "ignore_layout",
+    "floating",
+    "overflow_visible",
+    "layout_1",
+    "layout_2",
+    "widget_1",
+    "widget_2",
+    "user_1",
+    "user_2",
+    "user_3",
+    "user_4",
+)
+
+ARC_MODES = LvConstant("LV_ARC_MODE_", "NORMAL", "REVERSE", "SYMMETRICAL")
+BAR_MODES = LvConstant("LV_BAR_MODE_", "NORMAL", "SYMMETRICAL", "RANGE")
+
+BUTTONMATRIX_CTRLS = LvConstant(
+    "LV_BTNMATRIX_CTRL_",
+    "HIDDEN",
+    "NO_REPEAT",
+    "DISABLED",
+    "CHECKABLE",
+    "CHECKED",
+    "CLICK_TRIG",
+    "POPOVER",
+    "RECOLOR",
+    "CUSTOM_1",
+    "CUSTOM_2",
+)
+
+LV_BASE_ALIGNMENTS = (
+    "START",
+    "CENTER",
+    "END",
+)
+LV_CELL_ALIGNMENTS = LvConstant(
+    "LV_GRID_ALIGN_",
+    *LV_BASE_ALIGNMENTS,
+)
+LV_GRID_ALIGNMENTS = LV_CELL_ALIGNMENTS.extend(
+    "STRETCH",
+    "SPACE_EVENLY",
+    "SPACE_AROUND",
+    "SPACE_BETWEEN",
+)
+
+LV_FLEX_ALIGNMENTS = LvConstant(
+    "LV_FLEX_ALIGN_",
+    *LV_BASE_ALIGNMENTS,
+    "SPACE_EVENLY",
+    "SPACE_AROUND",
+    "SPACE_BETWEEN",
+)
+
+LV_MENU_MODES = LvConstant(
+    "LV_MENU_HEADER_",
+    "TOP_FIXED",
+    "TOP_UNFIXED",
+    "BOTTOM_FIXED",
+)
+
+LV_CHART_TYPES = (
+    "NONE",
+    "LINE",
+    "BAR",
+    "SCATTER",
+)
+LV_CHART_AXES = (
+    "PRIMARY_Y",
+    "SECONDARY_Y",
+    "PRIMARY_X",
+    "SECONDARY_X",
+)
+
+CONF_ACCEPTED_CHARS = "accepted_chars"
+CONF_ADJUSTABLE = "adjustable"
+CONF_ALIGN = "align"
+CONF_ALIGN_TO = "align_to"
+CONF_ANIMATED = "animated"
+CONF_ANIMATION = "animation"
+CONF_ANTIALIAS = "antialias"
+CONF_ARC_LENGTH = "arc_length"
+CONF_AUTO_START = "auto_start"
+CONF_BACKGROUND_STYLE = "background_style"
+CONF_DECIMAL_PLACES = "decimal_places"
+CONF_COLUMN = "column"
+CONF_DIGITS = "digits"
+CONF_DISP_BG_COLOR = "disp_bg_color"
+CONF_DISP_BG_IMAGE = "disp_bg_image"
+CONF_BODY = "body"
+CONF_BUTTONS = "buttons"
+CONF_BYTE_ORDER = "byte_order"
+CONF_CHANGE_RATE = "change_rate"
+CONF_CLOSE_BUTTON = "close_button"
+CONF_COLOR_DEPTH = "color_depth"
+CONF_CONTROL = "control"
+CONF_DEFAULT = "default"
+CONF_DEFAULT_FONT = "default_font"
+CONF_DEFAULT_GROUP = "default_group"
+CONF_DIR = "dir"
+CONF_DISPLAYS = "displays"
+CONF_ENCODERS = "encoders"
+CONF_END_ANGLE = "end_angle"
+CONF_END_VALUE = "end_value"
+CONF_ENTER_BUTTON = "enter_button"
+CONF_ENTRIES = "entries"
+CONF_FLAGS = "flags"
+CONF_FLEX_FLOW = "flex_flow"
+CONF_FLEX_ALIGN_MAIN = "flex_align_main"
+CONF_FLEX_ALIGN_CROSS = "flex_align_cross"
+CONF_FLEX_ALIGN_TRACK = "flex_align_track"
+CONF_FLEX_GROW = "flex_grow"
+CONF_FULL_REFRESH = "full_refresh"
+CONF_GRID_CELL_ROW_POS = "grid_cell_row_pos"
+CONF_GRID_CELL_COLUMN_POS = "grid_cell_column_pos"
+CONF_GRID_CELL_ROW_SPAN = "grid_cell_row_span"
+CONF_GRID_CELL_COLUMN_SPAN = "grid_cell_column_span"
+CONF_GRID_CELL_X_ALIGN = "grid_cell_x_align"
+CONF_GRID_CELL_Y_ALIGN = "grid_cell_y_align"
+CONF_GRID_COLUMN_ALIGN = "grid_column_align"
+CONF_GRID_COLUMNS = "grid_columns"
+CONF_GRID_ROW_ALIGN = "grid_row_align"
+CONF_GRID_ROWS = "grid_rows"
+CONF_HEADER_MODE = "header_mode"
+CONF_HOME = "home"
+CONF_INITIAL_FOCUS = "initial_focus"
+CONF_KEY_CODE = "key_code"
+CONF_LAYOUT = "layout"
+CONF_LEFT_BUTTON = "left_button"
+CONF_LINE_WIDTH = "line_width"
+CONF_LOG_LEVEL = "log_level"
+CONF_LONG_PRESS_TIME = "long_press_time"
+CONF_LONG_PRESS_REPEAT_TIME = "long_press_repeat_time"
+CONF_LVGL_ID = "lvgl_id"
+CONF_LONG_MODE = "long_mode"
+CONF_MSGBOXES = "msgboxes"
+CONF_OBJ = "obj"
+CONF_OFFSET_X = "offset_x"
+CONF_OFFSET_Y = "offset_y"
+CONF_ONE_LINE = "one_line"
+CONF_ON_SELECT = "on_select"
+CONF_ONE_CHECKED = "one_checked"
+CONF_NEXT = "next"
+CONF_PAD_ROW = "pad_row"
+CONF_PAD_COLUMN = "pad_column"
+CONF_PAGE = "page"
+CONF_PAGE_WRAP = "page_wrap"
+CONF_PASSWORD_MODE = "password_mode"
+CONF_PIVOT_X = "pivot_x"
+CONF_PIVOT_Y = "pivot_y"
+CONF_PLACEHOLDER_TEXT = "placeholder_text"
+CONF_POINTS = "points"
+CONF_PREVIOUS = "previous"
+CONF_REPEAT_COUNT = "repeat_count"
+CONF_RECOLOR = "recolor"
+CONF_RIGHT_BUTTON = "right_button"
+CONF_ROLLOVER = "rollover"
+CONF_ROOT_BACK_BTN = "root_back_btn"
+CONF_ROWS = "rows"
+CONF_SCALE_LINES = "scale_lines"
+CONF_SCROLLBAR_MODE = "scrollbar_mode"
+CONF_SELECTED_INDEX = "selected_index"
+CONF_SHOW_SNOW = "show_snow"
+CONF_SPIN_TIME = "spin_time"
+CONF_SRC = "src"
+CONF_START_ANGLE = "start_angle"
+CONF_START_VALUE = "start_value"
+CONF_STATES = "states"
+CONF_STYLE = "style"
+CONF_STYLES = "styles"
+CONF_STYLE_DEFINITIONS = "style_definitions"
+CONF_STYLE_ID = "style_id"
+CONF_SKIP = "skip"
+CONF_SYMBOL = "symbol"
+CONF_TAB_ID = "tab_id"
+CONF_TABS = "tabs"
+CONF_TIME_FORMAT = "time_format"
+CONF_TILE = "tile"
+CONF_TILE_ID = "tile_id"
+CONF_TILES = "tiles"
+CONF_TITLE = "title"
+CONF_TOP_LAYER = "top_layer"
+CONF_TOUCHSCREENS = "touchscreens"
+CONF_TRANSPARENCY_KEY = "transparency_key"
+CONF_THEME = "theme"
+CONF_UPDATE_ON_RELEASE = "update_on_release"
+CONF_VISIBLE_ROW_COUNT = "visible_row_count"
+CONF_WIDGET = "widget"
+CONF_WIDGETS = "widgets"
+CONF_X = "x"
+CONF_Y = "y"
+CONF_ZOOM = "zoom"
+
+# Keypad keys
+
+LV_KEYS = LvConstant(
+    "LV_KEY_",
+    "UP",
+    "DOWN",
+    "RIGHT",
+    "LEFT",
+    "ESC",
+    "DEL",
+    "BACKSPACE",
+    "ENTER",
+    "NEXT",
+    "PREV",
+    "HOME",
+    "END",
+)
+
+
+DEFAULT_ESPHOME_FONT = "esphome_lv_default_font"
+
+
+def join_enums(enums, prefix=""):
+    return literal("|".join(f"(int){prefix}{e.upper()}" for e in enums))

esphome/components/lvgl/encoders.py

@@ -0,0 +1,77 @@
+import esphome.codegen as cg
+from esphome.components.binary_sensor import BinarySensor
+from esphome.components.rotary_encoder.sensor import RotaryEncoderSensor
+import esphome.config_validation as cv
+from esphome.const import CONF_GROUP, CONF_ID, CONF_SENSOR
+
+from .defines import (
+    CONF_DEFAULT_GROUP,
+    CONF_ENCODERS,
+    CONF_ENTER_BUTTON,
+    CONF_INITIAL_FOCUS,
+    CONF_LEFT_BUTTON,
+    CONF_LONG_PRESS_REPEAT_TIME,
+    CONF_LONG_PRESS_TIME,
+    CONF_RIGHT_BUTTON,
+)
+from .helpers import lvgl_components_required, requires_component
+from .lvcode import lv, lv_add, lv_assign, lv_expr, lv_Pvariable
+from .schemas import ENCODER_SCHEMA
+from .types import lv_group_t, lv_indev_type_t
+
+ENCODERS_CONFIG = cv.ensure_list(
+    ENCODER_SCHEMA.extend(
+        {
+            cv.Required(CONF_ENTER_BUTTON): cv.use_id(BinarySensor),
+            cv.Required(CONF_SENSOR): cv.Any(
+                cv.All(
+                    cv.use_id(RotaryEncoderSensor), requires_component("rotary_encoder")
+                ),
+                cv.Schema(
+                    {
+                        cv.Required(CONF_LEFT_BUTTON): cv.use_id(BinarySensor),
+                        cv.Required(CONF_RIGHT_BUTTON): cv.use_id(BinarySensor),
+                    }
+                ),
+            ),
+        }
+    )
+)
+
+
+async def encoders_to_code(var, config):
+    default_group = lv_Pvariable(lv_group_t, config[CONF_DEFAULT_GROUP])
+    lv_assign(default_group, lv_expr.group_create())
+    lv.group_set_default(default_group)
+    for enc_conf in config[CONF_ENCODERS]:
+        lvgl_components_required.add("KEY_LISTENER")
+        lpt = enc_conf[CONF_LONG_PRESS_TIME].total_milliseconds
+        lprt = enc_conf[CONF_LONG_PRESS_REPEAT_TIME].total_milliseconds
+        listener = cg.new_Pvariable(
+            enc_conf[CONF_ID], lv_indev_type_t.LV_INDEV_TYPE_ENCODER, lpt, lprt
+        )
+        await cg.register_parented(listener, var)
+        if sensor_config := enc_conf.get(CONF_SENSOR):
+            if isinstance(sensor_config, dict):
+                b_sensor = await cg.get_variable(sensor_config[CONF_LEFT_BUTTON])
+                cg.add(listener.set_left_button(b_sensor))
+                b_sensor = await cg.get_variable(sensor_config[CONF_RIGHT_BUTTON])
+                cg.add(listener.set_right_button(b_sensor))
+            else:
+                sensor_config = await cg.get_variable(sensor_config)
+                lv_add(listener.set_sensor(sensor_config))
+        b_sensor = await cg.get_variable(enc_conf[CONF_ENTER_BUTTON])
+        cg.add(listener.set_enter_button(b_sensor))
+        if group := enc_conf.get(CONF_GROUP):
+            group = lv_Pvariable(lv_group_t, group)
+            lv_assign(group, lv_expr.group_create())
+        else:
+            group = default_group
+        lv.indev_set_group(lv_expr.indev_drv_register(listener.get_drv()), group)
+
+
+async def initial_focus_to_code(config):
+    for enc_conf in config[CONF_ENCODERS]:
+        if default_focus := enc_conf.get(CONF_INITIAL_FOCUS):
+            obj = await cg.get_variable(default_focus)
+            lv.group_focus_obj(obj)

esphome/components/lvgl/font.cpp

@@ -0,0 +1,76 @@
+#include "lvgl_esphome.h"
+
+#ifdef USE_LVGL_FONT
+namespace esphome {
+namespace lvgl {
+
+static const uint8_t *get_glyph_bitmap(const lv_font_t *font, uint32_t unicode_letter) {
+  auto *fe = (FontEngine *) font->dsc;
+  const auto *gd = fe->get_glyph_data(unicode_letter);
+  if (gd == nullptr)
+    return nullptr;
+  // esph_log_d(TAG, "Returning bitmap @  %X", (uint32_t)gd->data);
+
+  return gd->data;
+}
+
+static bool get_glyph_dsc_cb(const lv_font_t *font, lv_font_glyph_dsc_t *dsc, uint32_t unicode_letter, uint32_t next) {
+  auto *fe = (FontEngine *) font->dsc;
+  const auto *gd = fe->get_glyph_data(unicode_letter);
+  if (gd == nullptr)
+    return false;
+  dsc->adv_w = gd->offset_x + gd->width;
+  dsc->ofs_x = gd->offset_x;
+  dsc->ofs_y = fe->height - gd->height - gd->offset_y - fe->baseline;
+  dsc->box_w = gd->width;
+  dsc->box_h = gd->height;
+  dsc->is_placeholder = 0;
+  dsc->bpp = fe->bpp;
+  return true;
+}
+
+FontEngine::FontEngine(font::Font *esp_font) : font_(esp_font) {
+  this->bpp = esp_font->get_bpp();
+  this->lv_font_.dsc = this;
+  this->lv_font_.line_height = this->height = esp_font->get_height();
+  this->lv_font_.base_line = this->baseline = this->lv_font_.line_height - esp_font->get_baseline();
+  this->lv_font_.get_glyph_dsc = get_glyph_dsc_cb;
+  this->lv_font_.get_glyph_bitmap = get_glyph_bitmap;
+  this->lv_font_.subpx = LV_FONT_SUBPX_NONE;
+  this->lv_font_.underline_position = -1;
+  this->lv_font_.underline_thickness = 1;
+}
+
+const lv_font_t *FontEngine::get_lv_font() { return &this->lv_font_; }
+
+const font::GlyphData *FontEngine::get_glyph_data(uint32_t unicode_letter) {
+  if (unicode_letter == last_letter_)
+    return this->last_data_;
+  uint8_t unicode[5];
+  memset(unicode, 0, sizeof unicode);
+  if (unicode_letter > 0xFFFF) {
+    unicode[0] = 0xF0 + ((unicode_letter >> 18) & 0x7);
+    unicode[1] = 0x80 + ((unicode_letter >> 12) & 0x3F);
+    unicode[2] = 0x80 + ((unicode_letter >> 6) & 0x3F);
+    unicode[3] = 0x80 + (unicode_letter & 0x3F);
+  } else if (unicode_letter > 0x7FF) {
+    unicode[0] = 0xE0 + ((unicode_letter >> 12) & 0xF);
+    unicode[1] = 0x80 + ((unicode_letter >> 6) & 0x3F);
+    unicode[2] = 0x80 + (unicode_letter & 0x3F);
+  } else if (unicode_letter > 0x7F) {
+    unicode[0] = 0xC0 + ((unicode_letter >> 6) & 0x1F);
+    unicode[1] = 0x80 + (unicode_letter & 0x3F);
+  } else {
+    unicode[0] = unicode_letter;
+  }
+  int match_length;
+  int glyph_n = this->font_->match_next_glyph(unicode, &match_length);
+  if (glyph_n < 0)
+    return nullptr;
+  this->last_data_ = this->font_->get_glyphs()[glyph_n].get_glyph_data();
+  this->last_letter_ = unicode_letter;
+  return this->last_data_;
+}
+}  // namespace lvgl
+}  // namespace esphome
+#endif  // USES_LVGL_FONT

esphome/components/lvgl/helpers.py

@@ -0,0 +1,49 @@
+import re
+
+from esphome import config_validation as cv
+from esphome.const import CONF_ARGS, CONF_FORMAT
+
+lv_uses = {
+    "USER_DATA",
+    "LOG",
+    "STYLE",
+    "FONT_PLACEHOLDER",
+    "THEME_DEFAULT",
+}
+
+
+def add_lv_use(*names):
+    for name in names:
+        lv_uses.add(name)
+
+
+lv_fonts_used = set()
+esphome_fonts_used = set()
+lvgl_components_required = set()
+
+
+def validate_printf(value):
+    cfmt = r"""
+    (                                  # start of capture group 1
+    %                                  # literal "%"
+    (?:[-+0 #]{0,5})                   # optional flags
+    (?:\d+|\*)?                        # width
+    (?:\.(?:\d+|\*))?                  # precision
+    (?:h|l|ll|w|I|I32|I64)?            # size
+    [cCdiouxXeEfgGaAnpsSZ]             # type
+    )
+    """  # noqa
+    matches = re.findall(cfmt, value[CONF_FORMAT], flags=re.X)
+    if len(matches) != len(value[CONF_ARGS]):
+        raise cv.Invalid(
+            f"Found {len(matches)} printf-patterns ({', '.join(matches)}), but {len(value[CONF_ARGS])} args were given!"
+        )
+    return value
+
+
+def requires_component(comp):
+    def validator(value):
+        lvgl_components_required.add(comp)
+        return cv.requires_component(comp)(value)
+
+    return validator