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

esphome/components/lvgl/number/__init__.py

@@ -0,0 +1,66 @@
+import esphome.codegen as cg
+from esphome.components import number
+import esphome.config_validation as cv
+from esphome.cpp_generator import MockObj
+
+from ..defines import CONF_ANIMATED, CONF_LVGL_ID, CONF_UPDATE_ON_RELEASE, CONF_WIDGET
+from ..lv_validation import animated
+from ..lvcode import (
+    API_EVENT,
+    EVENT_ARG,
+    UPDATE_EVENT,
+    LambdaContext,
+    LvContext,
+    lv,
+    lv_add,
+)
+from ..schemas import LVGL_SCHEMA
+from ..types import LV_EVENT, LvNumber, lvgl_ns
+from ..widgets import get_widgets
+
+LVGLNumber = lvgl_ns.class_("LVGLNumber", number.Number)
+
+CONFIG_SCHEMA = (
+    number.number_schema(LVGLNumber)
+    .extend(LVGL_SCHEMA)
+    .extend(
+        {
+            cv.Required(CONF_WIDGET): cv.use_id(LvNumber),
+            cv.Optional(CONF_ANIMATED, default=True): animated,
+            cv.Optional(CONF_UPDATE_ON_RELEASE, default=False): cv.boolean,
+        }
+    )
+)
+
+
+async def to_code(config):
+    paren = await cg.get_variable(config[CONF_LVGL_ID])
+    widget = await get_widgets(config, CONF_WIDGET)
+    widget = widget[0]
+    var = await number.new_number(
+        config,
+        max_value=widget.get_max(),
+        min_value=widget.get_min(),
+        step=widget.get_step(),
+    )
+
+    async with LambdaContext([(cg.float_, "v")]) as control:
+        await widget.set_property(
+            "value", MockObj("v") * MockObj(widget.get_scale()), config[CONF_ANIMATED]
+        )
+        lv.event_send(widget.obj, API_EVENT, cg.nullptr)
+    async with LambdaContext(EVENT_ARG) as event:
+        event.add(var.publish_state(widget.get_value()))
+    event_code = (
+        LV_EVENT.VALUE_CHANGED
+        if not config[CONF_UPDATE_ON_RELEASE]
+        else LV_EVENT.RELEASED
+    )
+    async with LvContext(paren):
+        lv_add(var.set_control_lambda(await control.get_lambda()))
+        lv_add(
+            paren.add_event_cb(
+                widget.obj, await event.get_lambda(), UPDATE_EVENT, event_code
+            )
+        )
+        lv_add(var.publish_state(widget.get_value()))

esphome/components/lvgl/number/lvgl_number.h

@@ -0,0 +1,34 @@
+#pragma once
+
+#include "esphome/components/number/number.h"
+#include "esphome/core/automation.h"
+#include "esphome/core/component.h"
+#include "esphome/core/preferences.h"
+
+namespace esphome {
+namespace lvgl {
+
+class LVGLNumber : public number::Number {
+ public:
+  void set_control_lambda(std::function<void(float)> control_lambda) {
+    this->control_lambda_ = control_lambda;
+    if (this->initial_state_.has_value()) {
+      this->control_lambda_(this->initial_state_.value());
+      this->initial_state_.reset();
+    }
+  }
+
+ protected:
+  void control(float value) override {
+    if (this->control_lambda_ != nullptr) {
+      this->control_lambda_(value);
+    } else {
+      this->initial_state_ = value;
+    }
+  }
+  std::function<void(float)> control_lambda_{};
+  optional<float> initial_state_{};
+};
+
+}  // namespace lvgl
+}  // namespace esphome

esphome/components/lvgl/schemas.py

