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

esphome/components/lvgl/widgets/buttonmatrix.py

@@ -0,0 +1,275 @@
+from esphome import automation
+import esphome.codegen as cg
+from esphome.components.key_provider import KeyProvider
+import esphome.config_validation as cv
+from esphome.const import CONF_ID, CONF_ITEMS, CONF_TEXT, CONF_WIDTH
+from esphome.cpp_generator import MockObj
+
+from ..automation import action_to_code
+from ..defines import (
+    BUTTONMATRIX_CTRLS,
+    CONF_BUTTONS,
+    CONF_CONTROL,
+    CONF_KEY_CODE,
+    CONF_MAIN,
+    CONF_ONE_CHECKED,
+    CONF_ROWS,
+    CONF_SELECTED,
+)
+from ..helpers import lvgl_components_required
+from ..lv_validation import key_code, lv_bool
+from ..lvcode import lv, lv_add, lv_expr
+from ..schemas import automation_schema
+from ..types import (
+    LV_BTNMATRIX_CTRL,
+    LV_STATE,
+    LvBoolean,
+    LvCompound,
+    LvType,
+    ObjUpdateAction,
+    char_ptr,
+    lv_pseudo_button_t,
+)
+from . import Widget, WidgetType, get_widgets, widget_map
+from .button import lv_button_t
+
+CONF_BUTTONMATRIX = "buttonmatrix"
+CONF_BUTTON_TEXT_LIST_ID = "button_text_list_id"
+
+LvButtonMatrixButton = LvBoolean(
+    str(cg.uint16),
+    parents=(lv_pseudo_button_t,),
+)
+BUTTONMATRIX_BUTTON_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_TEXT): cv.string,
+        cv.Optional(CONF_KEY_CODE): key_code,
+        cv.GenerateID(): cv.declare_id(LvButtonMatrixButton),
+        cv.Optional(CONF_WIDTH, default=1): cv.positive_int,
+        cv.Optional(CONF_CONTROL): cv.ensure_list(
+            cv.Schema(
+                {cv.Optional(k.lower()): cv.boolean for k in BUTTONMATRIX_CTRLS.choices}
+            )
+        ),
+    }
+).extend(automation_schema(lv_button_t))
+
+BUTTONMATRIX_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_ONE_CHECKED, default=False): lv_bool,
+        cv.GenerateID(CONF_BUTTON_TEXT_LIST_ID): cv.declare_id(char_ptr),
+        cv.Required(CONF_ROWS): cv.ensure_list(
+            cv.Schema(
+                {
+                    cv.Required(CONF_BUTTONS): cv.ensure_list(
+                        BUTTONMATRIX_BUTTON_SCHEMA
+                    ),
+                }
+            )
+        ),
+    }
+)
+
+
+class ButtonmatrixButtonType(WidgetType):
+    """
+    A pseudo-widget for the matrix buttons
+    """
+
+    def __init__(self):
+        super().__init__("btnmatrix_btn", LvButtonMatrixButton, (), {}, {})
+
+    async def to_code(self, w, config: dict):
+        return []
+
+
+btn_btn_spec = ButtonmatrixButtonType()
+
+
+class MatrixButton(Widget):
+    """
+    Describes a button within a button matrix.
+    """
+
+    @staticmethod
+    def create_button(id, parent, config: dict, index):
+        w = MatrixButton(id, parent, config, index)
+        widget_map[id] = w
+        return w
+
+    def __init__(self, id, parent: Widget, config, index):
+        super().__init__(id, btn_btn_spec, config)
+        self.parent = parent
+        self.index = index
+        self.obj = parent.obj
+
+    def is_selected(self):
+        return self.parent.var.get_selected() == MockObj(self.var)
+
+    @staticmethod
+    def map_ctrls(state):
+        state = str(state).upper().removeprefix("LV_STATE_")
+        assert state in BUTTONMATRIX_CTRLS.choices
+        return getattr(LV_BTNMATRIX_CTRL, state)
+
+    def has_state(self, state):
+        state = self.map_ctrls(state)
+        return lv_expr.btnmatrix_has_btn_ctrl(self.obj, self.index, state)
+
+    def add_state(self, state):
+        state = self.map_ctrls(state)
+        return lv.btnmatrix_set_btn_ctrl(self.obj, self.index, state)
+
+    def clear_state(self, state):
+        state = self.map_ctrls(state)
+        return lv.btnmatrix_clear_btn_ctrl(self.obj, self.index, state)
+
+    def is_pressed(self):
+        return self.is_selected() & self.parent.has_state(LV_STATE.PRESSED)
+
+    def is_checked(self):
+        return self.has_state(LV_STATE.CHECKED)
+
+    def get_value(self):
+        return self.is_checked()
+
+    def check_null(self):
+        return None
+
+
+async def get_button_data(config, buttonmatrix: Widget):
+    """
+    Process a button matrix button list
+    :param config: The row list
+    :param buttonmatrix: The parent variable
+    :return: text array id, control list, width list
+    """
+    text_list = []
+    ctrl_list = []
+    width_list = []
+    key_list = []
+    for row in config:
+        for button_conf in row.get(CONF_BUTTONS, ()):
+            bid = button_conf[CONF_ID]
+            index = len(width_list)
+            MatrixButton.create_button(bid, buttonmatrix, button_conf, index)
+            cg.new_variable(bid, index)
+            text_list.append(button_conf.get(CONF_TEXT) or "")
+            key_list.append(button_conf.get(CONF_KEY_CODE) or 0)
+            width_list.append(button_conf[CONF_WIDTH])
+            ctrl = ["LV_BTNMATRIX_CTRL_CLICK_TRIG"]
+            for item in button_conf.get(CONF_CONTROL, ()):
+                ctrl.extend([k for k, v in item.items() if v])
+            ctrl_list.append(await BUTTONMATRIX_CTRLS.process(ctrl))
+        text_list.append("\n")
+    text_list = text_list[:-1]
+    text_list.append(cg.nullptr)
+    return text_list, ctrl_list, width_list, key_list
+
+
+lv_buttonmatrix_t = LvType(
+    "LvButtonMatrixType",
+    parents=(KeyProvider, LvCompound),
+    largs=[(cg.uint16, "x")],
+    lvalue=lambda w: w.var.get_selected(),
+)
+
+
+class ButtonMatrixType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_BUTTONMATRIX,
+            lv_buttonmatrix_t,
+            (CONF_MAIN, CONF_ITEMS),
+            BUTTONMATRIX_SCHEMA,
+            {},
+            lv_name="btnmatrix",
+        )
+
+    async def to_code(self, w: Widget, config):
+        lvgl_components_required.add("BUTTONMATRIX")
+        if CONF_ROWS not in config:
+            return []
+        text_list, ctrl_list, width_list, key_list = await get_button_data(
+            config[CONF_ROWS], w
+        )
+        text_id = config[CONF_BUTTON_TEXT_LIST_ID]
+        text_id = cg.static_const_array(text_id, text_list)
+        lv.btnmatrix_set_map(w.obj, text_id)
+        set_btn_data(w.obj, ctrl_list, width_list)
+        lv.btnmatrix_set_one_checked(w.obj, config[CONF_ONE_CHECKED])
+        for index, key in enumerate(key_list):
+            if key != 0:
+                lv_add(w.var.set_key(index, key))
+
+    def get_uses(self):
+        return ("btnmatrix",)
+
+
+def set_btn_data(obj, ctrl_list, width_list):
+    for index, ctrl in enumerate(ctrl_list):
+        lv.btnmatrix_set_btn_ctrl(obj, index, ctrl)
+    for index, width in enumerate(width_list):
+        lv.btnmatrix_set_btn_width(obj, index, width)
+
+
+buttonmatrix_spec = ButtonMatrixType()
+
+
+@automation.register_action(
+    "lvgl.matrix.button.update",
+    ObjUpdateAction,
+    cv.Schema(
+        {
+            cv.Optional(CONF_WIDTH): cv.positive_int,
+            cv.Optional(CONF_CONTROL): cv.ensure_list(
+                cv.Schema(
+                    {
+                        cv.Optional(k.lower()): cv.boolean
+                        for k in BUTTONMATRIX_CTRLS.choices
+                    }
+                ),
+            ),
+            cv.Required(CONF_ID): cv.ensure_list(
+                cv.maybe_simple_value(
+                    {
+                        cv.Required(CONF_ID): cv.use_id(LvButtonMatrixButton),
+                    },
+                    key=CONF_ID,
+                )
+            ),
+            cv.Optional(CONF_SELECTED): lv_bool,
+        }
+    ),
+)
+async def button_update_to_code(config, action_id, template_arg, args):
+    widgets = await get_widgets(config[CONF_ID])
+    assert all(isinstance(w, MatrixButton) for w in widgets)
+
+    async def do_button_update(w: MatrixButton):
+        if (width := config.get(CONF_WIDTH)) is not None:
+            lv.btnmatrix_set_btn_width(w.obj, w.index, width)
+        if config.get(CONF_SELECTED):
+            lv.btnmatrix_set_selected_btn(w.obj, w.index)
+        if controls := config.get(CONF_CONTROL):
+            adds = []
+            clrs = []
+            for item in controls:
+                adds.extend(
+                    [f"LV_BTNMATRIX_CTRL_{k.upper()}" for k, v in item.items() if v]
+                )
+                clrs.extend(
+                    [f"LV_BTNMATRIX_CTRL_{k.upper()}" for k, v in item.items() if not v]
+                )
+            if adds:
+                lv.btnmatrix_set_btn_ctrl(
+                    w.obj, w.index, await BUTTONMATRIX_CTRLS.process(adds)
+                )
+            if clrs:
+                lv.btnmatrix_clear_btn_ctrl(
+                    w.obj, w.index, await BUTTONMATRIX_CTRLS.process(clrs)
+                )
+
+    return await action_to_code(
+        widgets, do_button_update, action_id, template_arg, args
+    )

