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

esphome/components/lvgl/widgets/meter.py

@@ -0,0 +1,302 @@
+from esphome import automation
+import esphome.codegen as cg
+import esphome.config_validation as cv
+from esphome.const import (
+    CONF_COLOR,
+    CONF_COUNT,
+    CONF_ID,
+    CONF_LENGTH,
+    CONF_LOCAL,
+    CONF_RANGE_FROM,
+    CONF_RANGE_TO,
+    CONF_ROTATION,
+    CONF_VALUE,
+    CONF_WIDTH,
+)
+
+from ..automation import action_to_code
+from ..defines import (
+    CONF_END_VALUE,
+    CONF_MAIN,
+    CONF_PIVOT_X,
+    CONF_PIVOT_Y,
+    CONF_SRC,
+    CONF_START_VALUE,
+    CONF_TICKS,
+)
+from ..helpers import add_lv_use
+from ..lv_validation import (
+    angle,
+    get_end_value,
+    get_start_value,
+    lv_bool,
+    lv_color,
+    lv_float,
+    lv_image,
+    requires_component,
+    size,
+)
+from ..lvcode import LocalVariable, lv, lv_assign, lv_expr
+from ..types import LvType, ObjUpdateAction
+from . import Widget, WidgetType, get_widgets
+from .arc import CONF_ARC
+from .img import CONF_IMAGE
+from .line import CONF_LINE
+from .obj import obj_spec
+
+CONF_ANGLE_RANGE = "angle_range"
+CONF_COLOR_END = "color_end"
+CONF_COLOR_START = "color_start"
+CONF_INDICATORS = "indicators"
+CONF_LABEL_GAP = "label_gap"
+CONF_MAJOR = "major"
+CONF_METER = "meter"
+CONF_R_MOD = "r_mod"
+CONF_SCALES = "scales"
+CONF_STRIDE = "stride"
+CONF_TICK_STYLE = "tick_style"
+
+lv_meter_t = LvType("lv_meter_t")
+lv_meter_indicator_t = cg.global_ns.struct("lv_meter_indicator_t")
+lv_meter_indicator_t_ptr = lv_meter_indicator_t.operator("ptr")
+
+
+def pixels(value):
+    """A size in one axis in pixels"""
+    if isinstance(value, str) and value.lower().endswith("px"):
+        return cv.int_(value[:-2])
+    return cv.int_(value)
+
+
+INDICATOR_LINE_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_WIDTH, default=4): size,
+        cv.Optional(CONF_COLOR, default=0): lv_color,
+        cv.Optional(CONF_R_MOD, default=0): size,
+        cv.Optional(CONF_VALUE): lv_float,
+    }
+)
+INDICATOR_IMG_SCHEMA = cv.Schema(
+    {
+        cv.Required(CONF_SRC): lv_image,
+        cv.Required(CONF_PIVOT_X): pixels,
+        cv.Required(CONF_PIVOT_Y): pixels,
+        cv.Optional(CONF_VALUE): lv_float,
+    }
+)
+INDICATOR_ARC_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_WIDTH, default=4): size,
+        cv.Optional(CONF_COLOR, default=0): lv_color,
+        cv.Optional(CONF_R_MOD, default=0): size,
+        cv.Exclusive(CONF_VALUE, CONF_VALUE): lv_float,
+        cv.Exclusive(CONF_START_VALUE, CONF_VALUE): lv_float,
+        cv.Optional(CONF_END_VALUE): lv_float,
+    }
+)
+INDICATOR_TICKS_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_WIDTH, default=4): size,
+        cv.Optional(CONF_COLOR_START, default=0): lv_color,
+        cv.Optional(CONF_COLOR_END): lv_color,
+        cv.Exclusive(CONF_VALUE, CONF_VALUE): lv_float,
+        cv.Exclusive(CONF_START_VALUE, CONF_VALUE): lv_float,
+        cv.Optional(CONF_END_VALUE): lv_float,
+        cv.Optional(CONF_LOCAL, default=False): lv_bool,
+    }
+)
+INDICATOR_SCHEMA = cv.Schema(
+    {
+        cv.Exclusive(CONF_LINE, CONF_INDICATORS): INDICATOR_LINE_SCHEMA.extend(
+            {
+                cv.GenerateID(): cv.declare_id(lv_meter_indicator_t),
+            }
+        ),
+        cv.Exclusive(CONF_IMAGE, CONF_INDICATORS): cv.All(
+            INDICATOR_IMG_SCHEMA.extend(
+                {
+                    cv.GenerateID(): cv.declare_id(lv_meter_indicator_t),
+                }
+            ),
+            requires_component("image"),
+        ),
+        cv.Exclusive(CONF_ARC, CONF_INDICATORS): INDICATOR_ARC_SCHEMA.extend(
+            {
+                cv.GenerateID(): cv.declare_id(lv_meter_indicator_t),
+            }
+        ),
+        cv.Exclusive(CONF_TICK_STYLE, CONF_INDICATORS): INDICATOR_TICKS_SCHEMA.extend(
+            {
+                cv.GenerateID(): cv.declare_id(lv_meter_indicator_t),
+            }
+        ),
+    }
+)
+
+SCALE_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_TICKS): cv.Schema(
+            {
+                cv.Optional(CONF_COUNT, default=12): cv.positive_int,
+                cv.Optional(CONF_WIDTH, default=2): size,
+                cv.Optional(CONF_LENGTH, default=10): size,
+                cv.Optional(CONF_COLOR, default=0x808080): lv_color,
+                cv.Optional(CONF_MAJOR): cv.Schema(
+                    {
+                        cv.Optional(CONF_STRIDE, default=3): cv.positive_int,
+                        cv.Optional(CONF_WIDTH, default=5): size,
+                        cv.Optional(CONF_LENGTH, default="15%"): size,
+                        cv.Optional(CONF_COLOR, default=0): lv_color,
+                        cv.Optional(CONF_LABEL_GAP, default=4): size,
+                    }
+                ),
+            }
+        ),
+        cv.Optional(CONF_RANGE_FROM, default=0.0): cv.float_,
+        cv.Optional(CONF_RANGE_TO, default=100.0): cv.float_,
+        cv.Optional(CONF_ANGLE_RANGE, default=270): cv.int_range(0, 360),
+        cv.Optional(CONF_ROTATION): angle,
+        cv.Optional(CONF_INDICATORS): cv.ensure_list(INDICATOR_SCHEMA),
+    }
+)
+
+METER_SCHEMA = {cv.Optional(CONF_SCALES): cv.ensure_list(SCALE_SCHEMA)}
+
+
+class MeterType(WidgetType):
+    def __init__(self):
+        super().__init__(CONF_METER, lv_meter_t, (CONF_MAIN,), METER_SCHEMA)
+
+    async def to_code(self, w: Widget, config):
+        """For a meter object, create and set parameters"""
+
+        var = w.obj
+        for scale_conf in config.get(CONF_SCALES, ()):
+            rotation = 90 + (360 - scale_conf[CONF_ANGLE_RANGE]) / 2
+            if CONF_ROTATION in scale_conf:
+                rotation = scale_conf[CONF_ROTATION] // 10
+            with LocalVariable(
+                "meter_var", "lv_meter_scale_t", lv_expr.meter_add_scale(var)
+            ) as meter_var:
+                lv.meter_set_scale_range(
+                    var,
+                    meter_var,
+                    scale_conf[CONF_RANGE_FROM],
+                    scale_conf[CONF_RANGE_TO],
+                    scale_conf[CONF_ANGLE_RANGE],
+                    rotation,
+                )
+                if ticks := scale_conf.get(CONF_TICKS):
+                    color = await lv_color.process(ticks[CONF_COLOR])
+                    lv.meter_set_scale_ticks(
+                        var,
+                        meter_var,
+                        ticks[CONF_COUNT],
+                        ticks[CONF_WIDTH],
+                        ticks[CONF_LENGTH],
+                        color,
+                    )
+                    if CONF_MAJOR in ticks:
+                        major = ticks[CONF_MAJOR]
+                        color = await lv_color.process(major[CONF_COLOR])
+                        lv.meter_set_scale_major_ticks(
+                            var,
+                            meter_var,
+                            major[CONF_STRIDE],
+                            major[CONF_WIDTH],
+                            major[CONF_LENGTH],
+                            color,
+                            major[CONF_LABEL_GAP],
+                        )
+                for indicator in scale_conf.get(CONF_INDICATORS, ()):
+                    (t, v) = next(iter(indicator.items()))
+                    iid = v[CONF_ID]
+                    ivar = cg.new_variable(
+                        iid, cg.nullptr, type_=lv_meter_indicator_t_ptr
+                    )
+                    # Enable getting the meter to which this belongs.
+                    wid = Widget.create(iid, var, obj_spec, v)
+                    wid.obj = ivar
+                    if t == CONF_LINE:
+                        color = await lv_color.process(v[CONF_COLOR])
+                        lv_assign(
+                            ivar,
+                            lv_expr.meter_add_needle_line(
+                                var, meter_var, v[CONF_WIDTH], color, v[CONF_R_MOD]
+                            ),
+                        )
+                    if t == CONF_ARC:
+                        color = await lv_color.process(v[CONF_COLOR])
+                        lv_assign(
+                            ivar,
+                            lv_expr.meter_add_arc(
+                                var, meter_var, v[CONF_WIDTH], color, v[CONF_R_MOD]
+                            ),
+                        )
+                    if t == CONF_TICK_STYLE:
+                        color_start = await lv_color.process(v[CONF_COLOR_START])
+                        color_end = await lv_color.process(
+                            v.get(CONF_COLOR_END) or color_start
+                        )
+                        lv_assign(
+                            ivar,
+                            lv_expr.meter_add_scale_lines(
+                                var,
+                                meter_var,
+                                color_start,
+                                color_end,
+                                v[CONF_LOCAL],
+                                v[CONF_WIDTH],
+                            ),
+                        )
+                    if t == CONF_IMAGE:
+                        add_lv_use("img")
+                        lv_assign(
+                            ivar,
+                            lv_expr.meter_add_needle_img(
+                                var,
+                                meter_var,
+                                await lv_image.process(v[CONF_SRC]),
+                                v[CONF_PIVOT_X],
+                                v[CONF_PIVOT_Y],
+                            ),
+                        )
+                    start_value = await get_start_value(v)
+                    end_value = await get_end_value(v)
+                    set_indicator_values(var, ivar, start_value, end_value)
+
+
+meter_spec = MeterType()
+
+
+@automation.register_action(
+    "lvgl.indicator.update",
+    ObjUpdateAction,
+    cv.Schema(
+        {
+            cv.Required(CONF_ID): cv.use_id(lv_meter_indicator_t),
+            cv.Exclusive(CONF_VALUE, CONF_VALUE): lv_float,
+            cv.Exclusive(CONF_START_VALUE, CONF_VALUE): lv_float,
+            cv.Optional(CONF_END_VALUE): lv_float,
+        }
+    ),
+)
+async def indicator_update_to_code(config, action_id, template_arg, args):
+    widget = await get_widgets(config)
+    start_value = await get_start_value(config)
+    end_value = await get_end_value(config)
+
+    async def set_value(w: Widget):
+        set_indicator_values(w.var, w.obj, start_value, end_value)
+
+    return await action_to_code(widget, set_value, action_id, template_arg, args)
+
+
+def set_indicator_values(meter, indicator, start_value, end_value):
+    if start_value is not None:
+        if end_value is None:
+            lv.meter_set_indicator_value(meter, indicator, start_value)
+        else:
+            lv.meter_set_indicator_start_value(meter, indicator, start_value)
+    if end_value is not None:
+        lv.meter_set_indicator_end_value(meter, indicator, end_value)