@@ -0,0 +1,436 @@
+from esphome import config_validation as cv
+from esphome.automation import Trigger, validate_automation
+from esphome.components.time import RealTimeClock
+from esphome.const import (
+    CONF_ARGS,
+    CONF_FORMAT,
+    CONF_GROUP,
+    CONF_ID,
+    CONF_ON_VALUE,
+    CONF_STATE,
+    CONF_TEXT,
+    CONF_TIME,
+    CONF_TRIGGER_ID,
+    CONF_TYPE,
+)
+from esphome.core import TimePeriod
+from esphome.schema_extractors import SCHEMA_EXTRACT
+
+from . import defines as df, lv_validation as lvalid
+from .defines import CONF_TIME_FORMAT
+from .helpers import add_lv_use, requires_component, validate_printf
+from .lv_validation import lv_color, lv_font, lv_image
+from .lvcode import LvglComponent
+from .types import (
+    LVEncoderListener,
+    LvType,
+    WidgetType,
+    lv_group_t,
+    lv_obj_t,
+    lv_pseudo_button_t,
+    lv_style_t,
+)
+
+# this will be populated later, in __init__.py to avoid circular imports.
+WIDGET_TYPES: dict = {}
+
+# A schema for text properties
+TEXT_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_TEXT): cv.Any(
+            cv.All(
+                cv.Schema(
+                    {
+                        cv.Required(CONF_FORMAT): cv.string,
+                        cv.Optional(CONF_ARGS, default=list): cv.ensure_list(
+                            cv.lambda_
+                        ),
+                    },
+                ),
+                validate_printf,
+            ),
+            cv.Schema(
+                {
+                    cv.Required(CONF_TIME_FORMAT): cv.string,
+                    cv.GenerateID(CONF_TIME): cv.templatable(cv.use_id(RealTimeClock)),
+                }
+            ),
+            cv.templatable(cv.string),
+        )
+    }
+)
+
+LIST_ACTION_SCHEMA = cv.ensure_list(
+    cv.maybe_simple_value(
+        {
+            cv.Required(CONF_ID): cv.use_id(lv_pseudo_button_t),
+        },
+        key=CONF_ID,
+    )
+)
+
+PRESS_TIME = cv.All(
+    lvalid.lv_milliseconds, cv.Range(max=TimePeriod(milliseconds=65535))
+)
+
+ENCODER_SCHEMA = cv.Schema(
+    {
+        cv.GenerateID(): cv.All(
+            cv.declare_id(LVEncoderListener), requires_component("binary_sensor")
+        ),
+        cv.Optional(CONF_GROUP): cv.declare_id(lv_group_t),
+        cv.Optional(df.CONF_INITIAL_FOCUS): cv.use_id(lv_obj_t),
+        cv.Optional(df.CONF_LONG_PRESS_TIME, default="400ms"): PRESS_TIME,
+        cv.Optional(df.CONF_LONG_PRESS_REPEAT_TIME, default="100ms"): PRESS_TIME,
+    }
+)
+
+# All LVGL styles and their validators
+STYLE_PROPS = {
+    "align": df.CHILD_ALIGNMENTS.one_of,
+    "arc_opa": lvalid.opacity,
+    "arc_color": lvalid.lv_color,
+    "arc_rounded": lvalid.lv_bool,
+    "arc_width": cv.positive_int,
+    "anim_time": lvalid.lv_milliseconds,
+    "bg_color": lvalid.lv_color,
+    "bg_grad_color": lvalid.lv_color,
+    "bg_dither_mode": df.LvConstant("LV_DITHER_", "NONE", "ORDERED", "ERR_DIFF").one_of,
+    "bg_grad_dir": df.LvConstant("LV_GRAD_DIR_", "NONE", "HOR", "VER").one_of,
+    "bg_grad_stop": lvalid.stop_value,
+    "bg_image_opa": lvalid.opacity,
+    "bg_image_recolor": lvalid.lv_color,
+    "bg_image_recolor_opa": lvalid.opacity,
+    "bg_image_src": lvalid.lv_image,
+    "bg_main_stop": lvalid.stop_value,
+    "bg_opa": lvalid.opacity,
+    "border_color": lvalid.lv_color,
+    "border_opa": lvalid.opacity,
+    "border_post": lvalid.lv_bool,
+    "border_side": df.LvConstant(
+        "LV_BORDER_SIDE_", "NONE", "TOP", "BOTTOM", "LEFT", "RIGHT", "INTERNAL"
+    ).several_of,
+    "border_width": cv.positive_int,
+    "clip_corner": lvalid.lv_bool,
+    "color_filter_opa": lvalid.opacity,
+    "height": lvalid.size,
+    "image_recolor": lvalid.lv_color,
+    "image_recolor_opa": lvalid.opacity,
+    "line_width": cv.positive_int,
+    "line_dash_width": cv.positive_int,
+    "line_dash_gap": cv.positive_int,
+    "line_rounded": lvalid.lv_bool,
+    "line_color": lvalid.lv_color,
+    "opa": lvalid.opacity,
+    "opa_layered": lvalid.opacity,
+    "outline_color": lvalid.lv_color,
+    "outline_opa": lvalid.opacity,
+    "outline_pad": lvalid.pixels,
+    "outline_width": lvalid.pixels,
+    "pad_all": lvalid.pixels,
+    "pad_bottom": lvalid.pixels,
+    "pad_left": lvalid.pixels,
+    "pad_right": lvalid.pixels,
+    "pad_top": lvalid.pixels,
+    "shadow_color": lvalid.lv_color,
+    "shadow_ofs_x": cv.int_,
+    "shadow_ofs_y": cv.int_,
+    "shadow_opa": lvalid.opacity,
+    "shadow_spread": cv.int_,
+    "shadow_width": cv.positive_int,
+    "text_align": df.LvConstant(
+        "LV_TEXT_ALIGN_", "LEFT", "CENTER", "RIGHT", "AUTO"
+    ).one_of,
+    "text_color": lvalid.lv_color,
+    "text_decor": df.LvConstant(
+        "LV_TEXT_DECOR_", "NONE", "UNDERLINE", "STRIKETHROUGH"
+    ).several_of,
+    "text_font": lv_font,
+    "text_letter_space": cv.positive_int,
+    "text_line_space": cv.positive_int,
+    "text_opa": lvalid.opacity,
+    "transform_angle": lvalid.angle,
+    "transform_height": lvalid.pixels_or_percent,
+    "transform_pivot_x": lvalid.pixels_or_percent,
+    "transform_pivot_y": lvalid.pixels_or_percent,
+    "transform_zoom": lvalid.zoom,
+    "translate_x": lvalid.pixels_or_percent,
+    "translate_y": lvalid.pixels_or_percent,
+    "max_height": lvalid.pixels_or_percent,
+    "max_width": lvalid.pixels_or_percent,
+    "min_height": lvalid.pixels_or_percent,
+    "min_width": lvalid.pixels_or_percent,
+    "radius": lvalid.radius,
+    "width": lvalid.size,
+    "x": lvalid.pixels_or_percent,
+    "y": lvalid.pixels_or_percent,
+}
+
+STYLE_REMAP = {
+    "bg_image_opa": "bg_img_opa",
+    "bg_image_recolor": "bg_img_recolor",
+    "bg_image_recolor_opa": "bg_img_recolor_opa",
+    "bg_image_src": "bg_img_src",
+    "image_recolor": "img_recolor",
+    "image_recolor_opa": "img_recolor_opa",
+}
+
+# Complete object style schema
+STYLE_SCHEMA = cv.Schema({cv.Optional(k): v for k, v in STYLE_PROPS.items()}).extend(
+    {
+        cv.Optional(df.CONF_STYLES): cv.ensure_list(cv.use_id(lv_style_t)),
+        cv.Optional(df.CONF_SCROLLBAR_MODE): df.LvConstant(
+            "LV_SCROLLBAR_MODE_", "OFF", "ON", "ACTIVE", "AUTO"
+        ).one_of,
+    }
+)
+
+# Object states. Top level properties apply to MAIN
+STATE_SCHEMA = cv.Schema(
+    {cv.Optional(state): STYLE_SCHEMA for state in df.STATES}
+).extend(STYLE_SCHEMA)
+# Setting object states
+SET_STATE_SCHEMA = cv.Schema(
+    {cv.Optional(state): lvalid.lv_bool for state in df.STATES}
+)
+# Setting object flags
+FLAG_SCHEMA = cv.Schema({cv.Optional(flag): lvalid.lv_bool for flag in df.OBJ_FLAGS})
+FLAG_LIST = cv.ensure_list(df.LvConstant("LV_OBJ_FLAG_", *df.OBJ_FLAGS).one_of)
+
+
+def part_schema(widget_type: WidgetType):
+    """
+    Generate a schema for the various parts (e.g. main:, indicator:) of a widget type
+    :param widget_type:  The type of widget to generate for
+    :return:
+    """
+    parts = widget_type.parts
+    return cv.Schema({cv.Optional(part): STATE_SCHEMA for part in parts}).extend(
+        STATE_SCHEMA
+    )
+
+
+def automation_schema(typ: LvType):
+    if typ.has_on_value:
+        events = df.LV_EVENT_TRIGGERS + (CONF_ON_VALUE,)
+    else:
+        events = df.LV_EVENT_TRIGGERS
+    if isinstance(typ, LvType):
+        template = Trigger.template(typ.get_arg_type())
+    else:
+        template = Trigger.template()
+    return {
+        cv.Optional(event): validate_automation(
+            {
+                cv.GenerateID(CONF_TRIGGER_ID): cv.declare_id(template),
+            }
+        )
+        for event in events
+    }
+
+
+def create_modify_schema(widget_type):
+    return (
+        part_schema(widget_type)
+        .extend(
+            {
+                cv.Required(CONF_ID): cv.ensure_list(
+                    cv.maybe_simple_value(
+                        {
+                            cv.Required(CONF_ID): cv.use_id(widget_type),
+                        },
+                        key=CONF_ID,
+                    )
+                ),
+                cv.Optional(CONF_STATE): SET_STATE_SCHEMA,
+            }
+        )
+        .extend(FLAG_SCHEMA)
+        .extend(widget_type.modify_schema)
+    )
+
+
+def obj_schema(widget_type: WidgetType):
+    """
+    Create a schema for a widget type itself i.e. no allowance for children
+    :param widget_type:
+    :return:
+    """
+    return (
+        part_schema(widget_type)
+        .extend(FLAG_SCHEMA)
+        .extend(LAYOUT_SCHEMA)
+        .extend(ALIGN_TO_SCHEMA)
+        .extend(automation_schema(widget_type.w_type))
+        .extend(
+            cv.Schema(
+                {
+                    cv.Optional(CONF_STATE): SET_STATE_SCHEMA,
+                    cv.Optional(CONF_GROUP): cv.use_id(lv_group_t),
+                }
+            )
+        )
+    )
+
+
+LAYOUT_SCHEMAS = {}
+
+ALIGN_TO_SCHEMA = {
+    cv.Optional(df.CONF_ALIGN_TO): cv.Schema(
+        {
+            cv.Required(CONF_ID): cv.use_id(lv_obj_t),
+            cv.Required(df.CONF_ALIGN): df.ALIGN_ALIGNMENTS.one_of,
+            cv.Optional(df.CONF_X, default=0): lvalid.pixels_or_percent,
+            cv.Optional(df.CONF_Y, default=0): lvalid.pixels_or_percent,
+        }
+    )
+}
+
+
+def grid_free_space(value):
+    value = cv.Upper(value)
+    if value.startswith("FR(") and value.endswith(")"):
+        value = value.removesuffix(")").removeprefix("FR(")
+        return f"LV_GRID_FR({cv.positive_int(value)})"
+    raise cv.Invalid("must be a size in pixels, CONTENT or FR(nn)")
+
+
+grid_spec = cv.Any(
+    lvalid.size, df.LvConstant("LV_GRID_", "CONTENT").one_of, grid_free_space
+)
+
+cell_alignments = df.LV_CELL_ALIGNMENTS.one_of
+grid_alignments = df.LV_GRID_ALIGNMENTS.one_of
+flex_alignments = df.LV_FLEX_ALIGNMENTS.one_of
+
+LAYOUT_SCHEMA = {
+    cv.Optional(df.CONF_LAYOUT): cv.typed_schema(
+        {
+            df.TYPE_GRID: {
+                cv.Required(df.CONF_GRID_ROWS): [grid_spec],
+                cv.Required(df.CONF_GRID_COLUMNS): [grid_spec],
+                cv.Optional(df.CONF_GRID_COLUMN_ALIGN): grid_alignments,
+                cv.Optional(df.CONF_GRID_ROW_ALIGN): grid_alignments,
+                cv.Optional(df.CONF_PAD_ROW): lvalid.pixels,
+                cv.Optional(df.CONF_PAD_COLUMN): lvalid.pixels,
+            },
+            df.TYPE_FLEX: {
+                cv.Optional(
+                    df.CONF_FLEX_FLOW, default="row_wrap"
+                ): df.FLEX_FLOWS.one_of,
+                cv.Optional(df.CONF_FLEX_ALIGN_MAIN, default="start"): flex_alignments,
+                cv.Optional(df.CONF_FLEX_ALIGN_CROSS, default="start"): flex_alignments,
+                cv.Optional(df.CONF_FLEX_ALIGN_TRACK, default="start"): flex_alignments,
+                cv.Optional(df.CONF_PAD_ROW): lvalid.pixels,
+                cv.Optional(df.CONF_PAD_COLUMN): lvalid.pixels,
+            },
+        },
+        lower=True,
+    )
+}
+
+GRID_CELL_SCHEMA = {
+    cv.Required(df.CONF_GRID_CELL_ROW_POS): cv.positive_int,
+    cv.Required(df.CONF_GRID_CELL_COLUMN_POS): cv.positive_int,
+    cv.Optional(df.CONF_GRID_CELL_ROW_SPAN, default=1): cv.positive_int,
+    cv.Optional(df.CONF_GRID_CELL_COLUMN_SPAN, default=1): cv.positive_int,
+    cv.Optional(df.CONF_GRID_CELL_X_ALIGN): grid_alignments,
+    cv.Optional(df.CONF_GRID_CELL_Y_ALIGN): grid_alignments,
+}
+
+FLEX_OBJ_SCHEMA = {
+    cv.Optional(df.CONF_FLEX_GROW): cv.int_,
+}
+
+DISP_BG_SCHEMA = cv.Schema(
+    {
+        cv.Optional(df.CONF_DISP_BG_IMAGE): lv_image,
+        cv.Optional(df.CONF_DISP_BG_COLOR): lv_color,
+    }
+)
+
+# A style schema that can include text
+STYLED_TEXT_SCHEMA = cv.maybe_simple_value(
+    STYLE_SCHEMA.extend(TEXT_SCHEMA), key=CONF_TEXT
+)
+
+# For use by platform components
+LVGL_SCHEMA = cv.Schema(
+    {
+        cv.GenerateID(df.CONF_LVGL_ID): cv.use_id(LvglComponent),
+    }
+)
+
+ALL_STYLES = {**STYLE_PROPS, **GRID_CELL_SCHEMA, **FLEX_OBJ_SCHEMA}
+
+
+def container_validator(schema, widget_type: WidgetType):
+    """
+    Create a validator for a container given the widget type
+    :param schema: Base schema to extend
+    :param widget_type:
+    :return:
+    """
+
+    def validator(value):
+        result = schema
+        if w_sch := widget_type.schema:
+            result = result.extend(w_sch)
+        ltype = df.TYPE_NONE
+        if value and (layout := value.get(df.CONF_LAYOUT)):
+            if not isinstance(layout, dict):
+                raise cv.Invalid("Layout value must be a dict")
+            ltype = layout.get(CONF_TYPE)
+            if not ltype:
+                raise (cv.Invalid("Layout schema requires type:"))
+            add_lv_use(ltype)
+        if value == SCHEMA_EXTRACT:
+            return result
+        result = result.extend(LAYOUT_SCHEMAS[ltype.lower()])
+        return result(value)
+
+    return validator
+
+
+def container_schema(widget_type: WidgetType, extras=None):
+    """
+    Create a schema for a container widget of a given type. All obj properties are available, plus
+    the extras passed in, plus any defined for the specific widget being specified.
+    :param widget_type:     The widget type, e.g. "img"
+    :param extras:  Additional options to be made available, e.g. layout properties for children
+    :return: The schema for this type of widget.
+    """
+    schema = obj_schema(widget_type).extend(
+        {cv.GenerateID(): cv.declare_id(widget_type.w_type)}
+    )
+    if extras:
+        schema = schema.extend(extras)
+    # Delayed evaluation for recursion
+    return container_validator(schema, widget_type)
+
+
+def widget_schema(widget_type: WidgetType, extras=None):
+    """
+    Create a schema for a given widget type
+    :param widget_type: The name of the widget
+    :param extras:
+    :return:
+    """
+    validator = container_schema(widget_type, extras=extras)
+    if required := widget_type.required_component:
+        validator = cv.All(validator, requires_component(required))
+    return cv.Exclusive(widget_type.name, df.CONF_WIDGETS), validator
+
+
+# All widget schemas must be defined before this is called.
+
+
+def any_widget_schema(extras=None):
+    """
+    Generate schemas for all possible LVGL widgets. This is what implements the ability to have a list of any kind of
+    widget under the widgets: key.
+
+    :param extras: Additional schema to be applied to each generated one
+    :return:
+    """
+    return cv.Any(dict(widget_schema(wt, extras) for wt in WIDGET_TYPES.values()))