esphome/components/lvgl/widgets/checkbox.py

@@ -0,0 +1,27 @@
+from esphome.const import CONF_TEXT
+
+from ..defines import CONF_INDICATOR, CONF_MAIN
+from ..lv_validation import lv_text
+from ..lvcode import lv
+from ..schemas import TEXT_SCHEMA
+from ..types import LvBoolean
+from . import Widget, WidgetType
+
+CONF_CHECKBOX = "checkbox"
+
+
+class CheckboxType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_CHECKBOX,
+            LvBoolean("lv_checkbox_t"),
+            (CONF_MAIN, CONF_INDICATOR),
+            TEXT_SCHEMA,
+        )
+
+    async def to_code(self, w: Widget, config):
+        if (value := config.get(CONF_TEXT)) is not None:
+            lv.checkbox_set_text(w.obj, await lv_text.process(value))
+
+
+checkbox_spec = CheckboxType()

esphome/components/lvgl/widgets/dropdown.py

@@ -0,0 +1,76 @@
+import esphome.codegen as cg
+import esphome.config_validation as cv
+from esphome.const import CONF_OPTIONS
+
+from ..defines import (
+    CONF_DIR,
+    CONF_INDICATOR,
+    CONF_MAIN,
+    CONF_SELECTED_INDEX,
+    CONF_SYMBOL,
+    DIRECTIONS,
+    literal,
+)
+from ..lv_validation import lv_int, lv_text, option_string
+from ..lvcode import LocalVariable, lv, lv_expr
+from ..schemas import part_schema
+from ..types import LvSelect, LvType, lv_obj_t
+from . import Widget, WidgetType, set_obj_properties
+from .label import CONF_LABEL
+
+CONF_DROPDOWN = "dropdown"
+CONF_DROPDOWN_LIST = "dropdown_list"
+
+lv_dropdown_t = LvSelect("lv_dropdown_t")
+lv_dropdown_list_t = LvType("lv_dropdown_list_t")
+dropdown_list_spec = WidgetType(CONF_DROPDOWN_LIST, lv_dropdown_list_t, (CONF_MAIN,))
+
+DROPDOWN_BASE_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_SYMBOL): lv_text,
+        cv.Optional(CONF_SELECTED_INDEX): cv.templatable(cv.int_),
+        cv.Optional(CONF_DIR, default="BOTTOM"): DIRECTIONS.one_of,
+        cv.Optional(CONF_DROPDOWN_LIST): part_schema(dropdown_list_spec),
+    }
+)
+
+DROPDOWN_SCHEMA = DROPDOWN_BASE_SCHEMA.extend(
+    {
+        cv.Required(CONF_OPTIONS): cv.ensure_list(option_string),
+    }
+)
+
+
+class DropdownType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_DROPDOWN,
+            lv_dropdown_t,
+            (CONF_MAIN, CONF_INDICATOR),
+            DROPDOWN_SCHEMA,
+            DROPDOWN_BASE_SCHEMA,
+        )
+
+    async def to_code(self, w: Widget, config):
+        if options := config.get(CONF_OPTIONS):
+            text = cg.safe_exp("\n".join(options))
+            lv.dropdown_set_options(w.obj, text)
+        if symbol := config.get(CONF_SYMBOL):
+            lv.dropdown_set_symbol(w.obj, await lv_text.process(symbol))
+        if (selected := config.get(CONF_SELECTED_INDEX)) is not None:
+            value = await lv_int.process(selected)
+            lv.dropdown_set_selected(w.obj, value)
+        if dirn := config.get(CONF_DIR):
+            lv.dropdown_set_dir(w.obj, literal(dirn))
+        if dlist := config.get(CONF_DROPDOWN_LIST):
+            with LocalVariable(
+                "dropdown_list", lv_obj_t, lv_expr.dropdown_get_list(w.obj)
+            ) as dlist_obj:
+                dwid = Widget(dlist_obj, dropdown_list_spec, dlist)
+                await set_obj_properties(dwid, dlist)
+
+    def get_uses(self):
+        return (CONF_LABEL,)
+
+
+dropdown_spec = DropdownType()