esphome/components/lvgl/widgets/msgbox.py

@@ -0,0 +1,134 @@
+from esphome import config_validation as cv
+from esphome.const import CONF_BUTTON, CONF_ID, CONF_TEXT
+from esphome.core import ID
+from esphome.cpp_generator import new_Pvariable, static_const_array
+from esphome.cpp_types import nullptr
+
+from ..defines import (
+    CONF_BODY,
+    CONF_BUTTONS,
+    CONF_CLOSE_BUTTON,
+    CONF_MSGBOXES,
+    CONF_TITLE,
+    TYPE_FLEX,
+    literal,
+)
+from ..helpers import add_lv_use
+from ..lv_validation import lv_bool, lv_pct, lv_text
+from ..lvcode import (
+    EVENT_ARG,
+    LambdaContext,
+    LocalVariable,
+    lv_add,
+    lv_assign,
+    lv_expr,
+    lv_obj,
+    lv_Pvariable,
+)
+from ..schemas import STYLE_SCHEMA, STYLED_TEXT_SCHEMA, container_schema
+from ..styles import TOP_LAYER
+from ..types import LV_EVENT, char_ptr, lv_obj_t
+from . import Widget, set_obj_properties
+from .button import button_spec
+from .buttonmatrix import (
+    BUTTONMATRIX_BUTTON_SCHEMA,
+    CONF_BUTTON_TEXT_LIST_ID,
+    buttonmatrix_spec,
+    get_button_data,
+    lv_buttonmatrix_t,
+    set_btn_data,
+)
+from .label import CONF_LABEL
+from .obj import obj_spec
+
+CONF_MSGBOX = "msgbox"
+MSGBOX_SCHEMA = container_schema(
+    obj_spec,
+    STYLE_SCHEMA.extend(
+        {
+            cv.GenerateID(CONF_ID): cv.declare_id(lv_obj_t),
+            cv.Required(CONF_TITLE): STYLED_TEXT_SCHEMA,
+            cv.Optional(CONF_BODY): STYLED_TEXT_SCHEMA,
+            cv.Optional(CONF_BUTTONS): cv.ensure_list(BUTTONMATRIX_BUTTON_SCHEMA),
+            cv.Optional(CONF_CLOSE_BUTTON): lv_bool,
+            cv.GenerateID(CONF_BUTTON_TEXT_LIST_ID): cv.declare_id(char_ptr),
+        }
+    ),
+)
+
+
+async def msgbox_to_code(conf):
+    """
+    Construct a message box. This consists of a full-screen translucent background enclosing a centered container
+    with an optional title, body, close button and a button matrix. And any other widgets the user cares to add
+    :param conf: The config data
+    :return: code to add to the init lambda
+    """
+    add_lv_use(
+        TYPE_FLEX,
+        CONF_BUTTON,
+        CONF_LABEL,
+        CONF_MSGBOX,
+        *buttonmatrix_spec.get_uses(),
+        *button_spec.get_uses(),
+    )
+    messagebox_id = conf[CONF_ID]
+    outer = lv_Pvariable(lv_obj_t, messagebox_id.id)
+    buttonmatrix = new_Pvariable(
+        ID(
+            f"{messagebox_id.id}_buttonmatrix_",
+            is_declaration=True,
+            type=lv_buttonmatrix_t,
+        )
+    )
+    msgbox = lv_Pvariable(lv_obj_t, f"{messagebox_id.id}_msgbox")
+    outer_widget = Widget.create(messagebox_id, outer, obj_spec, conf)
+    buttonmatrix_widget = Widget.create(
+        str(buttonmatrix), buttonmatrix, buttonmatrix_spec, conf
+    )
+    text_list, ctrl_list, width_list, _ = await get_button_data(
+        (conf,), buttonmatrix_widget
+    )
+    text_id = conf[CONF_BUTTON_TEXT_LIST_ID]
+    text_list = static_const_array(text_id, text_list)
+    if (text := conf.get(CONF_BODY)) is not None:
+        text = await lv_text.process(text.get(CONF_TEXT))
+    if (title := conf.get(CONF_TITLE)) is not None:
+        title = await lv_text.process(title.get(CONF_TEXT))
+    close_button = conf[CONF_CLOSE_BUTTON]
+    lv_assign(outer, lv_expr.obj_create(TOP_LAYER))
+    lv_obj.set_width(outer, lv_pct(100))
+    lv_obj.set_height(outer, lv_pct(100))
+    lv_obj.set_style_bg_opa(outer, 128, 0)
+    lv_obj.set_style_bg_color(outer, literal("lv_color_black()"), 0)
+    lv_obj.set_style_border_width(outer, 0, 0)
+    lv_obj.set_style_pad_all(outer, 0, 0)
+    lv_obj.set_style_radius(outer, 0, 0)
+    outer_widget.add_flag("LV_OBJ_FLAG_HIDDEN")
+    lv_assign(
+        msgbox, lv_expr.msgbox_create(outer, title, text, text_list, close_button)
+    )
+    lv_obj.set_style_align(msgbox, literal("LV_ALIGN_CENTER"), 0)
+    lv_add(buttonmatrix.set_obj(lv_expr.msgbox_get_btns(msgbox)))
+    await set_obj_properties(outer_widget, conf)
+    if close_button:
+        async with LambdaContext(EVENT_ARG, where=messagebox_id) as context:
+            outer_widget.add_flag("LV_OBJ_FLAG_HIDDEN")
+        with LocalVariable(
+            "close_btn_", lv_obj_t, lv_expr.msgbox_get_close_btn(msgbox)
+        ) as close_btn:
+            lv_obj.remove_event_cb(close_btn, nullptr)
+            lv_obj.add_event_cb(
+                close_btn,
+                await context.get_lambda(),
+                LV_EVENT.CLICKED,
+                nullptr,
+            )
+
+    if len(ctrl_list) != 0 or len(width_list) != 0:
+        set_btn_data(buttonmatrix.obj, ctrl_list, width_list)
+
+
+async def msgboxes_to_code(config):
+    for conf in config.get(CONF_MSGBOXES, ()):
+        await msgbox_to_code(conf)