esphome/components/lvgl/select/__init__.py

@@ -0,0 +1,55 @@
+import esphome.codegen as cg
+from esphome.components import select
+import esphome.config_validation as cv
+from esphome.const import CONF_OPTIONS
+
+from ..defines import CONF_ANIMATED, CONF_LVGL_ID, CONF_WIDGET
+from ..lvcode import (
+    API_EVENT,
+    EVENT_ARG,
+    UPDATE_EVENT,
+    LambdaContext,
+    LvContext,
+    lv,
+    lv_add,
+)
+from ..schemas import LVGL_SCHEMA
+from ..types import LV_EVENT, LvSelect, lvgl_ns
+from ..widgets import get_widgets
+
+LVGLSelect = lvgl_ns.class_("LVGLSelect", select.Select)
+
+CONFIG_SCHEMA = (
+    select.select_schema(LVGLSelect)
+    .extend(LVGL_SCHEMA)
+    .extend(
+        {
+            cv.Required(CONF_WIDGET): cv.use_id(LvSelect),
+            cv.Optional(CONF_ANIMATED, default=False): cv.boolean,
+        }
+    )
+)
+
+
+async def to_code(config):
+    widget = await get_widgets(config, CONF_WIDGET)
+    widget = widget[0]
+    options = widget.config.get(CONF_OPTIONS, [])
+    selector = await select.new_select(config, options=options)
+    paren = await cg.get_variable(config[CONF_LVGL_ID])
+    async with LambdaContext(EVENT_ARG) as pub_ctx:
+        pub_ctx.add(selector.publish_index(widget.get_value()))
+    async with LambdaContext([(cg.uint16, "v")]) as control:
+        await widget.set_property("selected", "v", animated=config[CONF_ANIMATED])
+        lv.event_send(widget.obj, API_EVENT, cg.nullptr)
+    async with LvContext(paren) as ctx:
+        lv_add(selector.set_control_lambda(await control.get_lambda()))
+        ctx.add(
+            paren.add_event_cb(
+                widget.obj,
+                await pub_ctx.get_lambda(),
+                LV_EVENT.VALUE_CHANGED,
+                UPDATE_EVENT,
+            )
+        )
+        lv_add(selector.publish_index(widget.get_value()))