esphome/components/lvgl/widgets/img.py

@@ -0,0 +1,85 @@
+import esphome.config_validation as cv
+from esphome.const import CONF_ANGLE, CONF_MODE
+
+from ..defines import (
+    CONF_ANTIALIAS,
+    CONF_MAIN,
+    CONF_OFFSET_X,
+    CONF_OFFSET_Y,
+    CONF_PIVOT_X,
+    CONF_PIVOT_Y,
+    CONF_SRC,
+    CONF_ZOOM,
+    LvConstant,
+)
+from ..lv_validation import angle, lv_bool, lv_image, size, zoom
+from ..lvcode import lv
+from ..types import lv_img_t
+from . import Widget, WidgetType
+from .label import CONF_LABEL
+
+CONF_IMAGE = "image"
+
+BASE_IMG_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_PIVOT_X, default="50%"): size,
+        cv.Optional(CONF_PIVOT_Y, default="50%"): size,
+        cv.Optional(CONF_ANGLE): angle,
+        cv.Optional(CONF_ZOOM): zoom,
+        cv.Optional(CONF_OFFSET_X): size,
+        cv.Optional(CONF_OFFSET_Y): size,
+        cv.Optional(CONF_ANTIALIAS): lv_bool,
+        cv.Optional(CONF_MODE): LvConstant(
+            "LV_IMG_SIZE_MODE_", "VIRTUAL", "REAL"
+        ).one_of,
+    }
+)
+
+IMG_SCHEMA = BASE_IMG_SCHEMA.extend(
+    {
+        cv.Required(CONF_SRC): lv_image,
+    }
+)
+
+IMG_MODIFY_SCHEMA = BASE_IMG_SCHEMA.extend(
+    {
+        cv.Optional(CONF_SRC): lv_image,
+    }
+)
+
+
+class ImgType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_IMAGE,
+            lv_img_t,
+            (CONF_MAIN,),
+            IMG_SCHEMA,
+            IMG_MODIFY_SCHEMA,
+            lv_name="img",
+        )
+
+    def get_uses(self):
+        return "img", CONF_LABEL
+
+    async def to_code(self, w: Widget, config):
+        if src := config.get(CONF_SRC):
+            lv.img_set_src(w.obj, await lv_image.process(src))
+        if (cf_angle := config.get(CONF_ANGLE)) is not None:
+            pivot_x = config[CONF_PIVOT_X]
+            pivot_y = config[CONF_PIVOT_Y]
+            lv.img_set_pivot(w.obj, pivot_x, pivot_y)
+            lv.img_set_angle(w.obj, cf_angle)
+        if (img_zoom := config.get(CONF_ZOOM)) is not None:
+            lv.img_set_zoom(w.obj, img_zoom)
+        if (offset := config.get(CONF_OFFSET_X)) is not None:
+            lv.img_set_offset_x(w.obj, offset)
+        if (offset := config.get(CONF_OFFSET_Y)) is not None:
+            lv.img_set_offset_y(w.obj, offset)
+        if CONF_ANTIALIAS in config:
+            lv.img_set_antialias(w.obj, config[CONF_ANTIALIAS])
+        if mode := config.get(CONF_MODE):
+            lv.img_set_mode(w.obj, mode)
+
+
+img_spec = ImgType()