esphome/components/lvgl/widgets/obj.py

@@ -0,0 +1,28 @@
+from esphome import automation
+
+from ..automation import update_to_code
+from ..defines import CONF_MAIN, CONF_OBJ
+from ..schemas import create_modify_schema
+from ..types import ObjUpdateAction, WidgetType, lv_obj_t
+
+
+class ObjType(WidgetType):
+    """
+    The base LVGL object. All other widgets inherit from this.
+    """
+
+    def __init__(self):
+        super().__init__(CONF_OBJ, lv_obj_t, (CONF_MAIN,), schema={}, modify_schema={})
+
+    async def to_code(self, w, config):
+        return []
+
+
+obj_spec = ObjType()
+
+
+@automation.register_action(
+    "lvgl.widget.update", ObjUpdateAction, create_modify_schema(obj_spec)
+)
+async def obj_update_to_code(config, action_id, template_arg, args):
+    return await update_to_code(config, action_id, template_arg, args)

esphome/components/lvgl/widgets/page.py

@@ -0,0 +1,113 @@
+from esphome import automation, codegen as cg
+import esphome.config_validation as cv
+from esphome.const import CONF_ID, CONF_PAGES, CONF_TIME
+
+from ..defines import (
+    CONF_ANIMATION,
+    CONF_LVGL_ID,
+    CONF_PAGE,
+    CONF_PAGE_WRAP,
+    CONF_SKIP,
+    LV_ANIM,
+)
+from ..lv_validation import lv_bool, lv_milliseconds
+from ..lvcode import LVGL_COMP_ARG, LambdaContext, add_line_marks, lv_add, lvgl_comp
+from ..schemas import LVGL_SCHEMA
+from ..types import LvglAction, lv_page_t
+from . import Widget, WidgetType, add_widgets, set_obj_properties
+
+
+class PageType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_PAGE,
+            lv_page_t,
+            (),
+            {
+                cv.Optional(CONF_SKIP, default=False): lv_bool,
+            },
+        )
+
+    async def to_code(self, w: Widget, config: dict):
+        return []
+
+
+SHOW_SCHEMA = LVGL_SCHEMA.extend(
+    {
+        cv.Optional(CONF_ANIMATION, default="NONE"): LV_ANIM.one_of,
+        cv.Optional(CONF_TIME, default="50ms"): lv_milliseconds,
+    }
+)
+
+
+page_spec = PageType()
+
+
+@automation.register_action(
+    "lvgl.page.next",
+    LvglAction,
+    SHOW_SCHEMA,
+)
+async def page_next_to_code(config, action_id, template_arg, args):
+    animation = await LV_ANIM.process(config[CONF_ANIMATION])
+    time = await lv_milliseconds.process(config[CONF_TIME])
+    async with LambdaContext(LVGL_COMP_ARG) as context:
+        add_line_marks(action_id)
+        lv_add(lvgl_comp.show_next_page(animation, time))
+    var = cg.new_Pvariable(action_id, template_arg, await context.get_lambda())
+    await cg.register_parented(var, config[CONF_LVGL_ID])
+    return var
+
+
+@automation.register_action(
+    "lvgl.page.previous",
+    LvglAction,
+    SHOW_SCHEMA,
+)
+async def page_previous_to_code(config, action_id, template_arg, args):
+    animation = await LV_ANIM.process(config[CONF_ANIMATION])
+    time = await lv_milliseconds.process(config[CONF_TIME])
+    async with LambdaContext(LVGL_COMP_ARG) as context:
+        add_line_marks(action_id)
+        lv_add(lvgl_comp.show_prev_page(animation, time))
+    var = cg.new_Pvariable(action_id, template_arg, await context.get_lambda())
+    await cg.register_parented(var, config[CONF_LVGL_ID])
+    return var
+
+
+@automation.register_action(
+    "lvgl.page.show",
+    LvglAction,
+    cv.maybe_simple_value(
+        SHOW_SCHEMA.extend(
+            {
+                cv.Required(CONF_ID): cv.use_id(lv_page_t),
+            }
+        ),
+        key=CONF_ID,
+    ),
+)
+async def page_show_to_code(config, action_id, template_arg, args):
+    widget = await cg.get_variable(config[CONF_ID])
+    animation = await LV_ANIM.process(config[CONF_ANIMATION])
+    time = await lv_milliseconds.process(config[CONF_TIME])
+    async with LambdaContext(LVGL_COMP_ARG) as context:
+        add_line_marks(action_id)
+        lv_add(lvgl_comp.show_page(widget.index, animation, time))
+    var = cg.new_Pvariable(action_id, template_arg, await context.get_lambda())
+    await cg.register_parented(var, config[CONF_LVGL_ID])
+    return var
+
+
+async def add_pages(lv_component, config):
+    lv_add(lv_component.set_page_wrap(config[CONF_PAGE_WRAP]))
+    for pconf in config.get(CONF_PAGES, ()):
+        id = pconf[CONF_ID]
+        skip = pconf[CONF_SKIP]
+        var = cg.new_Pvariable(id, skip)
+        page = Widget.create(id, var, page_spec, pconf)
+        lv_add(lv_component.add_page(var))
+        # Set outer config first
+        await set_obj_properties(page, config)
+        await set_obj_properties(page, pconf)
+        await add_widgets(page, pconf)