esphome/components/lvgl/select/lvgl_select.h

@@ -0,0 +1,62 @@
+#pragma once
+
+#include "esphome/components/select/select.h"
+#include "esphome/core/automation.h"
+#include "esphome/core/component.h"
+#include "esphome/core/preferences.h"
+
+namespace esphome {
+namespace lvgl {
+
+static std::vector<std::string> split_string(const std::string &str) {
+  std::vector<std::string> strings;
+  auto delimiter = std::string("\n");
+
+  std::string::size_type pos;
+  std::string::size_type prev = 0;
+  while ((pos = str.find(delimiter, prev)) != std::string::npos) {
+    strings.push_back(str.substr(prev, pos - prev));
+    prev = pos + delimiter.size();
+  }
+
+  // To get the last substring (or only, if delimiter is not found)
+  strings.push_back(str.substr(prev));
+
+  return strings;
+}
+
+class LVGLSelect : public select::Select {
+ public:
+  void set_control_lambda(std::function<void(size_t)> lambda) {
+    this->control_lambda_ = lambda;
+    if (this->initial_state_.has_value()) {
+      this->control(this->initial_state_.value());
+      this->initial_state_.reset();
+    }
+  }
+
+  void publish_index(size_t index) {
+    auto value = this->at(index);
+    if (value)
+      this->publish_state(value.value());
+  }
+
+  void set_options(const char *str) { this->traits.set_options(split_string(str)); }
+
+ protected:
+  void control(const std::string &value) override {
+    if (this->control_lambda_ != nullptr) {
+      auto index = index_of(value);
+      if (index)
+        this->control_lambda_(index.value());
+    } else {
+      this->initial_state_ = value.c_str();
+    }
+  }
+
+  std::function<void(size_t)> control_lambda_{};
+  optional<const char *> initial_state_{};
+};
+
+}  // namespace lvgl
+}  // namespace esphome