esphome/components/lvgl/widgets/keyboard.py

@@ -0,0 +1,49 @@
+from esphome.components.key_provider import KeyProvider
+import esphome.config_validation as cv
+from esphome.const import CONF_ITEMS, CONF_MODE
+from esphome.cpp_types import std_string
+
+from ..defines import CONF_MAIN, KEYBOARD_MODES, literal
+from ..helpers import add_lv_use, lvgl_components_required
+from ..types import LvCompound, LvType
+from . import Widget, WidgetType, get_widgets
+from .textarea import CONF_TEXTAREA, lv_textarea_t
+
+CONF_KEYBOARD = "keyboard"
+
+KEYBOARD_SCHEMA = {
+    cv.Optional(CONF_MODE, default="TEXT_UPPER"): KEYBOARD_MODES.one_of,
+    cv.Optional(CONF_TEXTAREA): cv.use_id(lv_textarea_t),
+}
+
+lv_keyboard_t = LvType(
+    "LvKeyboardType",
+    parents=(KeyProvider, LvCompound),
+    largs=[(std_string, "text")],
+    has_on_value=True,
+    lvalue=lambda w: literal(f"lv_textarea_get_text({w.obj})"),
+)
+
+
+class KeyboardType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_KEYBOARD,
+            lv_keyboard_t,
+            (CONF_MAIN, CONF_ITEMS),
+            KEYBOARD_SCHEMA,
+        )
+
+    def get_uses(self):
+        return CONF_KEYBOARD, CONF_TEXTAREA
+
+    async def to_code(self, w: Widget, config: dict):
+        lvgl_components_required.add("KEY_LISTENER")
+        lvgl_components_required.add(CONF_KEYBOARD)
+        add_lv_use("btnmatrix")
+        await w.set_property(CONF_MODE, await KEYBOARD_MODES.process(config[CONF_MODE]))
+        if ta := await get_widgets(config, CONF_TEXTAREA):
+            await w.set_property(CONF_TEXTAREA, ta[0].obj)
+
+
+keyboard_spec = KeyboardType()