esphome/components/lvgl/widgets/roller.py

@@ -0,0 +1,77 @@
+import esphome.codegen as cg
+import esphome.config_validation as cv
+from esphome.const import CONF_MODE, CONF_OPTIONS
+
+from ..defines import (
+    CONF_ANIMATED,
+    CONF_MAIN,
+    CONF_SELECTED,
+    CONF_SELECTED_INDEX,
+    CONF_VISIBLE_ROW_COUNT,
+    ROLLER_MODES,
+    literal,
+)
+from ..lv_validation import animated, lv_int, option_string
+from ..lvcode import lv
+from ..types import LvSelect
+from . import WidgetType
+from .label import CONF_LABEL
+
+CONF_ROLLER = "roller"
+lv_roller_t = LvSelect("lv_roller_t")
+
+ROLLER_BASE_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_SELECTED_INDEX): cv.templatable(cv.int_),
+        cv.Optional(CONF_VISIBLE_ROW_COUNT): lv_int,
+    }
+)
+
+ROLLER_SCHEMA = ROLLER_BASE_SCHEMA.extend(
+    {
+        cv.Required(CONF_OPTIONS): cv.ensure_list(option_string),
+        cv.Optional(CONF_MODE, default="NORMAL"): ROLLER_MODES.one_of,
+    }
+)
+
+ROLLER_MODIFY_SCHEMA = ROLLER_BASE_SCHEMA.extend(
+    {
+        cv.Optional(CONF_ANIMATED, default=True): animated,
+    }
+)
+
+
+class RollerType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_ROLLER,
+            lv_roller_t,
+            (CONF_MAIN, CONF_SELECTED),
+            ROLLER_SCHEMA,
+            ROLLER_MODIFY_SCHEMA,
+        )
+
+    async def to_code(self, w, config):
+        if options := config.get(CONF_OPTIONS):
+            mode = await ROLLER_MODES.process(config[CONF_MODE])
+            text = cg.safe_exp("\n".join(options))
+            lv.roller_set_options(w.obj, text, mode)
+        animopt = literal(config.get(CONF_ANIMATED) or "LV_ANIM_OFF")
+        if CONF_SELECTED_INDEX in config:
+            if selected := config[CONF_SELECTED_INDEX]:
+                value = await lv_int.process(selected)
+                lv.roller_set_selected(w.obj, value, animopt)
+        await w.set_property(
+            CONF_VISIBLE_ROW_COUNT,
+            await lv_int.process(config.get(CONF_VISIBLE_ROW_COUNT)),
+        )
+
+    @property
+    def animated(self):
+        return True
+
+    def get_uses(self):
+        return (CONF_LABEL,)
+
+
+roller_spec = RollerType()