esphome/components/lvgl/sensor/__init__.py

@@ -0,0 +1,47 @@
+import esphome.codegen as cg
+from esphome.components.sensor import Sensor, new_sensor, sensor_schema
+import esphome.config_validation as cv
+
+from ..defines import CONF_LVGL_ID, CONF_WIDGET
+from ..lvcode import (
+    API_EVENT,
+    EVENT_ARG,
+    LVGL_COMP_ARG,
+    UPDATE_EVENT,
+    LambdaContext,
+    LvContext,
+    lv_add,
+)
+from ..schemas import LVGL_SCHEMA
+from ..types import LV_EVENT, LvNumber
+from ..widgets import Widget, get_widgets
+
+CONFIG_SCHEMA = (
+    sensor_schema(Sensor)
+    .extend(LVGL_SCHEMA)
+    .extend(
+        {
+            cv.Required(CONF_WIDGET): cv.use_id(LvNumber),
+        }
+    )
+)
+
+
+async def to_code(config):
+    sensor = await new_sensor(config)
+    paren = await cg.get_variable(config[CONF_LVGL_ID])
+    widget = await get_widgets(config, CONF_WIDGET)
+    widget = widget[0]
+    assert isinstance(widget, Widget)
+    async with LambdaContext(EVENT_ARG) as lamb:
+        lv_add(sensor.publish_state(widget.get_value()))
+    async with LvContext(paren, LVGL_COMP_ARG):
+        lv_add(
+            paren.add_event_cb(
+                widget.obj,
+                await lamb.get_lambda(),
+                LV_EVENT.VALUE_CHANGED,
+                API_EVENT,
+                UPDATE_EVENT,
+            )
+        )