esphome/components/lvgl/widgets/label.py

@@ -0,0 +1,42 @@
+import esphome.config_validation as cv
+from esphome.const import CONF_TEXT
+
+from ..defines import (
+    CONF_LONG_MODE,
+    CONF_MAIN,
+    CONF_RECOLOR,
+    CONF_SCROLLBAR,
+    CONF_SELECTED,
+    LV_LONG_MODES,
+)
+from ..lv_validation import lv_bool, lv_text
+from ..schemas import TEXT_SCHEMA
+from ..types import LvText, WidgetType
+from . import Widget
+
+CONF_LABEL = "label"
+
+
+class LabelType(WidgetType):
+    def __init__(self):
+        super().__init__(
+            CONF_LABEL,
+            LvText("lv_label_t"),
+            (CONF_MAIN, CONF_SCROLLBAR, CONF_SELECTED),
+            TEXT_SCHEMA.extend(
+                {
+                    cv.Optional(CONF_RECOLOR): lv_bool,
+                    cv.Optional(CONF_LONG_MODE): LV_LONG_MODES.one_of,
+                }
+            ),
+        )
+
+    async def to_code(self, w: Widget, config):
+        """For a text object, create and set text"""
+        if value := config.get(CONF_TEXT):
+            await w.set_property(CONF_TEXT, await lv_text.process(value))
+        await w.set_property(CONF_LONG_MODE, config)
+        await w.set_property(CONF_RECOLOR, config)
+
+
+label_spec = LabelType()

esphome/components/lvgl/widgets/led.py

@@ -0,0 +1,29 @@
+import esphome.config_validation as cv
+from esphome.const import CONF_BRIGHTNESS, CONF_COLOR, CONF_LED
+
+from ..defines import CONF_MAIN
+from ..lv_validation import lv_brightness, lv_color
+from ..lvcode import lv
+from ..types import LvType
+from . import Widget, WidgetType
+
+LED_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_COLOR): lv_color,
+        cv.Optional(CONF_BRIGHTNESS): lv_brightness,
+    }
+)
+
+
+class LedType(WidgetType):
+    def __init__(self):
+        super().__init__(CONF_LED, LvType("lv_led_t"), (CONF_MAIN,), LED_SCHEMA)
+
+    async def to_code(self, w: Widget, config):
+        if (color := config.get(CONF_COLOR)) is not None:
+            lv.led_set_color(w.obj, await lv_color.process(color))
+        if (brightness := config.get(CONF_BRIGHTNESS)) is not None:
+            lv.led_set_brightness(w.obj, await lv_brightness.process(brightness))
+
+
+led_spec = LedType()

esphome/components/lvgl/widgets/line.py

@@ -0,0 +1,50 @@
+import functools
+
+import esphome.codegen as cg
+import esphome.config_validation as cv
+
+from ..defines import CONF_MAIN, literal
+from ..lvcode import lv
+from ..types import LvType
+from . import Widget, WidgetType
+
+CONF_LINE = "line"
+CONF_POINTS = "points"
+CONF_POINT_LIST_ID = "point_list_id"
+
+lv_point_t = cg.global_ns.struct("lv_point_t")
+
+
+def point_list(il):
+    il = cv.string(il)
+    nl = il.replace(" ", "").split(",")
+    return [int(n) for n in nl]
+
+
+def cv_point_list(value):
+    if not isinstance(value, list):
+        raise cv.Invalid("List of points required")
+    values = [point_list(v) for v in value]
+    if not functools.reduce(lambda f, v: f and len(v) == 2, values, True):
+        raise cv.Invalid("Points must be a list of x,y integer pairs")
+    return values
+
+
+LINE_SCHEMA = {
+    cv.Required(CONF_POINTS): cv_point_list,
+    cv.GenerateID(CONF_POINT_LIST_ID): cv.declare_id(lv_point_t),
+}
+
+
+class LineType(WidgetType):
+    def __init__(self):
+        super().__init__(CONF_LINE, LvType("lv_line_t"), (CONF_MAIN,), LINE_SCHEMA)
+
+    async def to_code(self, w: Widget, config):
+        """For a line object, create and add the points"""
+        data = literal(config[CONF_POINTS])
+        points = cg.static_const_array(config[CONF_POINT_LIST_ID], data)
+        lv.line_set_points(w.obj, points, len(data))
+
+
+line_spec = LineType()

esphome/components/lvgl/widgets/lv_bar.py

@@ -0,0 +1,55 @@
+import esphome.config_validation as cv
+from esphome.const import CONF_MAX_VALUE, CONF_MIN_VALUE, CONF_MODE, CONF_VALUE
+
+from ..defines import BAR_MODES, CONF_ANIMATED, CONF_INDICATOR, CONF_MAIN, literal
+from ..lv_validation import animated, get_start_value, lv_float
+from ..lvcode import lv
+from ..types import LvNumber, NumberType
+from . import Widget
+
+# Note this file cannot be called "bar.py" because that name is disallowed.
+
+CONF_BAR = "bar"
+BAR_MODIFY_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_VALUE): lv_float,
+        cv.Optional(CONF_ANIMATED, default=True): animated,
+    }
+)
+
+BAR_SCHEMA = cv.Schema(
+    {
+        cv.Optional(CONF_VALUE): lv_float,
+        cv.Optional(CONF_MIN_VALUE, default=0): cv.int_,
+        cv.Optional(CONF_MAX_VALUE, default=100): cv.int_,
+        cv.Optional(CONF_MODE, default="NORMAL"): BAR_MODES.one_of,
+        cv.Optional(CONF_ANIMATED, default=True): animated,
+    }
+)
+
+
+class BarType(NumberType):
+    def __init__(self):
+        super().__init__(
+            CONF_BAR,
+            LvNumber("lv_bar_t"),
+            parts=(CONF_MAIN, CONF_INDICATOR),
+            schema=BAR_SCHEMA,
+            modify_schema=BAR_MODIFY_SCHEMA,
+        )
+
+    async def to_code(self, w: Widget, config):
+        var = w.obj
+        if CONF_MIN_VALUE in config:
+            lv.bar_set_range(var, config[CONF_MIN_VALUE], config[CONF_MAX_VALUE])
+            lv.bar_set_mode(var, literal(config[CONF_MODE]))
+        value = await get_start_value(config)
+        if value is not None:
+            lv.bar_set_value(var, value, literal(config[CONF_ANIMATED]))
+
+    @property
+    def animated(self):
+        return True
+
+
+bar_spec = BarType()