From 2f143429fa4ac8584aee373f590036ef70c0d5f8 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Thu, 11 Jul 2024 15:41:48 +1200 Subject: [PATCH 01/53] Bump version to 2024.8.0-dev --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 4 ++-- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Doxygen b/Doxygen index a840b136d..cdff1cae9 100644 --- a/Doxygen +++ b/Doxygen @@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome" # could be handy for archiving the generated documentation or if some version # control system is used. -PROJECT_NUMBER = 2024.7.0-dev +PROJECT_NUMBER = 2024.8.0-dev # Using the PROJECT_BRIEF tag one can provide an optional one line description # for a project that appears at the top of each page and should give viewer a diff --git a/Makefile b/Makefile index 7c0268fd5..aaf14f951 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ ESPHOME_PATH = ../esphome -ESPHOME_REF = 2024.6.6 +ESPHOME_REF = dev PAGEFIND_VERSION=1.1.0 PAGEFIND=pagefind NET_PAGEFIND=../pagefindbin/pagefind diff --git a/_static/version b/_static/version index 45336c376..092c4094c 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2024.7.0-dev \ No newline at end of file +2024.8.0-dev \ No newline at end of file diff --git a/conf.py b/conf.py index bb6562ff5..d9d29eb02 100644 --- a/conf.py +++ b/conf.py @@ -67,9 +67,9 @@ author = "ESPHome" # built documents. # # The short X.Y version. -version = "2024.7" +version = "2024.8" # The full version, including alpha/beta/rc tags. -release = "2024.7.0-dev" +release = "2024.8.0-dev" # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. From 0af8c80ea78fb759185118679ac2e5f47dbe327b Mon Sep 17 00:00:00 2001 From: Tomi Junnila Date: Thu, 11 Jul 2024 23:33:27 +0300 Subject: [PATCH 02/53] Add yac1fb9 model for the gree climate_ir component (#4029) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: H. Árkosi Róbert --- components/climate/climate_ir.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/components/climate/climate_ir.rst b/components/climate/climate_ir.rst index 6f67f8f9c..7013e6692 100644 --- a/components/climate/climate_ir.rst +++ b/components/climate/climate_ir.rst @@ -414,6 +414,7 @@ Configuration variables: - ``yan`` - ``yaa`` - ``yac`` + - ``yac1fb9`` .. code-block:: yaml From d104d944379c764aca46313ab64b2313979f5a3d Mon Sep 17 00:00:00 2001 From: soeffi Date: Thu, 11 Jul 2024 23:30:51 +0200 Subject: [PATCH 03/53] jsn_sr04t: Added options for AJ_SR04M sensor types (#4022) --- components/sensor/jsn_sr04t.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/components/sensor/jsn_sr04t.rst b/components/sensor/jsn_sr04t.rst index 700701255..50cd63208 100644 --- a/components/sensor/jsn_sr04t.rst +++ b/components/sensor/jsn_sr04t.rst @@ -6,7 +6,7 @@ JSN-SR04T Waterproof Ultrasonic Range Finder :image: jsn-sr04t-v3.jpg :keywords: JSN-SR04T -This sensor allows you to use the JSN-SR04T Waterproof Ultrasonic Range Finder **in Mode 1 and 2** +This sensor allows you to use the JSN-SR04T and AJ_SR04M Waterproof Ultrasonic Range Finder **in Mode 1 and 2** with ESPHome to measure distances. This sensor can measure ranges between 25 centimeters and 600 centimeters with a resolution of 1 millimeter. @@ -18,6 +18,12 @@ Configure the JSN-SR04T for mode 2: - **V1.0 and V2.0**: Add a 120k resistor to pad R27. - **V3.0**: Short pad M2 or add 120k resistor to pad mode. +Configure the AJ_SR04M for mode 1: + - Add a 120k resistor to pad R19. + +Configure the AJ_SR04M for mode 2: + - Add a 47k resistor to pad R19. + .. figure:: images/jsn-sr04t-v3-mode-select-pads.jpg :align: center :width: 50.0% @@ -55,6 +61,7 @@ Configuration variables: sensor. Defaults to ``60s``. Not applicable in mode 1. - **uart_id** (*Optional*, :ref:`config-id`): The ID of the :ref:`UART bus ` you wish to use for this sensor. Use this if you want to use multiple UART buses at once. +- **model** (*Optional*): Sensor model. Available options: ``jsn_sr04t`` (default) and ``aj_sr04t``. - All other options from :ref:`Sensor `. See Also From 5536a2c58f15a2ceb9b5a4267a6af7bb5255ecbc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=2E=20=C3=81rkosi=20R=C3=B3bert?= Date: Fri, 12 Jul 2024 23:19:42 +0200 Subject: [PATCH 04/53] Bump HeatpumpIR - add protocols (#3996) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/climate/climate_ir.rst | 518 +++++++++++++----------------- 1 file changed, 215 insertions(+), 303 deletions(-) diff --git a/components/climate/climate_ir.rst b/components/climate/climate_ir.rst index 7013e6692..8cf167f22 100644 --- a/components/climate/climate_ir.rst +++ b/components/climate/climate_ir.rst @@ -10,17 +10,15 @@ control signal, just as the unit's handheld remote controller would. .. figure:: images/climate-ui.png :align: center - :width: 60.0% + :width: 40.0% There is a growing list of compatible units. If your unit is not listed below you should submit a feature request (see FAQ). +---------------------------------------+---------------------+----------------------+ -| Name | Platform name | Supports receiver | +| Supported units | Platform name | Supports receiver | | | | | +=======================================+=====================+======================+ -| :ref:`Arduino-HeatpumpIR` | ``heatpumpir`` | | -+---------------------------------------+---------------------+----------------------+ | Ballu | ``ballu`` | yes | +---------------------------------------+---------------------+----------------------+ | Coolix | ``coolix`` | yes | @@ -39,7 +37,7 @@ submit a feature request (see FAQ). +---------------------------------------+---------------------+----------------------+ | :ref:`GREE` | ``gree`` | | +---------------------------------------+---------------------+----------------------+ -| Hitachi | ``hitachi_ac344`` | yes | +| Hitachi | ``hitachi_ac344``, | yes | | | ``hitachi_ac424`` | | +---------------------------------------+---------------------+----------------------+ | :ref:`LG` | ``climate_ir_lg`` | yes | @@ -62,11 +60,15 @@ submit a feature request (see FAQ). +---------------------------------------+---------------------+----------------------+ | :ref:`ZH/LT-01` | ``zhlt01`` | yes | +---------------------------------------+---------------------+----------------------+ +| :ref:`Arduino-HeatpumpIR` | ``heatpumpir`` | | +| library | | | ++---------------------------------------+---------------------+----------------------+ This component requires that you have configured a :doc:`/components/remote_transmitter`. Due to the unidirectional nature of IR remote controllers, this component cannot determine the actual state of the device and will assume the state of the device is the latest state requested. +The assumed state can be restored at boot. However, when receiver is supported, you can optionally add a :doc:`/components/remote_receiver` component so the climate state will be tracked when it is operated with the original remote @@ -80,7 +82,7 @@ controller unit. carrier_duty_percent: 50% climate: - - platform: coolix # adjust to match your AC unit! + - platform: REPLACEME name: "Living Room AC" Configuration Variables: @@ -95,53 +97,201 @@ Configuration Variables: receiver. see: :ref:`ir-receiver_id`. - All other options from :ref:`Climate `. -Advanced Options ----------------- +**Advanced Options** - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **transmitter_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the remote transmitter. -.. _heatpumpir: +**Specific configuration variables:** -Arduino-HeatpumpIR ------------------- +.. _climate_ir_lg: -The ``heatpumpir`` platform supports dozens of manufacturers and hundreds of AC units by utilising the `Arduino-HeatpumpIR library `__. +``climate_ir_lg`` **Climate**: -This platform should only be used if your AC unit is not supported by any of the other (native) platforms. No support can be provided for Arduino-HeatpumpIR, because it is a third party library. +- **header_high** (*Optional*, :ref:`config-time`): time for the high part of the header for the LG protocol. Defaults to ``8000us`` +- **header_low** (*Optional*, :ref:`config-time`): time for the low part of the header for the LG protocol. Defaults to ``4000us`` +- **bit_high** (*Optional*, :ref:`config-time`): time for the high part of any bit in the LG protocol. Defaults to ``600us`` +- **bit_one_low** (*Optional*, :ref:`config-time`): time for the low part of a '1' bit in the LG protocol. Defaults to ``1600us`` +- **bit_zero_low** (*Optional*, :ref:`config-time`): time for the low part of a '0' bit in the LG protocol. Defaults to ``550us`` -This platform utilises the library's generic one-size-fits-all API, which might not line up perfectly with all of the supported AC units. For example, some AC units have more fan speed options than what the generic API supports. +.. code-block:: yaml -Additional configuration must be specified for this platform: + # Example configuration entry + climate: + - platform: climate_ir_lg + name: "AC" + sensor: room_temperature + header_high: 3265us # AC Units from LG in Brazil, for example use these timings + header_low: 9856us -- **protocol** (**Required**, string): Choose one of Arduino-HeatpumpIR's supported protcols: - ``aux``, ``ballu``, ``carrier_mca``, ``carrier_nqv``, ``carrier_qlima_1``, ``carrier_qlima_1``, ``daikin``, ``daikin_arc417``, - ``daikin_arc480``, ``electroluxyal``, ``fuego``, ``fujitsu_awyz``, ``gree``, ``greeyaa``, ``greeyac``, ``greeyan``, ``greeyap``, - ``greeyt``, ``hisense_aud``, ``hitachi``, ``hyundai``, ``ivt``, ``midea``, ``mitsubishi_fa``, ``mitsubishi_fd``, - ``mitsubishi_fe``, ``mitsubishi_heavy_fdtc``, ``mitsubishi_heavy_zj``, ``mitsubishi_heavy_zm``, ``mitsubishi_heavy_zmp``, - ``mitsubishi_kj``, ``mitsubishi_msc``, ``mitsubishi_msy``, ``mitsubishi_sez``, ``nibe``, ``panasonic_ckp``, ``panasonic_dke``, - ``panasonic_jke``, ``panasonic_lke``, ``panasonic_nke``, ``samsung_aqv``, ``samsung_aqv12msan``, - ``samsung_fjm``, ``sharp``, ``toshiba``, ``toshiba_daiseikai``, ``zhjg01``, ``zhlt01``. +.. _daikin_brc: +``daikin_brc`` **Climate**: -- **horizontal_default** (**Required**, string): What to default to when the AC unit's horizontal direction is *not* set to swing. Options are: ``left``, ``mleft``, ``middle``, ``mright``, ``right``, ``auto``. -- **vertical_default** (**Required**, string): What to default to when the AC unit's vertical direction is *not* set to swing. Options are: ``down``, ``mdown``, ``middle``, ``mup``, ``up``, ``auto``. -- **max_temperature** (**Required**, float): The maximum temperature that the AC unit supports being set to. -- **min_temperature** (**Required**, float): The minimum temperature that the AC unit supports being set to. -- **sensor** (*Optional*, :ref:`config-id`): The sensor that is used to measure the ambient temperature. +The Daikin BRC remotes are used by the ceiling cassette model of Daikin heatpumps. + +- **use_fahrenheit** (*Optional*, boolean): U.S. models of the Daikin BRC remote send the temperature in Fahrenheit, if your remote shows Fahrenheit and can not be changed to Celsius then set this to true. Defaults to ``false``. + +.. code-block:: yaml + + # Example configuration entry + climate: + - platform: daikin_brc + name: "AC" + sensor: room_temperature + use_fahrenheit: true + +.. _delonghi_ir: + +``delonghi`` **Climate**: + +The ``delonghi`` climate currently supports the protocol used by some Delonghi portable units, known working with Delonghi PAC WE 120HP. + +.. _daikin_arc: + +``daikin_arc`` **Climate**: + +The Daikin ARC remotes (``daikin_arc`` climate, ``daikin_arc417``, ``daikin_arc480`` protocols of :ref:`Arduino-HeatpumpIR`) are used by the japanese model of Daikin. + +.. _gree_ir: + +``gree`` **Climate**: + +- **model** (*Required*, string): GREE has a few different protocols depending on model. One of these will work for you. + + - ``generic`` + - ``yan`` + - ``yaa`` + - ``yac`` + - ``yac1fb9`` + +.. code-block:: yaml + + # Example configuration entry + climate: + - platform: gree + name: "AC" + sensor: room_temperature + model: yan + +.. _midea_ir: + +``midea_ir`` **Climate**: + +These air conditioners support two protocols: Midea and Coolix. Therefore, when using an IR receiver, it considers both protocols and publishes the received states. + +- **use_fahrenheit** (*Optional*, boolean): Allows you to transfer the temperature to the air conditioner in degrees Fahrenheit. The air conditioner display also shows the temperature in Fahrenheit. Defaults to ``false``. + +.. code-block:: yaml + + # Example configuration entry + climate: + - platform: midea_ir + name: "AC" + sensor: room_temperature + use_fahrenheit: true .. note:: - - The ``greeyac`` protocol supports a feature Gree calls "I-Feel". The handheld remote control + - See :ref:`Transmit Midea` to send custom commands, including Follow Me mode. + - See :ref:`Toshiba` below if you are looking for compatibility with Midea model MAP14HS1TBL or similar. + +.. _mitsubishi: + +``mitsubishi`` **Climate**: + +- **set_fan_mode** (*Optional*, string): Select the fan modes desired or that are supported on your remote. Defaults to ``3levels`` + + - Options are: ``3levels`` , ``4levels``, ``quiet_4levels``. + + - ``3levels``; Low [fan speed 1], Medium [2], High [3] + - ``4levels``; Low [1], Middle [2], Medium [3], High [4] + - ``quiet_4levels``; Low [1], Middle [2], Medium [3], High [4], Quiet [5] + +- **supports_dry** (*Optional*, boolean): Enables setting dry mode for this unit. Defaults to ``false``. +- **supports_fan_only** (*Optional*, boolean): Enables setting fan only mode for this unit. Confirm that mode is supported on your remote. Defaults to ``false``. + +- **horizontal_default** (*Optional*, string): What to default to when the AC unit's horizontal direction is *not* set to swing. Defaults to ``middle``. + + - Options are: ``left``, ``middle-left``, ``middle``, ``middle-right``, ``right``, ``auto`` +- **vertical_default** (*Optional*, string): What to default to when the AC unit's vertical direction is *not* set to swing. Defaults to ``middle``. + + - Options are: ``down``, ``middle-down``, ``middle``, ``middle-up``, ``up``, ``auto`` + +.. note:: + + - This climate IR component is also known to work with some Stiebel Eltron Units. It has been tested with Stiebel Eltron IR-Remote ``KM07F`` and unit ``ACW 25 i`` + +.. code-block:: yaml + + # Example configuration entry + climate: + - platform: mitsubishi + name: "Heatpump" + set_fan_mode: "quiet_4levels" + supports_dry: "true" + supports_fan_only: "true" + horizontal_default: "left" + vertical_default: "down" + +.. _toshiba: + +``toshiba`` **Climate**: + +- **model** (*Optional*, string): There are two valid models + + - ``GENERIC``: Temperature range is from 17 to 30 (default) + - ``RAC-PT1411HWRU-C``: Temperature range is from 16 to 30; unit displays temperature in degrees Celsius + - ``RAC-PT1411HWRU-F``: Temperature range is from 16 to 30; unit displays temperature in degrees Fahrenheit + +.. note:: + + - While they are identified as separate models here, the ``RAC-PT1411HWRU-C`` and ``RAC-PT1411HWRU-C`` are + in fact the same physical model/unit. They are separated here only because different IR codes are used + depending on the desired unit of measurement. This only affects how temperature is displayed on the unit itself. + + - The ``RAC-PT1411HWRU`` model supports a feature Toshiba calls "Comfort Sense". The handheld remote control has a built-in temperature sensor and it will periodically transmit the temperature from this sensor to the AC unit. If a ``sensor`` is provided in the configuration with this model, the sensor's temperature will be - transmitted to the ``greeyac`` device in the same manner as the original remote controller. How often the + transmitted to the ``RAC-PT1411HWRU`` in the same manner as the original remote controller. How often the temperature is transmitted is determined by the ``update_interval`` assigned to the ``sensor``. Note that - ``update_interval`` must be less than 10 minutes or the ``greeyac`` device will revert to using its own - internal temperature sensor; a value of 2 minutes seems to work well. See :doc:`/components/sensor/index` + ``update_interval`` must be less than seven minutes or the ``RAC-PT1411HWRU`` will revert to using its own + internal temperature sensor; a value of 30 seconds seems to work well. See :doc:`/components/sensor/index` for more information. - - The ``zhlt01`` protocol supports multiple AC brands: Eurom, Chigo, Tristar, Tecnomaster, Elgin, Geant, Tekno, Topair, Proma, Sumikura, JBS, Turbo Air, Nakatomy, Celestial Air, Ager, Blueway, Airlux, etc. + - This climate IR component is also known to work with Midea model MAP14HS1TBL and may work with other similar + models, as well. (Midea acquired Toshiba's product line and re-branded it.) + +.. _whirlpool: + +``whirlpool`` **Climate**: + +- **model** (*Optional*, string): There are two valid models to choose from: + + - ``DG11J1-3A``: Temperature range is from 18 to 32 (default) + - ``DG11J1-91``: Temperature range is from 16 to 30 + +.. _whynter: + +``whynter`` **Climate**: + +- **use_fahrenheit** (*Optional*, boolean): Allows you to transfer the temperature to the air conditioner in degrees Fahrenheit. The air conditioner display also shows the temperature in Fahrenheit. Defaults to ``false``. + +.. code-block:: yaml + + # Example configuration entry + climate: + - platform: whynter + name: "AC" + sensor: room_temperature + use_fahrenheit: true + supports_heat: true + +.. _zhlt01: + +``zhlt01`` **Climate**: + +The ``zhlt01`` climate and protocol, based on the ZH/LT-01 remote controller, is used with many locally branded airconditioners, like: Eurom, Chigo, Tristar, Tecnomaster, Elgin, Geant, Tekno, Topair, Proma, Sumikura, JBS, Turbo Air, Nakatomy, Celestial Air, Ager, Blueway, Airlux, etc. .. _ir-receiver_id: @@ -174,286 +324,47 @@ IR receiver. tolerance: 55% climate: - - platform: coolix + - platform: REPLACEME name: "Living Room AC" receiver_id: rcvr -.. _climate_ir_lg: +.. _heatpumpir: -``climate_ir_lg`` Climate -------------------------- +Arduino-HeatpumpIR +------------------ -Additional configuration is available for this platform +The ``heatpumpir`` platform supports dozens of manufacturers and hundreds of AC units by utilising the `Arduino-HeatpumpIR library `__. +This platform compiles only under ``arduino`` framework or LibreTiny, and should only be used if your AC unit is not supported by any of the other (native) platforms from above. No support can be provided for Arduino-HeatpumpIR, because it is a third party library. -Configuration variables: +This platform utilises the library's generic one-size-fits-all API, which might not line up perfectly with all of the supported AC units. For example, some AC units have more fan speed options than what the generic API supports. -- **header_high** (*Optional*, :ref:`config-time`): time for the high part of the header for the LG protocol. Defaults to ``8000us`` -- **header_low** (*Optional*, :ref:`config-time`): time for the low part of the header for the LG protocol. Defaults to ``4000us`` -- **bit_high** (*Optional*, :ref:`config-time`): time for the high part of any bit in the LG protocol. Defaults to ``600us`` -- **bit_one_low** (*Optional*, :ref:`config-time`): time for the low part of a '1' bit in the LG protocol. Defaults to ``1600us`` -- **bit_zero_low** (*Optional*, :ref:`config-time`): time for the low part of a '0' bit in the LG protocol. Defaults to ``550us`` +Additional configuration must be specified for this platform: -.. code-block:: yaml - - # Example configuration entry - climate: - - platform: climate_ir_lg - name: "AC" - sensor: room_temperature - header_high: 3265us # AC Units from LG in Brazil, for example use these timings - header_low: 9856us - -.. _daikin_arc: - -``daikin_arc`` Climate -------------------------- - -The Daikin ARC remotes are used by the japanese model of Daikin. - -.. code-block:: yaml - - # Example configuration entry - climate: - - platform: daikin_arc - name: "AC" - sensor: room_temperature - -.. _daikin_brc: - -``daikin_brc`` Climate -------------------------- - -The Daikin BRC remotes are used by the ceiling cassette model of Daikin heatpumps. - - -Configuration variables: - -- **use_fahrenheit** (*Optional*, boolean): U.S. models of the Daikin BRC remote send the temperature in Fahrenheit, if your remote shows Fahrenheit and can not be changed to Celsius then set this to true. Defaults to ``false``. - -.. code-block:: yaml - - # Example configuration entry - climate: - - platform: daikin_brc - name: "AC" - sensor: room_temperature - use_fahrenheit: true - - -.. _delonghi_ir: - -``delonghi`` Climate -------------------------- - -Currently supports the protocol used by some Delonghi portable units - -Known working with: - -- Delonghi PAC WE 120HP - -.. _midea_ir: - -``midea_ir`` Climate -------------------------- - -These air conditioners support two protocols: Midea and Coolix. Therefore, when using an IR receiver, it considers both protocols and publishes the received states. - -Additional configuration is available for this platform - - -Configuration variables: - -- **use_fahrenheit** (*Optional*, boolean): Allows you to transfer the temperature to the air conditioner in degrees Fahrenheit. The air conditioner display also shows the temperature in Fahrenheit. Defaults to ``false``. - -.. code-block:: yaml - - # Example configuration entry - climate: - - platform: midea_ir - name: "AC" - sensor: room_temperature - use_fahrenheit: true +- **protocol** (**Required**, string): Choose one of Arduino-HeatpumpIR's supported protcols: + ``airway``, ``aux``, ``ballu``, ``bgh_aud``, ``carrier_mca``, ``carrier_nqv``, ``carrier_qlima_1``, ``carrier_qlima_1``, ``daikin``, + ``daikin_arc417``, ``daikin_arc480``, ``electroluxyal``, ``fuego``, ``fujitsu_awyz``, ``gree``, ``greeyaa``, ``greeyac``, ``greeyan``, + ``greeyap``, ``greeyt``, ``hisense_aud``, ``hitachi``, ``hyundai``, ``ivt``, ``midea``, ``mitsubishi_fa``, ``mitsubishi_fd``, + ``mitsubishi_fe``, ``mitsubishi_heavy_fdtc``, ``mitsubishi_heavy_zj``, ``mitsubishi_heavy_zm``, ``mitsubishi_heavy_zmp``, ``mitsubishi_kj``, + ``mitsubishi_msc``, ``mitsubishi_msy``, ``mitsubishi_sez``, ``nibe``, ``panasonic_altdke``, ``panasonic_ckp``, ``panasonic_dke``, + ``panasonic_jke``, ``panasonic_lke``, ``panasonic_nke``, ``r51m``, ``samsung_aqv``, ``samsung_aqv12msan``, ``samsung_fjm``, ``sharp``, + ``toshiba``, ``toshiba_daiseikai``, ``vaillantvai8``, ``zhjg01``, ``zhlt01`` +- **horizontal_default** (**Required**, string): What to default to when the AC unit's horizontal direction is *not* set to swing. Options are: ``left``, ``mleft``, ``middle``, ``mright``, ``right``, ``auto`` +- **vertical_default** (**Required**, string): What to default to when the AC unit's vertical direction is *not* set to swing. Options are: ``down``, ``mdown``, ``middle``, ``mup``, ``up``, ``auto`` +- **max_temperature** (**Required**, float): The maximum temperature that the AC unit supports being set to. +- **min_temperature** (**Required**, float): The minimum temperature that the AC unit supports being set to. +- **sensor** (*Optional*, :ref:`config-id`): The sensor that is used to measure the ambient temperature. .. note:: - - See :ref:`Transmit Midea` to send custom commands, including Follow Me mode. - - See :ref:`Toshiba` below if you are looking for compatibility with Midea model MAP14HS1TBL or similar. - -.. _mitsubishi: - -``mitsubishi`` Climate ------------------------- - -Additonal configurations available for this platform. - -Configuration variables: - -- **set_fan_mode** (*Optional*, string): Select the fan modes desired or that are supported on your remote. Defaults to ``3levels`` - - - Options are: ``3levels`` , ``4levels``, ``quiet_4levels``. - - - ``3levels``; Low [fan speed 1], Medium [2], High [3] - - ``4levels``; Low [1], Middle [2], Medium [3], High [4] - - ``quiet_4levels``; Low [1], Middle [2], Medium [3], High [4], Quiet [5] - -- **supports_dry** (*Optional*, boolean): Enables setting dry mode for this unit. Defaults to ``false``. -- **supports_fan_only** (*Optional*, boolean): Enables setting fan only mode for this unit. Confirm that mode is supported on your remote. Defaults to ``false``. - -- **horizontal_default** (*Optional*, string): What to default to when the AC unit's horizontal direction is *not* set to swing. Defaults to ``middle``. - - - Options are: ``left``, ``middle-left``, ``middle``, ``middle-right``, ``right``, ``auto`` -- **vertical_default** (*Optional*, string): What to default to when the AC unit's vertical direction is *not* set to swing. Defaults to ``middle``. - - - Options are: ``down``, ``middle-down``, ``middle``, ``middle-up``, ``up``, ``auto`` - -.. note:: - - - This climate IR component is also known to work with some Stiebel Eltron Units. It has been tested with Stiebel Eltron IR-Remote ``KM07F`` and unit ``ACW 25 i`` - -.. code-block:: yaml - - # Example configuration entry - climate: - - platform: mitsubishi - name: "Heatpump" - set_fan_mode: "quiet_4levels" - supports_dry: "true" - supports_fan_only: "true" - horizontal_default: "left" - vertical_default: "down" - -.. _toshiba: - -``toshiba`` Climate -------------------- - -Additional configuration is available for this model. - - -Configuration variables: - -- **model** (*Optional*, string): There are two valid models - - - ``GENERIC``: Temperature range is from 17 to 30 (default) - - ``RAC-PT1411HWRU-C``: Temperature range is from 16 to 30; unit displays temperature in degrees Celsius - - ``RAC-PT1411HWRU-F``: Temperature range is from 16 to 30; unit displays temperature in degrees Fahrenheit - -.. note:: - - - While they are identified as separate models here, the ``RAC-PT1411HWRU-C`` and ``RAC-PT1411HWRU-C`` are - in fact the same physical model/unit. They are separated here only because different IR codes are used - depending on the desired unit of measurement. This only affects how temperature is displayed on the unit itself. - - - The ``RAC-PT1411HWRU`` model supports a feature Toshiba calls "Comfort Sense". The handheld remote control - has a built-in temperature sensor and it will periodically transmit the temperature from this sensor to the - AC unit. If a ``sensor`` is provided in the configuration with this model, the sensor's temperature will be - transmitted to the ``RAC-PT1411HWRU`` in the same manner as the original remote controller. How often the - temperature is transmitted is determined by the ``update_interval`` assigned to the ``sensor``. Note that - ``update_interval`` must be less than seven minutes or the ``RAC-PT1411HWRU`` will revert to using its own - internal temperature sensor; a value of 30 seconds seems to work well. See :doc:`/components/sensor/index` - for more information. - - - This climate IR component is also known to work with Midea model MAP14HS1TBL and may work with other similar - models, as well. (Midea acquired Toshiba's product line and re-branded it.) - - -.. _whirlpool: - - -``whirlpool`` Climate ---------------------- - -Additional configuration is available for this model. - - -Configuration variables: - -- **model** (*Optional*, string): There are two valid models - - - ``DG11J1-3A``: Temperature range is from 18 to 32 (default) - - ``DG11J1-91``: Temperature range is from 16 to 30 - -.. _whynter: - -``whynter`` Climate -------------------------- - -Additional configuration is available for this platform - - -Configuration variables: - -- **use_fahrenheit** (*Optional*, boolean): Allows you to transfer the temperature to the air conditioner in degrees Fahrenheit. The air conditioner display also shows the temperature in Fahrenheit. Defaults to ``false``. - -.. code-block:: yaml - - # Example configuration entry - climate: - - platform: whynter - name: "AC" - sensor: room_temperature - use_fahrenheit: true - supports_heat: true - - -.. _gree_ir: - - -``gree`` Climate ---------------------- - -Additional configuration is available for this model. - - -Configuration variables: - -- **model** (*Required*, string): GREE has a few different protocols depending on model. One of these will work for you. - - - ``generic`` - - ``yan`` - - ``yaa`` - - ``yac`` - - ``yac1fb9`` - - -.. code-block:: yaml - - # Example configuration entry - climate: - - platform: gree - name: "AC" - sensor: room_temperature - model: yan - -.. _zhlt01: - - -``zhlt01`` Climate ---------------------- - -ZH/LT-01 is a remote control that is used with many locally branded split airconditioners. -Supported brands include: - -- Eurom -- Chigo -- Tristar -- Tecnomaster -- Elgin -- Geant -- Tekno -- Topair -- Proma -- Sumikura -- JBS -- Turbo Air -- Nakatomy -- Celestial Air -- Ager -- Blueway -- Airlux - -No additional configuration is required for this model. + The ``greeyac`` protocol in ``heatpumpir`` supports a feature Gree calls "I-Feel". The handheld remote control + has a built-in temperature sensor and it will periodically transmit the temperature from this sensor to the + AC unit. If a ``sensor`` is provided in the configuration with this model, the sensor's temperature will be + transmitted to the ``greeyac`` device in the same manner as the original remote controller. How often the + temperature is transmitted is determined by the ``update_interval`` assigned to the ``sensor``. Note that + ``update_interval`` must be less than 10 minutes or the ``greeyac`` device will revert to using its own + internal temperature sensor; a value of 2 minutes seems to work well. See :doc:`/components/sensor/index` + for more information. See Also -------- @@ -463,14 +374,15 @@ See Also - :doc:`/components/remote_transmitter` - :doc:`/components/sensor/index` - :apiref:`ballu.h `, -- :apiref:`coolix.h `, + :apiref:`climate_ir_lg.h ` + :apiref:`coolix.h `, :apiref:`daikin.h ` :apiref:`fujitsu_general.h `, + :apiref:`gree.h `, :apiref:`hitachi_ac344.h `, :apiref:`midea_ir.h `, :apiref:`mitsubishi.h `, :apiref:`tcl112.h `, :apiref:`yashima.h ` :apiref:`whirlpool.h ` - :apiref:`climate_ir_lg.h ` - :ghedit:`Edit` From 30ae8e56988534cbd7bda5e3f0d36030a7aff1e6 Mon Sep 17 00:00:00 2001 From: Anton Viktorov Date: Fri, 12 Jul 2024 21:42:48 +0000 Subject: [PATCH 05/53] LTR390 separate ALS and UV gain and resolution (#4012) --- components/sensor/ltr390.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/components/sensor/ltr390.rst b/components/sensor/ltr390.rst index 4b6933d75..d80ed2117 100644 --- a/components/sensor/ltr390.rst +++ b/components/sensor/ltr390.rst @@ -44,6 +44,28 @@ Configuration variables: - **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``. It is recommended that the update interval is at least 1 second since updates can take up to 800ms when using a high resolution value. +Granular control over gain and resolution +......................................... +By default, the ``gain`` and ``resolution`` parameters set same values for both ALS and UV measurements. In real life scenarios there might be significant +differences in the light intensity and UV index, so it is recommended to use different gain and resolution values for ALS and for UV sensor to avoid saturation. +See the example below, where the gain and resolution are set to different values for ALS and UV sensors.: + +.. code-block:: yaml + + sensor: + - platform: ltr390 + uv: + name: "UV Sensor Counts" + ambient_light: + name: "Light Sensor Counts" + gain: + ambient_light: X9 + uv: X3 + resolution: + ambient_light: 18 + uv: 13 + + Lux and UVI Formulas -------------------- From f80a0613055b69a95ca6a044fe2e67bc8a9c666e Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 16 Jul 2024 16:28:47 +1200 Subject: [PATCH 06/53] [i2s_audio] Microphone i2s mode (#4053) --- components/microphone/i2s_audio.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/components/microphone/i2s_audio.rst b/components/microphone/i2s_audio.rst index 7e84843f9..dc44ccbe1 100644 --- a/components/microphone/i2s_audio.rst +++ b/components/microphone/i2s_audio.rst @@ -46,6 +46,7 @@ Configuration variables: will be scaled down to 16bit before being forwarded. One of ``16bit`` or ``32bit``. Defaults to ``16bit``. - **use_apll** (*Optional*, boolean): I2S using APLL as main I2S clock, enable it to get accurate clock. Defaults to ``false``. +- **i2s_mode** (*Optional*, enum): The I²S mode to use. One of ``primary`` or ``secondary``. Defaults to ``primary``. - **i2s_audio_id** (*Optional*, :ref:`config-id`): The ID of the :ref:`I²S Audio ` you wish to use for this microphone. - All other options from :ref:`Microphone ` From 48f030f6b456ca9a97e048087a3fee0bb697b2ec Mon Sep 17 00:00:00 2001 From: Markus <974709+Links2004@users.noreply.github.com> Date: Sun, 21 Jul 2024 23:36:50 +0200 Subject: [PATCH 07/53] update MQTT docs to include discover_ip option (#3809) Co-authored-by: Keith Burzinski --- components/mqtt.rst | 105 +++++++++++++++++++++++++++++++++++++++----- guides/cli.rst | 2 +- 2 files changed, 96 insertions(+), 11 deletions(-) diff --git a/components/mqtt.rst b/components/mqtt.rst index c255d8ef2..6ec0cd291 100644 --- a/components/mqtt.rst +++ b/components/mqtt.rst @@ -41,7 +41,9 @@ Configuration variables: authentication. Empty (the default) means no authentication. - **client_id** (*Optional*, string): The client id to use for opening connections. See :ref:`mqtt-defaults` for more information. -- **discovery** (*Optional*, boolean): If Home Assistant automatic +- **discover_ip** (*Optional*, boolean): If Home Assistant automatic device + discovery should be enabled. Defaults to ``true``. +- **discovery** (*Optional*, boolean): If Home Assistant automatic entity discovery should be enabled. Defaults to ``true``. - **discovery_retain** (*Optional*, boolean): Whether to retain MQTT discovery messages so that entities are added automatically on Home @@ -137,10 +139,93 @@ Configuration options: - **retain** (*Optional*, boolean): If the published message should have a retain flag on or not. Defaults to ``true``. -.. _mqtt-using_with_home_assistant: -Using with Home Assistant -------------------------- +.. _mqtt-device_discovery: + +MQTT device discovery +--------------------- + +The ESPHome device will respond to the following MQTT topics if ``mqtt.discover_ip`` is enabled. + +- ``esphome/discover`` (All ESPHome device will answer) +- ``esphome/ping/`` + +The response will be sent to ``esphome/discover/`` and is a JSON encoded message. + +The MQTT device discovery is currently used for: + +- ESPHome dashboard (online / offline status) +- ESPHome CLI (IP discovery; used to view logs and perform OTA uploads) +- Home Assistant device discovery + +Example Payload: + +.. code-block:: json + + { + "ip": "192.168.0.122", + "name": "esp32-test", + "friendly_name": "Test Device", + "port": 6053, + "version": "2024.4.1", + "mac": "84fce6123456", + "platform": "ESP32", + "board": "esp32-c3-devkitm-1", + "network": "wifi", + "api_encryption": "Noise_NNpsk0_25519_ChaChaPoly_SHA256" + } + + +JSON keys: + +- **ip** (**Required**, ip): The IP address of the ESPHome device. +- **name** (**Required**, string): Name of the device (``esphome.name``). +- **mac** (**Required**, string): MAC address of the device. +- **board** (**Required**, string): Board used for the device. +- **version** (**Required**, string): ESPHome version. +- **port** (*Optional*, port): Port of the ESPHome API (if enabled). +- **ipX** (*Optional*, ip): Additional IP addresses (X is a number starting at 1). +- **friendly_name** (*Optional*, string): Friendly name of the device (``esphome.friendly_name``). +- **platform** (*Optional*, string): Platform of the device (e.g. ESP32 or ESP8266) +- **network** (*Optional*, string): Network type. +- **project_name** (*Optional*, string): ``esphome.project.name``. +- **project_version** (*Optional*, string): ``esphome.project.version``. +- **project_version** (*Optional*, string): ``dashboard_import.package_import_url``. +- **api_encryption** (*Optional*, string): API encryption type. + +.. _mqtt-using_device_discovery_with_home_assistant: + +Using device discovery with Home Assistant +------------------------------------------ + +MQTT can be used to automatically discover the ESPHome devices in Home Assistant. +This allows Home Assistant to find the ESPHome device and connect +to it via the ESPHome API which allows the usage +of more features then MQTT entity discovery alone (e.g. Bluetooth Proxy, Voice Assistant). + +This can be achieved by enabling ``api`` and ``mqtt`` with ``mqtt.discover_ip`` enabled. +It may makes sense to disable ``mqtt.discovery`` since there will be no need to use the +MQTT entity discovery if Home Assistant will connect to the ESPHome API. + +Example configuration: + +.. code-block:: yaml + + api: + encryption: + key: "" + + mqtt: + broker: 10.0.0.2 + username: livingroom + password: !secret mqtt_password + discovery: False # disable entity discovery + discover_ip: True # enable device discovery + +.. _mqtt-using_with_home_assistant_entities: + +Using with Home Assistant MQTT entities +--------------------------------------- Using ESPHome with Home Assistant is easy, simply setup an MQTT broker (like `mosquitto `__) and point both your @@ -377,16 +462,16 @@ Configuration variables: - **state_topic** (*Optional*, string): The topic to publish state updates to. Defaults to ``///state``. - - ESPHome will always publish a manually configured state topic, even if - the component is internal. Use ``null`` to disable publishing the + + ESPHome will always publish a manually configured state topic, even if + the component is internal. Use ``null`` to disable publishing the component's state. - **command_topic** (*Optional*, string): The topic to subscribe to for commands from the remote. Defaults to ``///command``. - - ESPHome will always subscribe to a manually configured command topic, - even if the component is internal. Use ``null`` to disable subscribing + + ESPHome will always subscribe to a manually configured command topic, + even if the component is internal. Use ``null`` to disable subscribing to the component's command topic. - **command_retain** (*Optional*, boolean): Whether MQTT command messages sent to the device should be retained or not. Default to ``false``. diff --git a/guides/cli.rst b/guides/cli.rst index 68e600eb2..37910334c 100644 --- a/guides/cli.rst +++ b/guides/cli.rst @@ -140,7 +140,7 @@ The ``esphome upload `` validates the configuration and uploads the most .. program:: esphome clean-mqtt The ``esphome clean-mqtt `` cleans retained MQTT discovery messages from the MQTT broker. -See :ref:`mqtt-using_with_home_assistant`. +See :ref:`mqtt-using_with_home_assistant_entities`. .. option:: --topic TOPIC From 662447151b9125cecb1ea949049475ed9e45d480 Mon Sep 17 00:00:00 2001 From: rnauber <7414650+rnauber@users.noreply.github.com> Date: Sun, 21 Jul 2024 23:58:03 +0200 Subject: [PATCH 08/53] Document m5angle8 input device (#3866) Co-authored-by: Richard Nauber Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/sensor/images/m5stack_8angle.jpg | Bin 0 -> 102177 bytes components/sensor/m5stack_8angle.rst | 145 ++++++++++++++++++++ images/m5stack_8angle.png | Bin 0 -> 20010 bytes index.rst | 1 + 4 files changed, 146 insertions(+) create mode 100644 components/sensor/images/m5stack_8angle.jpg create mode 100644 components/sensor/m5stack_8angle.rst create mode 100644 images/m5stack_8angle.png diff --git a/components/sensor/images/m5stack_8angle.jpg b/components/sensor/images/m5stack_8angle.jpg new file mode 100644 index 0000000000000000000000000000000000000000..20b444cb498da2bf4fd8d2766080c9811ac9c5cb GIT binary patch literal 102177 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 literal 0 HcmV?d00001 diff --git a/components/sensor/m5stack_8angle.rst b/components/sensor/m5stack_8angle.rst new file mode 100644 index 000000000..659d05458 --- /dev/null +++ b/components/sensor/m5stack_8angle.rst @@ -0,0 +1,145 @@ +M5Stack Unit 8 Angle +==================== + +.. seo:: + :description: Setting up the M5Stack Unit 8 Angle input device with 8 knobs. + :image: m5stack_8angle.png + +Component/Hub +------------- + +The ``m5stack_8angle`` platform allows to use the [m5angle](https://docs.m5stack.com/en/unit/UNIT%208Angle) input device with ESPHome. +It has 8 knobs, a switch and can individually drive 9 RGB LEDs. + +.. figure:: images/m5stack_8angle.jpg + :align: center + :width: 75.0% + + The m5stack_8angle unit. + +The ``m5stack_8angle`` component communicates through an :ref:`I²C ` bus and uses a default address of 0x43. + +.. code-block:: yaml + + # Example configuration entry + m5stack_8angle: + id: m5stack_8angle_base + +Configuration variables: +************************ + +- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. +- **i2c_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the :ref:`I²C Component ` if you need +- **address** (*Optional*, int): Manually specify the I²C address of the device. Defaults to ``0x43``. + + +Knob's position sensor +---------------------- + +The position of the 8 knobs can be made available as sensors with values between 0-1 (with 0 being the leftmost position). + +.. code-block:: yaml + + sensor: + - platform: m5stack_8angle + m5stack_8angle_id: m5stack_8angle_base + channel: 1 + name: "Knob 1" + bit_depth: 12 bit + - platform: m5stack_8angle + m5stack_8angle_id: m5stack_8angle_base + channel: 2 + name: "Knob 2" + +Configuration variables: +************************ + +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``10s``. +- **bit_depth** (*Optional*, one of ``12 bit`` or ``8 bit``) determines the precision of the analog readout, defaults to ``8bit``. +- **raw** (*Optional*, boolean) if true, the sensor returns the raw readout value of the knob. +- All other options from :ref:`Sensor `. + + +Input switch binary sensor +-------------------------- + + A binary sensor indicating the state of the switch on the device. + +.. code-block:: yaml + + binary_sensor: + - platform: m5stack_8angle + m5stack_8angle_id: m5stack_8angle_base + name: "Switch" + +Configuration variables: +************************ + +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``10s``. +- All other options from :ref:`Binary Sensor `. + + +Lights +------ +The 9 LEDs can be used a addressable light output. + +.. code-block:: yaml + + light: + - platform: m5stack_8angle + m5stack_8angle_id: m5stack_8angle_base + id: m8_angle_leds + name: "Lights" + effects: + - addressable_rainbow: + +Configuration variables: +************************ +- All options from :ref:`Light `. + + +Read knob's positions and switch state in Lambdas +------------------------------------------------- + +You can trigger the readout of the position of an individual knob through ``float value = id(...)->read_knob_pos(index);`` and of the switch through ``int value = id(...)->read_switch();``. +A negative return value indicates a failure to read the state. + +.. code-block:: yaml + + # Example configuration entry for having the LEDs indicate the knobs' position + light: + - platform: m5stack_8angle + m5stack_8angle_id: m5stack_8angle_base + id: m8_angle_leds + name: "Lights" + effects: + - addressable_lambda: + name: "Indicate Values" + update_interval: 200ms + lambda: |- + ESPHSVColor hsv; + hsv.value = 255; + hsv.saturation = 240; + auto parent = id(m5stack_8angle_base); + for (int i=0; i < 8; i++) { + auto kpos = parent->read_knob_pos(i); + if (kpos >= 0){ + hsv.hue = kpos * 200; + it[i] = hsv; + } + } + if (parent->read_switch() > 0) + hsv.hue = 200; + else + hsv.hue = 0; + it[8] = hsv; + +See Also +-------- + +- :ref:`sensor-filters` +- :doc:`/components/binary_sensor/index` +- :doc:`/components/light/index` +- :doc:`template` +- :apiref:`m5stack_8angle/m5stack_8angle.h` +- :ghedit:`Edit` diff --git a/images/m5stack_8angle.png b/images/m5stack_8angle.png new file mode 100644 index 0000000000000000000000000000000000000000..1a37ed3cb9cdaa58458bcfa1c760cd51dc3c032d GIT binary patch literal 20010 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 FV1gwisR;l8 literal 0 HcmV?d00001 diff --git a/index.rst b/index.rst index 970ace46e..32419b9b6 100644 --- a/index.rst +++ b/index.rst @@ -535,6 +535,7 @@ Miscellaneous Havells Solar, components/sensor/havells_solar, havellsgti5000d_s.jpg, Solar rooftop Integration, components/sensor/integration, sigma.svg, dark-invert Kuntze pool sensor, components/sensor/kuntze, kuntze.jpg + M5Stack Unit 8 Angle, components/sensor/m5stack_8angle, m5stack_8angle.png MicroNova pellet stove, components/micronova, pellet.svg Modbus Sensor, components/sensor/modbus_controller, modbus.png Nextion, components/sensor/nextion, nextion.jpg, Sensors from display From cfca1bcb523148d4082dd7c4207eb83c3ed157ad Mon Sep 17 00:00:00 2001 From: leejoow Date: Mon, 22 Jul 2024 03:33:14 +0200 Subject: [PATCH 09/53] [modbus_controller] on command sent trigger (#4039) Co-authored-by: Leo Schelvis --- components/modbus_controller.rst | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/components/modbus_controller.rst b/components/modbus_controller.rst index 82601c6f9..6e32a6389 100644 --- a/components/modbus_controller.rst +++ b/components/modbus_controller.rst @@ -89,6 +89,9 @@ Configuration variables: - **lambda** (**Required**, :ref:`lambda `): Lambda that returns the value of this register. +Automations: + +- **on_command_sent** (*Optional*, :ref:`Automation `): An automation to perform when a modbus command has been sent. See :ref:`modbus_controller-on_command_sent` Example Client -------------- @@ -721,6 +724,28 @@ The response is mapped to the sensor based on ``register_count`` and offset in b .. _modbusseealso: +.. _modbus_controller-automations: + +Automation +---------- + +.. _modbus_controller-on_command_sent: + +``on_command_sent`` +******************* + +This automation will be triggered when a command has been sent by the `modbus_controller`. In :ref:`Lambdas ` +you can get the function code in ``function_code`` and the register address in ``address``. + +.. code-block:: yaml + + modbus_controller: + - id: modbus_con + # ... + on_command_sent: + then: + - number.increment: modbus_commands + See Also -------- From 0a28e6d58c04dc2acd6a3e0c226bfa95fb538652 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aodren=20Auffr=C3=A9dou-Heinicke?= <54121510+aodrenah@users.noreply.github.com> Date: Sun, 21 Jul 2024 22:29:58 -0700 Subject: [PATCH 10/53] APDS9306 Ambient Light Sensor Documentation (#3826) Co-authored-by: Keith Burzinski Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/images/apds9306.png | Bin 0 -> 15142 bytes components/sensor/apds9306.rst | 70 ++++++++++++++++++++++++++ components/sensor/images/apds9306.png | Bin 0 -> 41129 bytes images/apds9306.png | Bin 0 -> 15142 bytes index.rst | 1 + 5 files changed, 71 insertions(+) create mode 100644 components/images/apds9306.png create mode 100644 components/sensor/apds9306.rst create mode 100644 components/sensor/images/apds9306.png create mode 100644 images/apds9306.png diff --git a/components/images/apds9306.png b/components/images/apds9306.png new file mode 100644 index 0000000000000000000000000000000000000000..07fbc1d37afe00c0fb226c0f84822c2a2c585a1c GIT binary patch literal 15142 zcmV+>JK4mEP)@|Nr~?`T6kh@BjY)|Ns5{{r>Xu^52qR`1tty`}>}ae)RP8|Nr*w?Cjj1 zVcU~orJRy`X<49}Zp#+r_T;o;$xm5i#MkG!<4po?;nfN#RW!M?t|sh5SNnTxcoqnwe3qoSZuLOIIH z$(f9Op`DtUhjgu@m(I@3%fhmOaA1mgYKL-N{>%UW{`~6d>2+dM%*Mc*nU{=tWPxj0 zv9PbFn~tlhsIjJ&sFHZQv#4rUOV7&0tDA|AeQbDUSJTtey1Kf1Wl;b8@|KW{<=@tT za%PixU~*tmfOKn>i-C!Ja7#QgkdK3mbzZcyvv6Ha!Mn7Da$=2!e)jO{*PUTmNIQyv zc%PS#l!$tVfOEFCw*SfUV^c}5sGr!6UfkEvn}KAGfOE~nxx%@wjfQ!rrKH-AX~e#` z$ilp%h-Id2H3r#MF*+*U`+Qj(B@*W3H{NnSyPHZ&%Wzc%6rDfNE4* zOhd@NtN!=u?&sdr%e=9nk;1s9rj2oUU`szTEZ?AO)QW|LZe4?UaIBVnk%)iBy|Ub$ zcdnq7l#PdKT~)t~gyNBEa8yCehkTTMXuh(cR6sFjQ$m@Pk+7bOy|}XY?%&bKwf*_^ zuZ3&Kn0Mi)aGG~w!-IF-sC${0ir1TLVNE@ATt&L8nCzsZ#)(#eXHKDaX5X=d(Uf1a zoPLvRS*&+#x{q_km1?tjMzM>7cT-HIf@9B}ZQazv%8-Wt#^LF=i^8XekY7-8W?r^? zW|3`WyMs`JR6)^|eYb;lt%-T!po*etU*V8;jcRlFw70y8X8pX;fLc(_u9M{3&4y4d z!FWxcZ&7wdBlEhy zl~6Q>(~Nu?wl|ltDjKv=WgCp@7XAg)_Fq6rMS&j)$6_&pglXTg)7pYp%KG znrp7P=9+7+x#pT{uDSj*B8WiX$V87k@~78BqdD<}cEXMx@Qif$iIEOJF-q@*``>;w z=EO6s!=2)PM@$eB@!!RMVBb)sL*Ji*9;_r`n5J$gV##Afa6%kB%7-#w3P>kX2W7d&P=2 zvnCV7pZaRheL=4p# zKe%+I5n&jHqFBZuaS(>EwSnlSQXJn&KsyTJ8*WD=sS zcEz476g6oUGyQkO!9XBDfW5XZj?8aLEI7;n@tagv!IAF}Zd@6eV6p(Yp7pKBw+w(S zRd;NKv|JzthZ(+5qIeYpSj>CUbg`Hgk}C1Yj1x~*Bke(3wMazPAF?dVq#_B|WEO@N z?iDYvnp8!xCkR=M2+nw>0T|QXGgJlG2m+DOJRfRQt~eqaUeFa15hE#Wv6&VUkn5Qy zh69XU+DW8%8+cI#lW@h^D|U6gSxj=L778j!Vjvv3FLvXC&`^mPyH@wttwlOeD}_ux z9CiPv`SbQ!0*- z!9NMJlZF9hVH~$>j5h*sw4FMl1w2 zqG4I0Lma=fw7`#jiwPhuntB$FvP!_;Fk_n_R4MI&uG27UWGD}qqS_=TLDhz<)41gd z(0fCf^2yyiCHFDkWkok!5poTCBOnK7sXh}Jsg0enMcQfTy}3*#1O1ocY`{WZ5*TKu z7!_-BwDA0n6O+E3So+UVrstv9oI!tkRK9!1Q zbw?~Muwy98J~ND7R3@{yczeITn`gr(pqPiLZ@^-w+wG=lZdD^@gBX^=)9Q9K3uA>u zfS!UA%f-bTSGKc7I=mqFNpi9-kv7fbz60b|z08*0Tv&MX8`(g>$)=taxWW!bOn+@A z;PK3R#aN0jJirKl`T)a?fzvEP_vKd3P@>`o8>EPAZV`05TCb&hhS76Pb08Xgqgm18 zG#68Gv^GvZ@lGfb;dy>llYC+rD#u1Ko|frCfmvB#M?Nt|1hH|6$spp*dYyGeaWD|g zG?hzco6YTJA{0qNuBTsw^lb`|BYZ)}5I+HTFjEF#y1=t1o<76%0oa>E@NtP|5HUhd zJC4{Z$b0l8V(?h3J39L?7=KwOPP z6Iqet+NdadE<>(qW@)QdYqje6g;T?EU(-egRWi(hnOaqVilY7@xfsU{}2tL6Qj8#~_`EZ?+n5F$ns7Ui{~R(*+m zGYndQfzotFBJvpBUU_?Qaep`8Geyu~FwpgGJh@uYi0RHX5btbO>-USr)ntJUwJ{74 z`x6$ExeZRjiKT|ap*%EPU^D4j3y6IIvH&qR!TAAD1M=!>{JklkLxPBSvsw+UHqrvi zCv4m!24rQ#7%1;7+$Ue zfoTQyiJ>CjN+g6RPw~3qA7l)guUr6N4>?y%r&_?!NnwY1FjVIucGn9&?v zG>l{$Bc_uWDi;tRJ^K1Ss9OFGkYhQ98?XivAg-44RH0Ae6OpPuD5iz%)Xvuc{OIY&-ax?BdgoT6(MT{9%hETGDrsv@1FwlLoKRN>L7nyNb_?lF^1-r-f;~9s-$u^z^akUV2!qgF2o2 ztBq(OM={}3aD}!c_e5yE-yu%FOu-BAngg$Hi@gZA46AZ^Da@*vPfQS)2DwJp`J|}? zJ`#ND$;bZpg_q7E+;VxNo@hj4e1_pm1x_BqWMRs+%|8?0{w^V+W+aZr>PU2D@EDoA zTMPFr#EXP-EgAwH*Q9CuPA|yx>zDy+-f9*P%bAJy!qV8)cq@q|OqX5XrsbnG+ z$?(OdYn1XA&R_niv-$AP-8TuqLkDRsVb;cg7zxLqUKjW1FQzcpK_EW; z*mEzu_4DgjH+|ss4&*w-WFj=RbaVL^Yxgd9_QB)tzMiBShAyK|VkDAcnS3sXh&PsB zTrsQ(GMGH>c6(oNaqZ}I7HaVLjStVhT?JgYukSa&=*3Apc=T9DATW{S)4cI4c zgVnSu8MZ$Uy9y{Lc0Nd%Lr~eje^WwHl3BBn7!HUpTkt z4hABU>`hn?_gfj3*6=?SDSPkQ@wMZhUA%bh+PQF3kvw8J;r(Vd$uRMQsY`Vr_$ZkC z-1Gnc#@(}5Z*Q!hJh{Gn@~8XpL=F_b zef;soJJ)WWqZ~i(iuIe{e|nBjWfG^SZkq^rwd>N$KYPi`^#>oEJiorY_CXZtbt;n? z!fe%Z`p}9j+oW?oaeawm#;7cN%$W5DX3hjA&1{R~9d!!WJ%QScLxvJ?sMO*E6$7Om zv1t{b7}P@1Ar^O0%%f|fwuvc@PO5Eca3Px3ZpowZbukW|rCWk;nZ;S8Z<&2;V>Hb= zV>8JX6^V3bK}(5f)yJ#mxfVcJ>ei= zBG#p2)T{c-_wUcn&QAPErcm>jE{QskK}^2Jo=m-|Qh+M>aQ5n1vj0eV_kJ+@ z@yD~{jvfsknV{y;DC~uV`}%TkeYwT#Hw$F@_FdD8WEz|hctE2hb?T(LrQ=XtQhB{a zw-!4QYim?kHy+=Ro}QSPZWo+?arEPlKb~^$K4TCGv(--LV_Xi86J-mTL|!qMuTh5_ zm@KjsIQ%Z7zH`ggYkZZamKH4ijdHm(H$@;26z#1tuS;l$_*7EHps!sjQ_0ra2VeZx z=;({*$K5?IC;_Y>;v*(T;h3mX86p>EVkyJd7wQE*m)~vPQCzmYY@bSHJ7waMoF>|d z*6tTn?L9v@Xt8ff=tf)XChAIRd7e3wXc_(2=!;dp{+<^~HBx0VhzZ#f8_NT5^btd3 z@^uE~>)vvU%kB0X<(}htWqO&F$dILgjsCT6u&Qbh{}kvp?XE?kQ5^^1>z@bCL){mv zECu#-)o!cR0FA}XARaD$c!lY~OkC8IoLov?tgorQZW0K*j;=0$VzDQ$tW%>Z9g2gJ zOJcbuHf z^nVA^+dKDZkI7_8c0z!uus(Xk!1|-|X;y{1t$w0&jM8o$Km?$o96j4T5-ZK?Dlq>#E_tBKZPM6B4)~HyAD$7 z{J!(&r#>d$3Gg!E_S=mo8r#}h;B19Z$WOkOm$@eXVGu`Y7ni9+DwuqIf`~_E{FmCb zdZj8Mi%t$EB8JEb7+!ol_wN5jrzk$S|K=^CebbHbn@Rk}#x`fRLXop=&z9pv9E+>G zC`F$4_2rbi!I6=XV7eYRtkQ%>ZQ+lBXaOTX)yZy z?9b1yJJHzTe17M)zRK-snQK->D>0BmzTUcPTXWNX68XRVD{T_F!MZZRb}9}v2!OE} z%}h)&yumwTV`I00OyPDo94?pFVi6?Oq5Da|hck{pwsC3d!_hkS!=+OcN-y$tU(WN5 zcY}p3M#$We4TA1U*Deb@3u)WEum38(KYokV)p*4 z5SZotf;0}k>IQMapy0$IC-IgryvNfXn*)yG={+u$UJL3FDnmwQHtUqwldWpwI29Wo ze=zapt!V(;q*_5_1frpvc@ z9d1OxO~iI^k~3^^ zyo!SP@!e8|ddG(Jp3MXONKx?m^w{)t5V-dyCM-T<2W4k$N9^*Q=Y_ywmgXS7`z^)b zW8rXqH)s$q_Vv@v#zB|+&CNYeD4fH?Es44P{r#vj{I3Ry_Ei9Tz5DGgmr34|(DKdP zIInLwFoXR4(}Nri?{_6;yvO>Q>g&qB9CeZf$KK6r)y|G4T*>(TegHcHuLfR41SWhb zZDeQ4&RD*Aw0t)LcNN1MOT-aBRTlnx-yiSShK}%p4Dr0LH!{BFx1b%;Kd>&_c>q_- z`%?hy!e0RdN@#nBv*v-F7cO5$Uk-8yb_7@a*U0BHuhuO|%=SX&5q;42cWOX?RwnuDw=w>SYKiLoE>6y~fQf2ZlpU-B$ zCW2=g(i#j>174eNC_BjI%p>!{i0P=jkuANNCVR1p>v|_A@jsVqb}lNe=9h0|ftlAAe5FG8m=ygmSG~;2qvY}x!U~au!H%x zdm59u*^~sb2Ccdy*kwJk4&AG>Z0LqpY;5{olC97&B$ZV0T#XKIs%y2by1sk1P2BxH z57J`}gX~u!r^o02eSXJt@N{>!;v$N&{(hB_VHx%&?sWTq5(D^%LV=xat68R&o~mo@ z^vNt`$X~S*o)`BaexI0TFSxw_=%K^M{`|y=*H4_Np;N(Un=9gI!4HYOM~Db0)Zb6C z@JAFDB4fHl<&imjYzCEy)~Tepse#Yu5*Z|QeQg(B$^X8Zf(-L>^-_gMR4x!Jt$J(# zT5H=nS))Zwka=1UK6w27UZsE{qneyK@CKld9Xot@$6l=E?Akm(fBHEeQZE&X0;DD? zQ>mmXmCAGWLob&7@bJ)P886|I2Ch{swpzg|(tsJ?f^zc#+I8hmjHlkrQz%3Nfe^Sh zn;3t>AoX?nzz~@-?6In7j7{TiB zF(g>)4?zf4kJ$iBAy+Px3qh*UiTIixO^;kI6uP@np7QN0p#lJx7!=?YiviqglM5lM zLdJHYK*DCE5l{0?&i8%?p#n0PUw--J{df`F>~P-YNh5-~!FcHsUKWr>Go|whd$YNy_ftWXO0d=@qAgJammGIbRH{q9R zgj}Ij;^=I}#u6f|M8b=n!C(1)EEAhCwo6N2!wb0JrNFz7trrj1LB=+uV3wf%wz-q( zt5Zu|$Rv_FZxjz9T2}!~jYebYfmXs9*;B!wy+u(nhRxf;32 z-eJ<Uni=llfik5xs)~4%Ihz;!Y>C!eHR? z`5KHW2)5!AHkY8=w+F+i^wz_N4+F8-GBi550*mp#_2@(z<;TCpf07?B8PfEmkyc{S zy7{=!!k#jj=-)>yBZnEvu5>!En}(_Zn`=tHcM}_4&nSnSi51(UOmlNz1&k%Oas?s; zEO2#vzCBDhZ>P7m(nF*F{qW)FXxyJjB>csR;mKQJdpZ>aFjuK}GpF+$(bX!C$v z(#FUt1m^~;!YMlfXJ%#vNl^^B&9E62QObiP#skki?eG()bDQ~|K21aasE?@=ApP=z zN_@5VKp4Qm^i~?irZI|RQ*(23PN=Z3xESB@xm)&BI&2qJ>GVpgq3yXmRxAt1Z1iSl zrp1vuSg%E@;GY{zrS0~Wf%*A?8683y5*tpnb{eIy*yZB!q-^Q;NA{kU_~{A2173@Q z3}U==BAp1nrpP&h+1bE%fjNRY7og1k;zFpHyyAgd!E`z-67ezaO4PDaPJT`GO_qml z4lPcUWug|9nX5UM-b&33%wrQ}p4v=gt?gqS9-a%6bC>I6^o_i49_Q?=3m)=Tpym)) zb)u@O@YetScVKpCV`FM+45p4vO-*hLVfpvYTrstmGKYp|JJP{kWo4z?ptZEg&YaF? zT^hhHNeMa~i?4?DMsa{xA+)8oV)M&g?d|Pdu(=2I5Y${n9dlfE(xnA5PpZONK^_ig zTT{$3kNJ*palpc8J{DHsvs5E!s+GZwf24cfP8geW~GPEM*|?>MUS(N zlUi41N@slIg?wzzuJ0eNag=d|reH^dDV$1$J8s3|{=%$6iH*g7rCQtoF_a;WPfd2b z|2_fs7`;A6_ny|eXvWL{SL1@qver(<>vcq8+B`5=RbHX; zSY%PyY~cZ!*evy7%9hvpPJHsyQ--Nf6}ipoTovLt7VyJjDuTSczR>t?W8?Px>gveI zNE|K$+8>y_T}E$2@-b{pH@ly+N8nN)u3lCMunUSKc6yr-b)vk#?aJTGueJj?tD^P? z-`>E`F0U=|crd}K>tnnsUI|=AJj)KhdU~&^nh@h`x<|^b)boK`Rdr5e8Xp>tQ(`AU zjzq4GG#-5S;K7CM&CP{{%~fi$Grlo2h`BVTHEIWoL$F7Q$Gh(fX7_H$`zxhhEi9%E zSHfW-i21sz!L9kOII);Q;|1aeG@AQ8@VLxette|{j40v#1X<<7gQmZEZytk~XHY8j zVzCW>{`~u&BalNB8Ni8=_3h1f0elcPLklAjny~##lRxJ|LMy-gqrOhI8BaSG;sQck zzyUC_R<)I|iiKQAqv7gi29~=LAO>ks*5d!X+tme^x7v(og2~^jmNBhr6{b@>6t=U? zFBN2ob84wG#K+HSF>|rHQC-iUfBXISKcC(3$9Kkb1Vftg9(#cuV= z<)q)o|Jq+xcQf~_g(2;50odSf5exWS^s^wA6X2^|?H~qeHjcl&zqmN@En(hz^HRAE z#6qjJzmJW2$h8p?Fw?byTt&BHNgRLZ!ueYRkd+kq^P#&-&Ulu%u@M$$zu#?K$FO!f zDULrodj>(GPyiztit?{=+S zrERAU#6qsM+H!@d^QcuvFtVjGtQBwwP42|MfBXyAAD5`5T6{Ld?ba)mKfkw}oF0pZ z02~4_ET+5};?32F-x*IXB?7ZQm&p-(4S+gF z;{EvS)E6hOsW9uec#s~{s*gnXmLp@+Ns1g9SwP-;ig*FU{`mBmKQPo_lV1*|f)^Vu z+iWeq)0~`$Ih+gL5;F5c-eHVo=5kyv4rUs|04@rR743t&Ya{FHSFf&b&rssU>85sC zn^$^B(<#L4Ma{Gt@z0Vap%P0sY|fGRB^-1-_WGZmyjH>-_j%FyIB-3oZag;ZcP=gY z;~-w$Y=p=7&JvGAh{b+qU~>HDreNBRGoHOR+j-0HK1qpQIlFP1k{WaiIyGY>vsAd`$nV zpSjqY8WyV!{k7$y-tozZzu1{XFoy^+K(j)^UXS=g(_>D5A~xP&Punl!gpExuZjoGg zF$ZD*%gnXlm16S1VD7-Hb_+iGW^f?ma1$lY03Xb#aeLtY{f+j0O|ITqxjD9C?#?T?vb-99PFBO;w`d?*0oViL@eRRr==yp1GTCzF^| zB?A9>F&#Et7RvFZRDS%UH$ZVX&(sav!>kr4%>62rjHzL~*a=ZdtYYpr>G>O7MGy*c zd~DwnU$t{ZMA~RC8@B^O+bX3N;~yv%o~#SJ$rZ07DsMF_>*Oy;u?Lgw1O0$Je@ZC4RM( zCTpZFW2@P1vk3t$6fcg?f!GP;rQ|UF{0{5-$jIvIY9uk8EQH7Y;lOOrj((hv^;@e# z+xp_}*&4t&@gNZJ(My~A`iymTWM9%7^_U;Wa1#n~aeLO`Eb+*r>p;#z6J(fdgRmlG zP&1tl$;Ti6EO%mZMjKo0U;VLGpwvS)J(w%UW06oHg#49UUEe_kER;xKu*2fQ_~=lB z9n%kerCw~6SY+OtyAu;&wE)CiG3oDwTz+|(mtlN;x6yb27`cgraZ%SZz|g|_BM@hW zlzsmnZ6Fp>S=Bz(#~@}oz{x#X<4zTqfi}1hwjK0ePiBbGO(vJRGIOS^oYPAf)G&Ez z_SVnOLzQ~B!V~p6UfcaK1K6Svhy+~a`O2SPMjgkB_u$|E6Z7WQG6g1Six5XP7Y;t7 z#;1^*2=G7uVWka?fZQZUc~(e1hOYTId%I!e56<$;$UeklM6yu-^$^;O%v8dk{Er8T z1V~Yx@r_3?O&5cb(@U{CI7);`vQ?{&dVSF|oZSo4-&tzQ%S8fxC4et>beMuze;EA5 zn_KhC5dvI9zd}W8Bb$xSnvAaJdNz;=@V~v&Yobe!NFu@(z58R_-R4p&`YpH~* z$5_kcF8$YcB9Es}{xO(Jc!}i*-=!o0UYbrO(1Vaw5QD@5V8(Ii#a%7Fpiz#}AgWry^?{KMzi{((AzVV&mf^DQ8* zuFjqKReD?*2mW{hLsMRN33RLu_BUclYkbRN#Mxi>N@1^tJXVV>4QwC%{c~Oy9Wwn}#5k zrU-CDhuvQJ_S-Gw6KdKV*N+RH^qF5t6k;y&u1*ATKmSdP5>uZ6I6dvBa{B$rq#tk7 zbEDs3e`4lbnbARc*_snIFL8GBc)y{=s<67bI$S4$AJTdr4@yoaPv4 zZ5g_A)GUM=zv?Rnq_`gw)-=G;+;ScXyZg4i(xZLWiqtsoPAZUdq(|yKsJ& z;YCM~AMfqkC*ON@!pbC&sn!d{nF}Y&l9N#gL0Ler@9FSWGaW*}kQFQL2*{AqD_1zq zLZ^XHFkI(BUM9`qnn`!{V|TeoF=>|D!SWTlbualA!39DKBP@d*Z3ZlO|q zg?;UGwsW^D6*6NW3u+DlgBVtSXm3ez8Ae((HgQh~ngiH~K%{{fmrG(%SW~qEacCV> zlng#p3>C+S$>edUg9x<_xGLzCW@y))D{No|U;{jNUNy17W;xP6ME@S?Mj-nD#<}&R8(~0u=mmZTX$H7;}~wQa{`F@crv8s=|K$( z!HF}c{L&7MQfadhgrOy`msMEu@iR{xizZyFFwa|pI230_^_e1pAVa1In`%cfT^iKs z3YKQyzV$P-hxIco>+#b}fb-K%mbv1oE;|a_+_ek+-j;(mEnE5B|IXy&UfJbK5Zf&+ zcR(GAfl4?jhQvrZql-`pou6rd=~T+mD@%W?22{y+d5R9QAa z`&lMH2WUu%$5Y~|sfLk>;ej^e+d(Q6(RBd!zr;nIKui!sGU|t?^e`npHZ~AOAp7ng z$;o+*SK*u;cy$JmdDDLQ`0=)Ovs^D;ym<7;=T+O`m?ux(Z=SMy3Z*fsH3cec%Ah2& zSe%Y&E)1uIUld3mXznho2Qp(f@?3+Vtb}y)0DjuzBzqt%+ZxUv_y+>DT#b2tuWwRaoT4Aq8c!3$vD6B~tB z6Gx!u);~3C=ZrNoGDTRrHR{}`Eywc{yJ3>JOIXw5jsJ)>zAPsT!ZGHq)4&PuMZ2Z;(q6=1EAof<#pyMm{&|e=9%88tWti zm_psK0L&^wT_6k??UT!bVv54p{3$*QmSuudUQi?(}EslunwK!F` zd&U|NOLu6toZE8vc;>)q-MW6#rd9K>eAgdU`t%>NJLAxyZdpRdU8hbBEAUm*#TTDE z@j|Cw?P0A}Es{zxy{l9b)ZAo6OECmF2YSvz1s5k(;>2@175#Uez6sKZCUs7mOh86) z81oxDluCKWQ-WzD?1^Y8r=(DGRXOj$m>TAe%iT_}Y<$B_16V`wz$Ci*vgnnu2iB~a zxJH|qd2Y+7!#`$5VOpFgZV)c9P{BotoZUWm?1qF0{&urD>1SVY8SIxgU^T=j&B)JJ zW{3z05;Wl;0s2%pRe(+v{uACcDvVK~zV5%~hEV*dSCoZ4dGOUB{#ms{WHgE-2^$5| z##2PLl-P{MC%2*Ihumw%%`rfByWJpm=HygWmN^h%!9yZh>ey=%56sJn6Qj-@xAs|> zo|4K>iwnfz*E5kK?;o@wUYwVQ0N;Tqz2Golq1X%p(Yj*56qDU#&#<=yUnCmqkT?kL zH26nC!c(huC?|oq$saw4zY(KvtINhhF+>o!huUl!wbd$`E88b9_l%F1$(67nDa!Hi zU`~d;ve)f)xm<2{PEPqFtS?!bHw-sHaL14z$vY32My~CR|0U832x*6)u<40O!P_XC zKc-~Y7)(|+(wl${S~)N_MseuiLLOE14PZBedAzmBY4-Urz~e&Fe&zXp;i3Jv z*k=CwPrv??@1)YN#+ykBOero49z{vYHd`$3tt)oZ12&;8;9D%A9q+ydu2=QVzli5rmL?Q4&5SRIsLs&>3 zpIh+7I0wo^Cy*taZ-oF{cGf#v2ObIpqN`Z;Jd!qK{?Wg_`91U(|M?FAOXfzlgPP+o zd=S~OND>D#vf}gFADihtK@w|=de_Msb*B9wx*FI>6dSqX6R-xtWs0ufdfe@{+%|Xf z6^*DGI6=zha&j`Wk`wcrDUl==IS`lqTI)dEGcz3VVeL8yIn41Ml6fAp7x0Z*n}&hf ze7jiy^VgBUUjFxIUi}^x9 zBCX)aY=0=?FQ}@DoI$V|Y$EW=GRlDT&`>&UcBWk}E_x4oiEM_JG;MWPau4KYspKUk=A&FhZqr94$z*s|cLtleVN%*zgi? z2Y~Ajx~T2XVZfxKT0{6mRf_5|Fb}sqL2%DM3+UJHXcw zuvSx7c%O;M{Mz=x<`?5+7m^V3`D{)`WNZ`w1}=b6>R=!etZ6e`u)=7Du%2BU!sLj) z@TnT(2kY}m40#g1mrIY$twq5~I)^D|D~ej!=zrku8*e(+dbk121^kG4&v(AF`QVGM zHePY71rIOoyY^9uzG!iKdwVlKH zt43Y5yzu1lo5rsMGM*^~&^Rlh(?32FuN}2K+0*glK2K8dNMxe7xtYo)*SxyIw4{-> zDt=P{smogH5XEg4DW)(MbQXmsFK{kSDT-{9OfH}@Mg-3yM8zm7(dQ0bZun&597oGF zG@&#z)(4rx99l4JWXcaoRV`R8c)5H0j>EN3dH$AY4DP2Ve;gldxaqEE+AIa+5s%<< zZEt4txs1;{+~;0oz(%8*it5a*qvphRf`B1&Dum67Qx+>YJ%rOUx3aUWvuKVt^PUhd zh47yw5w?JaYIXXBy7MnCe{Fg>kTH~XohI`}#3zKZZ1n_#gsjF6V#cWxZ(U>^OeBE(5=Gj@P>YdvaUPPGf~q^p z(^(QWM66uQ=U^YWC@Z7nC{;M? zkqZ9R$n4q%%}CmrJy0)7f%l!`9^xW~j2>!7<|*vvFRrS@0%8?Kx{6a@^;ywejJL9f zw9DPgXl+IW4-^hkWDtHMaOK4MgNdyPhim9G8Ch`@A}^+Ro`5ri93)^HPLkMaWNl+> z4yg9NKFmnE-I&;C#a=mLUFOSa+_0X>+)Fag7LtruiG>|hbt(!!kAcFEp;u{c#NEn+ zPn{A&*y|dx&1M9yh}G~q2$prggtL}-Sr(?ugfb_zsTI?}8+m%MRNz}d))ZU(+jt+pB@}LI z{V-jF4dU`HkKS9NHKqX<&tVOCkG8V+9*l7uSn;&up-1PZt=74HYypp9uf87j8HP%% zx9@L(*%f%}w3)$Oe8Y4$(@&3*0a(QQ+0|^L25t+E5Xu?_+p2^LQ9(+3RU7gJDw7qc z^LhsmUPVhA@q89A~6Yq2*Gc&E<41m#dm%YOR56!j27SCyge0oKr5(D%Gk zjts8_d>}Rv^2lj3?4~EoVv2w@h1(eL`ELTSmQ3)KUvhyKmmsvQ%1F;A)XGUKk=fmc z9x}>qM;vBYFHZp2luo?qz!dt3I?bpfbkrIwA^d-q(tx_Bj0xwdo$a*KT+BgcB1Zl) zI|H}`9LXjLcBsWG22&U1lmr=;9B|IGMxFD4xtH z%B&H1?;l)lMqStSEw%kDZ7!(l+|pzQu^G=aUk|L6Id3j=NuaBJ>tHV|?IG(7GMkCm z8NiQIG%AdEvmJHWe{VkNxvS2zR|QmcLgq-6_Hkf#qcmxqUo>B?g3t~My}9VKdmoKD zC&+Nxkfp1F*VtUJ9ufyt0A&X=Q14*Ctd_14VncI*s{$}DjqRH&I@Y2eHtgXll6fa- z6Z7H>wdB1JSnr3c2v@%ms-ug)YuYB!(ICiF?e-S^SgNkjdq`qNLxbi`b8tOWmB9LL zCT23-DmHKR+JzE%yi_H!-qF+}E+7**-A}ywfX^}mx~`5|a-+*wmC8(6o2b#em0lQD zFSFLiU98`xC{3T2E#ziH#{~N^rZ4ZtG000002Kif0VrO*$0000000000AWsoj UEqo|8?EnA(07*qoM6N<$g70|~&;S4c literal 0 HcmV?d00001 diff --git a/components/sensor/apds9306.rst b/components/sensor/apds9306.rst new file mode 100644 index 000000000..a86bbbb12 --- /dev/null +++ b/components/sensor/apds9306.rst @@ -0,0 +1,70 @@ +APDS9306 Sensor +=============== + +.. seo:: + :description: Instructions for setting up APDS9306 sensors. + :image: apds9306.png + + +.. _apds9306-component: + +Component +--------- + +The ``apds9306`` sensor component allows you to use APDS9306 ambient light sensors (`datasheet `__, `Broadcom`_) with ESPHome. +The :ref:`I²C ` is required to be set up in your configuration for this sensor to work. + +.. figure:: images/apds9306.png + :align: center + :width: 80.0% + + Image by `Broadcom`_ + + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: apds9306 + name: "APDS9306 Light Level" # below are optional + gain: 1 + bit_width: 18 + measurement_rate: 100ms + update_interval: 60s + +.. _Broadcom: https://www.broadcom.com/products/optical-sensors/ambient-light-photo-sensors/apds-9306-065 + +Configuration variables: +------------------------ + +The ``apds9306`` sensor allows you to use your :doc:`apds9306` to perform ambient light measurements. + +- **address** (*Optional*, int): The I²C address of the sensor. Should be ``0x52`` according to datasheet ("Contact factory for other addressing options"). +- **gain** (*Optional*, int): The gain of the ambient light sensor. One of 1, 3, 6, 9, 18. Defaults to ``1``. +- **bit\_width** (*Optional*, int): The bit width/resolution of the ambient light sensor. One of: + + - 20 - takes 400ms + - 19 - takes 200ms + - 18 - takes 100ms (``default``) + - 17 - takes 50ms + - 16 - takes 25ms + - 13 - takes 3.125ms + +- **measurement\_rate** (*Optional*, int): The measurement rate of the ambient light sensor in milliseconds. One of: + + - 25 + - 50 + - 100 (``default``); + - 200 + - 500 + - 1000 + +- **update\_interval** (*Optional*, :ref:`config-time`): The interval at which the sensor reading will be updated. Defaults to ``60s``. +- All opther options from :ref:`Sensor `. + +See Also +-------- + +- :ref:`sensor-filters` +- :apiref:`apds9306/apds9306.h` +- :ghedit:`Edit` diff --git a/components/sensor/images/apds9306.png b/components/sensor/images/apds9306.png new file mode 100644 index 0000000000000000000000000000000000000000..521acbfc8b8dc02aa90a71979b0890bf1c8d2f3f GIT binary patch literal 41129 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 literal 0 HcmV?d00001 diff --git a/images/apds9306.png b/images/apds9306.png new file mode 100644 index 0000000000000000000000000000000000000000..07fbc1d37afe00c0fb226c0f84822c2a2c585a1c GIT binary patch literal 15142 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 UEqo|8?EnA(07*qoM6N<$g70|~&;S4c literal 0 HcmV?d00001 diff --git a/index.rst b/index.rst index 32419b9b6..2bd2a1caa 100644 --- a/index.rst +++ b/index.rst @@ -488,6 +488,7 @@ Light .. imgtable:: AM43, components/sensor/am43, am43.jpg, Lux + APDS9306, components/sensor/apds9306, apds9306.png, Lux APDS9960, components/sensor/apds9960, apds9960.jpg, Colour & Gesture AS7341, components/sensor/as7341, as7341.jpg, Spectral Color Sensor BH1750, components/sensor/bh1750, bh1750.jpg, Lux From 6e9a0181eb87fd66759cd5abc7d5b32dbcce0c91 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 23 Jul 2024 13:51:37 +1200 Subject: [PATCH 11/53] [http_request] Change default timeout to 4.5s (#4077) --- components/http_request.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/http_request.rst b/components/http_request.rst index c7dfe400c..18fa0fe83 100644 --- a/components/http_request.rst +++ b/components/http_request.rst @@ -22,7 +22,7 @@ Configuration variables: - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **follow_redirects** (*Optional*, boolean): Enable following HTTP redirects. Defaults to ``true``. - **redirect_limit** (*Optional*, integer): Maximum amount of redirects to follow when enabled. Defaults to ``3``. -- **timeout** (*Optional*, :ref:`config-time`): Timeout for request. Defaults to ``5s``. +- **timeout** (*Optional*, :ref:`config-time`): Timeout for request. Defaults to ``4.5s``. - **useragent** (*Optional*, string): User-Agent header for requests. Defaults to ``ESPHome/ (https://esphome.io)`` where ```` is the version of ESPHome the device is running. For example: ``ESPHome/2024.6.0 (https://esphome.io)`` From 3802a8133c583c69343a2af0655d8eda6a571bd3 Mon Sep 17 00:00:00 2001 From: dentra Date: Wed, 24 Jul 2024 06:51:01 +0300 Subject: [PATCH 12/53] [http_request] Allow configure buffer size on ESP-IDF (#4078) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/http_request.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/components/http_request.rst b/components/http_request.rst index 18fa0fe83..54e1dc803 100644 --- a/components/http_request.rst +++ b/components/http_request.rst @@ -36,6 +36,11 @@ Configuration variables: experiencing device reboots due to watchdog timeouts;** doing so may prevent the device from rebooting due to a legitimate problem. **Only available on ESP32 and RP2040**. +**For the ESP32 when using ESP-IDF:** + +- **buffer_size_rx** (*Optional*, integer): Change HTTP receive buffer size. Defaults to ``512``. +- **buffer_size_tx** (*Optional*, integer): Change HTTP transmit buffer size. Defaults to ``512``. + **For the ESP8266:** - **esp8266_disable_ssl_support** (*Optional*, boolean): Determines whether to include HTTPS/SSL support in the From ba23ee9c4e27ee4096e71594d8eec75b7c5dbb5b Mon Sep 17 00:00:00 2001 From: RubyBailey <60991881+RubyBailey@users.noreply.github.com> Date: Mon, 29 Jul 2024 16:20:26 -0700 Subject: [PATCH 13/53] Fix for Mitsubishi units that only support cooling (#4088) --- components/climate/climate_ir.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/components/climate/climate_ir.rst b/components/climate/climate_ir.rst index 8cf167f22..b5a8c3623 100644 --- a/components/climate/climate_ir.rst +++ b/components/climate/climate_ir.rst @@ -200,6 +200,10 @@ These air conditioners support two protocols: Midea and Coolix. Therefore, when ``mitsubishi`` **Climate**: +.. note:: + + - When using this component with Mitsubishi units that only support cooling mode, the Off command may not work. Set **supports_heat** to ``false`` to resolve that issue. + - **set_fan_mode** (*Optional*, string): Select the fan modes desired or that are supported on your remote. Defaults to ``3levels`` - Options are: ``3levels`` , ``4levels``, ``quiet_4levels``. From a658adf4093a8c6a5bf8ea7ece8d294070422f28 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 30 Jul 2024 16:50:22 +1200 Subject: [PATCH 14/53] [touchscreen] Add ``pages`` config item (#4072) --- components/touchscreen/index.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/components/touchscreen/index.rst b/components/touchscreen/index.rst index b1c2d0e6f..bf2c19af5 100644 --- a/components/touchscreen/index.rst +++ b/components/touchscreen/index.rst @@ -300,6 +300,9 @@ Configuration variables: - **y_min** (**Required**, int): Top coordinate of the screen area to be detected as the virtual button. - **y_max** (**Required**, int): Bottom coordinate of the screen area to be detected as the virtual button. - **page_id** (*Optional*, :ref:`config-id`): Only trigger this binary sensor if the display is showing this page. + Cannot be used with ``pages``. +- **pages** (*Optional*, list of :ref:`config-id`): Only trigger this binary sensor if the display is showing one of these pages. + Cannot be used with ``page_id``. - All other options from :ref:`Binary Sensor `. From 08a5bb66701c96e2b2cda2097e7369ef087938f2 Mon Sep 17 00:00:00 2001 From: Keith Burzinski Date: Tue, 30 Jul 2024 01:06:13 -0500 Subject: [PATCH 15/53] Add deprecation notice for ESP32 Hall sensor (#3883) --- components/sensor/esp32_hall.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/components/sensor/esp32_hall.rst b/components/sensor/esp32_hall.rst index 436b8610a..12592170f 100644 --- a/components/sensor/esp32_hall.rst +++ b/components/sensor/esp32_hall.rst @@ -11,6 +11,12 @@ The ``esp32_hall`` sensor platform allows you to use the integrated ESP32 chip to measure the magnitude and direction of magnetic field around the chip (with quite poor accuracy). +.. warning:: + + Espressif has `removed support `__ + for the ESP32's Hall sensor in IDF 5; for this reason, support for this component is + likely to be removed in a future release. + Please make sure that nothing is connected to pins ``GPIO36`` and ``GPIO39`` if this component is enabled, as those pins are used for the internal low-noise amplifier used by the hall sensor. From 838ade7afaafd7d4d22b16b0d227f25baa72ce35 Mon Sep 17 00:00:00 2001 From: Kevin Ahrendt Date: Tue, 30 Jul 2024 22:15:41 -0400 Subject: [PATCH 16/53] [micro_wake_word] Update documentation to discuss how voice activity is detected (#4097) --- components/micro_wake_word.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/micro_wake_word.rst b/components/micro_wake_word.rst index 3f69ffd33..be541b796 100644 --- a/components/micro_wake_word.rst +++ b/components/micro_wake_word.rst @@ -55,7 +55,7 @@ Configuration variables: - **probability_cutoff** (*Optional*, percentage): The probability cutoff for voice activity detection. If the probability is below this value, then no wake word will be accepted. A larger value reduces the number of false accepts but increases the number of false rejections. - - **sliding_window_size** (*Optional*, int): The size of the sliding window for voice activity detection. The maximum of the probabilities in the sliding window is compared to ``probability_cutoff`` to determine if voice activity is detected. + - **sliding_window_size** (*Optional*, int): The size of the sliding window average for voice activity detection. The average probability is compared to ``probability_cutoff`` to determine if voice activity is detected. The ``probability_cutoff`` and ``sliding_window_size`` are provided by the JSON file but can be overridden in YAML. A default VAD model is provided with the ``vad`` configuration variables, but a different model can be overridden in YAML. From 67e2b0b31b90551cc03cbf03119108fc325b7bbb Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 31 Jul 2024 16:16:30 +1200 Subject: [PATCH 17/53] [update] Add automation documentation (#4098) * [update] Add automation documentation * Fix underline * Fix --- components/update/index.rst | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/components/update/index.rst b/components/update/index.rst index d4ac6a4c0..5e8b1f8f6 100644 --- a/components/update/index.rst +++ b/components/update/index.rst @@ -33,6 +33,31 @@ Configuration variables: - **internal** (*Optional*, boolean): Mark this component as internal. Internal components will not be exposed to the frontend (like Home Assistant). Specifying an ``id`` without a ``name`` will implicitly set this to true. +- **on_update_available** (*Optional*, :ref:`Action `): An automation to perform when an update is available. + +Automations +----------- + +``update.perform`` Action +~~~~~~~~~~~~~~~~~~~~~~~~~ + +This action allows you to trigger the update entity to start the update process. + +Configuration variables: + +- **id** (**Required**, :ref:`config-id`): The ID of the update entity. +- **force_update** (*Optional*, boolean): Perform the update even if the device is already running the same version. + Defaults to ``false``. + +``update.is_available`` Condition +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This condition checks if an update is available for the device. + +Configuration variables: + +- **id** (**Required**, :ref:`config-id`): The ID of the update entity. + See Also -------- From aa041a93fae0ceb925cd69474c2c563b8a070ae3 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Thu, 1 Aug 2024 22:38:39 +1200 Subject: [PATCH 18/53] [api] Update ``service`` -> ``action`` (#4104) --- changelog/v1.12.0.rst | 2 +- components/api.rst | 69 ++++++++++++++--------------- components/ble_client.rst | 6 +-- components/dfplayer.rst | 38 ++++++++-------- components/display/nextion.rst | 10 ++--- components/fingerprint_grow.rst | 14 +++--- components/rf_bridge.rst | 8 ++-- components/rtttl.rst | 4 +- components/sensor/ld2410.rst | 8 ++-- components/sensor/mhz19.rst | 6 +-- components/sensor/pulse_counter.rst | 6 +-- components/sensor/pulse_meter.rst | 4 +- components/sensor/scd4x.rst | 10 ++--- components/sim800l.rst | 16 +++---- components/sprinkler.rst | 16 +++---- components/tm1651.rst | 6 +-- cookbook/infostrip.rst | 6 +-- cookbook/power_meter.rst | 6 +-- custom/custom_component.rst | 4 +- guides/configuration-types.rst | 6 +-- guides/index.rst | 1 + 21 files changed, 123 insertions(+), 123 deletions(-) diff --git a/changelog/v1.12.0.rst b/changelog/v1.12.0.rst index 67a2059de..5ebdc124a 100644 --- a/changelog/v1.12.0.rst +++ b/changelog/v1.12.0.rst @@ -23,7 +23,7 @@ It's release day! 🎉 Today I'm happy to release ESPHome 1.12.0. What's new? A stuff got added! Let me walk you through it: Before 1.12, it was only possible to transfer data from ESPHome to Home Assistant (with the -``homeassistant.service`` call). With 1.12 you get :ref:`User-defined services `, +``homeassistant.service`` call). With 1.12 you get :ref:`User-defined services `, just define a service in your ESPHome file and call it like any other service from HA. All the rest (like variables, data validation, etc) are handled automatically! diff --git a/components/api.rst b/components/api.rst index 96d819ee6..398c46b14 100644 --- a/components/api.rst +++ b/components/api.rst @@ -60,7 +60,7 @@ Configuration variables: document.getElementById("api-key").value = bytesArrToBase64(array); -- **services** (*Optional*, list): A list of user-defined services. See :ref:`api-services`. +- **actions** (*Optional*, list): A list of user-defined actions. See :ref:`api-device-actions`. - **reboot_timeout** (*Optional*, :ref:`config-time`): The amount of time to wait before rebooting when no client connects to the API. This is needed because sometimes the low level ESP functions report that the ESP is connected to the network, when in fact it is not - only a full reboot fixes it. @@ -79,7 +79,7 @@ Actions ------- Before using any of the actions below, you'll need to tell Home Assistant to allow your device to -make service calls. +perform actions. Open the ESPHome integration page on your Home Assistant instance: @@ -91,7 +91,7 @@ Then: #. Find your device in the device list #. Click the "configure" button next to it -#. Check the "Allow the device to make Home Assistant service calls" box +#. Check the "Allow the device to perform Home Assistant actions" box #. Then click "submit". .. _api-homeassistant_event_action: @@ -102,7 +102,7 @@ Then: .. note:: Be sure to :ref:`follow the instructions above ` to tell Home Assistant to allow - your device to make service calls. + your device to perform actions. When using the native API with Home Assistant, you can create events in the Home Assistant event bus straight from ESPHome :ref:`Automations `. @@ -127,31 +127,30 @@ Configuration variables: - **variables** (*Optional*, mapping): Optional variables that can be used in the ``data_template``. Values are :ref:`lambdas ` and will be evaluated before sending the request. -.. _api-homeassistant_service_action: +.. _api-homeassistant_action-action: -``homeassistant.service`` Action +``homeassistant.action`` Action ******************************** .. note:: Be sure to :ref:`follow the instructions above ` to tell Home Assistant to allow - your device to make service calls. + your device to perform actions. -When using the native API with Home Assistant, you can create Home Assistant service -calls straight from ESPHome :ref:`Automations `. +When using the native API with Home Assistant, you can perform Home Assistant actions straight from ESPHome :ref:`Automations `. .. code-block:: yaml # In some trigger on_...: # Simple - - homeassistant.service: - service: notify.html5 + - homeassistant.action: + action: notify.html5 data: message: Button was pressed # With templates and variables - - homeassistant.service: - service: notify.html5 + - homeassistant.action: + action: notify.html5 data: title: New Humidity data_template: @@ -163,10 +162,10 @@ calls straight from ESPHome :ref:`Automations `. Configuration variables: ```````````````````````` -- **service** (**Required**, string): The Home Assistant `Service `__ - to call. -- **data** (*Optional*, mapping): Optional *static* data to pass along with the service call. -- **data_template** (*Optional*, mapping): Optional template data to pass along with the service call. +- **action** (**Required**, string): The Home Assistant `Action `__ + to perform. +- **data** (*Optional*, mapping): Optional *static* data to perform the action with. +- **data_template** (*Optional*, mapping): Optional template data to perform the action with. This is evaluated on the Home Assistant side with Home Assistant's templating engine. - **variables** (*Optional*, mapping): Optional variables that can be used in the ``data_template``. Values are :ref:`lambdas ` and will be evaluated before sending the request. @@ -182,7 +181,7 @@ the parameters in plain format. set_light_rgb: alias: 'ESPHome RGB light set' sequence: - - service: light.turn_on + - action: light.turn_on data_template: entity_id: '{{ light_name }}' rgb_color: @@ -196,8 +195,8 @@ Then, in ESPHome: # In some trigger on_...: - - homeassistant.service: - service: script.set_light_rgb + - homeassistant.action: + action: script.set_light_rgb data: light_name: 'my_light' red: '255' @@ -212,7 +211,7 @@ Then, in ESPHome: .. note:: Be sure to :ref:`follow the instructions above ` to tell Home Assistant to allow - your device to make service calls. + your device to make action calls. When using the native API with Home Assistant, you can push tag_scanned to Home Assistant straight from ESPHome :ref:`Automations `. @@ -289,27 +288,27 @@ if logs are shown remotely. then: - logger.log: API is connected! -.. _api-services: +.. _api-device-actions: -User-defined Services ---------------------- +User-defined Actions +-------------------- -It is also possible to get data from Home Assistant to ESPHome with user-defined services. -When you declare services in your ESPHome YAML file, they will automatically show up in +It is also possible to get data from Home Assistant to ESPHome with user-defined actions. +When you declare actions in your ESPHome YAML file, they will automatically show up in Home Assistant and you can call them directly. .. code-block:: yaml # Example configuration entry api: - services: - - service: start_laundry + actions: + - action: start_laundry then: - switch.turn_on: relay - delay: 3h - switch.turn_off: relay -For example with the configuration seen above, after uploading you will see a service +For example with the configuration seen above, after uploading you will see an action called ``esphome.livingroom_start_laundry`` (livingroom is the node name) which you can then call. @@ -319,8 +318,8 @@ Additionally, you can also transmit data from Home Assistant to ESPHome with thi # Example configuration entry api: - services: - - service: start_effect + actions: + - action: start_effect variables: my_brightness: int my_effect: string @@ -331,18 +330,18 @@ Additionally, you can also transmit data from Home Assistant to ESPHome with thi effect: !lambda 'return my_effect;' Using the ``variables`` key you can tell ESPHome which variables to expect from Home Assistant. -For example the service seen above would be executed with something like this: +For example the action seen above would be executed with something like this: .. code-block:: yaml - # Example Home Assistant Service Call - service: esphome.livingroom_start_effect + # Example Home Assistant Action + action: esphome.livingroom_start_effect data_template: my_brightness: "{{ states.brightness.state }}" my_effect: "Rainbow" Then each variable you define in the ``variables`` section is accessible in the automation -triggered by the user-defined service through the name you gave it in the variables section +triggered by the user-defined action through the name you gave it in the variables section (note: this is a local variable, so do not wrap it in ``id(...)`` to access it). There are currently 4 types of variables: diff --git a/components/ble_client.rst b/components/ble_client.rst index 4198f3b54..06f08c193 100644 --- a/components/ble_client.rst +++ b/components/ble_client.rst @@ -459,8 +459,8 @@ Secure connection with a dynamically generated passkey: .. code-block:: yaml api: - services: - - service: passkey_reply + actions: + - action: passkey_reply variables: passkey: int then: @@ -468,7 +468,7 @@ Secure connection with a dynamically generated passkey: - ble_client.passkey_reply: id: my_ble_client passkey: !lambda return passkey; - - service: numeric_comparison_reply + - action: numeric_comparison_reply variables: accept: bool then: diff --git a/components/dfplayer.rst b/components/dfplayer.rst index 672cc4615..512559c1e 100644 --- a/components/dfplayer.rst +++ b/components/dfplayer.rst @@ -345,19 +345,19 @@ Sample code logger.log: 'Playback finished event' api: - services: - - service: dfplayer_next + actions: + - action: dfplayer_next then: - dfplayer.play_next: - - service: dfplayer_previous + - action: dfplayer_previous then: - dfplayer.play_previous: - - service: dfplayer_play + - action: dfplayer_play variables: file: int then: - dfplayer.play: !lambda 'return file;' - - service: dfplayer_play_loop + - action: dfplayer_play_loop variables: file: int loop_: bool @@ -365,7 +365,7 @@ Sample code - dfplayer.play: file: !lambda 'return file;' loop: !lambda 'return loop_;' - - service: dfplayer_play_folder + - action: dfplayer_play_folder variables: folder: int file: int @@ -374,7 +374,7 @@ Sample code folder: !lambda 'return folder;' file: !lambda 'return file;' - - service: dfplayer_play_loop_folder + - action: dfplayer_play_loop_folder variables: folder: int then: @@ -382,54 +382,54 @@ Sample code folder: !lambda 'return folder;' loop: true - - service: dfplayer_set_device_tf + - action: dfplayer_set_device_tf then: - dfplayer.set_device: TF_CARD - - service: dfplayer_set_device_usb + - action: dfplayer_set_device_usb then: - dfplayer.set_device: USB - - service: dfplayer_set_volume + - action: dfplayer_set_volume variables: volume: int then: - dfplayer.set_volume: !lambda 'return volume;' - - service: dfplayer_set_eq + - action: dfplayer_set_eq variables: preset: int then: - dfplayer.set_eq: !lambda 'return static_cast(preset);' - - service: dfplayer_sleep + - action: dfplayer_sleep then: - dfplayer.sleep - - service: dfplayer_reset + - action: dfplayer_reset then: - dfplayer.reset - - service: dfplayer_start + - action: dfplayer_start then: - dfplayer.start - - service: dfplayer_pause + - action: dfplayer_pause then: - dfplayer.pause - - service: dfplayer_stop + - action: dfplayer_stop then: - dfplayer.stop - - service: dfplayer_random + - action: dfplayer_random then: - dfplayer.random - - service: dfplayer_volume_up + - action: dfplayer_volume_up then: - dfplayer.volume_up - - service: dfplayer_volume_down + - action: dfplayer_volume_down then: - dfplayer.volume_down diff --git a/components/display/nextion.rst b/components/display/nextion.rst index 09d8a85f9..d551f6c9f 100644 --- a/components/display/nextion.rst +++ b/components/display/nextion.rst @@ -115,8 +115,8 @@ The developer tools in Home Assistant can be used to trigger the update. The bel .. code-block:: yaml api: - services: - - service: update_nextion + actions: + - action: update_nextion then: - lambda: 'id(nextion1)->upload_tft();' @@ -151,8 +151,8 @@ The developer tools in Home Assistant can be used to trigger the update. The bel # Enable Home Assistant API api: - services: - - service: set_nextion_sensor + actions: + - action: set_nextion_sensor variables: nextion_type: int name: string @@ -160,7 +160,7 @@ The developer tools in Home Assistant can be used to trigger the update. The bel then: - lambda: |- id(nextion1).set_nextion_sensor_state(nextion_type,name,state); - - service: set_nextion_text + - action: set_nextion_text variables: name: string state: string diff --git a/components/fingerprint_grow.rst b/components/fingerprint_grow.rst index cdba66074..453a6dd51 100644 --- a/components/fingerprint_grow.rst +++ b/components/fingerprint_grow.rst @@ -475,8 +475,8 @@ All actions Test setup ---------- -With the following code you can quickly setup a node and use Home Assistant's service in the developer tools. -E.g. for calling ``fingerprint_grow.enroll`` select the service ``esphome.test_node_enroll`` and in service data enter +With the following code you can quickly setup a node and use Home Assistant's action in the developer tools. +E.g. for calling ``fingerprint_grow.enroll`` select the action ``esphome.test_node_enroll`` and in action data enter .. code-block:: json @@ -527,8 +527,8 @@ Sample code finger_id: !lambda 'return finger_id;' api: - services: - - service: enroll + actions: + - action: enroll variables: finger_id: int num_scans: int @@ -536,16 +536,16 @@ Sample code - fingerprint_grow.enroll: finger_id: !lambda 'return finger_id;' num_scans: !lambda 'return num_scans;' - - service: cancel_enroll + - action: cancel_enroll then: - fingerprint_grow.cancel_enroll: - - service: delete + - action: delete variables: finger_id: int then: - fingerprint_grow.delete: finger_id: !lambda 'return finger_id;' - - service: delete_all + - action: delete_all then: - fingerprint_grow.delete_all: diff --git a/components/rf_bridge.rst b/components/rf_bridge.rst index 0ab8e3b73..6aa4bc6e1 100644 --- a/components/rf_bridge.rst +++ b/components/rf_bridge.rst @@ -345,8 +345,8 @@ Home Assistant as events and will also setup a service so you can send codes wit .. code-block:: yaml api: - services: - - service: send_rf_code + actions: + - action: send_rf_code variables: sync: int low: int @@ -358,7 +358,7 @@ Home Assistant as events and will also setup a service so you can send codes wit low: !lambda 'return low;' high: !lambda 'return high;' code: !lambda 'return code;' - - service: learn + - action: learn then: - rf_bridge.learn @@ -391,7 +391,7 @@ To trigger the automation from Home Assistant you can invoke the service with th automation: # ... action: - - service: esphome.rf_bridge_send_rf_code + - action: esphome.rf_bridge_send_rf_code data: sync: 0x700 low: 0x800 diff --git a/components/rtttl.rst b/components/rtttl.rst index b502a649e..dd0872e17 100644 --- a/components/rtttl.rst +++ b/components/rtttl.rst @@ -174,8 +174,8 @@ Sample code - logger.log: 'Song ended!' api: - services: - - service: play_rtttl + actions: + - action: play_rtttl variables: song_str: string then: diff --git a/components/sensor/ld2410.rst b/components/sensor/ld2410.rst index acc4b4823..1f897b69e 100644 --- a/components/sensor/ld2410.rst +++ b/components/sensor/ld2410.rst @@ -156,7 +156,7 @@ Configuration variables: - **detection_distance** (*Optional*, int): Distance in cm of target. All options from :ref:`Sensor `. - **gX** (*Optional*): Energies for the Xth gate (X => 0 to 8). - + - **move_energy** (*Optional*, int): When in :ref:`engineering mode`, the move energy of the gate, otherwise ``unknown``. Value between ``0`` and ``100`` inclusive. All options from :ref:`Sensor `. @@ -276,7 +276,7 @@ Configuration variables: Value between ``2`` and ``8`` inclusive. Defaults to ``8``. All options from :ref:`Number `. - **gX** (*Optional*): Thresholds for the Xth gate (X => 0 to 8). - + - **move_threshold** (**Required**, int): Threshold for the gate for motion detection. Above this level for the considered gate (distance), movement detection will be triggered. Value between ``0`` and ``100`` inclusive. See default values below. @@ -435,8 +435,8 @@ To change the password from HA you can use the following example config: id: my_ld2410 api: - services: - - service: set_ld2410_bluetooth_password + actions: + - action: set_ld2410_bluetooth_password variables: password: string then: diff --git a/components/sensor/mhz19.rst b/components/sensor/mhz19.rst index 0d3c8f313..a62065672 100644 --- a/components/sensor/mhz19.rst +++ b/components/sensor/mhz19.rst @@ -82,13 +82,13 @@ for over 20 minutes and you execute this function. then: - mhz19.calibrate_zero: my_mhz19_id -You can provide :ref:`service ` to call it from Home Assistant +You can provide an :ref:`action ` to perform from Home Assistant .. code-block:: yaml api: - services: - - service: mhz19_calibrate_zero + actions: + - action: mhz19_calibrate_zero then: - mhz19.calibrate_zero: my_mhz19_id diff --git a/components/sensor/pulse_counter.rst b/components/sensor/pulse_counter.rst index 9486bd4de..8eecc593b 100644 --- a/components/sensor/pulse_counter.rst +++ b/components/sensor/pulse_counter.rst @@ -111,10 +111,10 @@ trying to match. .. code-block:: yaml - # Set pulse counter total from home assistant using this service call: + # Set pulse counter total from home assistant using this action: api: - services: - - service: set_pulse_total + actions: + - action: set_pulse_total variables: new_pulse_total: int then: diff --git a/components/sensor/pulse_meter.rst b/components/sensor/pulse_meter.rst index 785f299c5..4c060a453 100644 --- a/components/sensor/pulse_meter.rst +++ b/components/sensor/pulse_meter.rst @@ -91,8 +91,8 @@ trying to match. .. code-block:: yaml api: - services: - - service: set_total + actions: + - action: set_total variables: new_total: int then: diff --git a/components/sensor/scd4x.rst b/components/sensor/scd4x.rst index f2d32ecaf..a43eab724 100644 --- a/components/sensor/scd4x.rst +++ b/components/sensor/scd4x.rst @@ -105,13 +105,13 @@ As of April 2022 the average fresh air Co² concentration is 419 ppm. value: 419 # outside average April 2022 id: my_scd41 -value can also be a template, for example to define a Home Assistant calibration service: +value can also be a template, for example to define a Home Assistant calibration action: .. code-block:: yaml api: - services: - - service: calibrate_co2_value + actions: + - action: calibrate_co2_value variables: co2_ppm: int then: @@ -166,8 +166,8 @@ This example creates a service `set_ambient_pressure` that can be called from Ho .. code-block:: yaml api: - services: - - service: set_ambient_pressure + actions: + - action: set_ambient_pressure variables: pressure_mbar: int then: diff --git a/components/sim800l.rst b/components/sim800l.rst index 1f993dc37..273bea533 100644 --- a/components/sim800l.rst +++ b/components/sim800l.rst @@ -249,8 +249,8 @@ on Home Assistant and will also setup a service so you can send messages and dia .. code-block:: yaml api: - services: - - service: send_sms + actions: + - action: send_sms variables: recipient: string message: string @@ -258,19 +258,19 @@ on Home Assistant and will also setup a service so you can send messages and dia - sim800l.send_sms: recipient: !lambda 'return recipient;' message: !lambda 'return message;' - - service: dial + - action: dial variables: recipient: string then: - sim800l.dial: recipient: !lambda 'return recipient;' - - service: connect + - action: connect then: - sim800l.connect - - service: disconnect + - action: disconnect then: - sim800l.disconnect - - service: send_ussd + - action: send_ussd variables: ussdCode: string then: @@ -324,11 +324,11 @@ To trigger the automation from Home Assistant you can invoke the service with th automation: # ... action: - - service: esphome.livingroom_send_sms + - action: esphome.livingroom_send_sms data: recipient: "+15551234567" message: "Hello World!" - - service: esphome.livingroom_dial + - action: esphome.livingroom_dial data: recipient: "+15551234567" diff --git a/components/sprinkler.rst b/components/sprinkler.rst index 0221411f9..7e9d1706d 100644 --- a/components/sprinkler.rst +++ b/components/sprinkler.rst @@ -1087,38 +1087,38 @@ memory use. Expose Sprinkler Controller Actions via user-API ************************************************ -This configuration snippet illustrates how user-defined ESPHome API services may be used to expose +This configuration snippet illustrates how user-defined ESPHome API actions may be used to expose various sprinkler controller actions to the front end. This could be useful to change settings and/or trigger sprinkler controller actions using automations. .. code-block:: yaml api: - services: - - service: set_multiplier + actions: + - action: set_multiplier variables: multiplier: float then: - sprinkler.set_multiplier: id: lawn_sprinkler_ctrlr multiplier: !lambda 'return multiplier;' - - service: start_full_cycle + - action: start_full_cycle then: - sprinkler.start_full_cycle: lawn_sprinkler_ctrlr - - service: start_single_valve + - action: start_single_valve variables: valve: int then: - sprinkler.start_single_valve: id: lawn_sprinkler_ctrlr valve_number: !lambda 'return valve;' - - service: next_valve + - action: next_valve then: - sprinkler.next_valve: lawn_sprinkler_ctrlr - - service: previous_valve + - action: previous_valve then: - sprinkler.previous_valve: lawn_sprinkler_ctrlr - - service: shutdown + - action: shutdown then: - sprinkler.shutdown: lawn_sprinkler_ctrlr diff --git a/components/tm1651.rst b/components/tm1651.rst index 51dc85144..c439e348e 100644 --- a/components/tm1651.rst +++ b/components/tm1651.rst @@ -133,14 +133,14 @@ You also can control this component with lambda expressions .. code-block:: yaml api: - services: - - service: battery_level + actions: + - action: battery_level variables: level: int then: - lambda: |- id(tm1651_battery).set_level(level); - - service: battery_brightness + - action: battery_brightness variables: brightness: int then: diff --git a/cookbook/infostrip.rst b/cookbook/infostrip.rst index e20060aa8..c0bf5e80c 100644 --- a/cookbook/infostrip.rst +++ b/cookbook/infostrip.rst @@ -111,7 +111,7 @@ The automation to show the CO2 warning light (e.g. red if CO2 > 1000 ppm) is don above: 1000 condition: [] action: - - service: light.turn_on + - action: light.turn_on data: color_name: red entity_id: light.pl2 @@ -125,7 +125,7 @@ The automation to show the CO2 warning light (e.g. red if CO2 > 1000 ppm) is don below: 800 condition: [] action: - - service: light.turn_off + - action: light.turn_off entity_id: light.pl2 mode: single - alias: "State Light Mapping" @@ -134,7 +134,7 @@ The automation to show the CO2 warning light (e.g. red if CO2 > 1000 ppm) is don # You can also match on interval. This will match every 5 minutes minutes: "/5" action: - - service: light.turn_on + - action: light.turn_on data_template: entity_id: light.pl1 brightness_pct: 30 diff --git a/cookbook/power_meter.rst b/cookbook/power_meter.rst index 0411666e2..9e9205d47 100644 --- a/cookbook/power_meter.rst +++ b/cookbook/power_meter.rst @@ -108,8 +108,8 @@ Using this action, you are able to reset/set the total pulse count. This can be .. code-block:: yaml api: - services: - - service: set_total + actions: + - action: set_total variables: new_total: int then: @@ -137,7 +137,7 @@ Additionally you can also calculate the total daily energy generated, for which filters: # Multiplication factor from W to kW is 0.001 - multiply: 0.001 - + time: - platform: homeassistant id: homeassistant_time diff --git a/custom/custom_component.rst b/custom/custom_component.rst index 72e23baf9..a87dcb104 100644 --- a/custom/custom_component.rst +++ b/custom/custom_component.rst @@ -86,8 +86,8 @@ Native API Custom Component --------------------------- If you want to communicate directly with Home Assistant via the :doc:`native API ` -you can use the :apiclass:`api::CustomAPIDevice` class to declare services that can be executed from -Home Assistant, as well as starting services in Home Assistant. +you can use the :apiclass:`api::CustomAPIDevice` class to declare actions that can be performed from +Home Assistant, as well as performing actions in Home Assistant. .. code-block:: cpp diff --git a/guides/configuration-types.rst b/guides/configuration-types.rst index c50fef15d..4b39a4b3e 100644 --- a/guides/configuration-types.rst +++ b/guides/configuration-types.rst @@ -358,7 +358,7 @@ Consider the following example where the author put common pieces of configurati I²C into base files and extends it with some device specific configurations in the main config. Note how the piece of configuration describing ``api`` component in ``device_base.yaml`` gets -merged with the services definitions from main config file. +merged with the actions definitions from main config file. .. code-block:: yaml @@ -372,8 +372,8 @@ merged with the services definitions from main config file. device_base: !include common/device_base.yaml api: - services: - - service: start_laundry + actions: + - action: start_laundry then: - switch.turn_on: relay - delay: 3h diff --git a/guides/index.rst b/guides/index.rst index 1dd6ba9d7..e51c0fd51 100644 --- a/guides/index.rst +++ b/guides/index.rst @@ -3,5 +3,6 @@ Guides .. toctree:: :glob: + :maxdepth: 1 * From 9d1692a663d27c1722151b96c769124b8cd4788c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B6rn=20Ebbinghaus?= Date: Fri, 2 Aug 2024 01:59:08 +0200 Subject: [PATCH 19/53] Add docs for `round_to_multiple_of` filter (#4085) --- components/sensor/index.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/components/sensor/index.rst b/components/sensor/index.rst index 4d5ca3b60..177b95285 100644 --- a/components/sensor/index.rst +++ b/components/sensor/index.rst @@ -296,6 +296,27 @@ Rounds the value to the given decimal places. - round: 1 # will round to 1 decimal place + +``round_to_multiple_of`` +************************ + +Rounds the value to the nearest multiple. Takes a float greater than zero. + +.. code-block:: yaml + + - platform: ... + filters: + - round_to_multiple_of: 10 + # 123 -> 120 + # 126 -> 130 + + - platform: ... + filters: + - round_to_multiple_of: 0.25 + # 3.1415 -> 3.25 + # 1.6180 -> 1.5 + + ``quantile`` ************ From c049dfef3765eb7de0029b8c8fc3b772c5e09316 Mon Sep 17 00:00:00 2001 From: Nate Clark Date: Mon, 5 Aug 2024 23:53:56 -0400 Subject: [PATCH 20/53] MQTT enabled Alarm Control Panel (#4107) --- components/alarm_control_panel/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/components/alarm_control_panel/index.rst b/components/alarm_control_panel/index.rst index da0e8d8a8..a89586322 100644 --- a/components/alarm_control_panel/index.rst +++ b/components/alarm_control_panel/index.rst @@ -49,6 +49,7 @@ Configuration variables: - **on_chime** (*Optional*, :ref:`Action `): An automation to perform when a zone has been marked as chime in the configuration, and it changes from closed to open. See :ref:`alarm_control_panel_on_chime_trigger`. +- If MQTT enabled, all other options from :ref:`MQTT Component `. - If Webserver enabled, ``web_server_sorting_weight`` can be set. See :ref:`Webserver Entity Sorting `. From 2c7a185f85954033a0433fe74c89a50cf28c02fc Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 6 Aug 2024 17:22:00 +1200 Subject: [PATCH 21/53] ``service`` -> ``action`` take 2 (#4113) --- components/packages.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/components/packages.rst b/components/packages.rst index 1a23253c0..6acc58a3e 100644 --- a/components/packages.rst +++ b/components/packages.rst @@ -28,7 +28,7 @@ Local Packages Consider the following example where the author put common pieces of configuration (like Wi-Fi and API) into base files and then extends it with some device-specific configuration in the main configuration. -Note how the piece of configuration describing ``api`` component in ``device_base.yaml`` gets merged with the services +Note how the piece of configuration describing ``api`` component in ``device_base.yaml`` gets merged with the actions definitions from main configuration file. .. code-block:: yaml @@ -39,8 +39,8 @@ definitions from main configuration file. device_base: !include common/device_base.yaml api: - services: - - service: start_laundry + actions: + - action: start_laundry then: - switch.turn_on: relay From 07ce2a7dde9976ab66bffb038e81a088fd8be6c3 Mon Sep 17 00:00:00 2001 From: guillempages Date: Tue, 6 Aug 2024 13:08:13 +0200 Subject: [PATCH 22/53] Add online_image documentation (#2076) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/display/index.rst | 1 + components/image.rst | 3 +- components/online_image.rst | 152 ++++++++++++++++++++++++++++++++++ images/image-sync-outline.svg | 1 + index.rst | 1 + 5 files changed, 157 insertions(+), 1 deletion(-) create mode 100644 components/online_image.rst create mode 100644 images/image-sync-outline.svg diff --git a/components/display/index.rst b/components/display/index.rst index dc305ca4f..7b4512f6f 100644 --- a/components/display/index.rst +++ b/components/display/index.rst @@ -610,6 +610,7 @@ See Also - :ref:`QR Code Component ` - :ref:`Image Component ` - :ref:`Animation Component ` +- :ref:`Online Image ` - :ghedit:`Edit` .. toctree:: diff --git a/components/image.rst b/components/image.rst index c9962db99..2a27138ae 100644 --- a/components/image.rst +++ b/components/image.rst @@ -9,6 +9,8 @@ Images Use this component to store graphical images on the device, you can then draw the images on compatible displays. +For showing images downloaded at runtime, take a look at the :ref:`Online Image ` component. + .. code-block:: yaml image: @@ -121,4 +123,3 @@ be supplied to modify the color used to represent the on and off bits respective You can also use this to invert images in two color displays, use ``COLOR_OFF`` then ``COLOR_ON`` as the additional parameters. - diff --git a/components/online_image.rst b/components/online_image.rst new file mode 100644 index 000000000..7ac693fd5 --- /dev/null +++ b/components/online_image.rst @@ -0,0 +1,152 @@ +.. _online_image: + +Online Image Component +====================== + +.. seo:: + :description: Instructions for displaying images downloaded at runtime in ESPHome. + :image: image-sync-outline.svg + +With this component you can define images that will be downloaded, decoded and drawn at runtime. + +.. note:: + + Currently only images in PNG format are supported. + +.. warning:: + + This component requires a fair amount of RAM; both for downloading the image, and for storing the decoded image. It might work on devices without PSRAM, but there is no guarantee. + +This component has a dependency to :doc:`/components/http_request`; the configuration options you set to the ``http_request`` component will also apply here. + +.. code-block:: yaml + + online_image: + - url: "https://example.com/example.png" + format: png + id: my_online_image + +Configuration variables +----------------------- + +- **url** (**Required**, url): The URL where the image will be downloaded from. +- **id** (**Required**, :ref:`config-id`): The ID with which you will be able to reference the image later + in your display code. +- **format** (**Required**): The format that the image is encoded with. + + - ``PNG``: The image on the server is encoded in PNG format. +- **resize** (*Optional*, string): If set, this will resize the image to fit inside the given dimensions ``WIDTHxHEIGHT`` + and preserve the aspect ratio. +- **type** (*Optional*): Specifies how to encode image internally. Defaults to ``BINARY``. + + - ``BINARY``: Two colors, suitable for 1 color displays or 2 color image in color displays. Uses 1 bit + per pixel, 8 pixels per byte. + - ``TRANSPARENT_BINARY``: One color, any pixel that is fully transparent will not be drawn, and any other pixel + will be the on color. Uses 1 bit per pixel, 8 pixels per byte. + - ``GRAYSCALE``: Full scale grey. Uses 8 bits per pixel, 1 pixel per byte. + - ``RGB565``: Lossy RGB color stored. Uses 2 bytes per pixel. + - ``RGB24``: Full RGB color stored. Uses 3 bytes per pixel. + - ``RGBA``: Full RGB color stored. Uses 4 bytes per pixel. Any pixel with an alpha value < 127 will not be drawn. +- **use_transparency** (*Optional*, boolean): If set the alpha channel of the input image will be taken into account, + and pixels with alpha < 127 will not be drawn. For image types without explicit alpha channel, + the color (0, 0, 1) (very dark blue) will be mapped to black, to be able to store transparency information + within the image. Explicitly transparent types (``TRANSPARENT_BINARY`` and ``RGBA``) default to ``true`` and cannot be set to ``false``; other types default to ``false``. +- **update_interval** (*Optional*, int): Redownload the image when the specified time has elapsed. Defaults to ``never`` (i.e. the update component action needs to be called manually). + +Automations +----------- + +- **on_download_finished** (*Optional*, :ref:`Automation `): An automation to perform when the image has been successfully downloaded. + +A good example for that is to update the display component after the download succeeded. + +- **on_error** (*Optional*, :ref:`Automation `): An automation to perform when an error happened during download or decode. + +Actions +------- + +**online_image.set_url**: Change the URL where the image is downloaded from. The image needs to be manually updated afterwards. + +Configuration variables: + +- **id** (**Required**, :ref:`config-id`): The image to update the URL for. +- **url** (**Required**, url): The new URL to download the image from. + +.. code-block:: yaml + + on_...: + - online_image.set_url: + id: my_online_image + url: "https://www.example.com/new_image.png" + - component.update: my_online_image + +**online_image.release**: Release the memory currently used by an image. Can be used if different display pages need different images, to avoid wasting memory on an image that is currently not being displayed. + +Configuration variables: + +- **id** (**Required**, :ref:`config-id`): The image to update the URL for. + +.. code-block:: yaml + + on_...: + - online_image.release: my_online_image + +Examples +-------- + +.. code-block:: yaml + + online_image: + - url: "https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png" + format: png + id: my_online_image + on_download_finished: + component.update: my_display + +And then later in code: + +.. code-block:: yaml + + display: + - platform: ... + id: my_display + # ... + lambda: |- + // Draw the image my_online_image at position [x=0,y=0] + it.image(0, 0, id(my_online_image)); + +For monochrome displays the ``image`` method accepts two additional color parameters which can +be supplied to specify the color used to draw bright and dark pixels respectively. +In this case the image will be internally converted to a grayscale image and then to monochrome +based on an internally defined threshold. + +.. code-block:: yaml + + display: + - platform: ... + id: my_display + # ... + lambda: |- + // Draw the image my_image at position [x=0,y=0] + // with front color "OFF" and back color "ON" + it.image(0, 0, id(my_online_image), COLOR_OFF, COLOR_ON); + +By default ``online_image`` is configured to not automatically update/download the image; in order to do the initial download, you can either: + - Add a ``component.update `` in the ``on_connect:`` action on the :doc:`/components/wifi` component. + - Explicitly set an ``update_interval``. + - Call ``component.update `` in an :doc:`/components/interval` block. + - Call ``component.update `` where you need the image to be downloaded/updated. + +.. code-block:: yaml + + wifi: + on_connect: + - component.update: my_online_image + +See Also +-------- + +- :apiref:`online_image/online_image.h` +- :doc:`Image Component ` +- :doc:`Animation Component ` +- :ghedit:`Edit` diff --git a/images/image-sync-outline.svg b/images/image-sync-outline.svg new file mode 100644 index 000000000..7415eee7a --- /dev/null +++ b/images/image-sync-outline.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/index.rst b/index.rst index 54c49ec68..48e810f7e 100644 --- a/index.rst +++ b/index.rst @@ -823,6 +823,7 @@ Display Components QR Code, components/qr_code, qr-code.svg, dark-invert Image, components/image, image-outline.svg, dark-invert Animation, components/animation, image-multiple-outline.svg, dark-invert + Online Image, components/online_image, image-sync-outline.svg, dark-invert Display Menu Core, components/display_menu/index, folder-open.svg, dark-invert Graphical Display Menu, components/display_menu/graphical_display_menu, graphical_display_menu.png LCD Menu, components/display_menu/lcd_menu, lcd_menu.png From db2fda75c33e04662622e996ebcfa5b580ba4f85 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=2E=20=C3=81rkosi=20R=C3=B3bert?= Date: Mon, 12 Aug 2024 00:39:48 +0200 Subject: [PATCH 23/53] Initial LVGL doc for ESPHome (#3678) Co-authored-by: Keith Burzinski Co-authored-by: clydebarrow <2366188+clydebarrow@users.noreply.github.com> Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/binary_sensor/lvgl.rst | 39 + components/display/index.rst | 25 +- components/font.rst | 4 +- components/index.rst | 1 + components/key_collector.rst | 18 +- components/light/lvgl.rst | 44 + components/lvgl/images/lvgl_align.png | Bin 0 -> 15911 bytes components/lvgl/images/lvgl_animimg.gif | Bin 0 -> 7025 bytes components/lvgl/images/lvgl_arc.png | Bin 0 -> 2738 bytes components/lvgl/images/lvgl_bar.png | Bin 0 -> 374 bytes components/lvgl/images/lvgl_baseobj.png | Bin 0 -> 730 bytes components/lvgl/images/lvgl_boxmodel.png | Bin 0 -> 9051 bytes components/lvgl/images/lvgl_button.png | Bin 0 -> 1062 bytes components/lvgl/images/lvgl_buttonmatrix.png | Bin 0 -> 2739 bytes components/lvgl/images/lvgl_checkbox.png | Bin 0 -> 1420 bytes components/lvgl/images/lvgl_dropdown.png | Bin 0 -> 2959 bytes components/lvgl/images/lvgl_image.png | Bin 0 -> 10371 bytes components/lvgl/images/lvgl_keyboard.png | Bin 0 -> 8996 bytes components/lvgl/images/lvgl_label.png | Bin 0 -> 1123 bytes components/lvgl/images/lvgl_led.png | Bin 0 -> 1123 bytes components/lvgl/images/lvgl_line.png | Bin 0 -> 1775 bytes .../lvgl/images/lvgl_main_screenshot.png | Bin 0 -> 134021 bytes components/lvgl/images/lvgl_meter.png | Bin 0 -> 7065 bytes components/lvgl/images/lvgl_msgbox.png | Bin 0 -> 4971 bytes components/lvgl/images/lvgl_roller.png | Bin 0 -> 2677 bytes components/lvgl/images/lvgl_slider.png | Bin 0 -> 521 bytes components/lvgl/images/lvgl_spinbox.png | Bin 0 -> 799 bytes components/lvgl/images/lvgl_spinner.gif | Bin 0 -> 36060 bytes components/lvgl/images/lvgl_switch.png | Bin 0 -> 737 bytes components/lvgl/images/lvgl_symbols.png | Bin 0 -> 30832 bytes components/lvgl/images/lvgl_tabview.png | Bin 0 -> 7993 bytes components/lvgl/images/lvgl_textarea.png | Bin 0 -> 4749 bytes components/lvgl/index.rst | 690 +++++++ components/lvgl/widgets.rst | 1788 +++++++++++++++++ components/number/lvgl.rst | 47 + components/select/lvgl.rst | 44 + components/sensor/lvgl.rst | 46 + components/switch/lvgl.rst | 42 + components/text/lvgl.rst | 43 + components/text_sensor/lvgl.rst | 44 + images/lvgl.png | Bin 0 -> 3401 bytes images/lvgl_c_bns.png | Bin 0 -> 1688 bytes images/lvgl_c_lig.png | Bin 0 -> 1658 bytes images/lvgl_c_num.png | Bin 0 -> 998 bytes images/lvgl_c_sel.png | Bin 0 -> 2622 bytes images/lvgl_c_swi.png | Bin 0 -> 1437 bytes images/lvgl_c_txt.png | Bin 0 -> 1623 bytes index.rst | 11 + 48 files changed, 2867 insertions(+), 19 deletions(-) create mode 100644 components/binary_sensor/lvgl.rst create mode 100644 components/light/lvgl.rst create mode 100644 components/lvgl/images/lvgl_align.png create mode 100644 components/lvgl/images/lvgl_animimg.gif create mode 100644 components/lvgl/images/lvgl_arc.png create mode 100644 components/lvgl/images/lvgl_bar.png create mode 100644 components/lvgl/images/lvgl_baseobj.png create mode 100644 components/lvgl/images/lvgl_boxmodel.png create mode 100644 components/lvgl/images/lvgl_button.png create mode 100644 components/lvgl/images/lvgl_buttonmatrix.png create mode 100644 components/lvgl/images/lvgl_checkbox.png create mode 100644 components/lvgl/images/lvgl_dropdown.png create mode 100644 components/lvgl/images/lvgl_image.png create mode 100644 components/lvgl/images/lvgl_keyboard.png create mode 100644 components/lvgl/images/lvgl_label.png create mode 100644 components/lvgl/images/lvgl_led.png create mode 100644 components/lvgl/images/lvgl_line.png create mode 100644 components/lvgl/images/lvgl_main_screenshot.png create mode 100644 components/lvgl/images/lvgl_meter.png create mode 100644 components/lvgl/images/lvgl_msgbox.png create mode 100644 components/lvgl/images/lvgl_roller.png create mode 100644 components/lvgl/images/lvgl_slider.png create mode 100644 components/lvgl/images/lvgl_spinbox.png create mode 100644 components/lvgl/images/lvgl_spinner.gif create mode 100644 components/lvgl/images/lvgl_switch.png create mode 100644 components/lvgl/images/lvgl_symbols.png create mode 100644 components/lvgl/images/lvgl_tabview.png create mode 100644 components/lvgl/images/lvgl_textarea.png create mode 100644 components/lvgl/index.rst create mode 100644 components/lvgl/widgets.rst create mode 100644 components/number/lvgl.rst create mode 100644 components/select/lvgl.rst create mode 100644 components/sensor/lvgl.rst create mode 100644 components/switch/lvgl.rst create mode 100644 components/text/lvgl.rst create mode 100644 components/text_sensor/lvgl.rst create mode 100644 images/lvgl.png create mode 100644 images/lvgl_c_bns.png create mode 100644 images/lvgl_c_lig.png create mode 100644 images/lvgl_c_num.png create mode 100644 images/lvgl_c_sel.png create mode 100644 images/lvgl_c_swi.png create mode 100644 images/lvgl_c_txt.png diff --git a/components/binary_sensor/lvgl.rst b/components/binary_sensor/lvgl.rst new file mode 100644 index 000000000..e56b9c196 --- /dev/null +++ b/components/binary_sensor/lvgl.rst @@ -0,0 +1,39 @@ +LVGL Binary Sensor +================== + +.. seo:: + :description: Instructions for setting up an LVGL widget binary sensor. + :image: ../images/lvgl_c_bns.png + +The ``lvgl`` binary sensor platform creates a binary sensor from an LVGL widget +and requires :doc:`LVGL ` to be configured. + +Supported widget is :ref:`lvgl-widget-button`. A single binary sensor supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome binary sensor component. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a supported widget configured in LVGL, which will reflect the state of the binary sensor. +- All other variables from :ref:`Binary Sensor `. + +Example: + +.. code-block:: yaml + + binary_sensor: + - platform: lvgl + widget: btn_id + name: LVGL push button + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`Button widget ` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/text/lvgl` +- :doc:`/components/text_sensor/lvgl` +- :ghedit:`Edit` diff --git a/components/display/index.rst b/components/display/index.rst index 7b4512f6f..5d5c02af1 100644 --- a/components/display/index.rst +++ b/components/display/index.rst @@ -8,14 +8,25 @@ Display Component The ``display`` component houses ESPHome's powerful rendering and display engine. Fundamentally, there are these types of displays: -- Text based displays like :doc:`7-Segment displays ` or +- Character displays like :doc:`7-Segment displays ` or :doc:`LCD displays `. -- Graphical serial displays like :doc:`nextion` that have their own processors for rendering. +- Serial displays like :doc:`nextion` that have their own processors for graphics rendering. - Graphical binary displays which can toggle ON/OFF any pixel, like :doc:`E-Paper `, + :doc:`OLED ` or :doc:`TFT ` displays. -For the last type, ESPHome has a powerful rendering engine that can do -many things like draw some basic shapes, print text with any font you want, or even show images. +For graphical displays, which offer the greatest flexibility, there are two options: + +- ESPHome's :ref:`own rendering engine ` +- :doc:`LVGL ` - Light and Versatile Graphics Library + +.. _display-engine: + +Display Rendering Engine +------------------------ + +ESPHome's own powerful rendering engine can handle many common tasks such as drawing basic shapes, +printing text with fonts of your choice, or even rendering images. To achieve all this flexibility displays tie in directly into ESPHome's :ref:`lambda system `. So when you want to write some text or sensor values to the screen you will be writing in C++ code @@ -24,11 +35,6 @@ using an API that is designed to - be simple and to be used without programming experience - but also be flexible enough to work with more complex tasks like displaying an analog clock. -.. _display-engine: - -Display Rendering Engine ------------------------- - In this section we will be discussing how to use ESPHome's display rendering engine from ESPHome and some basic commands. Please note that this only applies to displays that can control each pixel individually. @@ -605,6 +611,7 @@ See Also -------- - :apiref:`display/display_buffer.h` +- :doc:`LVGL ` - :ref:`Fonts ` - :ref:`Graph Component ` - :ref:`QR Code Component ` diff --git a/components/font.rst b/components/font.rst index 47ab89461..8f215822c 100644 --- a/components/font.rst +++ b/components/font.rst @@ -9,7 +9,7 @@ Font Renderer Component ESPHome's graphical rendering engine also has a powerful font drawer which integrates seamlessly into the system. You have the option to use **any** OpenType/TrueType (``.ttf``, ``.otf``, ``.woff``) font file at **any** size, as well as fixed-size `PCF `_ and `BDF `_ bitmap fonts. -These fonts can be used in ESPHome's :ref:`own rendering engine `. +These fonts can be used in ESPHome's :ref:`own rendering engine ` or in the :doc:`LVGL Graphics ` component. To use fonts you can either - Just grab a ``.ttf``, ``.otf``, ``.woff``, ``.pcf``, or ``.bdf`` file from somewhere on the internet and place it, for example, inside a ``fonts`` folder next to your configuration file. @@ -83,6 +83,7 @@ Next, create a ``font:`` section in your configuration: display: # ... + Configuration variables: ------------------------ @@ -155,6 +156,7 @@ See Also - :apiref:`display/display_buffer.h` - :ref:`display-engine` +- :doc:`/components/lvgl/index` - `MDI cheatsheet `_ - `MDI font repository `_ - :ghedit:`Edit` diff --git a/components/index.rst b/components/index.rst index f937b80a2..df4c68c25 100644 --- a/components/index.rst +++ b/components/index.rst @@ -26,6 +26,7 @@ Components touchscreen/index lock/index display_menu/index + lvgl/index media_player/index microphone/index speaker/index diff --git a/components/key_collector.rst b/components/key_collector.rst index 552522b5b..0976caf06 100644 --- a/components/key_collector.rst +++ b/components/key_collector.rst @@ -6,12 +6,12 @@ Key collector component .. seo:: :description: Key collector component -The ``key_collector`` component collects key presses from -components like :ref:`matrix_keypad` or ``wiegand``. It allows you to process -key sequences and treat them as one, for example to allow inputting of -a PIN code or a passkey. The component outputs the result of the keypress -sequence as a variable usable in automations. - +The ``key_collector`` component collects key presses from components +like :ref:`matrix_keypad`, :doc:`Wiegand keypad ` +or LVGL :ref:`Button Matrix `, :ref:`Keyboard ` +widgets. It allows you to process key sequences and treat them as one, for +example to allow inputting of a PIN code or a passkey. The component outputs +the result of the keypress sequence as a variable usable in automations. Component --------- @@ -92,7 +92,7 @@ See Also -------- - :doc:`/components/matrix_keypad` - -.. - :doc:`/components/wiegand` - +- :doc:`/components/wiegand` +- :ref:`LVGL Button Matrix widget ` +- :ref:`LVGL Keyboard widget ` - :ghedit:`Edit` diff --git a/components/light/lvgl.rst b/components/light/lvgl.rst new file mode 100644 index 000000000..a4e1d1d3b --- /dev/null +++ b/components/light/lvgl.rst @@ -0,0 +1,44 @@ +LVGL Light +========== + +.. seo:: + :description: Instructions for setting up an LVGL widget light. + :image: ../images/lvgl_c_lig.png + +The ``lvgl`` light platform creates a light from an LVGL widget +and requires :doc:`LVGL ` to be configured. + +Supported widget is :ref:`lvgl-widget-led`. A single light supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome light component. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a ``led`` widget configured in LVGL, which will reflect the state of the light. +- All other options from :ref:`light `. + + +Example: + +.. code-block:: yaml + + light: + - platform: lvgl + widget: led_id + name: LVGL light + +.. note:: + + To have linear brightness control, ``gamma_correct`` of the light is set by default to ``0``. + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`LED widget ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/text/lvgl` +- :doc:`/components/text_sensor/lvgl` +- :ghedit:`Edit` diff --git a/components/lvgl/images/lvgl_align.png b/components/lvgl/images/lvgl_align.png new file mode 100644 index 0000000000000000000000000000000000000000..e7a1381ca6e132dea3ac5302df356af8131d754e GIT binary patch literal 15911 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 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_animimg.gif b/components/lvgl/images/lvgl_animimg.gif new file mode 100644 index 0000000000000000000000000000000000000000..9f6bce8bee17d7b8d415e4436d93d16152327b82 GIT binary patch literal 7025 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

YrQaDu@zRonb)p zZHqcwN8O2Zc!&tRoe#DKR9GoBW%q|?Ml@J4jH)?cDhrAu*6)gMEVXSVUdX8!jAY>ghlg=WEz{k1~ZwmMbudX+xb_*$XPxK-#@UQ0a!Tqvr*cA|-k-T8jnN|;u zlOSpd^&3b6 zMbwROkoSrMCe3@T&|@Q__&Cu&dqLVha02ETAV@|A02uLt>)NzYxNJ9`r&E@f~EZRt9^X>M5#e z-CWVRj<6lNcI_fVibNJ#wSs&$w70GgoB%*%K%%+uzY9=<8^g&bNb^67w?|!H3`Ow+ zNGWC4uGPS808MP$8%x`<%Nv)9s!N0$+k52(q48DW_lrkLX@_55_%qi3&!MBsO9%(m zPN4mb=Ox&Od@#2c%2^rq+I^7Rhx%k~m@!k?hSmIQu;v`9x^}Kd)n4dB5JiPxpE5DQ zqPEjyL^B^X!m<`&D-$1~%06BQRz7!|XTeh*G_S23V%A<{LQI*OtCz-J6k#3E$hZ}~ zlg+53%4m;*@nO+uKVk6D+Z(*^lg!$xIUQsJ3+h-6dG0+FUW;{ji{h_9cCu>6IQG-o zVbi%8)7j|hf>l(bmi#gkGlxa;$usA}W-2mfc(pT?YREYzX2MAR=L+Ur2Bs-&wk2b> zt#-B}V|H0E#s4)cP@99{u>UDFpgrIZz!>lFfJrIArSJ$T zWh7J?1yx1E)G%-j8H5%NsUwThlSgk;z!>ADP1UgGnzEK!a+cci7TOBtI!dOxD#p6% zL|uZRp0=UBj-kGu;Wm9kgKY+eh6aX210vCoXtV{9Xk=t$Y+^#%3e&A1o07?Z z*5206-qzm1&cVUX(b1mb=sEv>Ds zZEbDs?d=^M9hWX$>g??7>gu|D`SO)3R|EnS9^PV`}+F&`}+q5282T4 z;NalU(AH7BHat9h{rdGAH*SbWhQ~$MCdAh!Mz2qdiN?prCnhE)Cnu+-rlzN-XJ%$* zXJ_Z;=5F5HQfIer-@bk4&K-$FGCx0m_wL;-d$zE!aR2`O2M-=ReE4v2aq-ckM~@#r zURqjOUS59kgPyhPsua%XRXV0FkuC6|R{(Q@`y?F8B<;$0^UcFjhUw{4j_1}O0 z{pQV^w{PFRd-v}B`}bQGZewHP!-o$aKYsl5>C@-Wpa1>$-z_iq_3PJf-@bkS{(Vc( z{rvfJ%hCP*{d-HSncp(sQfhw?YVgSal$wmbM;e_?$wTWX{u*FV$BXcqG0W3tTH|L4 zhSENQjg>4eK{+ge)6+c1ChjMm|9@OvA_nn~#oI5d5_XBspRsWX3d1fki&0*W zBQ#|NLr9iCk9kcQx9Vh02pZYsRw2`ZuvX3-a>p zdhHdl*(7Z9%Z%{JPwI7;6hh6E?0r0I*G+e{yr0GKtV>e+o_H+npgH`h{ctA=loBCP zP-QF4$AV5t1s#O}7yUBuz%Qz_$}T;u3huSMsz*#%+Wav;>NlBFXq&vnow;#eWmT0= zrO}z_oES+k2v@Pk#YpAzKH3X}ZX;#n(bqtl?4~o!&2uxrHDTqMl)oZQcUj z7kSpMrDB^GM@4?Q`e|Z5R_d@@oJ0v1@k8UR-vQl&9spV)wgUd7ssv9(LT);VMS9rE z%^jNoFDOk&z5On7)8qUikjW4KM#TNcPde?NetF(z$r}ua0`=i=Dv`{zw_V`fEL>X9 zS|v9Hlt}zb4f^|a2c>_xrOUrZIS{6yWx`o?dbMfMMfs$CUQ8{QZhA@)|GG+a`(rM@ z%?)5c(Y~QPBRem2xcgHU-*95b8g)=Q`=$E>w}m(nM|vB5?9`8Mbvzu-yOwIQ2{xvc zB%ZuDOuDb)CyE=)m}>r$!TZ~1;N>fGw^mQSRtQGb#Y1aB1M+0{Ddv_$h^|VLivdp@ z;o{kaNiX? zBk%(RW6Jem(j1;3CQCKB-U?gp&!QzXEh?WXg&C^h+bP6;il?HrCJw_D%D)O+ zX@8gV7C-TqnOKiH+WBE<@HtL^9%gWVusxdowt%PY2{AxICe00B~!-3 zxI6ouP8%rgi#`_AWU8Ah5X0TLY-kJtgloI_r)41f+pVK8I|@kla;)&0?iveJfLMDF z1C}F8*qCFK-_!0+a5n+_y{cGF__+p>fw4G}SOhwpM}w6fmAa?H6rud!;|8@?bdD2m zYd;>~Ab!XoK3j;tU4G>#!xtoJ@Ms@N{^i-jF@z#k-Me(M6X7lc**W(FO;|p{~81 z2~+JH#OZamLB5GjlFhWJ@LtUVI|A2sEJ$lQ2JXtDvdwzMI(y1`T|<)&A$GgybTG0M z7FW(6{F%2vDxGz+U)?sAP;gT*mAi|iT?Ky@PR7V~pOKhpZT*aCZ7TRiL?0j=KX@#T T5D=Ag;J}f!C*laBD03Em_Td@#F`0Aw9LVi-NQP|9^#{YTi+%*C3ExM z;-hj{#+gf;9EK=?$vT069hku$5J-Uy$lya86ljACRbYenpp2p^_n%j-maLZQJH9Aw zyT7jYURAZaFPxs9LK74IAO|#kjJ6dgw5>RyZN&*g4)i^hIzKo<^*}f$sD6Mr0f3!4 zlRpOl$fX4UW*|F?l!5FR8%tm^ZOWgE2^admC#=+Y^#I!kqIT$MMU`AyWRjQ}W7)Ad z$?IQR8)d$IAa-ojj-oN-MJ6F~7G}oS&8dFZ)_1lx%6xNAyt2Vhx-01{rXl7mG$_!C9|uZPxhOFMXQ#DCE*&>2sFPoKJ4-oh`e; z@4ptM{kVE+r!X$=Tw~TqubuVC)<&7%-4^}O??r`ah)s^3~MfA3I_W8;y(cxvAON+wAZb>>zQ(NhM zr)&I~gjk(px$$oO&Jo+%+2{Xw-cg|{jEki!=e9sssq?kB9ZfS#LwtXuTf(BW)k&Lf z8e$=fZ!Vpir*zYXU-p1kOAoZXobkuOt4W2?C9 z{QKuHS7I(LzP-||yb%dI`~17NVLB$$5dXRy@w#FJwl>Oq<&7K+#5Bax6qaV9{A0Su z+P1S+4s$uKUPXi{u~S>&+KOCS+`HCysn4HEo!@<}JjkMLIy$lyPE~Ivl3gOils`gY z;ceLse(R~)ysDRrG~FY_a#|)K*5@ObJBGjebNPjus!T#Wo{zmM0Qrphc%EevLjDJD zYDaAOg~I2(2x;s78%HUF=h9+*K4yi=hsm_LKF^xBmJ->iv-@uxIjTsQOt@L&i_hht z4~22D_H|qfl|M^AI!Y6=;th0?U6gIv4gSRs3R!#B66^DWsjA7Xrw)Bl*fhj{{~o@8 zDQCi!mkO#1;{&b=!1{cuFiuU0{DiH%q<;7;YPL4YoPHhU(gT|SCDy)9(QDY2%{Izh zj?z%bgi1Lus-872sLp3BhOCAB1PT*KnbfnSV2fT+O+!2$pbn5orOyBQlzKI{Fb&+E z#>!>VxuV)q>H|CMeBz7JS!!o8iDwJJXN+36)_$Sp<;5v6oT>oiGv?wH^+dH(ImGOL zf{Pi+R&kd)7tW<)yapHvcdjaQ9PQXg_{*aJVMJSU#1+#J_pXto4mR1*kSC#Xh}EC{ zgaz9w?mEPK@Rp`rZt5F09L}HoPY%*~xC@7S3ZvMPBd+AqA}(8tU8S@Kej*3y@Dr5w zcTN`Cg99Z98A$@G%+1!&Os`wlsz}BO8q=H!(7m@6?4FJ`;98tyR2!6IIbxvso zO+zf{f%O~qksMLQ=Lmkb9{x%iSPNO*T=WP(Tcw&Dapjv!dSLYkPg@&hPFeCQj0-)m z+OZOHL=~SSc-q?BBc(xIu_Ur-IiiZs5j<_ZvgOEGa%nxVWbzYoL=~SSxZ9$p!HaT4 zQ<#9+!Gq~c1BD4W*uve`_5mpk7A^)G9X3*?d3#z8(z!kDw>jxlU_B?7EGVk&J~M^^*OV@S0nDIpYXQC4!Z$>7gunxstgRu;Fi z;0+ue1`P$@y)iixR_cCLuEp$x9MJ?ryTW}M4cS)nQ9J%vOc$*%n17_5H1FXh+o}>; z3~NM=XsEbU9vPp~CEIem#kQCplOq};jM1{82ePf|2Pxn}ig1BwLgUlK%eI;?n((Lj zkU32VNMp-efox0D&&akYldUnu6)?>wC`BaNv88t)Lql!iJqTkwkY4iq^#3x-0_}EeZqTACfm~VGqNq_Ew%+^S4HEB&u+*k zycNi{vZGSK1O)5QFcRiX}7Rx&O#bn-pIBnyCHT%j%cV5(vr`vifoIr zzHSRhZAc1?w#IbTg3JCtvxxS35J#heb(t^TcAz3s)xa!(Mb4g;eWz=V8PW^ zhH&@xChaT9nsz8HhELIgtF0MAqftB3rArNd%tDu_Cr%D0#EQid!2=8a zwr+n$I>e)@zOTj|e$0DkYcg$8R(Sad)78rrV#Nxa6u0oR1z>^pq{z}f+u7H{>vwQY ztyswfVI3Vnpskxzro~7<@;g1eeoyej7Jh@$Uo;7@1z?f(M6jJYTifpRy@&&Y<2aN# z767L5klJP5W0^6=s(?CxvoZ#lpmexT++rGW*qE$Vx3 zB6&}2tfA*X7-|CxL|XusKBry<#WLHh4QW2)TpwXi7QM^LNpgGlxQh`hA&qw z!rQV&%+)!Cj$@b!-LgxBw*??KZhn7*1=d-5&WscjnDe!)Za4Sq+bZQI0>Wx&&djl+!5R22DR@c5IHInilUa54He|rSB06hDfd&iMU zi1qn^t1s>(N0aWt3?#=Q=q%c~aC&+w$HG$FbxQ9)c7VCGC|twX0ssI2fP6HM0003!NklZC#3+I%5K^YS~X8W40yibF*ReF zHlCq3oob$h-5&2-9#eAwy1wW2HzVlfiWl+fW6Mi|c6(lk5w!jVPRIJ2mjoSnU`Eg) zc~Q{fiV^hvB`@MtQ}L1@^VOme^xXw7;#FJolAsuPAx6+=i}LoINAV|y)bE7=3fT8T zBWM6m*J|3iHq)$07*qoM6N<$g3UFf+W-In literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_baseobj.png b/components/lvgl/images/lvgl_baseobj.png new file mode 100644 index 0000000000000000000000000000000000000000..5fe7294ce66f7e61a72fe4a3f18a876e81800fc5 GIT binary patch literal 730 zcmeAS@N?(olHy`uVBq!ia0vp^`+&Hfg9%99TlD@m0|V1SPZ!6KinzBo4rV5}4? za@!BS)%knB-}_zF6u;_PRJLqf``07k`uu$-*KWOhJJa@5UeEDDiFa%z=5s6O{r`*7aVCdjI$H;`z&7zSa%D{qoMP$_)_&3@@WIpU+5 zKM5ZGUZ4JMN$}FcSA`CLE)nyyymO~J(OR~`%c^CGv&TpzGOXubyH(Y(cbE8KtGQ9x znoGa$lS3>D`cm2SI*miZiD-Fp1j06Yc6Xp?K!@2%BAyv z?|Jvl%~-1&eQwf`Q*Ks=4X!xrE}e7F@7uh)v!4I_Ql_=^inDCn*J;6Cl{;hfUT+NY z()?_5-_Pc2K=$3Z^ZJ*gUhl21`*PW&cJI?yc~(oOT)TBi_P2@LarWOw7ng{=-TU=k y?Yj5wYqwte^*3hECmY!tTMB*J=1<^TSnv2`%R|Sb!Iyw(mci52&t;ucLK6UZ)mUHv literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_boxmodel.png b/components/lvgl/images/lvgl_boxmodel.png new file mode 100644 index 0000000000000000000000000000000000000000..98251f41698f40b98077c1fdb5907c6e0a83eb10 GIT binary patch literal 9051 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 AumAu6 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_button.png b/components/lvgl/images/lvgl_button.png new file mode 100644 index 0000000000000000000000000000000000000000..c80d07f2d16b54fcc0b841b1e9d703cec2db3ecf GIT binary patch literal 1062 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 Q4Wj@X%hRYTq|fz#16OP$v;Y7A literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_checkbox.png b/components/lvgl/images/lvgl_checkbox.png new file mode 100644 index 0000000000000000000000000000000000000000..31b63cc7f5eeecdcfb2f5b39df9a530a6e7496b1 GIT binary patch literal 1420 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 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_keyboard.png b/components/lvgl/images/lvgl_keyboard.png new file mode 100644 index 0000000000000000000000000000000000000000..a9b009d310b9e2617b9205df246dae67333a710a GIT binary patch literal 8996 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 WlPM2Y`?diK4+c+HKbLh*2~7ZgofS|3 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_led.png b/components/lvgl/images/lvgl_led.png new file mode 100644 index 0000000000000000000000000000000000000000..0349f1b9cde81373ffe8919880e8e8f01e2de1ab GIT binary patch literal 1123 zcmV-p1f2VcP)CEO5QWcMQj9tYQpm8y22vzl{{L@S*w-aRAc0-5ihxx-&?y4hVkB9Xof}{0F61OF#o^}je@DW%#r#x#F9q8|qwY6(EjZIwuE9^gCAp^Tysi)R7= zF+c$l0ifV#VeJL#QAjYAMq`pl`7zb1v#@rBY^EU*Cv8w0X$52iB4S-8tBrk3Uptgi z<3yYgBbhKo#0VzD$OcG6U@gSZMmQ^CKvt%-gXt7dZ%mAg6Q+nT=5_^51OOu}ArtFh zE&Tu{Az>}7!;bKs0sCx#I*B1XK=Z}AGS7S@U%U>#iqDNOXt6vd~{Oxgz8rg?oq z2$&{5zaWI{N~d?=E#fWmp8)UW_68)G1R$`7X#;3Zoi)uk^63$8v43YR60fiP73J<8 zg=WDdl2TeTZ2$o^bt2-9w@8Mqc9?jm?l0QqEV52dMpz#FH{hLANroaZ|#S64J1>Z z;Zx-E%dWgRp|{BA7fdAwnr&yXRd+yH+Ev%$7&W!~J_i&+Ha@RmW%XKW1w?{Lm%eOI z7&qTMTO`AnP09;>T93Q}LUAa&nh?JitX8`H&4c$e=z&UHk%(Aay)aN2Q_F-E)(kW! z7m2b%k!*K{@9G`%unkI^*Q=0e?WgK$or_5ApFb|97&d@Zen@zf#xM#E3EqbWHCRYE6l@|-2=-r)LsfxEVHdz0<)gVd0TboJ1dLqPsloP{6Y2RJ8p z_nZIFE{Vw9J)A3}72~(m&uL>!UJ$Jlk^_Z_x=23oNYN;QhkFbIych2=c(JY?9e3B% z>Zi3r>Io*-=U1|~$X8ukxhph(+~gdnlYdJaK*pGq5=7M1N~6w*$f;vcl}J7YIXBY` zLr!fGtg30%1`w8kL(3!vn(x04n+HWK4~m+F;(brE6)e>@5H^{N=66@brKbVfO@sYFsvc{8CIEABw|wqIQJn{*TAVdodsK=7 p;7kj-vNS77XZ4f{slH09W%Z?{pkPz002ovPDHLkV1ihd@-+Ye literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_line.png b/components/lvgl/images/lvgl_line.png new file mode 100644 index 0000000000000000000000000000000000000000..6d85c445b4d1abcd49c9ac4f5737c40c9a234036 GIT binary patch literal 1775 zcmZ8iX;_k36sD%d-AbE46Du}T)AZ981JhgpMay=le6&%-78lGECG07;C=ex58d1kW zZF0<9A|o|RLj}VLOVdnD#z_WqW!#9GZ~o4Y_nzn6d(ZZs^W4ik6pS}DvND1|Af`lu z?_p5tK%6jG39dnMVH79~69}OfArQ0n|FGh=gPAo1vZjpa>wT0a_)@$-W;5PWqJ(Y4 z9P(PT5zXIn)oL$#9l?TdZ^WK&xyIc!v24Vj$$i;qaN}@0l{~bE`ywJG*@94Mmltt~ zxc*VmuZY_QtDGM81vMTyvv~OZ=2^eAx%r-nraP(oMUN()y^GQJ4y7wqjb;#6)`dMA z(^h1^v5#)b-}HaPshq>hf^$4<#Fxvn{()wPdtA2NzqH2Y8~sm>;ou^-MK4)+VA8f} z2!3Trsu5efF&3w0v@8#5xF&6gA-Ga4SZrVieNeOQe&e5xt=zpW3rJ7RqE`^ZEvi;s z8wq%LD~Z;LQ^v*HPk-IpywpeYADnvgG|S6aYSI)PyP`RUsC!Qlm;^5n(3aFmyJ zexFu#aO;me*raZ8*tVgz3)d=ienkoYqn^^CZ!;Dzy2L7D>9~OvFzcc%qq*#$Pj~8~ z&wrr8n2*vnW_XWhRor|_<7*!e46F`nWMf{AuD0|WACt7rN~<)YrqT2SL)95Yf5h{g zNgiRLuww!{PcPe4U2+$y^c5e;t>gi4Gy`>GW&Io~$yWavH*DOT^h&E654OGdak03i zVP>Z~&=oqOHxJN!`IO$Qo3sc*n~flxg`p>l1!Vlhgoo3KxfFKVhca;LiA{fwfo)ilK==?$h?C(=5g+N8>dUyQ zswlNnIzAIk_URSeeba6cSkiJol?PblGSbeU;*sah>})MZJ()bOxm)iZ2_7P*bq!HD z$=QGuEenX7zn-8GX*1a{^O37?}r!85(CB&2y4Q@?X9wa zXp;MtTAURJD~x|2$j?hIh&?B1SM}3`PK^37RwlCkLOp3-0=#qIB{($1i z5jo-dZrO5?%S^*LEH|&^b)x?PR%oAw#jK1~t$(WhQV0eJ5^)_hbV<8KE6vw|(F$I% z3>9U;EDl0d>&vt+Kw_lz7xsZZBP0lW^=%%oAt`!b7lnk~%En_An(Y*1jI3@)51+Qu zngbQ~AD0`1aLFG^U1lQX%Qk2F(k|6>Oi3Qc)t*kTc*!WmA z@E=cg6Ys0;a=}*oF1eSj1(}7JY_7??=kt!m#QdxZA*MM{q@&$+gJ6wRYYtbjpd0$4 z){=5TU(xS{U{w~)GwTB5$4EBw^p4YR;0%{ovT{hE+24RT+u1tharr)# zu5&l5T;AsWlxPzfclF!y#jnmig7Pch%xbNCRxqs(`rZPcTH2o)CsU(e1STRl!m(@k z9Sdr9Hg)V>Y2gV2pI+Q~g;HgzvQtmZWK%7H;ZEcK;pTUU{{DopBA~1f{J|hZzhK{o I2O_Th3;G^#zyJUM literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_main_screenshot.png b/components/lvgl/images/lvgl_main_screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..a8c971a901e5a2623316069fdd7d6615ebd4520d GIT binary patch literal 134021 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 `-gHYpC9M8$NJbjIk>De*TFYhU9LE=axSr5) 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 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_meter.png b/components/lvgl/images/lvgl_meter.png new file mode 100644 index 0000000000000000000000000000000000000000..1283126cccb54041511b0ec5e9084869e81a5eef GIT binary patch literal 7065 zcmW+*1zc257k!8VF06Dn(k)$rbV$QWBM3-?Al+RO(%mIXucWkeH_|OgNT)3Dz5n;y z*|)oIXLs(*+$Xg^7zgsGfUqU1gN*&UxTX@U=t?Qpv z&9^PJur2kUaT|Wd7TPvHd}W9Jqv3N=WXp0+GK28oZ=&I1BZGW$K3Wdm0*;J)0k7~y z?(2TG82Q4tN(Ai;xL$LCdY^biJ;y0-uZV{<=-nO-dP&t zSB^DE8Bk_Abb>3pPfBEaA`LraV^g1`2?ntxVY_<}0%Y0NcC@7Qn{=P_+M-)a%s@2 zS9~T}$*huD?Q`PV6x@%Xj1kPR67FwfU; z1WL=7HsbopV4Yf|>zw*alLe@M0aP2qjNL!GOoZQi%O-f0wWdX&!D5j)lwNU&B;;6T zc2NF(x;iCdNf54A*)GN3a#{HXYTUybhi$>WL5+Q4+quyC?+iJbp-E+UaPp)Ed4#?BmzvJ+tn7)wWkqL zWhGJvXY&EB+S4Lt(WRVfD4pv|!P3WAD4o@hzkiXKiQ4A2i$MXmInKcZw^sH+pmS}* zGY35&@-04oDkFE_axg_-+ODStL47b=h$+cjSCD<73_L^1L->F=&t~rWk0GB6Z4dXz zUaIQ3*tpa3@-js?H)raXj&4zkSaY7|0Q<0wiXdR}>}5z#(H|Ef6dFIaqt)HmwJ6>Q zQ<9SF%hhyjOCUhIXUNoz8#EmU2td|Hr2rdPz1V!m*| z0DMNryk3H-Nr{pJ==@{ zjQ7}g8NRilBxSK%_*;|B->#Od5wz}kCu$D2G%j^UEr-3WIa5$L|S(C_T zR{=3m;n!vGeIGmH7ME=~dgqq~+1&987(riEOVPv72C#R{&b#wB*3TtjFr&+=-s0Zd z`Bv`^1K4a}eqb!I=m7Pei@vBLX^|$2CgYwXs|a>JUFg(ah1mNPF13G4b)R(9VY4)m z85}b9-fPX`2MAtfbBG2*yh78y5ghK;Ixl(g`Ot|T@40iOHfyp1{nVPi(Qw90s$M+1 zV_Mi5Av{)W&xI~NVmSgQK7-n^UF0(i=V?C`y5}`l&YmU={IJC}nx~-%1@$DNmgbY+f1{+#t*bjfAvpglAgKaC`B65xl*>2agp*q+mS|IHdN zrl>>3R)FcohZ}tBPpXbGGv9ieI$LsV_@17OmQbOIO~yfnNWwrHcDXqqtJysyeWQtU z1PP+i)}$QPW`3#G{7aP{@3p13HVi6GP4NQCbi_y}NEbPd2Zy7@q7kJM@%BTZ-+=uu zls|GEXw0_EzHclj@ZmM%Dwa+M(SVClrX9r>)mO-(>mRpg7r^qHxo#CNg#kNoK2e+X zH{6}WuffVeSCeHH&4yBwjhEnpUi>X+5}rHn@zDHD+Cv-)9Kc|?M6Y#eQgWlv`$ za(Ny~NYcmH0}usCqz>Fl9~BuKpE^ObVfLbvZcf_;aJY_Tm4L)*#s9qwHhZh~-?qqg znC-wJdE%>C-!)(`ST=NgEX?vAbQ#q;YXd`0ou$ZzT8U`TUq3e+8dbafei(@ARU-m_ zs6VXaFyFS8tyDaxBL+Ql{Y4q>u(<+d9&M`UTV$ zJL?}KVWgb0YWo)$$_(-^91geX$E3`VT9t2IT!X_^jniG44bO8YM93mrB74;kDtTa+ z4AoM_LWRY*Fc?!Q(`9NN(=<);k#2I{*EwO1OId|t%_4tZ>P)6Ks3guni?z@ca>Vk7 zHgIW}>(l~=i-h92*{)T`W+hCqNc#mE}i7PnKJ`(9f}sT#F)q@jYyz ztA-sDK(KGk;*rtohw`Lz3NTx9lbb0+3LazpfIq&KzkVGacr~-7EAI>!;d7 zeZ2EuT63$Yyq4%sy%Ji#qHLlPpi)wK%)HNcmwqU{58g!=egCJ`@BH6s!&+jz2^LVaMy^?50n9BqZbwx^D5f_> z4O$81%a{kjyF$Ujzf4R0YvjlN-#hM#kLJuOmshj2aHWpJ^yBKK@`v~IxlpmXBMJuA zHcD4>6D)3P-;4F-;f;t}^){g;b>sIE4n^N5C0MXT(RFkG5^q8SIMfa^w4#NAVv!+B_`Nd{gBTbui z)}yBOKv_p58$`)fX=A)~mdKzka!C+pjVeyj32;1@?^Y6Z7!{kWz;HHa_7H{)1h9Kf zfwbeLmH%<=p@34CEmX;MV`{Ag-yOfqQPX$#UmZkyO2u~M|EOWanL4>Hwp#JzTXAb; z$i_qs8@5VhP->xx5Z~eIaSn96WO}c6oM=y!K1tQ6D@&_2>UR+qP!TK;(dj?-#a*Tb zWp|TaPsH!+X5QNjdW5#+l+69=#ozu7D_}L3=V+1s1Lmu$oWzclUM?A6eP6hA+FEP? zYY30?8_u9R2a7Ly_2xFQqI2Q57fzRkmrT!1u_Ril37)kpOTOxF6TsQc+;(!l%=#>t zEcSGdO;Lm3V0kZSRefz&X>3VOPs>&kKnX$NO#u?;06fs(&ldr|`LP&t=hj zKvY0nZsfVIVDN>t`k@tVHZcR#h)eI&8 zny5`w2`>{Dm%4-BRVTUD{p7q5(z(nj?wPWJkCSic$tL^!s>Tfe4nZ?U{dv?LrblF5 zD=4~nx{Fw?1Qq=o7Zc?QaJx^5bor2;t`QiDZ7yamoQvS@cL#>8{_+wg7QA_ar$C(El_GTMZ;}IAaa5D4;bhxFY7ILv;fzuCAC!0}0cvJb%Qab#cp)8M0uyM72`Rc7+z4ARRI z{iQ`SJUh|+oMh{d{NyxOcKc)aH5elo?W+d1o#e)JL%A$Dz9>3eA-{T+MX=%nNGn{0b6)Bah1r7p@Ocf> zC%y?k7v74h7m5itqOAqYpyb$U7vt9Z+>aKv)9S+}crm6927up5oCKJc2vS(luoQa@ z<=Cp@CD7MD^`h`~zfXB6VLG8zPlbi11uDu$rgFrUP}MsYtoH~+JO(-_`zwZT6y#&0FEyzRd{ z?%x%M>{mFbokQ@xF^H{WUtyhp!hdK>LtGg$7CR=2q`dcx5`RK^$2Ita;BfzssC=l1 zN{I)y=e^o3syu4fZg5xti{u(Pmv>blzu9qIbJVLVKkJ1&GzCO5EtT{+hCS0FQth@a zycJY)_imWV!yP_szaHiMxk<2)JnNnV(mR}_1MUld-9#USxfpx3itN#WfVonGbdiro zJ6T6>^h+Lfmjfm!v?5L}Pu4rvPi{?HR;oyqhvZLQ?_;6`gX|sGCRnm&%<9sn#rqX1 z>@JJ~Ts;B47GDE-do_yXx>ts%wjccY1^jL&D9j*_!v3rt@W;k`^Pb_YQ>+|nJKrC( zo49pS0B{|geiZJ?s-`hiEgd>QU0wdEs;h)XQS+{P@m?PJZ=^^iA1RXbUgtw@A7HXS zM9|1|?x&a_!}!u>l-=|4W~tRrAN%oHuEYeQS=lfHC$Zore_#($`{VuokzbkjjeEEH zI_}wUk@Jwwx4UEq#S{YBcm}wxoxuB@jBa`lW&AXrPIoHo7(VmGgZ~{NrtN-{9tv(Wha^U zgC;>@fp=~u<8ioZezlDH(I6KP{pjTLFK#-ccZtraIbp!335yI~v zjO*We+nBN#SD$FX(SQ;#5vqQ}WqK{%=$*Ud-=n6L6AD@D(aMuij@o7n>dN!ZZ5iTi zK5|0JBiV=h9D7S2Z8NrnGUnZAozDp%X;PTrqiT28FF@oOANzOf_x2%Qml&H*-JSO@f zjPnB%9FmK&8?vol9{3aV{zpT}uiDt+6)v(5UgAfqROf5-)s-!pd7)l3vSI{1vOI#y zW=__WCNbJxV35u6A`t6JOB53<_ozrXCRljhAZsp?%{OjR1?}Ni>x5!L+yhP&{Z1V6 z`U>jt5AU*7EkQ(hWI%4^BGY_$BO#jW9~Ixp4fh|Km}g?y)_HmaTB6d&$FuX08bpLX zQpEa_+4?e0Pg&Ip@z^UN4YAtDGeCWChCO75qoq>-vSqM7$Pr;~uJH9Gk zkI~1Xj?0C2|12Op@{4oCxT9UVW$g9^EasPNI&EKkHbU%1a+iw#o0m$@Z)a$D7>gr+ zvQj(?HYJyvx|fqp?UV8E&iXc#uJg-#pI+or?>vrOKa}VwN73^uN;H^i~bVyv~UK~ zwW4e3)uVz&FneCPTLEE{orrCqzko@GTj$#hAs5KaH@Ro{FKe3W6iWEx>kGg%xy(j6 z6HW>$`hiNk*B1|U8}C9}q@=FX3&3zvE#-McBvBFG2Vdm3u0y3j)p~iKv!|9h1o{wvaoEadv%~a?PsmRiJrk&QmbY9E zozhz3);PHPkoMx=^E!g-zq^_9#-0)ceZ1r`^H)HfrL~aNAPD8D?Qv*47ptydW*>IG zr1<^zf-=A~EesW!Ko9DDVHRG2zQIX;Xt~fcu zQ5U%ubnoC+W{#^baOZ!Fl*UAhLOKsk+Q-j;fN8y-zk(FI5~LbB!EEfdz|hE-+^deR z{sb4}9R%f#b$Pj?bj%e4uoWv7#azU}&|(w=k9e2H$974if#EXyO?`1+fFV%lmG84B zWTA(me|wlp-ANm2X|$pR;E<<$5ELN&LurMbPN5PlCEfrL3sf8O3QKwpH>o2f=B|O| znPvb6?LVs5$x?Zwqx{3k`Hi(txhxAlC2`;czRO2Qgf>A@Qtw`=>W2ngRN{0tRI+_h z&d=X8(ne)qeyV@h@a|Kc2e}qK%Q=Un7rJC2UufD;hxEfes?JsA-4wx-&0n(?$RB^v z%9uR}Es>2s@Q{M98Q7kh*W!|QHYoH?Y@=ijLO7C=3UL5XJ|+aKArtMD<1I+%0J}FC zVQ0)*w4=9Z&x)!W+R*Tes_79wJj19=Fa0AYh(&?p2)0!l&vSTAEPznx@$PfJ4= z|24b7?rx1NAt^b$Qk&|VIxS%0_OTM4vbaHnn2c{*Ul(r z83j{7k5;N(aZmxKbY3dUlg9DUqcKE^%tP3~*b8AJnO`5NgaRHN1^d7PboI5f zC9_!(^#oI$!@7FBEHVMnCP08)L=i5NlvS0fk}?VUAM{3>+W-In literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_msgbox.png b/components/lvgl/images/lvgl_msgbox.png new file mode 100644 index 0000000000000000000000000000000000000000..101a40c8b4f71430581d95d0cdfc91a562c905e3 GIT binary patch literal 4971 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 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_roller.png b/components/lvgl/images/lvgl_roller.png new file mode 100644 index 0000000000000000000000000000000000000000..3eab1039c096540a7710312f2ba2b9f9dfc3b3a7 GIT binary patch literal 2677 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 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_slider.png b/components/lvgl/images/lvgl_slider.png new file mode 100644 index 0000000000000000000000000000000000000000..d2de4030d2fc6ddbf12efd85046016cfbc97f645 GIT binary patch literal 521 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 H#$XKq@`m>x literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_switch.png b/components/lvgl/images/lvgl_switch.png new file mode 100644 index 0000000000000000000000000000000000000000..9864b2b79bb7768789c766ac5f2c10deb94eace9 GIT binary patch literal 737 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 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_tabview.png b/components/lvgl/images/lvgl_tabview.png new file mode 100644 index 0000000000000000000000000000000000000000..ae18acf31a59a254690b250414f57bdadb3fc6b4 GIT binary patch literal 7993 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 literal 0 HcmV?d00001 diff --git a/components/lvgl/images/lvgl_textarea.png b/components/lvgl/images/lvgl_textarea.png new file mode 100644 index 0000000000000000000000000000000000000000..1382f7e10061ed79797ee3b8ef067dd5b6a9b662 GIT binary patch literal 4749 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 (Light and Versatile Graphics Library) is a free and open-source +embedded graphics library to create beautiful UIs for any MCU, MPU and display type. ESPHome supports `LVGL version 8 `__. + +.. figure:: /components/lvgl/images/lvgl_main_screenshot.png + +To use LVGL with a :ref:`display ` in ESPHome, you'll need an ESP32 or supported ESP32 variant. PSRAM is not a strict requirement but it is generally recommended, especially for color displays with resolutions larger than approximately 240x240 pixels. + +The graphic display should be configured with ``auto_clear_enabled: false`` and ``update_interval: never``, and should not have any ``lambda`` set. + +For interactivity, a :doc:`Touchscreen ` (capacitive highly preferred), a :doc:`/components/sensor/rotary_encoder` or a custom keypad made up from discrete :doc:`Binary Sensors ` can be used. + + +Basics +------ + +In LVGL, graphical elements like buttons, labels, sliders, etc. are called widgets or objects. See :doc:`/components/lvgl/widgets` for a complete list of widgets supported within ESPHome. Not all LVGL widgets are implemented, just those commonly used to support home automation needs/tasks. + +Every widget has a parent object where it is created. For example, if a label is created on a button, the button is the parent of the label. Complex widgets internally consist of several smaller/simpler widgets; these are known as parts, each of which can have separate properties from the main widget. + +Pages in ESPHome are implemented as LVGL screens, which are special objects which have no parent. There is always one active page on a display. + +Widgets can be assigned with an :ref:`config-id` so that they can be referenced in :ref:`automations `. + +Some widgets integrate also as native ESPHome components: + +.. list-table:: + :header-rows: 1 + :widths: 1 1 + + * - LVGL Widget + - ESPHome component + + * - ``button`` + - :doc:`Switch `, :doc:`Binary Sensor ` + + * - ``switch``, ``checkbox`` + - :doc:`Switch ` + + * - ``slider``, ``arc``, ``spinbox`` + - :doc:`Number `, :doc:`Sensor ` + + * - ``dropdown``, ``roller`` + - :doc:`Select ` + + * - ``label``, ``textarea`` + - :doc:`Text `, :doc:`Text Sensor ` + + * - ``led`` + - :doc:`Light ` + +These are useful with `Home Assistant automations `__ interacting directly with the widgets. + +Main Configuration +------------------ + +Although LVGL is a complex matrix of objects-parts-states-styles, ESPHome simplifies this into a hierarchy. + +At the highest level of the LVGL object hierarchy is the display (represented by the hardware driver). A display can have one or more pages associated with it. Each page contains a hierarchy of objects for graphical widgets representing a layout to be presented on the display. + +The following configuration variables apply to the main ``lvgl`` component, in order to establish the principal operating conditions. Some :ref:`styling options ` can be set at this level too, but only for inheritance purposes. + +**Configuration variables:** + +- **displays** (*Optional*, list, :ref:`config-id`): A list of display IDs where LVGL should perform rendering based on its configuration. This may be omitted if there is a single display configured, which will be used automatically. +- **touchscreens** (*Optional*, list): A list of touchscreens interacting with the LVGL widgets on the display. + - **touchscreen_id** (**Required**, :ref:`config-id`): ID of a touchscreen configuration related to a display. + - **long_press_time** (*Optional*, :ref:`Time `): For the touchscreen, delay after which the ``on_long_pressed`` :ref:`interaction trigger ` will be called. Defaults to ``400ms``. + - **long_press_repeat_time** (*Optional*, :ref:`Time `): For the touchscreen, repeated interval after ``long_press_time``, when ``on_long_pressed_repeat`` :ref:`interaction trigger ` will be called. Defaults to ``100ms``. +- **encoders** (*Optional*, list): A list of rotary encoders interacting with the LVGL widgets on the display. + - **group** (*Optional*, string): A name for a group of widgets which will interact with the the input device. See the :doc:`common properties ` of the widgets for more information on groups. + - **enter_button** (**Required**, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``ENTER`` key. + - **sensor** (*Optional*, :ref:`config-id`): The ID of a :doc:`/components/sensor/rotary_encoder`; or a list with buttons for left/right interaction with the widgets: + - **left_button** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``LEFT`` key. + - **right_button** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``RIGHT`` key. + - **long_press_time** (*Optional*, :ref:`Time `): For the rotary encoder, delay after which the ``on_long_pressed`` :ref:`interaction trigger ` will be called. Defaults to ``400ms``. Can be disabled with ``never``. + - **long_press_repeat_time** (*Optional*, :ref:`Time `): For the rotary encoder, repeated interval after ``long_press_time``, when ``on_long_pressed_repeat`` :ref:`interaction trigger ` will be called. Defaults to ``100ms``. Can be disabled with ``never``. +- **keypads** (*Optional*, list): A list of keypads interacting with the LVGL widgets on the display. + - **group** (*Optional*, string): A name for a group of widgets which will interact with the the input device. See the :doc:`common properties ` of the widgets for more information on groups. + - **up** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``UP`` key. + - **down** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``DOWN`` key. + - **right** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``RIGHT`` key. + - **left** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``LEFT`` key. + - **esc** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``ESC`` key. + - **del** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``DEL`` key. + - **backspace** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``BACKSPACE`` key. + - **enter** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``ENTER`` key. + - **next** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``NEXT`` key. + - **prev** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``PREV`` key. + - **home** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``HOME`` key. + - **end** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``END`` key. + - **long_press_time** (*Optional*, :ref:`Time `): For the keypad, delay after which the ``on_long_pressed`` :ref:`interaction trigger ` will be called. Defaults to ``400ms``. Can be disabled with ``never``. + - **long_press_repeat_time** (*Optional*, :ref:`Time `): For the keypad, repeated interval after ``long_press_time``, when ``on_long_pressed_repeat`` :ref:`interaction trigger ` will be called. Defaults to ``100ms``. Can be disabled with ``never``. + + .. tip:: + + When using binary sensors (from physical keys) to interact with LVGL, if there are only three keys available, they are best used when configured as a rotary encoder, where ``LEFT`` and ``RIGHT`` act like the rotary wheel, and ``ENTER`` generates an ``on_press`` :ref:`trigger `. With four or more keys, a keypad configuration is generally more appropriate. For example, a keypad consisting of five keys might use ``PREV``, ``NEXT``, ``UP``, ``DOWN`` and ``ENTER``; ``PREV``/``NEXT`` are used to select a widget within the group, ``UP``/``DOWN`` changes the selected value and ``ENTER`` generates an ``on_press`` :ref:`trigger `. + + The ``long_press_time`` and ``long_press_repeat_time`` can be fine-tuned also by setting them to ``never`` and using the ``autorepeat`` filter on each binary sensor separately. + +- **color_depth** (*Optional*, string): The color deph at which the contents are generated. Currently only ``16`` is supported (RGB565, 2 bytes/pixel), which is the default value. +- **buffer_size** (*Optional*, percentage): The percentage of screen size to allocate buffer memory. Default is ``100%`` (or ``1.0``). For devices without PSRAM, the recommended value is ``25%``. +- **log_level** (*Optional*, string): Set the logger level specifically for the messages of the LVGL library: ``TRACE``, ``INFO``, ``WARN``, ``ERROR``, ``USER``, ``NONE``. Defaults to ``WARN``. +- **byte_order** (*Optional*, int16): The byte order of the data LVGL outputs; either ``big_endian`` or ``little_endian``. Defaults to ``big_endian``. +- **disp_bg_color** (*Optional*, :ref:`color `): Solid color used to fill the background. Can be changed at runtime with the ``lvgl.update`` action. +- **disp_bg_image** (*Optional*, :ref:`image `): The ID of an existing image configuration, to be used as background wallpaper. To change the image at runtime use the ``lvgl.update`` action. Also see :ref:`lvgl-widget-image` for a note regarding supported image formats. +- **default_font** (*Optional*, ID): The ID of the :ref:`font ` used by default to render the text or symbols. Defaults to LVGL's internal ``montserrat_14`` if not specified. +- **style_definitions** (*Optional*, list): A batch of style definitions to use in LVGL widget's ``styles`` configuration. See :ref:`below ` for more details. +- **theme** (*Optional*, list): A list of styles to be applied to all widgets. See :ref:`below ` for more details. +- **widgets** (*Optional*, list): A list of :doc:`/components/lvgl/widgets` to be drawn on the root display. May not be used if ``pages`` (below) is configured. +- **pages** (*Optional*, list): A list of page IDs. Each page acts as a parent for widgets placed on it. May not be used with ``widgets`` (above). Options for each page: + - **skip** (*Optional*, boolean): Option to skip this page when navigating between them with :ref:`lvgl-page-next-previous-action`. + - **layout** (*Optional*): See :ref:`lvgl-layouts` for details. Defaults to ``NONE``. + - **widgets** (*Optional*, list): A list of :doc:`/components/lvgl/widgets` to be drawn on the page. + - All other options from :ref:`lvgl-styling` to be applied to this page. +- **page_wrap** (*Optional*, boolean): Wrap from the last to the first page when navigating between them with :ref:`lvgl-page-next-previous-action`. Defaults to ``true``. +- **top_layer** (*Optional*, list): A special kind of *Always on Top* page, which acts as a parent for widgets placed on it. It's shown above all the pages, which may be useful for widgets which always need to be visible. + - **layout** (*Optional*): See :ref:`lvgl-layouts` for details. Defaults to ``NONE``. + - **widgets** (*Optional*, list): A list of :doc:`/components/lvgl/widgets` to be drawn on the page. + - All other options from :ref:`lvgl-styling` to be applied to this page. +- **layout** (*Optional*): See :ref:`lvgl-layouts` for details. Defaults to ``NONE``. +- All other options from :ref:`lvgl-styling` to be applied to all widgets directly. + +**Example:** + +.. code-block:: yaml + + # Example configuration entry + lvgl: + displays: + - my_display + touchscreens: + - my_touch + pages: + - id: main_page + widgets: + - label: + align: CENTER + text: 'Hello World!' + + +.. _lvgl-color: + +Colors +****** + +Colors can be specified anywhere in the LVGL configuration either by referencing a preconfigured :ref:`ESPHome color ` ID or by representing the color in the common hexadecimal notation. For example, ``0xFF0000`` would be red. + +.. _lvgl-opacity: + +Opacity +******* + +Various parts of the widgets (like background, borders etc.) support opacity. It can be overridden with a string: ``TRANSP`` for fully transparent, ``COVER`` for fully opaque, or percentage between ``0%`` and ``100%``. Actual default values depend on widget specifics. + +.. _lvgl-fonts: + +Fonts +***** + +Two font choices are available: + +**ESPHome fonts** + +You can use :ref:`fonts configured normally`, the glyphs will be rendered while building the binary. This has the advantage that you can define custom sets of glyphs of any size, with icons or diacritic characters of your choice, for any language, from any TrueType/OpenType font, allowing a more optimal flash space usage because you don't need to include all glyphs for all sizes you wish to use. + +.. tip:: + + For best results, set ``bpp: 4`` to get the glyphs rendered with proper anti-aliasing. + + +**Library fonts** + +The LVGL library offers by default prerendered sets with ASCII characters (``0x20-0x7F``), the degree symbol (``0xB0``), the bullet symbol (``0x2022``) from `Montserrat Medium `__, and 60 symbols from `FontAwesome `__ (see below). You can use the IDs below when specifying the ``text_font`` parameter: + +- ``montserrat_8``: 8px font +- ``montserrat_10``: 10px font +- ``montserrat_12``: 12px font +- ``montserrat_14``: 14px font (**default**, included if ``default_font`` option is missing) +- ``montserrat_16``: 16px font +- ``montserrat_18``: 18px font +- ``montserrat_20``: 20px font +- ``montserrat_22``: 22px font +- ``montserrat_24``: 24px font +- ``montserrat_26``: 26px font +- ``montserrat_28``: 28px font +- ``montserrat_30``: 30px font +- ``montserrat_32``: 32px font +- ``montserrat_34``: 34px font +- ``montserrat_36``: 36px font +- ``montserrat_38``: 38px font +- ``montserrat_40``: 40px font +- ``montserrat_42``: 42px font +- ``montserrat_44``: 44px font +- ``montserrat_46``: 46px font +- ``montserrat_48``: 48px font + +The binary will only include any of the above if used in the configuration. + +You can display the embedded symbols among the text by their codepoint address preceded by ``\u``. For example: ``\uF00C``: + +.. figure:: /components/lvgl/images/lvgl_symbols.png + :align: center + +.. note:: + + The ``text_font`` parameter affects the size of symbols, since all the built-in font arrays based on Montserrat include these symbols at the respective sizes. If you set ``text_font`` on a widget to a custom ESPHome font, these symbols will likely not display, unless you include them manually from a FontAwesome OpenType file. + + For escape sequences to work, you have to put them in strings enclosed in double quotes. + +In addition to the above, the following special fonts are available from LVGL as built-in: + +- ``unscii_8``: 8 px pixel perfect font with only ASCII characters. +- ``unscii_16``: 16 px pixel perfect font with only ASCII characters. +- ``simsun_16_cjk``: 16 px font with normal range + 1000 most common `CJK Radicals `__. +- ``dejavu_16_persian_hebrew``: 16 px font with normal range + Hebrew, Arabic, Persian letters and all their forms. + +.. _lvgl-styling: + +Style properties +**************** + +LVGL follows CSS's `border-box model `__. A widget's *box* is built from the following parts: + +.. figure:: /components/lvgl/images/lvgl_boxmodel.png + :align: center + +- *bounding box*: the box defined with ``width`` and ``height`` of the widgets (pixels or parent content area percentage; not drawn, just for calculations). +- *border*: the border line, drawn on the inner side of the bounding box (pixels). +- *outline*: the outline, drawn on the outer side of the bounding box (pixels). +- *padding*: space to keep between the border of the widget and its content or children (*I don't want my children too close to my sides, so keep this space*). +- *content*: the content area which is the size of the bounding box reduced by the border width and padding (it's what's referenced as the ``SIZE_CONTENT`` option of certain widgets). + +You can adjust the appearance of widgets by changing their foreground, background, border color and/or font. Some widgets allow for more complex styling, effectively changing all or part of their appearance. + +**Styling variables:** + +- **bg_color** (*Optional*, :ref:`color `): Color for the background of the widget. Defaults to ``0xFFFFFF`` (white). +- **bg_grad_color** (*Optional*, :ref:`color `): Color to make the background gradually fade to. Defaults to ``0`` (black). +- **bg_dither_mode** (*Optional*, dict): Set dithering of the background gradient. One of ``NONE``, ``ORDERED``, ``ERR_DIFF``. Defaults to ``NONE``. +- **bg_grad_dir** (*Optional*, dict): Choose the direction of the background gradient: ``NONE``, ``HOR``, ``VER``. Defaults to ``NONE``. +- **bg_main_stop** (*Optional*, 0-255): Specify where the gradient should start: ``0`` = upper left, ``128`` = in the center, ``255`` = lower right. Defaults to ``0``. +- **bg_grad_stop** (*Optional*, 0-255): Specify where the gradient should stop: ``0`` = upper left, ``128`` = in the center, ``255`` = lower right. Defaults to ``255``. +- **opa** (*Optional*, :ref:`opacity `): Opacity of the entire widget. Inherited from parent. Defaults to ``COVER``. +- **bg_opa** (*Optional*, :ref:`opacity `): Opacity of the widget background. +- **opa_layered** (*Optional*, :ref:`opacity `): Opacity of the entire layer the widget is on. Inherited from parent. Defaults to ``COVER``. +- **bg_image_src** (*Optional*, :ref:`image `): The ID of an existing image configuration, to show as the background of the widget. +- **bg_image_opa** (*Optional*, :ref:`opacity `): Opacity of the background image of the widget. +- **bg_image_recolor** (*Optional*, :ref:`color `): Color to mix with every pixel of the background image of the widget. +- **bg_image_recolor_opa** (*Optional*, :ref:`opacity `): Opacity of the recoloring of the background image of the widget. +- **border_width** (*Optional*, int16): Set the width of the border in pixels. Defaults to ``0``. +- **border_color** (*Optional*, :ref:`color `): Color to draw borders of the widget. Defaults to ``0`` (black). +- **border_opa** (*Optional*, :ref:`opacity `): Opacity of the borders of the widget. Defaults to ``COVER``. +- **border_post** (*Optional*, boolean): If ``true`` the border will be drawn after all children of the widget have been drawn. Defaults to ``false``. +- **border_side** (*Optional*, list): Select which borders of the widgets to show (multiple can be specified as a YAML list, defaults to ``NONE``): + - ``NONE`` + - ``TOP`` + - ``BOTTOM`` + - ``LEFT`` + - ``RIGHT`` + - ``INTERNAL`` +- **radius** (*Optional*, uint16): The radius to be used to form the widget's rounded corners. 0 = no radius (square corners); 65535 = pill shaped widget (true circle if it has same width and height). +- **clip_corner** (*Optional*, boolean): If set to ``true``, overflowing content will be clipped off by the widget's rounded corners (``radius`` > ``0``). +- **outline_width** (*Optional*, int16): Set the width of the outline in pixels. Defaults to ``0``. +- **outline_color** (*Optional*, :ref:`color `): Color used to draw an outline around the widget. Defaults to ``0`` (black). +- **outline_opa** (*Optional*, :ref:`opacity `): Opacity of the outline of the widget. Defaults to ``COVER``. +- **outline_pad** (*Optional*, int16): Distance between the outline and the widget itself. Defaults to ``0``. +- **pad_all** (*Optional*, int16): Set the padding in all directions, in pixels. +- **pad_top** (*Optional*, int16): Set the padding on the top, in pixels. +- **pad_bottom** (*Optional*, int16): Set the padding on the bottom, in pixels. +- **pad_left** (*Optional*, int16): Set the padding on the left, in pixels. +- **pad_right** (*Optional*, int16): Set the padding on the right, in pixels. +- **pad_row** (*Optional*, int16): Set the padding between the rows of the children elements, in pixels. +- **pad_column** (*Optional*, int16): Set the padding between the columns of the children elements, in pixels. +- **shadow_color** (*Optional*, :ref:`color `): Color used to create a drop shadow under the widget. Defaults to ``0`` (black). +- **shadow_ofs_x** (*Optional*, int16): Horizontal offset of the shadow, in pixels. Defaults to ``0``. +- **shadow_ofs_y** (*Optional*, int16): Vertical offset of the shadow, in pixels. Defaults to ``0``. +- **shadow_opa** (*Optional*, :ref:`opacity `): Opacity of the shadow. Defaults to ``COVER``. +- **shadow_spread** (*Optional*, int16): Spread of the shadow, in pixels. Defaults to ``0``. +- **shadow_width** (*Optional*, int16): Width of the shadow, in pixels. Defaults to ``0``. +- **transform_angle** (*Optional*, 0-360): Transformation angle of the widget (eg. rotation) +- **transform_height** (*Optional*, int16 or percentage): Transformation height of the widget (eg. stretching) +- **transform_pivot_x** (*Optional*, int16): Horizontal anchor point of the transformation. Relative to the widget's top left corner. +- **transform_pivot_y** (*Optional*, int16): Vertical anchor point of the transformation. Relative to the widget's top left corner. +- **transform_zoom** (*Optional*, 0.1-10): Transformation zoom of the widget (eg. resizing) +- **translate_x** (*Optional*, int16 or percentage): Movement of the widget with this value in horizontal direction. +- **translate_y** (*Optional*, int16 or percentage): Movement of the widget with this value in vertical direction. + +.. _lvgl-theme: + +Themes +****** + +The widgets support lots of :ref:`lvgl-styling` to customize their appearance and behavior. + +You can configure a global theme for all widgets at the top level with the ``theme`` configuration variable. In the example below, all the ``arc``, ``slider`` and ``button`` widgets will, by default, use the styles and properties defined here. A combination of styles and :ref:`states ` can be chosen for every widget. + +.. code-block:: yaml + + lvgl: + theme: + arc: + scroll_on_focus: true + group: general + slider: + scroll_on_focus: true + group: general + button: + scroll_on_focus: true + group: general + border_width: 2 + outline_pad: 6 + pressed: + border_color: 0xFF0000 + checked: + border_color: 0xFFFF00 + focused: + border_color: 0x00FF00 + +Naturally, you can override these at the individual configuration level of each widget. This can be done in batches, using the ``style_definitions`` configuration variable of the main component. +In the example below, you defined ``date_style``: + +.. code-block:: yaml + + lvgl: + style_definitions: + - id: date_style # choose an ID for your definition + text_font: unscii_8 + align: center + text_color: 0x000000 + bg_opa: cover + radius: 4 + pad_all: 2 + +And then you apply these selected styles to two labels, and only change very specific style ``y`` locally: + +.. code-block:: yaml + + widgets: + - label: + id: day_label + styles: date_style # apply the definition here by the ID chosen above + y: -20 + - label: + id: date_label + styles: date_style + y: +20 + +Additionally, you can change the styles based on the :ref:`state ` property of the widgets or their parts. If you want to set a property for all states (e.g. red background color) just set it for the default state at the root of the widget. If the widget can't find a property for its current state it will fall back to this. + +In the example below, you have an ``arc`` with some styles set here. Note how you change the ``arc_color`` of the ``indicator`` part, based on state changes: + +.. code-block:: yaml + + - arc: + id: my_arc + value: 75 + min_value: 1 + max_value: 100 + indicator: + arc_color: 0xF000FF + pressed: + arc_color: 0xFFFF00 + focused: + arc_color: 0x808080 + +So the precedence happens like this: state based styles override the locally specified styles, which override the style definitions, which override the theme, which overrides the top level styles. The value precedence of states is quite intuitive and it's something the user would expect naturally. For example, if a widget is focused the user will still want to see if it's pressed, therefore the pressed state has a higher precedence. (If the focused state had a higher precedence it would override the *pressed* color, defeating its purpose.) + +Feel free to experiment to discover inheritance and precedence of the styles based on states between the nested widgets. + + +.. _lvgl-layouts: + +Layouts +******* + +Layouts aim to position widgets automatically, eliminating the need to specify ``x`` and ``y`` coordinates to position each widget. This is a great way to simplify your configuration as it allows you to omit alignment options. + +The layout configuration options are applied to any parent widget or page, influencing the appearance of the children. The position and size calculated by the layout overwrites the *normal* ``x``, ``y``, ``width``, and ``height`` settings of the children. + + +The ``hidden``, ``ignore_layout`` and ``floating`` :ref:`flags ` can be used on widgets to ignore them in layout calculations. + +**Configuration variables:** + +- **layout** (*Optional*, dict): A dictionary describing the layout configuration: + - **type** (*Optional*, string): ``FLEX``, ``GRID`` or ``NONE``. Defaults to ``NONE``. + - Further options from below depending on the chosen type. + +**Flex** + +The Flex layout in LVGL is a subset implementation of `CSS Flexbox `__. + +It can arrange items into rows or columns (tracks), handle wrapping, adjust spacing between items and tracks and even handle growing the layout to make the item(s) fill the remaining space with respect to minimum/maximum width and height. + +**Terms used:** + +- *track*: the rows or columns *main* direction flow: row or column in the direction in which the items are placed one after the other. +- *cross direction*: perpendicular to the main direction. +- *wrap*: if there is no more space in the track a new track is started. +- *gap*: the space between the rows and columns or the items on a track. +- *grow*: if set on an item it will grow to fill the remaining space on the track. The available space will be distributed among items respective to their grow value (larger value means more space). It dictates what amount of the available space the widget should take up. For example if all items on the track have a ``grow`` set to ``1``, the space in the track will be distributed equally to all of them. If one of the items has a value of 2, that one would take up twice as much of the space as either one of the others. + +**Configuration variables:** + + - **flex_flow** (*Optional*, string): Select the arrangement of the children widgets: + - ``ROW``: place the children in a row without wrapping. + - ``COLUMN``: place the children in a column without wrapping. + - ``ROW_WRAP``: place the children in a row with wrapping (default). + - ``COLUMN_WRAP``: place the children in a column with wrapping. + - ``ROW_REVERSE``: place the children in a row without wrapping but in reversed order. + - ``COLUMN_REVERSE``: place the children in a column without wrapping but in reversed order. + - ``ROW_WRAP_REVERSE``: place the children in a row with wrapping but in reversed order. + - ``COLUMN_WRAP_REVERSE``: place the children in a column with wrapping but in reversed order. + + - **flex_align_main** (*Optional*, string): Determines how to distribute the items in their track on the *main* axis. For example, flush the items to the right on with ``flex_flow: ROW_WRAP`` (known as *justify-content* in CSS). Possible options below. + - **flex_align_cross** (*Optional*, string): Determines how to distribute the items in their track on the *cross* axis. For example, if the items have different height place them to the bottom of the track (known as *align-items* in CSS). Possible options below. + - **flex_align_track** (*Optional*, string): Determines how to distribute the tracks (known as *align-content* in CSS). Possible options below. + + Values for use with ``flex_align_main``, ``flex_align_cross``, ``flex_align_track``: + + - ``START``: means left horizontally and top vertically (default). + - ``END``: means right horizontally and bottom vertically. + - ``CENTER``: simply center. + - ``SPACE_EVENLY``: items are distributed so that the spacing between any two items (and the space to the edges) is equal. Does not apply to ``flex_align_track``. + - ``SPACE_AROUND``: items are evenly distributed in the track with equal space around them. Note that visually the spaces aren’t equal, since all the items have equal space on both sides. The first item will have one unit of space against the container edge, but two units of space between the next item because that next item has its own spacing that applies. Does not apply to ``flex_align_track``. + - ``SPACE_BETWEEN``: items are evenly distributed in the track: first item is on the start line, last item on the end line. Does not apply to ``flex_align_track``. + + - **pad_row** (*Optional*, int16): Set the padding between the rows, in pixels. + - **pad_column** (*Optional*, int16): Set the padding between the columns, in pixels. + - **flex_grow** (*Optional*, int16): Flex grow can be used to make one or more children fill the available space on the track. When more children have grow parameters, the available space will be distributed proportionally to the grow values. Defaults to ``0``, which disables growing. + +**Grid** + +The Grid layout in LVGL is a subset implementation of `CSS Flexbox `__. + +It can arrange items into a 2D "table" that has rows or columns (tracks). The item(s) can span through multiple columns or rows. The track's size can be set in pixels, to the largest item of the track (``CONTENT``) or in "free units" to distribute the free space proportionally. + +**Terms used:** + +- *tracks*: the rows or the columns. +- *gap*: the space between the rows and columns or the items on a track. +- *free unit (FR)*: a proportional distribution unit for the space available on the track. It accepts a unitless integer value that serves as a proportion. It dictates what amount of the available space the widget should take up. For example if all items on the track have a ``FR`` set to ``1``, the space in the track will be distributed equally to all of them. If one of the items has a value of 2, that one would take up twice as much of the space as either one of the others. + +**Configuration variables:** + + - **grid_rows** (**Required**): The number of rows in the grid, expressed a list of values in pixels, ``CONTENT`` or ``FR(n)`` (free units, where ``n`` is a proportional integer value). + - **grid_columns** (**Required**): The number of columns in the grid, expressed a list of values in pixels, ``CONTENT`` or ``FR(n)`` (free units, where ``n`` is a proportional integer value). + - **grid_row_align** (*Optional*, string): How to align the row. Works only when ``grid_rows`` is given in pixels. Possible options below. + - **grid_column_align** (*Optional*, string): How to align the column. Works only when ``grid_columns`` is given in pixels. Possible options below. + - **pad_row** (*Optional*, int16): Set the padding between the rows, in pixels. + - **pad_column** (*Optional*, int16): Set the padding between the columns, in pixels. + +In a grid layout, *all the widgets placed on the grid* will get some additional configuration variables to help with placement: + + - **grid_cell_row_pos** (**Required**, int16): Position of the widget, in which row to appear (0 based count). + - **grid_cell_column_pos** (**Required**, int16): Position of the widget, in which column to appear (0 based count). + - **grid_cell_x_align** (*Optional*, string): How to align the widget horizontally within the cell. Can also be applied through :ref:`lvgl-styling`. Possible options below. + - **grid_cell_y_align** (*Optional*, string): How to align the widget vertically within the cell. Can also be applied through :ref:`lvgl-styling`. Possible options below. + - **grid_cell_row_span** (*Optional*, int16): How many rows to span across the widget. Defaults to ``1``. + - **grid_cell_column_span** (*Optional*, int16): How many columns to span across the widget. . Defaults to ``1``. + + .. note:: + + These ``grid_cell_`` variables apply to widget configuations! + +Values for use with ``grid_column_align``, ``grid_row_align``, ``grid_cell_x_align``, ``grid_cell_y_align``: + + - ``START``: means left horizontally and top vertically (default). + - ``END``: means right horizontally and bottom vertically. + - ``CENTER``: simply center. + - ``STRETCH``: stretch the widget to the cell in the respective direction. Does not apply to ``grid_column_align``, ``grid_row_align``. + - ``SPACE_EVENLY``: items are distributed so that the spacing between any two items (and the space to the edges) is equal. + - ``SPACE_AROUND``: items are evenly distributed in the track with equal space around them. Note that visually the spaces aren’t equal, since all the items have equal space on both sides. The first item will have one unit of space against the container edge, but two units of space between the next item because that next item has its own spacing that applies. + - ``SPACE_BETWEEN``: items are evenly distributed in the track: first item is on the start line, last item on the end line. + +.. tip:: + + To visualize real, calculated sizes of transparent widgets you can temporarily set ``outline_width: 1`` on them. + +Widgets +******* + +LVGL supports a list of :doc:`/components/lvgl/widgets` which can be used to draw interactive objects on the screen. + +Actions +------- + +Widgets support :ref:`general or specific ` actions. +Several actions are available for LVGL, these are outlined below. + +.. _lvgl-redraw-action: + +``lvgl.widget.redraw`` +********************** + +This :ref:`action ` redraws the entire screen, or optionally only a widget on it. + +- **id** (*Optional*): The ID of a widget configured in LVGL which you want to redraw; if omitted, the entire screen will be redrawn. + +.. code-block:: yaml + + on_...: + then: + - lvgl.widget.redraw: + +.. _lvgl-pause-action: + +``lvgl.pause`` +************** + +This :ref:`action ` pauses the activity of LVGL, including rendering. + +- **show_snow** (*Optional*, boolean): When paused, display random colored pixels across the entire screen in order to minimize screen burn-in, to relief the tension put on each individual pixel. + +.. code-block:: yaml + + on_...: + then: + - lvgl.pause: + show_snow: true + +.. _lvgl-resume-action: + +``lvgl.resume`` +*************** + +This :ref:`action ` resumes the activity of LVGL, including rendering. + +.. code-block:: yaml + + on_...: + then: + - lvgl.resume: + +``lvgl.update`` +*************** + +This :ref:`action ` allows changing/updating the ``disp_bg_color`` or ``disp_bg_image`` configuration variables of the main component, making it possible to change the background color or wallpaper at any time. + +.. code-block:: yaml + + # Examples: + on_...: + then: + - lvgl.update: + disp_bg_color: 0x0000FF + - lvgl.update: + disp_bg_image: cat_image + +.. _lvgl-page-next-previous-action: + +``lvgl.page.next``, ``lvgl.page.previous`` +****************************************** + +This :ref:`action ` changes the page to the next/previous based on the configuration (pages with their ``skip`` option enabled are...skipped). Page changes will wrap around at the end. + +- **animation** (*Optional*): Animate page changes as specified. One of: ``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``. Defaults to ``NONE``. +- **time** (*Optional*, :ref:`Time `): Duration of the page change animation. Defaults to ``50ms``. + +.. code-block:: yaml + + on_...: + then: + - lvgl.page.next: + animation: OUT_LEFT + time: 300ms + + on_...: + then: + - lvgl.page.previous: + animation: OUT_RIGHT + time: 300ms + +.. _lvgl-page-show-action: + +``lvgl.page.show`` +****************** + +This :ref:`action ` shows a specific page (including pages with their ``skip`` option enabled). + +- **id** (**Required**): The ID of the page to be shown. +- **animation** (*Optional*): Animate page changes as specified. One of: ``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``. Defaults to ``NONE``. +- **time** (*Optional*, :ref:`Time `): Duration of the page change animation. Defaults to ``50ms``. + +.. code-block:: yaml + + on_...: + then: + - lvgl.page.show: + id: secret_page + + on_...: + then: + - lvgl.page.show: secret_page # shorthand version + +.. _lvgl-conditions: + +Conditions +---------- + +.. _lvgl-is-idle-condition: + +``lvgl.is_idle`` +**************** + +This :ref:`condition ` checks if the amount of time specified has passed since the last touch event. + +- **timeout** (**Required**, :ref:`templatable `, int): Amount of :ref:`time ` expected since the last touch event. + +.. code-block:: yaml + + # In some trigger: + on_...: + then: + - if: + condition: lvgl.is_idle + timeout: 5s + then: + - light.turn_off: + id: display_backlight + transition_length: 3s + +.. _lvgl-is-paused-condition: + +``lvgl.is_paused`` +****************** + +This :ref:`condition ` checks if LVGL is in the paused state or not. + +.. code-block:: yaml + + # In some trigger: + on_...: + then: + - if: + condition: lvgl.is_paused + then: + - lvgl.resume: + +Triggers +-------- + +Widget level :ref:`interaction triggers ` can be configured universally, or depending on the widtget functionality. + +.. _lvgl-on-idle-trigger: + +``lvgl.on_idle`` +**************** + +LVGL has a notion of screen inactivity -- in other words, the time since the last user interaction with the screen is tracked. This can be used to dim the display backlight or turn it off after a moment of inactivity (like a screen saver). Every use of an input device (touchscreen, rotary encoder) counts as an activity and resets the inactivity counter. + +The ``on_idle`` :ref:`triggers ` are activated when inactivity time becomes longer than the specified ``timeout``. You can configure any desired number of timeouts with different actions. + +- **timeout** (**Required**, :ref:`templatable `, int): :ref:`Time ` that has elapsed since the last touch event, after which you want your actions to be performed. + +.. code-block:: yaml + + lvgl: + ... + on_idle: + - timeout: 30s + then: + - lvgl.page.show: main_page + - timeout: 60s + then: + - light.turn_off: display_backlight + - lvgl.pause: + + +See Also +-------- + +.. toctree:: + :maxdepth: 1 + :glob: + + * + +- :doc:`/components/display/index` +- :doc:`/components/touchscreen/index` +- :doc:`/components/sensor/rotary_encoder` +- `LVGL docs `__ +- :ghedit:`Edit` diff --git a/components/lvgl/widgets.rst b/components/lvgl/widgets.rst new file mode 100644 index 000000000..1700ee2b3 --- /dev/null +++ b/components/lvgl/widgets.rst @@ -0,0 +1,1788 @@ +LVGL Widgets +============ + +At the next level of the LVGL object hierarchy are the widgets, which support styling directly. They can have sub-parts, which may be styled separately. Usually styles are inherited, but this depends on widget specifics or functionality. The widget and its parts have states, and different styling can be set for different states. + +Widgets can have children, which can be any other widgets. Think of this as a nested structure. The child widgets move with the parent and, if the parent is hidden, its children will also be hidden. + +By default, LVGL draws new widgets on top of old widgets, including their children. When widgets have children, property inheritance takes place. Some properties (typically those related to text and opacity) can be inherited from the parent widgets's styles. When the property is inheritable, the parent will be searched for an object which specifies a value for the property. The parents will use their own :ref:`state ` to determine the value. For example, if a button is pressed and the text color is defined by the "pressed" state, this "pressed" text color will be used. + +Common properties +----------------- + +The properties below are common to all widgets. + +**Configuration variables:** + +- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. +- **x** (*Optional*, int16 or percentage): Horizontal position of the widget. +- **y** (*Optional*, int16 or percentage): Vertical position of the widget. + +.. note:: + + By default, the ``x`` and ``y`` coordinates are measured from the *top left corner* of the parent's content area. :ref:`Important `: content area starts *after the padding* thus if the parent has a non-zero padding value, position will be shifted with that. Percentage values are calculated from the parent's content area size. + + If specifying ``align``, ``x`` and ``y`` can be used as an offset to the calculated position (can also be negative). They are ignored if :ref:`lvgl-layouts` are used on the parent. + +- **height** (*Optional*): Height of the widget in pixels or a percentage, or ``SIZE_CONTENT``. +- **width** (*Optional*): Width of the widget in pixels or a percentage, or ``SIZE_CONTENT``. + +.. note:: + + The size settings support a special value: ``SIZE_CONTENT``. It means the widget's size in the respective direction will be set to the size of its children. Note that only children on the right and bottom sides will be considered and children on the top and left remain cropped. This limitation makes the behavior more predictable. Widgets with ``hidden`` or ``floating`` flags will be ignored by the ``SIZE_CONTENT`` calculation. + + Similarly to CSS, LVGL also supports ``min_width``, ``max_width``, ``min_height`` and ``max_height``. These are limits preventing a widget's size from becoming smaller/larger than these values. They are especially useful if the size is set by percentage or ``SIZE_CONTENT``. + +- **min_width**, **max_width**, **min_height**, **max_height** (*Optional*, int16 or percentage): Sets a minimal/maximal width or a minimal/maximal height. Pixel and percentage values can be used. Percentage values are relative to the dimensions of the parent's content area. Defaults to ``0%``. +- **scrollbar_mode** (*Optional*, string): If a child widget is outside its parent content area (the size without padding), the parent can become scrollable (see the ``scrollable`` :ref:`flag `). The widget can either be scrolled horizontally or vertically in one stroke. Scroll bars can appear depending on the setting: + - ``"OFF"``: Never show the scroll bars (use the double quotes!). + - ``"ON"``: Always show the scroll bars (use the double quotes!). + - ``"ACTIVE"``: Show scroll bars while a widget is being scrolled. + - ``"AUTO"``: Show scroll bars when the content is large enough to be scrolled (default). + +- **align** (*Optional*, dict): Alignment of the of the widget relative to the parent. A child widget is clipped to its parent boundaries. One of the values *not* starting with ``OUT_`` (see picture below). +- **align_to** (*Optional*, list): Alignment of the of the widget relative to another widget on the same level: + - **id** (**Required**): The ID of a widget *to* which you want to align. + - **align** (**Required**, string): Desired alignment (one of the values starting with ``OUT_``). + - **x** (*Optional*, int16 or percentage): Horizontal offset position. Default ``0``. + - **y** (*Optional*, int16 or percentage): Vertical offset position. Default ``0``. + +.. figure:: /components/lvgl/images/lvgl_align.png + :align: center + +- **group** (*Optional*, string): The name of the group of widgets which will interact with a :doc:`/components/sensor/rotary_encoder`. In every group there is always one focused widget which receives the encoder actions. You need to associate an input device with a group. An input device can send key events to only one group but a group can receive data from more than one input device. If no group is specified for a widget or an encoder, an unnamed default group will be assigned, so in most cases where only one encoder is used it will not be necessary to explicitly specify a group. +- **layout** (*Optional*): See :ref:`lvgl-layouts` for details. Defaults to ``NONE``. +- **styles** (*Optional*, :ref:`config-id`): The ID of a *style definition* from the main component configuration to override the theme styles. +- **theme** (*Optional*, list): A list of styles to apply to the widget and children. Same configuration option as at the main component. +- **widgets** (*Optional*, list): A list of LVGL widgets to be drawn as children of this widget. Same configuration option as at the main component. + +.. _lvgl-widgetproperty-state: + +- **state** (*Optional*, dict): Widgets or their (sub)parts can have have states, which support separate styling. These state styles inherit from the theme, but can be locally set or overridden within style definitions. Can be one of: + - **checked** (*Optional*, boolean): Toggled or checked state. + - **default** (*Optional*, boolean): Normal, released state. + - **disabled** (*Optional*, boolean): Disabled state (also usable with :ref:`shorthand ` actions ``lvgl.widget.enable`` and ``lvgl.widget.disable``). + - **edited** (*Optional*, boolean): Edit by an encoder. + - **focus_key** (*Optional*, boolean): Focused via keypad or encoder but *not* via touch screen. + - **focused** (*Optional*, boolean): Focused via keypad or encoder or clicked via touch screen. + - **pressed** (*Optional*, boolean): Being pressed. + - **scrolled** (*Optional*, boolean): Being scrolled. + - **user_1**, **user_2**, **user_3**, **user_4** (*Optional*, boolean): Custom states. + +By default, states are all ``false``, and they are templatable. +To apply styles to the states, you need to specify them one level above, for example: + +.. code-block:: yaml + + - button: + checkable: true + state: + checked: true # here you activate the state to be used at boot + checked: + bg_color: 0x00FF00 # here you apply styles to be used when in the respective state + +The state itself can be can be changed by interacting with the widget, or through :ref:`actions ` with ``lvgl.widget.update``. + +.. _lvgl-widget-flags: + +In addition to visual styling, each widget supports some boolean **flags** to influence the behavior: + +- **adv_hittest** (*Optional*, boolean): allow performing more accurate hit (click) test. For example, may help by accounting for rounded corners. +- **checkable** (*Optional*, boolean): toggle checked state when the widget is clicked. +- **click_focusable** (*Optional*, boolean): add focused state to the widget when clicked. +- **clickable** (*Optional*, boolean): make the widget clickable by input devices. Defaults to ``true``. If ``false``, it will pass the click to the widgets behind it (clicking through). +- **event_bubble** (*Optional*, boolean): propagate the events to the parent. +- **floating** (*Optional*, boolean): do not scroll the widget when the parent scrolls and ignore layout. +- **gesture_bubble** (*Optional*, boolean): propagate the gestures to the parent. +- **hidden** (*Optional*, boolean): make the widget hidden (like it wasn't there at all), also usable with :ref:`shorthand ` actions ``lvgl.widget.show`` and ``lvgl.widget.hide``. Hidden objects are ignored in layout calculations. Defaults to ``false``. +- **ignore_layout** (*Optional*, boolean): the widget is simply ignored by the layouts. Its coordinates can be set as usual. +- **layout_1**, **layout_2** (*Optional*, boolean): custom flags, free to use by layouts. +- **overflow_visible** (*Optional*, boolean): do not clip the children's content to the parent's boundary. +- **press_lock** (*Optional*, boolean): keep the widget pressed even if the press slid from the widget. +- **scroll_chain simple** (*Optional*, boolean): packaging for (``scroll_chain_hor | scroll_chain_ver``). +- **scroll_chain_hor** (*Optional*, boolean): allow propagating the horizontal scroll to a parent. +- **scroll_chain_ver** (*Optional*, boolean): allow propagating the vertical scroll to a parent. +- **scroll_elastic** (*Optional*, boolean): allow scrolling inside but with slower speed. +- **scroll_momentum** (*Optional*, boolean): make the widget scroll further when "thrown". +- **scroll_on_focus** (*Optional*, boolean): automatically scroll widget to make it visible when focused. +- **scroll_one** (*Optional*, boolean): allow scrolling only on ``snappable`` children. +- **scroll_with_arrow** (*Optional*, boolean): allow scrolling the focused widget with arrow keys. +- **scrollable** (*Optional*, boolean): the widget can become scrollable. Defaults to ``true`` (also see the ``scrollbar_mode`` property). +- **snappable** (*Optional*, boolean): if scroll snap is enabled on the parent it can snap to this widget. +- **user_1**, **user_2**, **user_3**, **user_4** (*Optional*, boolean): custom flags, free to use by user. +- **widget_1**, **widget_2** (*Optional*, boolean): custom flags, free to use by widget. + +.. note:: + + LVGL only supports **integers** for numeric ``value``. Visualizer widgets can't display floats directly, but they allow scaling by 10s. + +.. _lvgl-widget-animimg: + +``animimg`` +----------- + +The animation image is similar to the normal ``image`` widget. The main difference is that instead of one source image, you set a list of multiple source images. You can also specify a duration and a repeat count. + +.. figure:: /components/lvgl/images/lvgl_animimg.gif + :align: center + +**Configuration variables:** + +- **src** (**Required**, list of :ref:`images `): A list of IDs of existing image configurations to be loaded as frames of the animation. +- **auto_start** (*Optional*, boolean): Start the animation playback automatically at boot and when updating the widget. Defaults to ``true``. +- **duration** (**Required**, :ref:`Time `): Total duration of a playback cycle (each frame is displayed for an equal amount of time). +- **repeat_count** (*Optional*, int16 or *forever*): The number of times playback should be repeated. Defaults to ``forever``. +- Some style options from :ref:`lvgl-styling` for the background rectangle that uses the typical background style properties and the image itself using the image style properties. + +**Actions:** + +- ``lvgl.animimg.start`` :ref:`action ` starts the animation playback if it was displayed with ``auto_start`` false or after ``repeat_count`` expired. + - **id** (**Required**): The ID or a list of IDs of animimg widgets which you want start. + +- ``lvgl.animimg.stop`` :ref:`action ` stops the animation playback. + - **id** (**Required**): The ID or a list of IDs of animimg widgets which you want stop. + +- ``lvgl.animimg.update`` :ref:`action ` can be used to change ``repeat_count`` and ``duration``, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. ``src`` and ``auto_start`` cannot be updated at runtime. + - **id** (**Required**): The ID or a list of IDs of animimg widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - animimg: + align: CENTER + id: anim_id + src: [ cat_image, cat_image_bowtie ] + duration: 1000ms + + # Example actions: + on_...: + then: + - lvgl.animimg.update: + id: anim_id + repeat_count: 100 + duration: 300ms + +.. _lvgl-widget-arc: + +``arc`` +------- + +The arc consists of a background and a foreground arc. The indicator foreground can be touch-adjusted with a knob. + +.. figure:: /components/lvgl/images/lvgl_arc.png + :align: center + +**Configuration variables:** + +- **adjustable** (*Optional*, boolean): Add a knob that the user can move to change the value. Defaults to ``false``. +- **arc_color** (*Optional*, :ref:`color `): Color used to draw the arc. +- **arc_opa** (*Optional*, :ref:`opacity `): Opacity of the arc. +- **arc_rounded** (*Optional*, boolean): Make the end points of the arcs rounded. ``true`` rounded, ``false`` perpendicular line ending. +- **arc_width** (*Optional*, int16): Set the width of the arcs in pixels. +- **change_rate** (*Optional*, int8): If the arc is pressed the current value will set with a limited speed according to the set change rate. The change rate is defined in degree/second. Defaults to ``720``. +- **end_angle** (*Optional*, 0-360): end angle of the arc background (see note). Defaults to ``45``. +- **indicator** (*Optional*, list): Settings for the indicator *part* to show the value. Supports a list of :ref:`styles ` and state-based styles to customize. Draws *another arc using the arc style* properties. Its padding values are interpreted relative to the background arc. +- **knob** (*Optional*, list): Settings for the knob *part* to control the value. Supports a list of :ref:`styles ` and state-based styles to customize. Draws a handle on the end of the indicator using all background properties and padding values. With zero padding the knob size is the same as the indicator's width. Larger padding makes it larger, smaller padding makes it smaller. +- **max_value** (*Optional*, int8): Maximum value of the indicator. Defaults to ``100``. +- **min_value** (*Optional*, int8): Minimum value of the indicator. Defaults to ``0``. +- **mode** (*Optional*, string): ``NORMAL``: the indicator is drawn from the minimum value to the current. ``REVERSE``: the indicator is drawn counter-clockwise from the maximum value to the current. ``SYMMETRICAL``: the indicator is drawn from the middle point to the current value. Defaults to ``NORMAL``. +- **rotation** (*Optional*, 0-360): Offset to the 0 degree position. Defaults to ``0.0``. +- **start_angle** (*Optional*, 0-360): start angle of the arc background (see note). Defaults to ``135``. +- **value** (**Required**, int8): Actual value of the indicator at start, in ``0``-``100`` range. Defaults to ``0``. +- Any :ref:`Styling ` and state-based option to override styles inherited from parent. The arc's size and position will respect the padding style properties. + +If the ``adv_hittest`` :ref:`flag ` is enabled the arc can be clicked through in the middle. Clicks are recognized only on the ring of the background arc. + +.. note:: + + The zero degree position is at the middle right (3 o'clock) of the widget and the degrees increase in a clockwise direction from there. Angles are specified in the ``0``-``360`` range. + +**Actions:** + +- ``lvgl.arc.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of arc widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated when the knob changes the value of the arc. The new value is returned in the variable ``x``. +- :ref:`interaction ` LVGL event triggers which also return the value in ``x``. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - arc: + x: 10 + y: 10 + id: arc_id + value: 75 + min_value: 0 + max_value: 100 + adjustable: true + + # Example action: + on_...: + then: + - lvgl.arc.update: + id: arc_id + knob: + bg_color: 0x00FF00 + value: 55 + + # Example trigger: + - arc: + ... + on_value: + - logger.log: + format: "Arc value is: %.0f" + args: [ 'x' ] + +.. note:: + + The ``on_value`` trigger is sent as the arc knob is dragged or changed with keys. The event is sent *continuously* while the arc knob is being dragged; this generally has a negative effect on performance. To mitigate this, consider using a :ref:`universal interaction trigger ` like ``on_release``, to get the ``x`` variable once after the interaction has completed. + +The ``arc`` can be also integrated as :doc:`Number ` or :doc:`Sensor ` component. + +.. _lvgl-widget-bar: + +``bar`` +------- + +The bar widget has a background and an indicator foreground on it. The size of the indicator is set according to the current ``value`` of the bar. + +.. figure:: /components/lvgl/images/lvgl_bar.png + :align: center + +Vertical bars can be created if the width is smaller than the height. + +Not only the end, but also the start value of the bar can be set, which changes the start position of the indicator. + +**Configuration variables:** + +- **anim_time** (*Optional*, :ref:`Time `): Sets the animation time if the value is set with ``animated: true``. +- **animated** (*Optional*, boolean): Animate the indicator when the bar changes value. Defaults to ``true``. +- **indicator** (*Optional*, list): Settings for the indicator *part* to show the value. Supports a list of :ref:`styles ` and state-based styles to customize, all the typical background properties. +- **max_value** (*Optional*, int8): Maximum value of the indicator. Defaults to ``100``. +- **min_value** (*Optional*, int8): Minimum value of the indicator. Defaults to ``0``. +- **mode** (*Optional*, string): ``NORMAL``: the indicator is drawn from the minimum value to the current. ``REVERSE``: the indicator is drawn counter-clockwise from the maximum value to the current. ``SYMMETRICAL``: the indicator is drawn from the middle point to the current value. Defaults to ``NORMAL``. +- **value** (**Required**, int8): Actual value of the indicator at start, in ``0``-``100`` range. Defaults to ``0``. +- Style options from :ref:`lvgl-styling`. The background of the bar and it uses the typical background style properties. Adding padding will make the indicator smaller or larger. + +**Actions:** + +- ``lvgl.bar.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of bar widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - bar: + x: 10 + y: 100 + id: bar_id + value: 75 + min_value: 1 + max_value: 100 + + # Example action: + on_...: + then: + - lvgl.bar.update: + id: bar_id + value: 55 + +The ``bar`` can be also integrated as :doc:`Number ` or :doc:`Sensor ` component. + +.. _lvgl-widget-button: + +``button`` +---------- + +Simple push (momentary) or toggle (two-states) button. + +.. figure:: /components/lvgl/images/lvgl_button.png + :align: center + +**Configuration variables:** + +- **checkable** (*Optional*, boolean): A significant :ref:`flag ` to make a toggle button (which remains pressed in ``checked`` state). Defaults to ``false``. +- Style options from :ref:`lvgl-styling` for the background of the button. Uses the typical background style properties. + +A notable state is ``checked`` (boolean) which can have different styles applied. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated after clicking. If ``checkable`` is ``true``, the boolean variable ``x``, representing the checked state, may be used by lambdas within this trigger. +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - button: + x: 10 + y: 10 + width: 50 + height: 30 + id: btn_id + +To have a button with a text label on it, add a child :ref:`lvgl-widget-label` widget to it: + +.. code-block:: yaml + + # Example toggle button with text: + - button: + x: 10 + y: 10 + width: 70 + height: 30 + id: btn_id + checkable: true + widgets: + - label: + align: center + text: "Light" + + # Example trigger: + - button: + ... + on_value: + then: + - logger.log: + format: "Button checked state: %d" + args: [ x ] + +The ``button`` can be also integrated as a :doc:`Binary Sensor ` or as a :doc:`Switch ` component. + +.. _lvgl-widget-buttonmatrix: + +``buttonmatrix`` +---------------- + +The button matrix widget is a lightweight way to display multiple buttons in rows and columns. It's lightweight because the buttons are not actually created but instead simply drawn on the fly. This reduces the memory footprint of each button from approximately 200 bytes (for both the button and its label widget) down to only eight bytes. + +.. figure:: /components/lvgl/images/lvgl_buttonmatrix.png + :align: center + +**Configuration variables:** + +- **rows** (**Required**, list): A list for the button rows: + - **buttons** (**Required**, list): A list of buttons in a row: + - **id** (*Optional*): An ID for the button in the matrix. + - **key_code** (*Optional*, string): One character be sent as the key code to a :ref:`key_collector` instead of ``text`` when the button is pressed. + - **selected** (*Optional*, boolean): Set the button as the most recently released or focused. Defaults to ``false``. + - **text** (*Optional*): Text (or built-in :ref:`symbol ` codepoint) to display on the button. + - **width** (*Optional*): Width relative to the other buttons in the same row. Must be a value between ``1`` and ``15``; the default is ``1`` (for example, given a line with two buttons, one with ``width: 1`` and another one with ``width: 2``, the first will be ``33%`` wide while the second will be ``66%`` wide). + - **control** (*Optional*): Binary flags to control behavior of the buttons (all ``false`` by default): + - **checkable** (*Optional*, boolean): Enable toggling of a button, ``checked`` state will be added/removed as the button is clicked. + - **checked** (*Optional*, boolean): Make the button checked. Apply ``checked`` styles to the button. + - **click_trig** (*Optional*, boolean): Control how to :ref:`trigger ` ``on_value`` : if ``true`` on *click*, if ``false`` on *press*. + - **custom_1** and **custom_2** (*Optional*, boolean): Custom, free to use flags. + - **disabled** (*Optional*, boolean): Apply ``disabled`` styles to the button. + - **hidden** (*Optional*, boolean): Make a button hidden (hidden buttons still take up space in the layout, they are just not visible or clickable). + - **no_repeat** (*Optional*, boolean): Disable repeating when the button is long pressed. + - **popover** (*Optional*, boolean): Show the button label in a popover when pressing this button. + - **recolor** (*Optional*, boolean): Enable recoloring of button text with ``#``. For example: ``It's #FF0000 red#`` + +- **items** (*Optional*, list): Settings for the items *part*, the buttons all use the text and typical background style properties except translations and transformations. +- **one_checked** (*Optional*, boolean): Allow only one button to be checked at a time (aka. radio buttons). Defaults to ``false``. +- Style options from :ref:`lvgl-styling` for the background of the button matrix, uses the typical background style properties. ``pad_row`` and ``pad_column`` set the space between the buttons. + +**Actions:** + +- ``lvgl.buttonmatrix.update`` :ref:`action ` updates the item styles and properties specified in the specific ``state``, ``items`` options. + - **id** (**Required**): The ID or a list of IDs of buttonmatrix widgets which you want update. + - Widget styles or properties from ``state``, ``items`` options above, which you want update. + +- ``lvgl.matrix.button.update`` :ref:`action ` updates the button styles and properties specified in the specific ``control``, ``width`` and ``selected`` options. + - **id** (**Required**): The ID or a list of IDs of matrix buttons which you want update. + - Widget styles or properties from ``control``, ``width`` and ``selected`` options above, which you want update. + +**Triggers:** + +- ``on_value`` and :ref:`interaction ` triggers can be configured for each button, is activated after clicking. If ``checkable`` is ``true``, the boolean variable ``x``, representing the checked state, may be used by lambdas within this trigger. +- The :ref:`interaction ` LVGL event triggers can be configured for the main widget, they pass the ID of the pressed button (or null if nothing pressed) as variable ``x`` (a pointer to a ``uint16_t`` which holds the index number of the button). + +**Example:** + +.. code-block:: yaml + + # Example widget: + - buttonmatrix: + x: 10 + y: 40 + width: 220 + items: + pressed: + bg_color: 0xFFFF00 + id: matrix_id + rows: + - buttons: + - id: button_1 + text: "\uF04B" + control: + checkable: true + - id: button_2 + text: "\uF04C" + control: + checkable: true + - buttons: + - id: button_3 + text: "A" + control: + popover: true + - id: button_4 + text: "B" + control: + disabled: true + - buttons: + - id: button_5 + text: "It's #ff0000 red#" + width: 2 + control: + recolor: true + + # Example action: + on_...: + then: + - lvgl.matrix.button.update: + id: button_1 + width: 1 + selected: true + control: + checkable: false + - lvgl.buttonmatrix.update: + id: matrix_id + state: + disabled: true + items: + bg_color: 0xf0f0f0 + + # Example trigger: + - buttonmatrix: + ... + rows: + - buttons: + ... + - id: button_2 + ... + control: + checkable: true + on_value: # Trigger for the individual button, returning the checked state + then: + - logger.log: + format: "Button 2 checked: %d" + args: [ x ] + on_press: # Triggers for the matrix, to determine which button was pressed. + logger.log: + format: "Matrix button pressed: %d" + args: ["x"] # If x is 65535, it was the container, (or through a disabled button). + on_click: + logger.log: + format: "Matrix button clicked: %d, is button_2 = %u" + args: ["x", "id(button_2) == x"] + +.. tip:: + + The Button Matrix widget supports the :ref:`key_collector` to collect the button presses as key press sequences for further automations. + +.. _lvgl-widget-checkbox: + +``checkbox`` +------------ + +The checkbox widget is made internally from a *tick box* and a label. When the checkbox is clicked the tick box's ``checked`` state will be toggled. + +.. figure:: /components/lvgl/images/lvgl_checkbox.png + :align: center + +**Configuration variables:** + +- **indicator** (*Optional*, list): Settings for the indicator *part* to show the value. Supports a list of :ref:`styles ` and state-based styles to customize. The "tick box" is a square that uses all the typical background style properties. By default, its size is equal to the height of the main part's font. Padding properties make the tick box larger in the respective directions. +- Style options from :ref:`lvgl-styling` for the background of the widget and it uses the text and all the typical background style properties. ``pad_column`` adjusts the spacing between the tick box and the label. + +**Actions:** + +- ``lvgl.checkbox.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of checkbox widgets which you want update. + - **text** (**Required**, :ref:`templatable `, string): The ``text`` option in this action can contain static text, a :ref:`lambda ` outputting a string or can be formatted using ``printf``-style formatting (see :ref:`display-printf`). + - **format** (*Optional*, string): The format for the message in :ref:`printf-style `. + - **args** (*Optional*, list of :ref:`lambda `): The optional arguments for the format message. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +``on_value`` :ref:`trigger ` is activated when toggling the checkbox. The boolean variable ``x``, representing the checkbox's state, may be used by lambdas within this trigger. +- :ref:`interaction ` LVGL event triggers which also return the value in ``x``. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - checkbox: + x: 10 + y: 10 + id: checkbox_id + text: Checkbox + + # Example action: + on_...: + then: + - lvgl.checkbox.update: + id: checkbox_id + state: + checked: true + text: Checked + + # Example trigger: + - checkbox: + ... + on_value: + then: + - logger.log: + format: "Checkbox state: %d" + args: [ x ] + +.. note:: + + In case you configure ``default_font`` in the main section to a custom font, the checkmark will not be shown correctly when the checkbox is in the checked state. + +The ``checkbox`` can be also integrated as a :doc:`Switch ` component. + +.. _lvgl-widget-dropdown: + +``dropdown`` +------------ + +The dropdown widget allows the user to select one value from a list. + +The dropdown list is closed by default and displays a single value. When activated (by clicking on the drop-down list), a list is drawn from which the user may select one option. When the user selects a new value, the list is deleted from the screen. + +.. figure:: /components/lvgl/images/lvgl_dropdown.png + :align: center + +The Dropdown widget is built internally from a *button* part and a *list* part (both not related to the actual widgets with the same name). + +**Configuration variables:** + +- **dir** (*Optional*, dict): Where the list part of the dropdown gets created relative to the button part. ``LEFT``, ``RIGHT``, ``BOTTOM``, ``TOP``, defaults to ``BOTTOM``. +- **dropdown_list** (*Optional*, list): Settings for the dropdown_list *part*, the list with items. Supports a list of :ref:`styles ` to customize. Notable are ``text_line_space`` and ``pad_all`` for spacing of list items, and ``text_font`` to separately change the font in the list. +- **indicator** (*Optional*, list): Settings for the the parent of ``symbol``. Supports a list of :ref:`styles ` to customize. +- **options** (**Required**, list): The list of available options in the drop-down. +- **scrollbar** (*Optional*, list): Settings for the scrollbar *part*. Supports a list of :ref:`styles ` to customize. The scrollbar background, border, shadow properties and width (for its own width) and right padding for the spacing on the right. +- **selected_index** (*Optional*, int8): The index of the item you wish to be selected. +- **selected** (*Optional*, list): Settings for the selected item in the list. Supports a list of :ref:`styles ` to customize. +- **symbol** (*Optional*, dict): A symbol (typically an chevron) is shown in dropdown list. If ``dir`` of the drop-down list is ``LEFT`` the symbol will be shown on the left, otherwise on the right. Choose a different :ref:`symbol ` from those built-in or from your own customized font. +- Style options from :ref:`lvgl-styling` for the background of the button and the list. Uses the typical background properties and :ref:`lvgl-widget-label` text properties for the text on it. ``max_height`` can be used to limit the height of the list. ``text_font`` can be used to set the font of the button part, including the symbol. + +**Actions:** + +- ``lvgl.dropdown.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of dropdown widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated only when you select an item from the list. The new selected index is returned in the variable ``x``. The :ref:`interaction ` LVGL event triggers also apply, and they also return the selected index in ``x``. +- ``on_cancel`` :ref:`trigger ` is also activated when you close the dropdown without selecting an item from the list. The currently selected index is returned in the variable ``x``. +- :ref:`interaction ` LVGL event triggers which also return the value in ``x``. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - dropdown: + id: dropdown_id + width: 90 + align: CENTER + options: + - Violin + - Piano + - Bassoon + - Chello + - Drums + selected_index: 2 + + # Example action: + on_...: + then: + - lvgl.dropdown.update: + id: dropdown_id + selected_index: 4 + + # Example trigger: + - dropdown: + ... + on_value: + - logger.log: + format: "Selected index is: %d" + args: [ x ] + on_cancel: + - logger.log: + format: "Dropdown closed. Selected index is: %d" + args: [ x ] + +The ``dropdown`` can be also integrated as :doc:`Select ` component. + +.. _lvgl-widget-image: + +``image`` +--------- + +Images are the basic widgets used to display images. + +.. figure:: /components/lvgl/images/lvgl_image.png + :align: center + +**Configuration variables:** + +- **angle** (*Optional*, 0-360): Rotation of the image. Defaults to ``0.0``. Needs ``pivot_x`` and ``pivot_y`` to be specified. +- **antialias** (*Optional*): The quality of the angle or scale transformation. When anti-aliasing is enabled, the transformations are higher quality but slower. Defaults to ``false``. +- **mode** (*Optional*): Either ``REAL`` or ``VIRTUAL``. With ``VIRTUAL``, when the image is scaled or rotated, the real coordinates of the image object are not changed. The larger content simply overflows the object's boundaries. It also means the layouts are not affected the by the transformations. With ``REAL``, if the width/height of the object is set to ``SIZE_CONTENT``, the object's size will be set to the scaled and rotated size. If an explicit size is set, the overflowing content will be cropped. Defaults to ``VIRTUAL``. +- **offset_x** (*Optional*): Add a horrizontal offset to the image position. +- **offset_y** (*Optional*): Add a vertical offset to the image position. +- **pivot_x** (*Optional*): Horizontal position of the pivot point of rotation, in pixels, relative to the top left corner of the image. +- **pivot_y** (*Optional*): Vertical position of the pivot point of rotation, in pixels, relative to the top left corner of the image. +- **scale** (*Optional*, 0.1-10): Zoom of the image. +- **src** (**Required**, :ref:`image `): The ID of an existing image configuration. +- Some style options from :ref:`lvgl-styling` for the background rectangle that uses the typical background style properties and the image itself using the image style properties. + +**Actions:** + +- ``lvgl.image.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. Updating the ``src`` option changes the image at runtime. + - **id** (**Required**): The ID or a list of IDs of image widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - image: + align: CENTER + src: cat_image + id: img_id + radius: 11 + clip_corner: true + + # Example action: + on_...: + then: + - lvgl.image.update: + id: img_id + src: cat_image_bowtie + +.. note:: + + Currently ``RGB565`` type images are supported, with transparency using the optional parameter ``use_transparency`` set to ``true``. See :ref:`display-image` for how to load an image for rendering in ESPHome. + +.. tip:: + + ``offset_x`` and ``offset_y`` can be useful when the widget size is set to be smaller than the image source size. A "running image" effect can be created by animating these values. + +.. _lvgl-widget-keyboard: + +``keyboard`` +------------ + +The keyboard widget is a special Button matrix with predefined keymaps and other features to show an on-screen keyboard usable to type text into a :ref:`lvgl-widget-textarea`. + +.. figure:: /components/lvgl/images/lvgl_keyboard.png + :align: center + +For styling, the ``keyboard`` widget uses the same settings as :ref:`lvgl-widget-buttonmatrix`. + +**Configuration variables:** + +- **textarea** (*Optional*): The ID of the ``textarea`` from which to receive the keystrokes. +- **mode** (*Optional*, dict): Keyboard layout to use. Each ``TEXT_`` layout contains a button to allow the user to iterate through the ``TEXT_`` layouts. + - ``TEXT_LOWER``: Display lower case letters (default). + - ``TEXT_UPPER``: Display upper case letters. + - ``TEXT_SPECIAL``: Display special characters. + - ``NUMBER``: Display numbers, +/- sign, and decimal dot. + +**Actions:** + +- ``lvgl.keyboard.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of keyboard widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- ``on_ready`` :ref:`trigger ` is activated when the checkmark key is pressed. +- ``on_cancel`` :ref:`trigger ` is activated when the key containing the keyboard icon is pressed. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - keyboard: + id: keyboard_id + textarea: textarea_1 + mode: TEXT_UPPER + + # Example actions: + on_focus: + then: + - lvgl.keyboard.update: + id: keyboard_id + mode: number + textarea: textarea_2 + + # Example trigger: + - keyboard: + ... + on_ready: + then: + - logger.log: Keyboard is ready + on_cancel: + then: + - logger.log: Keyboard cancelled + +.. tip:: + + The Keyboard widget supports the :ref:`key_collector` to collect the button presses as key press sequences for further automations. + +.. note:: + + The Keyboard widget in ESPHome doesn't support popovers or custom layouts. + +.. _lvgl-widget-label: + +``label`` +--------- + +A label is the basic widget type that is used to display text. + +.. figure:: /components/lvgl/images/lvgl_label.png + :align: center + +**Configuration variables:** + +- **long_mode** (*Optional*, list): By default, the width and height of the label is set to ``SIZE_CONTENT``. Therefore, the size of the label is automatically expanded to the text size. Otherwise, if the ``width`` or ``height`` are explicitly set (or set by :ref:`lvgl-layouts`), the lines wider than the label's width can be manipulated according to the long mode policies below. These policies can be applied if the height of the text is greater than the height of the label. + - ``WRAP``: Wrap lines which are too long. If the height is ``SIZE_CONTENT``, the label's height will be expanded, otherwise the text will be clipped (default). + - ``DOT``: Replaces the last 3 characters from bottom right corner of the label with dots. + - ``SCROLL``: If the text is wider than the label, scroll the text horizontally back and forth. If it's higher, scroll vertically. Text will scroll in only one direction; horizontal scrolling has higher precedence. + - ``SCROLL_CIRCULAR``: If the text is wider than the label, continuously scroll the text horizontally. If it's higher, scroll vertically. Text will scroll in only one direction; horizontal scrolling has higher precedence. + - ``CLIP``: Simply clip the parts of the text outside the label. +- **recolor** (*Optional*, boolean): Enable recoloring of button text with ``#``. This makes it possible to set the color of characters in the text individually by prefixing the text to be re-colored with a ``#RRGGBB`` hexadecimal color code followed by a *space*, and finally closed with a single hash ``#`` tag. For example: ``Write a #FF0000 red# word``. +- **scrollbar** (*Optional*, list): Settings for the indicator *part* to show the value. Supports a list of :ref:`styles ` and state-based styles to customize. The scroll bar that is shown when the text is larger than the widget's size. +- **selected** (*Optional*, list): Settings for the the style of the selected text. Only ``text_color`` and ``bg_color`` style properties can be used. +- **text_align** (*Optional*, dict): Alignment of the text in the widget - it doesn't align the object itself, only the lines inside the object. One of ``LEFT``, ``CENTER``, ``RIGHT``, ``AUTO``. Inherited from parent. Defaults to ``AUTO``, which detects the text base direction and uses left or right alignment accordingly. +- **text_color** (*Optional*, :ref:`color `): Color to render the text in. Inherited from parent. Defaults to ``0`` (black). +- **text_decor** (*Optional*, list): Choose decorations for the text: ``NONE``, ``UNDERLINE``, ``STRIKETHROUGH`` (multiple can be specified as YAML list). Inherited from parent. Defaults to ``NONE``. +- **text_font**: (*Optional*, :ref:`font `): The ID of the font used to render the text or symbol. Inherited from parent. +- **text_letter_space** (*Optional*, int16): Extra character spacing of the text. Inherited from parent. Defaults to ``0``. +- **text_line_space** (*Optional*, int16): Line spacing of the text. Inherited from parent. Defaults to ``0``. +- **text_opa** (*Optional*, :ref:`opacity `): Opacity of the text. Inherited from parent. Defaults to ``COVER``. +- **text** (**Required**, string): The text (or built-in :ref:`symbol ` codepoint) to display. To display an empty label, specify ``""``. +- Style options from :ref:`lvgl-styling`. Uses all the typical background properties and the text properties. The padding values can be used to add space between the text and the background. + +.. note:: + + Newline escape sequences are handled automatically by the label widget. You can use ``\n`` to make a line break. For example: ``"line1\nline2\n\nline4"``. For escape sequences like newline to be translated, *enclose the string in double quotes*. + +**Actions:** + +- ``lvgl.label.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of label widgets which you want update. + - **text** (**Required**, :ref:`templatable `, string): The ``text`` option in this action can contain static text, a :ref:`lambda ` outputting a string or can be formatted using ``printf``-style formatting (see :ref:`display-printf`). + - **format** (*Optional*, string): The format for the message in :ref:`printf-style `. + - **args** (*Optional*, list of :ref:`lambda `): The optional arguments for the format message. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - label: + align: CENTER + id: lbl_id + recolor: true + text: "#FF0000 write# #00FF00 colored# #0000FF text#" + + - label: + align: TOP_MID + id: lbl_symbol + text_font: montserrat_28 + text: "\uF013" + + # Example action (update label with a value from a sensor): + on_...: + then: + - lvgl.label.update: + id: lbl_id + text: + format: "%.0fdBm" + args: [ 'id(wifi_signal_db).get_state()' ] + +The ``label`` can be also integrated as :doc:`Text ` or :doc:`Text Sensor ` component. + +.. _lvgl-widget-led: + +``led`` +------- + +The LED widgets are either circular or rectangular widgets whose brightness can be adjusted. As their brightness decreases, the colors become darker. + +.. figure:: /components/lvgl/images/lvgl_led.png + :align: center + +**Configuration variables:** + +- **brightness** (*Optional*, percentage): The brightness of the LED color, where ``0%`` corresponds to black, and ``100%`` corresponds to the full brightness of the color specified above. +- **color** (*Optional*, :ref:`color `): Color for the background, border, and shadow of the widget. +- Style options from :ref:`lvgl-styling`, using all the typical background style properties. + +**Actions:** + +- ``lvgl.led.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of led widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - led: + id: led_id + align: CENTER + color: 0xFF0000 + brightness: 70% + + # Example action: + on_...: + then: + - lvgl.led.update: + id: led_id + color: 0x00FF00 + +The ``led`` can be also integrated as :doc:`Light ` component. + +.. note:: + + If configured as a light component, ``color`` and ``brightness`` are overridden by the light at startup, according to its ``restore_mode`` setting. + +.. _lvgl-widget-line: + +``line`` +-------- + +The line widget is capable of drawing straight lines between a set of points. + +.. figure:: /components/lvgl/images/lvgl_line.png + :align: center + +**Configuration variables:** + +- **line_color** (*Optional*, :ref:`color `): Color for the line. +- **line_dash_gap** (*Optional*, int16): Set the width of the gap between the dashes in the line (in pixels). +- **line_dash_width** (*Optional*, int16): Set the width of the dashes in the line (in pixels). +- **line_rounded** (*Optional*, boolean): Make the end points of the line rounded. ``true`` rounded, ``false`` perpendicular line ending. +- **line_width** (*Optional*, int16): Set the width of the line in pixels. +- **points** (**Required**, list): A list of ``x, y`` integer pairs for point coordinates (origin from top left of parent) +- Style options from :ref:`lvgl-styling`, all the typical background properties and line style properties. + +By default, the Line widget width and height dimensions are set to ``SIZE_CONTENT``. This means it will automatically set its size to fit all the points. If the size is set explicitly, parts of the line may not be visible. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - line: + points: + - 5, 5 + - 70, 70 + - 120, 10 + - 180, 60 + - 230, 15 + line_width: 8 + line_color: 0x0000FF + line_rounded: true + +.. _lvgl-widget-meter: + +``meter`` +--------- + +The meter widget can visualize data in very flexible ways. It can use arcs, needles, ticks, lines and/or labels. + +.. figure:: /components/lvgl/images/lvgl_meter.png + :align: center + +**Configuration variables:** + +- **scales** (**Required**, list): A list with (any number of) scales to be added to the meter. + - **angle_range** (**Required**): The angle between start and end of the tick scale. Defaults to ``270``. + - **indicators** (**Required**, list): A list with indicators to be added to the scale. Multiple of each can be added. Their values are interpreted in the range of the scale: + - **arc** (*Optional*): Add a background arc the scale: + - **color**: :ref:`Color ` to draw the arc. Defaults to ``0`` (black). + - **end_value**: The value in the scale range to end drawing the arc to. + - **r_mod**: Adjust the position of the arc from the scale radius with this amount (can be negative). Defaults to ``0``. + - **start_value**: The value in the scale range to start drawing the arc from. + - **width**: Arc width in pixels. Defaults to ``4``. + - Style options for the *arc* using the :ref:`lvgl-widget-arc` style properties. + - **image** (*Optional*): Add a rotating needle image to the scale: + - **id**: Manually specify the :ref:`config-id` used for updating the indicator value at runtime. + - **pivot_x**: Horizontal position of the pivot point of rotation, in pixels, relative to the top left corner of the image. + - **pivot_y**: Vertical position of the pivot point of rotation, in pixels, relative to the top left corner of the image. + - **src**: The ID of an existing image configuration, representing a needle pointing to the right like ``-o--->``. + - **value**: The value in the scale range to show at start. + - **line** (*Optional*): Add a needle line to the scale. By default, the length of the line is the same as the scale's radius: + - **color**: :ref:`Color ` for the needle line. Defaults to ``0`` (black). + - **id**: Manually specify the :ref:`config-id` used for updating the indicator value at runtime. + - **r_mod**: Adjust the length of the needle from the scale radius with this amount (can be negative). Defaults to ``0``. + - **value**: The value in the scale range to show at start. + - **width**: Needle line width in pixels. Defaults to ``4``. + - Style options for the *needle line* using the :ref:`lvgl-widget-line` style properties, as well as the background properties from :ref:`lvgl-styling` to draw a square (or circle) on the pivot of the needles. Padding makes the square larger. + - **tick_style** (**Optional**): Add tick style modifications: + - **color_end**: :ref:`Color ` for the gradient end of the ticks. + - **color_start**: :ref:`Color ` for the gradient start of the ticks. + - **end_value**: The value in the scale range to modify the ticks to. + - **local**: If ``true`` the ticks' color will be faded from ``color_start`` to ``color_end`` in the start and end values specified above. If ``false``, ``color_start`` and ``color_end`` will be mapped to the entire scale range (and only a *slice* of that color gradient will be visible in the indicator's start and end value range). Defaults to ``false``. + - **start_value**: The value in the scale range to modify the ticks from. + - **width**: Modifies the ``width`` of the tick lines. + - **range_from** (**Required**): The minimum value of the tick scale. Defaults to ``0``. + - **range_to** (**Required**): The maximum value of the tick scale. Defaults to ``100``. + - **rotation** (*Optional*): The rotation angle offset of the tick scale. + - **ticks** (**Required**, list): A scale can have minor and major ticks and labels on the major ticks. To add the minor ticks: + - **color** (*Optional*, :ref:`color `): Color to draw the ticks. Required if ``count`` is greater than ``0``. Defaults to ``0x808080``. + - **count** (**Required**): How many ticks to be on the scale. Defaults to ``12``. + - **length** (*Optional*): Tick line length in pixels. Required if ``count`` is greater than ``0``. Defaults to ``10``. + - **width** (*Optional*): Tick line width in pixels. Required if ``count`` is greater than ``0``. Defaults to ``2``. + - **major** (*Optional*, list): If you want major ticks and value labels displayed: + - **color**: :ref:`Color ` to draw the major ticks. Defaults to ``0`` (black). + - **label_gap**: Label distance from the ticks with text proportional to the values of the tick line. Defaults to ``4``. + - **length**: Tick line length in pixels or percentage. Defaults to ``15%``. + - **stride**: How many minor ticks to skip when adding major ticks. Defaults to ``3``. + - **width**: Tick line width in pixels. Defaults to ``5``. + - Style options from :ref:`lvgl-styling` for the tick *lines* and *labels* using the :ref:`lvgl-widget-line` and :ref:`lvgl-widget-label` text style properties. +- Style options from :ref:`lvgl-styling` for the background of the meter, using the typical background properties. + +.. note:: + + The zero degree position is at the middle right (3 o'clock) of the widget and the degrees increase in a clockwise direction from there. Angles are specified in the ``0``-``360`` range. + +**Actions:** + +- ``lvgl.indicator.update`` :ref:`action ` updates indicator options except ``src``, which cannot be updated at runtime. :ref:`lvgl.widget.update ` action can be used for the common styles, states or flags of the meter widget (not the indicators). + - **id** (**Required**): The ID or a list of IDs of line or image indicators which you want update. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - meter: + align: center + scales: + range_from: -10 + range_to: 40 + angle_range: 240 + rotation: 150 + ticks: + count: 51 + length: 3 + major: + stride: 5 + length: 13 + label_gap: 13 + indicators: + - line: + id: temperature_needle + width: 2 + color: 0xFF0000 + r_mod: -4 + - tick_style: + start_value: -10 + end_value: 40 + color_start: 0x0000bd #FF0000 + color_end: 0xbd0000 #0000FF + + # Example action: + on_...: + then: + - lvgl.indicator.update: + id: temperature_needle + value: 3 + +.. _lvgl-widget-msgbox: + +``msgboxes`` +------------ + +The message boxes act as pop-ups. They are built from a background container, a title, an optional close button, a text and optional buttons. + +.. figure:: /components/lvgl/images/lvgl_msgbox.png + :align: center + +The text will be broken into multiple lines automatically and the height will be set automatically to include the text and the buttons. The message box is modal (blocks clicks on the rest of the screen until closed). + +**Configuration variables:** + +- **msgboxes** (*Optional*, dict): A list of message boxes to use. This option has to be added to the top level of the LVGL component configuration. + - **body** (**Required**, dict): The content of the body of the message box: + - **text** (**Required**, string): The string to be displayed in the body of the message box. Can be shorthanded if no further options are specified. + - Style options from :ref:`lvgl-styling`. Uses all the typical background properties and the text properties. + - **buttons** (**Required**, dict): A list of buttons to show at the bottom of the message box: + - **text** (**Required**, string): The text (or built-in :ref:`symbol ` codepoint) to display on the button. + - **close_button** (**Required**, boolean): Controls the appearance of the close button to the top right of the message box. + - **title** (**Required**, string): A string to display at the top of the message box. + +**Actions:** + +The configured message boxes are hidden by default. One can show them with ``lvgl.widget.show`` and ``lvgl.widget.hide`` :ref:`actions `. + +**Example:** + +.. code-block:: yaml + + # Example widget: + lvgl: + ... + msgboxes: + - id: message_box + close_button: true + title: Message box + body: + text: "This is a sample message box." + bg_color: 0x808080 + buttons: + - id: msgbox_apply + text: "Apply" + - id: msgbox_close + text: "\uF00D" + on_click: + then: + - lvgl.widget.hide: message_box + +.. tip:: + + You can create your own more complex dialogs with a full-screen sized, half-opaque ``obj`` with any child widgets on it, and the ``hidden`` flag set to ``true`` by default. For non-modal dialogs, simply set the ``clickable`` flag to ``false`` on it. + +.. _lvgl-widget-obj: + +``obj`` +------- + +The base object is just a simple, empty widget. By default, it's nothing more than a rounded rectangle: + +.. figure:: /components/lvgl/images/lvgl_baseobj.png + :align: center + +You can use it as a parent container for other widgets. By default, it catches touches. + +**Configuration variables:** + +- Style options from :ref:`lvgl-styling`. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - obj: + x: 10 + y: 10 + width: 220 + height: 300 + widgets: + - ... + +.. _lvgl-widget-roller: + +``roller`` +---------- + +Roller allows you to simply select one option from a list by scrolling. + +.. figure:: /components/lvgl/images/lvgl_roller.png + :align: center + +**Configuration variables:** + +- **anim_time** (*Optional*, :ref:`Time `): When the Roller is scrolled and doesn't stop exactly on an option it will scroll to the nearest valid option automatically in this amount of time. +- **mode** (*Optional*, dict): Option to make the roller circular. ``NORMAL`` or ``INFINITE``, defaults to ``NORMAL``. +- **options** (**Required**, list): The list of available options in the roller. +- **selected_index** (*Optional*, int8): The index of the item you wish to be selected. +- **selected** (*Optional*, list): Settings for the selected *part* to show the value. Supports a list of :ref:`styles ` and state-based styles to customize. The selected option in the middle. Besides the typical background properties it uses the :ref:`lvgl-widget-label` text style properties to change the appearance of the text in the selected area. +- **visible_row_count** (*Optional*, int8): The number of visible rows. +- Style options from :ref:`lvgl-styling`. The background of the roller uses all the typical background properties and :ref:`lvgl-widget-label` style properties. ``text_line_space`` adjusts the space between the options. + +**Actions:** + +- ``lvgl.roller.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of roller widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated when you select an item from the list. The new selected index is returned in the variable ``x``. +- :ref:`interaction ` LVGL event triggers which also return the selected index in ``x``. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - roller: + align: CENTER + id: roller_id + options: + - Violin + - Piano + - Bassoon + - Chello + - Drums + + # Example action: + on_...: + then: + - lvgl.roller.update: + id: roller_id + selected_index: 4 + + # Example trigger: + - roller: + ... + on_value: + - logger.log: + format: "Selected index is: %d" + args: [ x ] + +The ``roller`` can be also integrated as :doc:`Select ` component. + +.. _lvgl-widget-slider: + +``slider`` +---------- + +The slider widget looks like a bar supplemented with a knob. The user can drag the knob to set a value. Just like bar, slider can be vertical or horizontal. The size of the indicator foreground and the knob position is set according to the current ``value`` of the slider. + +.. figure:: /components/lvgl/images/lvgl_slider.png + :align: center + +**Configuration variables:** + +- **anim_time** (*Optional*, :ref:`Time `): Sets the animation time if the value is set with ``animated: true``. +- **animated** (*Optional*, boolean): Animate the indicator when the bar changes value. Defaults to ``true``. +- **indicator** (*Optional*, list): Settings for the indicator *part* to show the value. Supports a list of :ref:`styles ` and state-based styles to customize. The indicator shows the current state of the slider. Also uses all the typical background style properties. +- **knob** (*Optional*, list): Settings for the knob *part* to control the value. Supports a list of :ref:`styles ` and state-based styles to customize. A rectangle (or circle) is drawn at the current value. Also uses all the typical background properties to describe the knob. By default, the knob is square (with an optional corner radius) with side length equal to the smaller side of the slider. The knob can be made larger with the padding values. Padding values can be asymmetric. +- **max_value** (*Optional*, int8): Maximum value of the indicator. Defaults to ``100``. +- **min_value** (*Optional*, int8): Minimum value of the indicator. Defaults to ``0``. +- **value** (**Required**, int8): Actual value of the indicator at start, in ``0``-``100`` range. Defaults to ``0``. +- Any :ref:`Styling ` and state-based option for the background of the slider. Uses all the typical background style properties. Padding makes the indicator smaller in the respective direction. + +Normally, the slider can be adjusted either by dragging the knob, or by clicking on the slider bar. In the latter case the knob moves to the point clicked and slider value changes accordingly. In some cases it is desirable to set the slider to react on dragging the knob only. This feature is enabled by enabling the ``adv_hittest`` flag. + +**Actions:** + +- ``lvgl.slider.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of slider widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated when the knob changes the value of the slider. The new value is returned in the variable ``x``. +- :ref:`interaction ` LVGL event triggers which also return the value in ``x``. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - slider: + x: 10 + y: 10 + width: 220 + id: slider_id + value: 75 + min_value: 0 + max_value: 100 + + # Example action: + on_...: + then: + - lvgl.slider.update: + id: slider_id + knob: + bg_color: 0x00FF00 + value: 55 + + # Example trigger: + - slider: + ... + on_value: + - logger.log: + format: "Slider value is: %.0f" + args: [ 'x' ] + +.. note:: + + The ``on_value`` trigger is sent as the slider is dragged or changed with keys. The event is sent *continuously* while the slider is being dragged; this generally has a negative effect on performance. To mitigate this, consider using a :ref:`universal interaction trigger ` like ``on_release``, to get the ``x`` variable once after the interaction has completed. + +The ``slider`` can be also integrated as :doc:`Number ` or :doc:`Sensor ` component. + +.. _lvgl-widget-spinbox: + +``spinbox`` +----------- + +The spinbox contains a numeric value (as text) which can be increased or decreased through actions. You can, for example, use buttons labeled with plus and minus to call actions which increase or decrease the value as required. + +.. figure:: /components/lvgl/images/lvgl_spinbox.png + :align: center + +**Configuration variables:** + +- **anim_time** (*Optional*, :ref:`Time `): Sets the cursor's blink time. +- **decimal_places** (*Optional*, 0..6): The number of digits after the decimal point. If ``0``, no decimal point is displayed. Defaults to ``0``. +- **digits** (*Optional*, 1..10): The number of digits (excluding the decimal separator and the sign characters). Defaults to ``4``. +- **range_from** (*Optional*, float): The minimum value allowed to set the spinbox to. Defaults to ``0``. +- **range_to** (*Optional*, float): The maximum value allowed to set the spinbox to. Defaults to ``100``. +- **rollover** (*Optional*, boolean): While increasing or decreasing the value, if either the minimum or maximum value is reached with this option enabled, the value will change to the other limit. If disabled, the value will remain at the minimum or maximum value. Defaults to ``false``. +- **step** (*Optional*, float): The granularity with which the value can be set. Defaults to ``1.0``. +- **value** (**Required**, float): Actual value to be shown by the spinbox at start. + +.. note:: + + The sign character will only be shown if the set range contains negatives. + +**Actions:** + +- ``lvgl.spinbox.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of spinbox widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +- ``lvgl.spinbox.increment`` :ref:`action ` increases the value by one ``step`` configured above. + - **id** (**Required**): The ID of the spinbox widget which you want to increment. + +- ``lvgl.spinbox.decrement`` :ref:`action ` decreases the value by one ``step`` configured above. + - **id** (**Required**): The ID of the spinbox widget which you want to decrement. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated when the knob changes the value of the arc. The new value is returned in the variable ``x``. +- :ref:`interaction ` LVGL event triggers which also return the value in ``x``. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - spinbox: + id: spinbox_id + text_align: center + range_from: -10 + range_to: 40 + step: 0.5 + digits: 3 + decimal_places: 1 + + # Example actions: + on_...: + then: + - lvgl.spinbox.decrement: spinbox_id + on_...: + then: + - lvgl.spinbox.update: + id: spinbox_id + value: 25.5 + + # Example trigger: + - spinbox: + ... + on_value: + then: + - logger.log: + format: "Spinbox value is %f" + args: [ x ] + +The ``spinbox`` can be also integrated as :doc:`Number ` or :doc:`Sensor ` component. + +.. _lvgl-widget-spinner: + +``spinner`` +----------- + +The Spinner widget is a spinning arc over a ring. + +.. figure:: /components/lvgl/images/lvgl_spinner.gif + :align: center + +**Configuration variables:** + +- **arc_color** (*Optional*, :ref:`color `): Color to draw the arcs. +- **arc_length** (**Required**, 0-360): Length of the spinning arc in degrees. +- **arc_opa** (*Optional*, :ref:`opacity `): Opacity of the arc. +- **arc_rounded** (*Optional*, boolean): Make the end points of the arcs rounded. ``true`` rounded, ``false`` perpendicular line ending. +- **arc_width** (*Optional*, int16): Set the width of the arcs in pixels. +- **indicator** (*Optional*, list): Settings for the indicator *part* to show the value. Supports a list of :ref:`styles ` and state-based styles to customize. Draws *another arc using the arc style* properties. Its padding values are interpreted relative to the background arc. +- **spin_time** (**Required**, :ref:`Time `): Duration of one cycle of the spin. + +**Actions:** + +- ``lvgl.spinner.update`` :ref:`action ` updates the widget styles and properties for the *indicator* part (anything other than the properties that apply commonly to all widgets), just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. + - **id** (**Required**): The ID or a list of IDs of spinner widgets which you want update. + - Widget styles or properties from the specific options above, which you want update. + +**Triggers:** + +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - spinner: + align: center + spin_time: 2s + arc_length: 60deg + id: spinner_id + indicator: + arc_color: 0xd4d4d4 + + # Example action: + on_...: + then: + - lvgl.spinner.update: + id: spinner_id + arc_color: 0x31de70 + +.. _lvgl-widget-switch: + +``switch`` +---------- + +The switch looks like a little slider and can be used to turn something on and off. + +.. figure:: /components/lvgl/images/lvgl_switch.png + :align: center + +**Configuration variables:** + +- **indicator** (*Optional*, list): Settings for the indicator *part*, the foreground area underneath the knob shown when the switch is in ``checked`` state. Supports a list of :ref:`styles ` and state-based styles to customize. +- **knob** (*Optional*, list): Settings for the knob *part* to control the value. Supports a list of :ref:`styles ` and state-based styles to customize. +- Style options from :ref:`lvgl-styling`. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated when toggling the switch. The boolean variable ``x``, representing the switch's state, may be used by lambdas within this trigger. +- :ref:`interaction ` LVGL event triggers which also return the value in ``x``. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - switch: + x: 10 + y: 10 + id: switch_id + + # Example trigger: + - switch: + ... + on_value: + then: + - logger.log: + format: "Switch state: %d" + args: [ x ] + +The ``switch`` can be also integrated as a :doc:`Switch ` component. + +.. _lvgl-widget-tabview: + +``tabview`` +----------- + +The tab view object can be used to organize content in tabs. The tab buttons are internally generated with a :ref:`lvgl-widget-buttonmatrix`. + +.. figure:: /components/lvgl/images/lvgl_tabview.png + :align: center + +The tabs are indexed (zero-based) in the order they appear in the configuration file. A new tab can be selected either by clicking on a tab button, by sliding horizontally on the content or via the ``lvgl.tabview.select`` :ref:`action `, specifying the tab's index. + +**Configuration variables:** + +- **position** (*Optional*, string): Position of the tab selector buttons. One of ``TOP``, ``BOTTOM``, ``LEFT``, ``RIGHT``. Defaults to ``TOP``. +- **size** (*Optional*, percentage): The height (in case of ``TOP``, ``BOTTOM``) or width (in case of ``LEFT``, ``RIGHT``) tab buttons. Defaults to ``10%``. +- **tabs** (**Required**, list): A list with (any number of) tabs to be added to tabview. + - **name** (**Required**): The text to be shown on the button corresponding to the tab. + - **id** (*Optional*): An ID for the tab itself. + - **widgets** (**Required**, list): A list of :doc:`/components/lvgl/widgets` to be drawn on the tab, as children. +- **tab_style** (*Optional*): Style settings for the tabs. + - **items** (*Optional*, list): Settings for the items *part*, the buttons all use the text and typical background style properties except translations and transformations. + +**Actions:** + +- ``lvgl.tabview.select`` :ref:`action ` jumps the view to the desired tab: + - **id** (**Required**): The ID of the tabview which receives this action. + - **index** (**Required**): The (zero-based) index of the tab to which to jump. + - **animated** (*Optional*, boolean): To animate the movement. Defaults to ``false``. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated when displayed tab changes. The new value is returned in the variable ``tab`` as the ID of the now-visible tab. +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - tabview: + id: tabview_id + position: top + tab_style: + border_color: 0x00FF00 + border_width: 6 + items: + text_color: 0x0000FF + tabs: + - name: Dog + id: tabview_tab_1 + widgets: + - image: + src: dog_img + ... + ... + + # Example action: + on_...: + then: + - lvgl.tabview.select: + id: tabview_id + index: 1 + animated: true + + # Example trigger: + - tabview: + ... + on_value: + then: + - if: + condition: + lambda: return tab == id(tabview_tab_1); + then: + - logger.log: "Dog tab is now showing" + +.. _lvgl-widget-textarea: + +``textarea`` +------------ + +The textarea is an extended label widget which displays a cursor and allows the user to input text. Long lines are wrapped and when the text becomes long enough the text area can be scrolled. It supports one line mode and password mode, where typed characters are replaced visually with bullets or asterisks. + +.. figure:: /components/lvgl/images/lvgl_textarea.png + :align: center + +**Configuration variables:** + +- **accepted_chars** (*Optional*, string): You can set a list of accepted characters, so other characters will be ignored. +- **max_length** (*Optional*, int): Limit the maximum number of characters to this value. +- **one_line** (*Optional*, boolean): The text area can be limited to only allow a single line of text. In this case the height will set automatically to fit only one line, line break characters will be ignored, and word wrap will be disabled. +- **password_mode** (*Optional*, boolean): The text area supports password mode. By default, if the ``•`` (bullet, ``0x2022``) glyph exists in the font, the entered characters are converted to it after some time or when a new character is entered. If ``•`` is missing from the font, ``*`` (asterisk) will be used. +- **placeholder_text** (*Optional*, string): A placeholder text can be specified, which is displayed when the Text area is empty. +- any :ref:`Styling ` and state-based option for the background of the textarea. Uses all the typical background style properties and the text/label related style properties for the text. + +**Actions:** + +- ``lvgl.textarea.update`` :ref:`action ` updates the widget's ``text`` property, to replace the entire text content. + - **id** (**Required**): The ID or a list of IDs of textarea widgets which you want update. + - **text** (**Required**): The new text content to be displayed. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated on every keystroke. +- ``on_ready`` :ref:`trigger ` is activated when ``one_line`` is configured as ``true`` and the newline character is received (Enter/Ready key on the keyboard). +- :ref:`interaction ` LVGL event triggers. + +For both triggers above, when triggered, the variable ``text`` (``std::string`` type) is available for use in lambdas within these triggers and it will contain the entire contents of the textarea. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - textarea: + id: textarea_id + one_line: true + placeholder_text: "Enter text here" + + # Example action: + on_...: + then: + - lvgl.textarea.update: + id: textarea_id + text: "Hello World!" + + # Example trigger: + - textarea: + ... + on_value: + then: + - logger.log: + format: "Textarea changed to: %s" + args: [ text.c_str() ] + on_ready: + then: + - logger.log: + format: "Textarea ready: %s" + args: [ text.c_str() ] + +The ``textarea`` can be also integrated as :doc:`Text ` or :doc:`Text Sensor ` component. + +.. _lvgl-widget-tileview: + +``tileview`` +------------ + +The tileview is a container object whose elements, called tiles, can be arranged in grid form. A user can navigate between the tiles by dragging or swiping. Any direction can be disabled on the tiles individually to not allow moving from one tile to another. + +If the Tile view is screen sized, the user interface resembles what you may have seen on smartwatches. + +**Configuration variables:** + +- **tiles** (**Required**, list): A list with (any number of) tiles to be added to tileview. + - **column** (**Required**): Vertical position of the tile in the tileview grid. + - **row** (**Required**): Horizontal position of the tile in the tileview grid. + - **dir** (*Optional*): Enable moving to adjacent tiles in the given direction by swiping/dragging. One (or multiple as YAML list) of ``LEFT``, ``RIGHT``, ``TOP``, ``BOTTOM``, ``HOR``, ``VER``, ``ALL``. Defaults to ``ALL``. + - **id** (*Optional*): A tile ID to be used with the ``lvgl.tileview.select`` action. + - **widgets** (*Optional*, list): A list of :doc:`/components/lvgl/widgets` to be drawn on the tile, as children. + +**Actions:** + +- ``lvgl.tileview.select`` :ref:`action ` jumps the ``tileview`` to the desired tile: + - **animated** (*Optional*, boolean): To animate the movement. Defaults to ``false``. + - **column** (*Optional*): Vertical position of the tile to which to jump. Required if not specifying ``tile_id``. + - **row** (*Optional*): Horizontal position of the tile to which to jump. Required if not specifying ``tile_id``. + - **id** (**Required**): The ID of the tileview which receives this action. + - **tile_id** (*Optional*): The ID of the tile (from within the tileview) to which to jump. Required if not specifying ``row`` and ``column``. + +**Triggers:** + +- ``on_value`` :ref:`trigger ` is activated when displayed tile changes. The new value is returned in the variable ``tile`` as the ID of the now-visible tile. +- :ref:`interaction ` LVGL event triggers. + +**Example:** + +.. code-block:: yaml + + # Example widget: + - tileview: + id: tiv_id + tiles: + - id: cat_tile + row: 0 + column: 0 + dir: VER + widgets: + - image: + src: cat_image + - ... + - ... + + # Example action: + on_...: + then: + - lvgl.tileview.select: + id: tiv_id + tile_id: cat_tile + animated: true + + # Example trigger: + - tileview: + ... + on_value: + - if: + condition: + lambda: return tile == id(cat_tile); + then: + - logger.log: "Cat tile is now showing" + +.. _lvgl-automations: + +Automations +----------- + +.. _lvgl-automation-actions: + +Actions +******* + +As outlined in the sections above, each widget type supports several of its own, unique actions. +Several universal actions are also available for all widgets, these are outlined below. + +``lvgl.widget.update`` +^^^^^^^^^^^^^^^^^^^^^^ + +This powerful :ref:`action ` allows changing/updating any widget's common :ref:`style property `, state (templatable) or :ref:`flag ` on the fly. + +- **id** (**Required**): The ID or a list of IDs of widgets configured in LVGL which you want update. +- The widget's common :ref:`style property `, state (templatable) or :ref:`flag `. + +.. code-block:: yaml + + # Example for updating styles (in states): + on_...: + then: + - lvgl.widget.update: + id: my_button_id + bg_color: 0xFF0000 + state: + disabled: true + + # Example for updating flag: + on_...: + then: + - lvgl.widget.update: + id: my_label_id + hidden: true + + +.. _lvgl-automation-shorthands: + +``lvgl.widget.hide``, ``lvgl.widget.show`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +These :ref:`actions ` are shorthands for toggling the ``hidden`` :ref:`flag ` of any widget. + +- **id** (**Required**): The ID or a list of IDs of widgets configured in LVGL which you want to hide or show. + +.. code-block:: yaml + + on_...: + then: + - lvgl.widget.hide: my_label_id # a single widget + - lvgl.widget.show: [my_button_1, my_button_2] # a list of widgets + - delay: 0.5s + - lvgl.widget.show: + -id: my_label_id + - lvgl.widget.hide: + - id: [my_button_1, my_button_2] + +``lvgl.widget.disable``, ``lvgl.widget.enable`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +These :ref:`actions ` are shorthands for toggling the ``disabled`` state of any widget (which controls the appearance of the corresponding *disabled* style set of the theme): + +- **id** (**Required**): The ID or a list of IDs of widgets configured in LVGL which you want to disable or enable. + +.. code-block:: yaml + + - on_...: + then: + - lvgl.widget.disable: + - my_button_1 + - my_button_2 + + - on_...: + then: + - lvgl.widget.enable: + - id: my_button_1 + - id: my_button_2 + +.. _lvgl-automation-triggers: + +Triggers +******** + +Specific triggers like ``on_value`` are available for certain widgets; they are described above in their respective section. +Some universal triggers are also available for all of the widgets: + +ESPHome implements as universal triggers the following interaction events generated by LVGL: + +- ``on_press``: The widget has been pressed. +- ``on_long_press``: The widget has been pressed for at least the ``long_press_time`` specified in the input device configuration. Not called if scrolled. +- ``on_long_press_repeat``: Called after ``long_press_time`` in every ``long_press_repeat_time`` ms. Not called if scrolled. +- ``on_short_click``: The widget was pressed for a short period of time, then released. Not called if scrolled or long pressed. +- ``on_click``: Called on release if a widget did not scroll (regardless of long press). +- ``on_release``: Called in every case when a widget has been released. +- ``on_scroll_begin``: Scrolling of the widget begins. +- ``on_scroll_end``: Scrolling of the widget ends. +- ``on_scroll``: The widget was scrolled. +- ``on_focus``: The widget is focused. +- ``on_defocus``: The widget is unfocused. + +These triggers can be applied directly to any widget in the LVGL configuration, *given that the widget itself supports generating such events*. For the widgets having a value, the triggers return the current value in variable ``x``; this variable may be used in lambdas defined within those triggers. + +.. code-block:: yaml + + # Example triggers: + - button: + ... + on_short_click: + then: + lvgl.page.show: main_page + on_long_press: + then: + light.toggle: display_backlight + + - slider: + ... + on_release: + then: + - light.turn_on: + id: display_backlight + transition_length: 0ms + brightness: !lambda return x / 100; + +See Also +-------- + +- :doc:`LVGL Main component ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/text/lvgl` +- :doc:`/components/text_sensor/lvgl` +- `LVGL docs `__ +- :ghedit:`Edit` diff --git a/components/number/lvgl.rst b/components/number/lvgl.rst new file mode 100644 index 000000000..0183592cc --- /dev/null +++ b/components/number/lvgl.rst @@ -0,0 +1,47 @@ +LVGL Number +=========== + +.. seo:: + :description: Instructions for setting up an LVGL widget number component. + :image: ../images/lvgl_c_num.png + +The ``lvgl`` number platform creates a number component from an LVGL widget +and requires :doc:`LVGL ` to be configured. + +Supported widgets are :ref:`lvgl-widget-arc`, :ref:`lvgl-widget-bar`, :ref:`lvgl-widget-slider` and :ref:`lvgl-widget-spinbox`. A single number supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome number component. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a supported widget configured in LVGL, which will reflect the state of the number. +- **animated** (*Optional*, boolean): Whether to set the value of the widget with an animation (if supported by the widget). Defaults to ``true``. +- All other variables from :ref:`Number `. + +Example: + +.. code-block:: yaml + + number: + - platform: lvgl + widget: slider_id + name: LVGL Slider + +.. note:: + + Widget-specific actions (``lvgl.arc.update``, ``lvgl.bar.update``, ``lvgl.slider.update``, ``lvgl.spinbox.update``, ``lvgl.spinbox.decrement``, ``lvgl.spinbox.increment``) will trigger correspponding component updates to be sent to Home Assistant. + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`Arc widget ` +- :ref:`Bar widget ` +- :ref:`Slider widget ` +- :ref:`Spinbox widget ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/text/lvgl` +- :doc:`/components/text_sensor/lvgl` +- :ghedit:`Edit` diff --git a/components/select/lvgl.rst b/components/select/lvgl.rst new file mode 100644 index 000000000..711c2509d --- /dev/null +++ b/components/select/lvgl.rst @@ -0,0 +1,44 @@ +LVGL Select +=========== + +.. seo:: + :description: Instructions for setting up an LVGL widget select. + :image: ../images/lvgl_c_sel.png + +The ``lvgl`` select platform creates a select from an LVGL widget +and requires :doc:`LVGL ` to be configured. + +Supported widgets are :ref:`lvgl-widget-dropdown` and :ref:`lvgl-widget-roller`. A single select supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome select component. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a supported widget configured in LVGL, which will reflect the state of the select. +- All other variables from :ref:`Select `. + +Example: + +.. code-block:: yaml + + select: + - platform: lvgl + widget: dropdown_id + name: LVGL Dropdown + +.. note:: + + Widget-specific actions (``lvgl.dropdown.update``, ``lvgl.roller.update``) will trigger correspponding component updates to be sent to Home Assistant. + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`Roller widget ` +- :ref:`Dropdown widget ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/text/lvgl` +- :doc:`/components/text_sensor/lvgl` +- :ghedit:`Edit` diff --git a/components/sensor/lvgl.rst b/components/sensor/lvgl.rst new file mode 100644 index 000000000..b7c13e252 --- /dev/null +++ b/components/sensor/lvgl.rst @@ -0,0 +1,46 @@ +LVGL Sensor +=========== + +.. seo:: + :description: Instructions for setting up an LVGL widget sensor component. + :image: ../images/lvgl_c_num.png + +The ``lvgl`` sensor platform creates a semsor component from an LVGL widget +and requires :doc:`LVGL ` to be configured. + +Supported widgets are :ref:`lvgl-widget-arc`, :ref:`lvgl-widget-bar`, :ref:`lvgl-widget-slider` and :ref:`lvgl-widget-spinbox`. A single sensor supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome sensor. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a supported widget configured in LVGL, which will reflect the state of the sensor. +- All other variables from :ref:`Sensor `. + +Example: + +.. code-block:: yaml + + sensor: + - platform: lvgl + widget: slider_id + name: LVGL Slider + +.. note:: + + Widget-specific actions (``lvgl.arc.update``, ``lvgl.bar.update``, ``lvgl.slider.update``, ``lvgl.spinbox.update``, ``lvgl.spinbox.decrement``, ``lvgl.spinbox.increment``) will trigger correspponding component updates to be sent to Home Assistant. + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`Arc widget ` +- :ref:`Bar widget ` +- :ref:`Slider widget ` +- :ref:`Spinbox widget ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/text/lvgl` +- :doc:`/components/text_sensor/lvgl` +- :ghedit:`Edit` diff --git a/components/switch/lvgl.rst b/components/switch/lvgl.rst new file mode 100644 index 000000000..37a0478c2 --- /dev/null +++ b/components/switch/lvgl.rst @@ -0,0 +1,42 @@ +LVGL Switch +=========== + +.. seo:: + :description: Instructions for setting up an LVGL widget switch. + :image: ../images/lvgl_c_swi.png + +The ``lvgl`` switch platform creates a switch from an LVGL widget +and requires :doc:`LVGL ` to be configured. + +Supported widgets are :ref:`lvgl-widget-button` (with ``checkable`` option enabled), :ref:`lvgl-widget-switch` and :ref:`lvgl-widget-checkbox`. A single switch supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome switch component. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a supported widget configured in LVGL, which will reflect the state of the switch. +- All other variables from :ref:`Switch `. + +Example: + +.. code-block:: yaml + + switch: + - platform: lvgl + widget: checkbox_id + name: LVGL switch + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`Button widget ` +- :ref:`Switch widget ` +- :ref:`Checkbox widget ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/text/lvgl` +- :doc:`/components/text_sensor/lvgl` +- :doc:`/components/output/index` +- :ghedit:`Edit` diff --git a/components/text/lvgl.rst b/components/text/lvgl.rst new file mode 100644 index 000000000..78b16e11e --- /dev/null +++ b/components/text/lvgl.rst @@ -0,0 +1,43 @@ +LVGL Text +========= + +.. seo:: + :description: Instructions for setting up an LVGL Text component. + :image: ../images/lvgl_c_txt.png + +The ``lvgl`` text platform creates an editable text component from an LVGL textual widget and requires :doc:`LVGL ` to be configured. + +Supported widgets are :ref:`lvgl-widget-label` and :ref:`lvgl-widget-textarea`. A single text supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome text component. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a ``textarea`` widget configured in LVGL, which will reflect the state of the text component. +- All other variables from :ref:`Text `. + +Example: + +.. code-block:: yaml + + text: + - platform: lvgl + widget: textarea_id + name: "Textarea 1 text" + +.. note:: + + Widget-specific actions (``lvgl.label.update``, ``lvgl.textarea.update``) will trigger correspponding component updates to be sent to Home Assistant. + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`Label widget ` +- :ref:`Textarea widget ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/text_sensor/lvgl` +- :ghedit:`Edit` diff --git a/components/text_sensor/lvgl.rst b/components/text_sensor/lvgl.rst new file mode 100644 index 000000000..61610f423 --- /dev/null +++ b/components/text_sensor/lvgl.rst @@ -0,0 +1,44 @@ +LVGL Text Sensor +================ + +.. seo:: + :description: Instructions for setting up an LVGL Text Sensor. + :image: ../images/lvgl_c_txt.png + +The ``lvgl`` text sensor platform creates a Text Sensor from an LVGL textual widget +and requires :doc:`LVGL ` to be configured. + +Supported widgets are :ref:`lvgl-widget-label` and :ref:`lvgl-widget-textarea`. A single text sensor supports only a single widget; in other words, it's not possible to have multiple widgets associated with a single ESPHome text sensor component. + +Configuration variables: +------------------------ + +- **widget** (**Required**): The ID of a ``textarea`` widget configured in LVGL, which will reflect the state of the text sensor. +- All other variables from :ref:`Text Sensor `. + +Example: + +.. code-block:: yaml + + text_sensor: + - platform: lvgl + widget: textarea_id + name: "Textarea 1 text" + +.. note:: + + Widget-specific actions (``lvgl.label.update``, ``lvgl.textarea.update``) will trigger correspponding component updates to be sent to Home Assistant. + +See Also +-------- +- :doc:`LVGL Main component ` +- :ref:`Label widget ` +- :ref:`Textarea widget ` +- :doc:`/components/binary_sensor/lvgl` +- :doc:`/components/sensor/lvgl` +- :doc:`/components/number/lvgl` +- :doc:`/components/switch/lvgl` +- :doc:`/components/light/lvgl` +- :doc:`/components/select/lvgl` +- :doc:`/components/text/lvgl` +- :ghedit:`Edit` diff --git a/images/lvgl.png b/images/lvgl.png new file mode 100644 index 0000000000000000000000000000000000000000..a48dd7c4f8f569bb154d6365c0bd6d792e578b6d GIT binary patch literal 3401 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 literal 0 HcmV?d00001 diff --git a/images/lvgl_c_txt.png b/images/lvgl_c_txt.png new file mode 100644 index 0000000000000000000000000000000000000000..72f1d05113a88968343a9c2f48a9c14ffc658a7f GIT binary patch literal 1623 zcma)-e>f8e7{^zR6H`RD{Qgm+2&=n($Q{MVa9h@@GZSIUjfL|ohf-@y+fGW!uV~#u zWPXI1q5Rm&5}TCTQqdSKEH(`1cF%LqbN4*=&;9Yf-{*PX=Y5~|{p0<-*+=0=^mI&g z004j<%m<28D_dRj>Xx9*WaN6fyS z4e`}To(0ZW5s!ySi5s)6^-~(qAlZYxeP28tCrLv+@8tSqR+zKVf`J{BT%=E|4nej{ zusIyNV@GIh1GvP)nzWyV^3+&(v}yWqX2Q8E^U*E!&)q&DR#yFmE;Azq%TsAHZG#e{ zwsb#0$x_)Xy^O<`SQ(j{7C5CR?addnYwc(k-H_p^df9R@PZ!ZM;gs{czovCV!Pd>e zF&6WnmTjKy;`(8%0O&cFBj6w_tsZ6(A~eZ9zzwOxaLo@KB&`#N5nk+%<|5`+erM1Q z|4j|IE((nr?{-3fp4FqWecY|#)J^7mHh3;Bz;}tcN?bEH%aIfjlo? zV=aXNDUiAw$LSf!MA`$pDs)#~osT4W+`@dp?Qx=2Lns9VZ~{60xr<%E3gTr`Ci-6J0bdIAv)m)vc}^Q(!UlnO zab~>9Hl(+#D(~(uQ^*WrM1%Kvs8lU}oMR527{pYl9W1U?_e7(a8y25`4cBBYwjPS-8OBLchS5X1CBRgnQjTg*v_6N1lS)E=DzjtUNs=Xb^R96eSyzji zJ(Ut4((fhdY4u9x{s^?|&EXHx@Tgnug*Da3znP;*coKQGoU}xm8pLz%_oBh8!R)R( zQSaWU#}*s!pCe?FIRs{G)lrPSjFY0aHymC}#h5o3uj3`asn+8eG+T=?FOKIvR;3br3sP~8gr zliCaE=>+vs3)hOa!i~O=Haet*C~(ulr7WaYeIMeL!zV#GXK3w)CA}#!CD(EhS%`UZ zfUJs|7Piz;!l9_ZDsr+^o6_*+g)QS5h9A+uSerssbgyxo*tj{i$|}9U1ToYUwLj*qINsnz%f3cz&6#UYBUJcblW@wx zes{;WI~mM-L85pM?~)P!M9?^B6g*8$egE*$YHzwy7N|tu3=#(>Ue+h2J$Ct2z0y>l z7E=(ErY?>R%$5ZOO~NO8D4-(KBIx$ZKRt8CF|j;5F3*YD*fcRvZei88X86AJGdgU0 z91D#X?X|&QScJ8D3EU4(mMF6>%uf#=E@?f4_~)9XBR33eTV~c#oys0ZV1VZnP5pO^ zcH&0ElvTfkUVZI+%Y^2a!J02o{pOm!C7%nAL^h>n0E1sjHy#TbGA?R0WZ2@;IZ-y-^_BLzS(2pSRUAp?(A6P Date: Mon, 12 Aug 2024 04:20:53 +0200 Subject: [PATCH 24/53] Feature improv serial project identity (#4125) --- components/improv_serial.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/components/improv_serial.rst b/components/improv_serial.rst index 206df451a..6d76b1c40 100644 --- a/components/improv_serial.rst +++ b/components/improv_serial.rst @@ -10,6 +10,8 @@ for configuring Wi-Fi on an ESPHome device by using a serial connection to the d The ``improv_serial`` component requires the serial ``logger`` to be configured. +The ``improv_serial`` component will use the project name and version instead of ESPHomes version whenever it's available. + .. code-block:: yaml From 2c0848f91f560d64db53608760f9147feedef187 Mon Sep 17 00:00:00 2001 From: Keith Burzinski Date: Sun, 11 Aug 2024 23:15:04 -0500 Subject: [PATCH 25/53] [bme68x_bsec2_i2c] Add docs (#4018) * Add docs for new `bme68x_bsec2_i2c` component * Linting * Fix link name * Add note about BSEC2 to BME680 component doc * Organize examples better Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> * Fix up example * Update sensor platform name --------- Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/sensor/bme680_bsec.rst | 8 +- components/sensor/bme68x_bsec2.rst | 285 +++++++++++++++++++++++++++++ index.rst | 1 + 3 files changed, 291 insertions(+), 3 deletions(-) create mode 100644 components/sensor/bme68x_bsec2.rst diff --git a/components/sensor/bme680_bsec.rst b/components/sensor/bme680_bsec.rst index 2b3e0780b..ec5c1073b 100644 --- a/components/sensor/bme680_bsec.rst +++ b/components/sensor/bme680_bsec.rst @@ -18,9 +18,11 @@ for CO₂ and Breath Volatile Organic Compounds (b-VOC) using a correlation betw .. note:: - The BSEC library is only available for use after accepting its software license agreement. By enabling this component, - you are explicitly agreeing to the terms of the `BSEC license agreement`_. You must not distribute any compiled firmware - binaries that include this component. + - The BSEC library is only available for use after accepting its software license agreement. By enabling this component, + you are explicitly agreeing to the terms of the `BSEC license agreement`_. You must not distribute any compiled firmware + binaries that include this component. + + - We recommend using the newer :doc:`bme68x_bsec2 ` component whenever possible. The :ref:`I²C ` is required to be set up in your configuration for this sensor to work. diff --git a/components/sensor/bme68x_bsec2.rst b/components/sensor/bme68x_bsec2.rst new file mode 100644 index 000000000..6b5135914 --- /dev/null +++ b/components/sensor/bme68x_bsec2.rst @@ -0,0 +1,285 @@ +BME68x Temperature, Humidity, Pressure & Gas Sensor via BSEC2 +============================================================= + +.. seo:: + :description: Instructions for setting up BME68x temperature, humidity, pressure, and gas sensors via BSEC2. + :image: bme680.jpg + :keywords: BME680, BME688, BME68X, BSEC2 + +Component/Hub +------------- + +The ``bme68x_bsec2_i2c`` sensor platform allows you to use your +`BME680 `__ and +`BME688 `__ +(`Adafruit`_, `Pimoroni`_) temperature, humidity, pressure and gas sensors with ESPHome via the Bosch Sensortec +Environmental Cluster 2 (BSEC2) software library. The use of Bosch's proprietary algorithms provide an Index for Air +Quality (IAQ) measurement derived from the gas resistance sensor's response to specific Volatile Organic Compounds +(VOCs). The BSEC software also provides estimated values for CO₂ and Breath Volatile Organic Compounds (b-VOC) using +a correlation between VOC and CO₂ in a human's exhaled breath. + +The :ref:`I²C ` is required to be set up in your configuration for this sensor to work. + +.. _BSEC license agreement: https://www.bosch-sensortec.com/media/boschsensortec/downloads/software/bme688_development_software/2023_04/license_terms_bme688_bme680_bsec.pdf + +.. _Adafruit: https://www.adafruit.com/product/3660 + +.. _Pimoroni: https://shop.pimoroni.com/products/bme680-breakout + +.. note:: + + The BSEC2 library is only available for use after accepting its software license agreement. By enabling this + component in your configuration, you are explicitly agreeing to the terms of the `BSEC license agreement`_. Note + that the license forbids distribution of any compiled firmware binaries that include this component. + +.. figure:: images/bme680-full.jpg + :align: center + :width: 50.0% + + BME680 Temperature, Pressure, Humidity & Gas Sensor. + +.. figure:: images/bme680-bsec-ui.png + :align: center + :width: 80.0% + + Example UI + +.. code-block:: yaml + + # Minimal example configuration with common sensors + bme68x_bsec2_i2c: + address: 0x76 + model: bme680 + operating_age: 28d + sample_rate: LP + voltage: 3.3V + + + +Configuration variables: +^^^^^^^^^^^^^^^^^^^^^^^^ + +- **address** (*Optional*, int): Manually specify the I²C address of the sensor. Defaults to ``0x76``. The sensor can + also be configured to use ``0x77``. +- **model** (*Optional*, string): The model of the connected sensor; either ``BME680`` or ``BME688``. +- **algorithm_output** (*Optional*, string): The output of the BSEC2 algorithm. Either ``classification`` (default) or + ``regression``. *Only valid when model is BME688.* +- **operating_age** (*Optional*, string): The history BSEC2 considers for the automatic background calibration of the + IAQ in days. That means changes in this time period will influence the IAQ value. Either ``4d`` or ``28d``. +- **sample_rate** (*Optional*, string): Sample rate. Default is ``LP`` for low power consumption, sampling every 3 + seconds. Can be ``ULP`` for ultra-low power, sampling every 5 minutes. This controls the sampling rate for + gas-dependent sensors and will govern the interval at which the sensor heater is operated. By default, this rate will + also be used for temperature, humidity and pressure sensors but can be overridden per-sensor if required. +- **supply_voltage** (*Optional*, string): Supply voltage of the sensor. Default is ``3.3V``. Can be set to ``1.8V`` if + your sensor is powerd with 1.8 volts (for example, the Pimoroni PIM357 BME680 breakout module). +- **temperature_offset** (*Optional*, float): Temperature offset if device is in enclosure and reads too high. This + value is subtracted from the reading (for example, if the sensor reads 5°C higher than expected, set this to ``5``) + and also corrects the relative humidity readings. Defaults to ``0``. +- **state_save_interval** (*Optional*, :ref:`config-time`): The minimum interval at which to save the calibrated BSEC2 + algorithm state to flash so that calibration doesn't have to start from scratch on device restart. Defaults to ``6h``. +- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. Use this ID in the sensor + section to refer to the correct BME68x sensor if you have more than one device. This will also be used to refer to + the calibrated BSEC2 algorithm state saved to flash. + +Sensor +------ + +.. code-block:: yaml + + sensor: + - platform: bme68x_bsec2 + temperature: + name: "BME68x Temperature" + pressure: + name: "BME68x Pressure" + humidity: + name: "BME68x Humidity" + iaq: + name: "BME68x IAQ" + id: iaq + co2_equivalent: + name: "BME68x CO2 Equivalent" + breath_voc_equivalent: + name: "BME68x Breath VOC Equivalent" + +Configuration variables: +^^^^^^^^^^^^^^^^^^^^^^^^ + +- **bme68x_bsec2_id** (*Optional*, :ref:`config-id`): The ID of the ``bme68x_bsec2_i2c`` component sensors will refer + to. Useful when multiple devices are present in your configuration. + +- **temperature** (*Optional*): Configuration for the temperature sensor. + + - **sample_rate** (*Optional*, string): Optional sample rate override for this sensor. Can be ``LP`` for low power + consumption, sampling every 3 seconds or ``ULP`` for ultra-low power, sampling every 5 minutes. + - All other options from :ref:`Sensor `. + +- **pressure** (*Optional*): Configuration for the pressure sensor. + + - **sample_rate** (*Optional*, string): Optional sample rate override for this sensor. Can be ``LP`` for low power + consumption, sampling every 3 seconds or ``ULP`` for ultra-low power, sampling every 5 minutes. + - All other options from :ref:`Sensor `. + +- **humidity** (*Optional*): Configuration for the humidity sensor. + + - **sample_rate** (*Optional*, string): Optional sample rate override for this sensor. Can be ``LP`` for low power + consumption, sampling every 3 seconds or ``ULP`` for ultra-low power, sampling every 5 minutes. + - All other options from :ref:`Sensor `. + +- **gas_resistance** (*Optional*): Configuration for the gas sensor. + + - All options from :ref:`Sensor `. + +- **iaq** (*Optional*): Configuration for the IAQ sensor. + + - All options from :ref:`Sensor `. + +- **iaq_static** (*Optional*): Configuration for the IAQ static sensor. + + - All options from :ref:`Sensor `. + +- **iaq_accuracy** (*Optional*): Configuration for the numeric IAQ accuracy sensor. + + - All options from :ref:`Sensor `. + +- **co2_equivalent** (*Optional*): Configuration for the CO₂ equivalent sensor. + + - All options from :ref:`Sensor `. + +- **breath_voc_equivalent** (*Optional*): Configuration for the Breath VOC equivalent humidity sensor. + + - All options from :ref:`Sensor `. + +Text Sensor +----------- + +The sensor's accuracy can be reported in text format. + +.. code-block:: yaml + + text_sensor: + - platform: bme68x_bsec2 + iaq_accuracy: + name: "BME68x IAQ Accuracy" + +Configuration variables: +^^^^^^^^^^^^^^^^^^^^^^^^ + +- **bme68x_bsec2_id** (*Optional*, :ref:`config-id`): The ID of the ``bme68x_bsec2_i2c`` component the text sensor + will refer to. Useful when multiple devices are present in your configuration. +- **iaq_accuracy** (*Optional*): Configuration for the IAQ accuracy sensor. Shows: ``Stabilizing``, ``Uncertain``, + ``Calibrating``, ``Calibrated``. + + - All other options from :ref:`Text Sensor `. + +Index for Air Quality (IAQ) Measurement +--------------------------------------- + +The measurements are expressed with an index scale ranging from 0 to 500. The index itself is deduced from tests using +ethanol gas, as well as important VOC in the exhaled breath of healthy humans. The VOC values themselves are derived +from several publications on breath analysis studies. The BSEC2 software library defines the levels as follows: + ++-----------+---------------------+ +| IAQ Index | Air Quality | ++===========+=====================+ +| 0 - 50 | Excellent | ++-----------+---------------------+ +| 51 - 100 | Good | ++-----------+---------------------+ +| 101 - 150 | Lightly polluted | ++-----------+---------------------+ +| 151 - 200 | Moderately polluted | ++-----------+---------------------+ +| 201 - 250 | Heavily polluted | ++-----------+---------------------+ +| 251 - 350 | Severely polluted | ++-----------+---------------------+ +| > 351 | Extremely polluted | ++-----------+---------------------+ + +This can be represented by a template text sensor such as below + +.. code-block:: yaml + + text_sensor: + - platform: template + name: "BME68x IAQ Classification" + lambda: |- + if ( int(id(iaq).state) <= 50) { + return {"Excellent"}; + } + else if (int(id(iaq).state) >= 51 && int(id(iaq).state) <= 100) { + return {"Good"}; + } + else if (int(id(iaq).state) >= 101 && int(id(iaq).state) <= 150) { + return {"Lightly polluted"}; + } + else if (int(id(iaq).state) >= 151 && int(id(iaq).state) <= 200) { + return {"Moderately polluted"}; + } + else if (int(id(iaq).state) >= 201 && int(id(iaq).state) <= 250) { + return {"Heavily polluted"}; + } + else if (int(id(iaq).state) >= 251 && int(id(iaq).state) <= 350) { + return {"Severely polluted"}; + } + else if (int(id(iaq).state) >= 351) { + return {"Extremely polluted"}; + } + else { + return {"error"}; + } + +The selected b-VOC gasses are as follows: + ++--------------------+----------------+ +| Compound | Molar fraction | ++====================+================+ +| `Ethane`_ | 5 ppm | ++--------------------+----------------+ +| `Isoprene`_ | 10 ppm | ++--------------------+----------------+ +| `Ethanol`_ | 10 ppm | ++--------------------+----------------+ +| `Acetone`_ | 50 ppm | ++--------------------+----------------+ +| `Carbon Monoxide`_ | 15 ppm | ++--------------------+----------------+ + +.. _Ethane: https://en.wikipedia.org/wiki/Ethane +.. _Isoprene: https://en.wikipedia.org/wiki/Isoprene +.. _Ethanol: https://en.wikipedia.org/wiki/Ethanol +.. _Acetone: https://en.wikipedia.org/wiki/Acetone +.. _Carbon Monoxide: https://en.wikipedia.org/wiki/Carbon_monoxide + +.. _bsec2-calibration: + +IAQ Accuracy and Calibration +---------------------------- + +The BSEC2 software automatically calibrates in the background to provide consistent IAQ performance. The calibration +process considers the recent measurement history so that a value of 50 corresponds to a “typical good” level and a +value of 200 to a “typical polluted” level. The IAQ Accuracy sensor will indicate one of the following values: + +- ``Stabilizing``: The device has just started, and the sensor is stabilizing (this typically lasts 5 minutes) +- ``Uncertain``: The background history of BSEC2 is uncertain. This typically means the gas sensor data was too stable + for BSEC2 to clearly define its reference. +- ``Calibrating``: BSEC2 found new calibration data and is currently calibrating. +- ``Calibrated``: BSEC2 calibrated successfully. + +Every ``state_save_interval``, or as soon thereafter when full calibration is reached, the current algorithm state is +saved to flash so that the process does not have to start from scratch on device restart. + +See Also +-------- + +- :ref:`sensor-filters` +- :doc:`absolute_humidity` +- :doc:`bme680` +- :apiref:`bme68x_bsec2_i2c/bme68x_bsec2_i2c.h` +- `BME680 datasheet `__ +- `BME688 datasheet `__ +- `BME680 VOC classification `__ +- `Bosch BSEC2 Library `__ by `Bosch Sensortec `__ +- `Bosch Sensortec Community `__ +- :ghedit:`Edit` diff --git a/index.rst b/index.rst index ebe17387e..5b7a3f43a 100644 --- a/index.rst +++ b/index.rst @@ -442,6 +442,7 @@ Environmental AM2320, components/sensor/am2320, am2320.jpg, Temperature & Humidity b-parasite, components/sensor/b_parasite, b_parasite.jpg, Moisture & Temperature & Humidity & Light BME280, components/sensor/bme280, bme280.jpg, Temperature & Humidity & Pressure + BME68x via BSEC2, components/sensor/bme68x_bsec2, bme680.jpg, Temperature & Humidity & Pressure & Gas BME680 via BSEC, components/sensor/bme680_bsec, bme680.jpg, Temperature & Humidity & Pressure & Gas BME680, components/sensor/bme680, bme680.jpg, Temperature & Humidity & Pressure & Gas BMP085, components/sensor/bmp085, bmp180.jpg, Temperature & Pressure From bbc391290297778e67bbc58b65725c3c1aaa413a Mon Sep 17 00:00:00 2001 From: juanluss31 <40864809+juanluss31@users.noreply.github.com> Date: Tue, 13 Aug 2024 03:12:51 +0200 Subject: [PATCH 26/53] Add Xiaomi LYWSD02MMC (#4046) --- components/sensor/xiaomi_ble.rst | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/components/sensor/xiaomi_ble.rst b/components/sensor/xiaomi_ble.rst index cf88a30bf..9929cc6b1 100644 --- a/components/sensor/xiaomi_ble.rst +++ b/components/sensor/xiaomi_ble.rst @@ -4,7 +4,7 @@ Xiaomi Mijia BLE Sensors .. seo:: :description: Instructions for setting up Xiaomi Mi Home (Mijia) bluetooth-based sensors in ESPHome. :image: xiaomi_mijia_logo.jpg - :keywords: Xiaomi, Mi Home, Mijia, BLE, Bluetooth, HHCCJCY01, GCLS002, HHCCPOT002, LYWSDCGQ, LYWSD02, CGG1, LYWSD03MMC, CGD1, JQJCY01YM, MUE4094RT, WX08ZM, MHO, C401, MHOC401 + :keywords: Xiaomi, Mi Home, Mijia, BLE, Bluetooth, HHCCJCY01, GCLS002, HHCCPOT002, LYWSDCGQ, LYWSD02, LYWSD02MMC, CGG1, LYWSD03MMC, CGD1, JQJCY01YM, MUE4094RT, WX08ZM, MHO, C401, MHOC401 The ``xiaomi_ble`` sensor platform lets you track the output of Xiaomi Bluetooth Low Energy devices using the :doc:`/components/esp32_ble_tracker`. This component will track, for example, the temperature, humidity, moisture, conductivity, illuminance, formaldehyde, mosquito tablet and battery level of the device every time the sensor sends out a BLE broadcast. Contrary to other implementations, ``xiaomi_ble`` listens passively to advertisement packets and does not pair with the device. Hence ESPHome has no impact on battery life. Thus, if you only use such sensors, you can safely set ``scan_parameters.active: false`` in ``esp32_ble_tracker`` configuration, to save from spamming your RF environment with useless scan requests. @@ -143,6 +143,26 @@ Configuration example: battery_level: name: "LYWSD02 Battery Level" +LYWSD02MMC +********** + +Hygro thermometer, rectangular body, e-ink display, broadcasts temperature, humidity and battery level. Encrypted. + +Configuration example: + +.. code-block:: yaml + + sensor: + - platform: xiaomi_lywsd02mmc + mac_address: "A4:C1:38:54:5E:18" + bindkey: "2529d8e0d23150a588675cc54ad48400" + temperature: + name: "LYWSD02MMC Temperature" + humidity: + name: "LYWSD02MMC Humidity" + battery_level: + name: "LYWSD02MMC Battery Level" + CGG1 **** From 3c1f1871cf4145bfae47cd793635d44148368227 Mon Sep 17 00:00:00 2001 From: guillempages Date: Tue, 13 Aug 2024 09:44:46 +0200 Subject: [PATCH 27/53] [online_image] Add placeholder documentation (#4102) --- components/online_image.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/components/online_image.rst b/components/online_image.rst index 7ac693fd5..a69fcb68d 100644 --- a/components/online_image.rst +++ b/components/online_image.rst @@ -37,6 +37,8 @@ Configuration variables - ``PNG``: The image on the server is encoded in PNG format. - **resize** (*Optional*, string): If set, this will resize the image to fit inside the given dimensions ``WIDTHxHEIGHT`` and preserve the aspect ratio. +- **placeholder** (**Optional**, :ref:`config-id`): ID of an :doc:`Image ` to display while the downloaded image is not yet ready. + This placeholder image will **not** be resized; regardless of the ``resize`` option value for the ``online_image``. - **type** (*Optional*): Specifies how to encode image internally. Defaults to ``BINARY``. - ``BINARY``: Two colors, suitable for 1 color displays or 2 color image in color displays. Uses 1 bit From 52a59ad8408bf14673efc6e2ca95cdf856809b85 Mon Sep 17 00:00:00 2001 From: Clyde Stubbs <2366188+clydebarrow@users.noreply.github.com> Date: Tue, 13 Aug 2024 18:06:04 +1000 Subject: [PATCH 28/53] [lvgl] Document `initial_focus` for encoders (#4128) --- components/lvgl/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/components/lvgl/index.rst b/components/lvgl/index.rst index f47df9e91..402127229 100644 --- a/components/lvgl/index.rst +++ b/components/lvgl/index.rst @@ -75,6 +75,7 @@ The following configuration variables apply to the main ``lvgl`` component, in o - **long_press_repeat_time** (*Optional*, :ref:`Time `): For the touchscreen, repeated interval after ``long_press_time``, when ``on_long_pressed_repeat`` :ref:`interaction trigger ` will be called. Defaults to ``100ms``. - **encoders** (*Optional*, list): A list of rotary encoders interacting with the LVGL widgets on the display. - **group** (*Optional*, string): A name for a group of widgets which will interact with the the input device. See the :doc:`common properties ` of the widgets for more information on groups. + - **initial_focus** (*Optional*, :ref:`config-id`): An optional ID for a widget to be given focus on startup (especially useful if there is only one focusable widget.) - **enter_button** (**Required**, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``ENTER`` key. - **sensor** (*Optional*, :ref:`config-id`): The ID of a :doc:`/components/sensor/rotary_encoder`; or a list with buttons for left/right interaction with the widgets: - **left_button** (*Optional*, :ref:`config-id`): The ID of a :doc:`Binary Sensor `, to be used as ``LEFT`` key. From c1f0ce57724c3b2cbf94b57a2e48c15483a9dd5f Mon Sep 17 00:00:00 2001 From: PaoloTK <60204407+PaoloTK@users.noreply.github.com> Date: Tue, 13 Aug 2024 23:29:58 +0200 Subject: [PATCH 29/53] Updated documentation for Light dim_relative min/max brightness feature PR (#3984) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/light/index.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/components/light/index.rst b/components/light/index.rst index 60125554e..d88af7dd4 100644 --- a/components/light/index.rst +++ b/components/light/index.rst @@ -318,6 +318,15 @@ Configuration variables: - **relative_brightness** (**Required**, :ref:`templatable `, percentage): The relative brightness to dim the light by. - **transition_length** (*Optional*, :ref:`config-time`, :ref:`templatable `): The length of the transition. +- **brightness_limits** (*Optional*): Limits in the brightness range. + - **min_brightness** (*Optional*, percentage): The minimum brightness to dim the light to. Defaults to ``0%``. + - **max_brightness** (*Optional*, percentage): The maximum brightness to dim the light to. Defaults to ``100%``. + - **limit_mode** (*Optional*): What to do when the current brightness is outside of the limit range. Defaults to ``CLAMP``. + Valid limit modes are: + + - ``CLAMP``: Clamp the brightness to the limit range. + - ``DO_NOTHING``: No dimming if the brightness is outside the limit range. + .. note:: @@ -338,6 +347,8 @@ Configuration variables: id: light_1 relative_brightness: 5% transition_length: 0.1s + brightness_limits: + max_brightness: 90% - delay: 0.1s .. _light-addressable_set_action: From ed4a4c292c32f4d520e1c58120cdd0204f0708f1 Mon Sep 17 00:00:00 2001 From: Markus <974709+Links2004@users.noreply.github.com> Date: Wed, 14 Aug 2024 04:03:16 +0200 Subject: [PATCH 30/53] Add docu for Homeassistant Switch (#4006) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/switch/homeassistant.rst | 30 +++++++++++++++++++++++++++++ index.rst | 2 ++ 2 files changed, 32 insertions(+) create mode 100644 components/switch/homeassistant.rst diff --git a/components/switch/homeassistant.rst b/components/switch/homeassistant.rst new file mode 100644 index 000000000..177adb3af --- /dev/null +++ b/components/switch/homeassistant.rst @@ -0,0 +1,30 @@ +Home Assistant Switch +===================== + +.. seo:: + :description: Instructions for setting up Home Assistant Switch with ESPHome that import states and allows control via your Home Assistant instance. + :image: home-assistant.svg + +The ``homeassistant`` Switch platform allows you to create Switch that **import** +states and allow **control** via your Home Assistant instance using the :doc:`native API `. + +.. code-block:: yaml + + # Example configuration entry + switch: + - platform: homeassistant + id: my_cool_switch_from_ha + entity_id: switch.my_cool_switch + +Configuration variables: +------------------------ + +- **entity_id** (**Required**, string): The entity ID to import / control from Home Assistant. +- All other options from :ref:`Switch `. + +See Also +-------- + +- :ref:`automation` +- :apiref:`homeassistant/switch/homeassistant_switch.h` +- :ghedit:`Edit` diff --git a/index.rst b/index.rst index 5b7a3f43a..b1dc97a30 100644 --- a/index.rst +++ b/index.rst @@ -781,6 +781,7 @@ Switch Components Shutdown Switch, components/switch/shutdown, power_settings.svg, dark-invert Tuya Switch, components/switch/tuya, tuya.png UART Switch, components/switch/uart, uart.svg + Home Assistant, components/switch/homeassistant, home-assistant.svg, dark-invert Button Components ----------------- @@ -1042,6 +1043,7 @@ Components specifically for interacting with Home Assistant. Bluetooth Proxy, components/bluetooth_proxy, bluetooth.svg, dark-invert micro Wake Word, components/micro_wake_word, voice-assistant.svg, dark-invert Sensor, components/sensor/homeassistant, home-assistant.svg, dark-invert + Switch, components/switch/homeassistant, home-assistant.svg, dark-invert Text Sensor, components/text_sensor/homeassistant, home-assistant.svg, dark-invert Voice Assistant, components/voice_assistant, voice-assistant.svg, dark-invert From c8a20d91f3d79f333b81d0002a5e166b043192e6 Mon Sep 17 00:00:00 2001 From: Landon Rohatensky Date: Tue, 13 Aug 2024 19:04:04 -0700 Subject: [PATCH 31/53] Documentation for Home Assistant Number (#3942) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/number/home_assistant.rst | 36 ++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 components/number/home_assistant.rst diff --git a/components/number/home_assistant.rst b/components/number/home_assistant.rst new file mode 100644 index 000000000..3a657c513 --- /dev/null +++ b/components/number/home_assistant.rst @@ -0,0 +1,36 @@ +Home Assistant Number +===================== + +.. seo:: + :description: Instructions for setting up Home Assistant numbers with ESPHome. + :image: description.svg + +The ``homeassistant`` number platform allows you to create a number that is synchronized +with Home Assistant. Min, Max and Step are not configurable for this platform because they are taken from the Home Assistant entity. + +.. code-block:: yaml + + # Example configuration entry + number: + - platform: homeassistant + id: my_ha_number + entity_id: number.my_number + +Configuration variables: +------------------------ + +- **entity_id** (**Required**, string): The Home Assistant entity ID of the number to synchronize with. +- All other options from :ref:`Number `. + +``number.set`` Action +--------------------- + +You can also set the number for the Home Assistant number from elsewhere in your YAML file +with the :ref:`number-set_action`. + +See Also +-------- + +- :ref:`automation` +- :apiref:`homeassistant/number/homeassistant_number.h` +- :ghedit:`Edit` From 08aaee13a3b67e89c74198e6aabb76f9e1037e48 Mon Sep 17 00:00:00 2001 From: Clyde Stubbs <2366188+clydebarrow@users.noreply.github.com> Date: Wed, 14 Aug 2024 12:05:28 +1000 Subject: [PATCH 32/53] [lvgl] Document `update_on_release` for number (#4132) --- components/number/lvgl.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/components/number/lvgl.rst b/components/number/lvgl.rst index 0183592cc..29b2e5cfd 100644 --- a/components/number/lvgl.rst +++ b/components/number/lvgl.rst @@ -15,6 +15,7 @@ Configuration variables: - **widget** (**Required**): The ID of a supported widget configured in LVGL, which will reflect the state of the number. - **animated** (*Optional*, boolean): Whether to set the value of the widget with an animation (if supported by the widget). Defaults to ``true``. +- **update_on_release** (*Optional*, boolean): By default the number will publish a new value each time the value of the associated widget changes. If this option is ``true`` then the value will only be published when touch is released. - All other variables from :ref:`Number `. Example: From fcd1f157e601664804d399107f4980a0afb6e80e Mon Sep 17 00:00:00 2001 From: Clyde Stubbs <2366188+clydebarrow@users.noreply.github.com> Date: Wed, 14 Aug 2024 12:06:15 +1000 Subject: [PATCH 33/53] Document `color_filter_opa` style property (#4136) --- components/lvgl/index.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/components/lvgl/index.rst b/components/lvgl/index.rst index 402127229..50648ea8a 100644 --- a/components/lvgl/index.rst +++ b/components/lvgl/index.rst @@ -266,8 +266,8 @@ You can adjust the appearance of widgets by changing their foreground, backgroun - ``LEFT`` - ``RIGHT`` - ``INTERNAL`` -- **radius** (*Optional*, uint16): The radius to be used to form the widget's rounded corners. 0 = no radius (square corners); 65535 = pill shaped widget (true circle if it has same width and height). - **clip_corner** (*Optional*, boolean): If set to ``true``, overflowing content will be clipped off by the widget's rounded corners (``radius`` > ``0``). +- **color_filter_opa** (*Optional*, :ref:`opacity `): Opacity of the color filter. Currently color filters are applied only by the default LVGL theme, this option allows the effect of those to be disabled by setting to ``TRANSP``. - **outline_width** (*Optional*, int16): Set the width of the outline in pixels. Defaults to ``0``. - **outline_color** (*Optional*, :ref:`color `): Color used to draw an outline around the widget. Defaults to ``0`` (black). - **outline_opa** (*Optional*, :ref:`opacity `): Opacity of the outline of the widget. Defaults to ``COVER``. @@ -279,6 +279,7 @@ You can adjust the appearance of widgets by changing their foreground, backgroun - **pad_right** (*Optional*, int16): Set the padding on the right, in pixels. - **pad_row** (*Optional*, int16): Set the padding between the rows of the children elements, in pixels. - **pad_column** (*Optional*, int16): Set the padding between the columns of the children elements, in pixels. +- **radius** (*Optional*, uint16): The radius to be used to form the widget's rounded corners. 0 = no radius (square corners); 65535 = pill shaped widget (true circle if it has same width and height). - **shadow_color** (*Optional*, :ref:`color `): Color used to create a drop shadow under the widget. Defaults to ``0`` (black). - **shadow_ofs_x** (*Optional*, int16): Horizontal offset of the shadow, in pixels. Defaults to ``0``. - **shadow_ofs_y** (*Optional*, int16): Vertical offset of the shadow, in pixels. Defaults to ``0``. From 37d65d2eb213541405defd25431cb43badc54676 Mon Sep 17 00:00:00 2001 From: Philippe Wechsler <29612400+MadMonkey87@users.noreply.github.com> Date: Wed, 14 Aug 2024 04:25:50 +0200 Subject: [PATCH 34/53] support illuminance for airthings wave plus device (#3110) --- components/sensor/airthings_ble.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/components/sensor/airthings_ble.rst b/components/sensor/airthings_ble.rst index 697dd7bad..56267a672 100644 --- a/components/sensor/airthings_ble.rst +++ b/components/sensor/airthings_ble.rst @@ -71,6 +71,8 @@ Configuration example: name: "WavePlus CO2" tvoc: name: "WavePlus VOC" + illuminance: + name: "WavePlus ambient light" battery_voltage: name: "WavePlus Battery Voltage" From 11ade94a738eb5297277ff0223a3adf1463b328d Mon Sep 17 00:00:00 2001 From: NP v/d Spek Date: Wed, 14 Aug 2024 05:42:46 +0200 Subject: [PATCH 35/53] Add new Action and Condition. (#3953) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/speaker/index.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/components/speaker/index.rst b/components/speaker/index.rst index 045d3bab0..aa9279ad9 100644 --- a/components/speaker/index.rst +++ b/components/speaker/index.rst @@ -60,6 +60,17 @@ Configuration variables: - **id** (*Optional*, :ref:`config-id`): The speaker to control. Defaults to the only one in YAML. +.. _speaker-finish: + +``speaker.finish`` Action +^^^^^^^^^^^^^^^^^^^^^^^^^ + +This action will stop playing audio data from the speaker after all data **is** played. + +Configuration variables: + +- **id** (*Optional*, :ref:`config-id`): The speaker to control. Defaults to the only one in YAML. + .. _speaker-conditions: Speaker Conditions @@ -79,6 +90,21 @@ Configuration variables: - **id** (*Optional*, :ref:`config-id`): The speaker to check. Defaults to the only one in YAML. +.. _speaker-is_stopped: + +``speaker.is_stopped`` Condition +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This condition will check if the speaker is fully stopped audio data and is in idle mode. + +.. note: + +Between the time ``speaker.is_playing`` is false and ``speaker.is_stopped`` is true the 'speaker' component is closing down structures that where used to play the data correctly. *It better to check if the speaker is stopped then that if it plays.* + +Configuration variables: + +- **id** (*Optional*, :ref:`config-id`): The speaker to check. Defaults to the only one in YAML. + Platforms --------- From b3f5742e25e1ca0757aea193c1eb881c67dcb290 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 14 Aug 2024 16:56:53 +1200 Subject: [PATCH 36/53] Bump version to 2024.8.0b1 --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Doxygen b/Doxygen index cdff1cae9..00714ae6f 100644 --- a/Doxygen +++ b/Doxygen @@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome" # could be handy for archiving the generated documentation or if some version # control system is used. -PROJECT_NUMBER = 2024.8.0-dev +PROJECT_NUMBER = 2024.8.0b1 # Using the PROJECT_BRIEF tag one can provide an optional one line description # for a project that appears at the top of each page and should give viewer a diff --git a/Makefile b/Makefile index aaf14f951..be8260b94 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ ESPHOME_PATH = ../esphome -ESPHOME_REF = dev +ESPHOME_REF = 2024.8.0b1 PAGEFIND_VERSION=1.1.0 PAGEFIND=pagefind NET_PAGEFIND=../pagefindbin/pagefind diff --git a/_static/version b/_static/version index 092c4094c..84b6e8968 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2024.8.0-dev \ No newline at end of file +2024.8.0b1 \ No newline at end of file diff --git a/conf.py b/conf.py index d9d29eb02..6b16299ac 100644 --- a/conf.py +++ b/conf.py @@ -69,7 +69,7 @@ author = "ESPHome" # The short X.Y version. version = "2024.8" # The full version, including alpha/beta/rc tags. -release = "2024.8.0-dev" +release = "2024.8.0b1" # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. From 9419f97921cced9f053cf3c2d49abd4b1c1c6671 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 14 Aug 2024 17:26:49 +1200 Subject: [PATCH 37/53] Update changelog for 2024.8.0b1 --- _static/changelog-2024.8.0.png | Bin 0 -> 196992 bytes changelog/2024.8.0.rst | 269 +++++++++++++++++++++++++++++++++ changelog/index.rst | 2 +- 3 files changed, 270 insertions(+), 1 deletion(-) create mode 100644 _static/changelog-2024.8.0.png create mode 100644 changelog/2024.8.0.rst diff --git a/_static/changelog-2024.8.0.png b/_static/changelog-2024.8.0.png new file mode 100644 index 0000000000000000000000000000000000000000..cf40f46b68f6faf18be6562e23085d5663b29878 GIT binary patch literal 196992 zcmeFZ_dl2K|2M8AtE@-v6g*Z*++@Or;*DbMG59_Mj99{2S)123FAy_;%36$uH+?z3l9E|HMz^dKQ2 zEuh$mpXAK0{J{TF-aT{0o`i&^ocM2BC_fD=2?+rw7V_dKm$>fmF7qPhNQ+A>O2M^r+Sk*sd>-a)uT_00ET(TJ6zQ*YILgc0WoRV+ zQ@gyyl=woSVa61D@3{0$!P^#ji(YMRVdcMmNz?k$DN%6#|No_K7TK4{L56C~e&hgYmNk3@MFide@-ZC~e-gf@{c^6mL zZ{6J+<5MKm)YKm9%k+183KdVC+IjGV%e}!tvqMLY3@lFkuBxfgT553oEAxEI!qSq$ z+1c5}-Tkdbq}W{t2jA#uHVq98BNG#!!om|~78cyHvaIzna>`e)?w{=W`uH)kaDQjc z&E@&Amjzo?@w^6wQiX+u7xL}QwLe_gruvBSenP_G+MhpXHaFbO%*^_JzCMmi9d4f* zANc;PRqj^lN#;olVmZ8zo0*&cnH#C+J3xOi;ZlMcCm$cx!Gj0w26)cL1Wo+TOR?1U zrMqorWJDq?EQ|{r2siXn9BWFr`0fmS#H&}ORaF$fe*LPdt}cCj{LXaWw+9*Zyv#z^ zORzvKa_d_S!}+g;^vRV1J|C*9tNZJ%T>i$YIWa=YHom}r8;NCWa_F1m9!c7duI5fZJSHEw}0FDoJUY__wCN?i;V#k zjY5ajLQek9z1+wU~q7AW6AJVZxLHyU|>~U-CpC6TUgPCB2RY-%LbC2 zJ9ie!zYYs~n077CWTY;-s;Y|4%9pG;VZ4M-QgZJT*5kuLujSk&C2w`S@u8Nz5@$8x9MSLC$_md zE_^`7fr4GZi_zFug{8nwVZ0-YTS-}YsB#yJ*pBz-V=p%b1SCIU5q~(wLTq`>*OC=q zoTs!!_>=-9leCiw0u}Ah~LXYv2RD-Yky*F3h zt8LO0IIt~SwtS#Z)QBu)OnE}d?(OZp>wpxUkdTm1uKUKSqrlZ{3XA#}rfhv3>xMVm zutdfd7VjOd2^$oa6uQnmkBB&0QWfygVa%&7PMJLDfb{6peeC__Rx&b1L@@3~=kc#!c#F8f|-eK$=VMwLrG(WTJZe{bv{7o{H1| z;-ry<+Z!Ai-Nk+^>(eLY>(>wPXudk+@{xS`qgdYAmpmPxZMj#Mrf5AqCqDG(rs|1G z-03->m8kJ8M$TR2Zr@3)i$-@Dm#^h>ETQRmTN=f#U5x({4v<8=er?+DMzJH?>Ltey zW}$}X3@{5@nFLGzCHcy@{)*(vAMY)i}(#A zR3o1w?j$8Yf9`&~SFrTm*_TE(HbO3ICVZ$7!*$V*ar`J}OG!v>-MS@W)pUqh#lz}h zjPEq#_vshJE=>Fm=l!MZaP1|JX2eT5l7`&d*XU0xV|DQL6uWm<{B2Dk^A5XfXIDBu z)|}-sW75&tN!7VnZ#mbc8J+DG6%w`q)azfLEZ&|8=89i3H!`}1 z1t|Ugo&4>oC#9b(>Q$z+j-m>U_I#Bk&M7mqKX&uQXj>&JQDtRimD8u+V!`7VwLY4i z70@qWv>&OfsC>ezI#$-%x&PCRpGpa8p(<9rKYmbBGYgeRN!#yGAk_#@f564X%`IL3 zp!pO^j^5|HaYnS|vpaU|C~0oq^I+$0hFi=ZBlvWZeNk_|b#`72S@iVu%yL_>_Vx4o zQ|d<@KdEjiWJI^SJRyL#8zIh^%nL_`3JTe77}GV{KDRs22Z z7B)6EpS?B;&Tw<793N}iNK^@Ah!D4+sSXq5w^opsm)HB^BzWrCLBY<#)2~Nth@Jg0 zGqdEg?Ldp%E+vQUhds1Y?S`r&6ujj#m~@q9G1hiXKPN=VXN@@ECLw6ucuiEc-c zIi;eqBSyhHeUg)2NxQbRbi4gRF1s7_NX`s1mm2PjQVO;fMts5RtzuM9EQzCKR7 zxVY$(yC#Pc+t6@9N>np6ut8k=c(O5Wi?@WfiFUcrPca-WR6{h8*EpKcVjW18i*c ztgMe8G4WG%rspQ>r0n(a@fobVUhJjMZ&1Ql+S(dAM>b!dZPomcLEd-z9sd$5Gc&V* zUgpWTPveZnw{JgLnHw?f$Taqeo%!(7{?j8lG8Of7PZN&!?X`}dpRxbV62E~P0x*g0cxnE!kr z!{JQJMy|$}a=q5Sa|OA$xI%1B6Wc^BTa zO>4fatgUhL@SK`w-nlZrupnyFC53JD;azd5hVG=rr6fjlgUSNO@uR<#i!ROgwr3P? zCg+Z5D+R2E9KE<5ds6$#3(nZ!VEP;NF}rnjb-#7C{7*YnMNhdmT;fX+z#z{jfsbVr zysDjMnwgVR@$c6soki*kmXeZ^ME!}1j&3Dx>=EvLr%tl=#cNyKr=Kzo#+aI$Cp0l# z`|plWrPH)o3+&h!IfKv8F)<~)6fVVf+f7bR-V>{S{`~1nmlzoK?8)-p@;Y?*@Sh(q zj}-p4wXRW@c4j9j#U49$Ocf0HhaLi) zDRKpiZD@?8c2`cPU>w`eQa-`+#yrHu9sQ z4qVT-BcnZdqU3kp9nMfSltwZO3yaVB`QJ)P?&S+|b8`o=9;cCWUmTQs>cJ4W1C^P8 zG_IaP$Br>s)J1(O^QWCzUAVcAmG!M&mdW(|yl-CK@r<*svGSgG*A{Odkhb%knsywP zIhw5X{@nE9;$_!jlezi%K}V+_!Gq$@@5vZ-I;M+S@ zcg)W_)JBMs9yuSQVqnli>%BSnW6!&H@A}Xuu!v;;CMM_^7<^DhMYojxcIAr$0{a7U zh(1$)$tY}az_c>x+lPy9|2xKKYHMrh_U^457q_yq(#yTYLUZs$Kv!2+Y$YIPJUSTB z2)Ivm>9#t zc)NwQ!l6Sul>KSU4?c^);ri)Om7&2?Ru?UsWjCaD!fpOTiIls$`}*eE6q>njk^Iv9 z@7mg3dw4WXZf$OO%P=2$)HuBM3&6}pct3~V`PY)SLsko4zhS7fP`_{|r>Sz=d6-TjZ_U4gK*<`smIkyQL77gOAJ5M+RhQ0~d zD|q#dO?Ls`__ODwO79uuK~{(^(kd6k{<)w)ELPTjb>2!vMTJ9F_I3USo|4h*;E#@c z`y+|xW9#PM@P?|1S~hS1WBTT^??r>VA@tJ(^n*+FQAuMXeQUCgGMe^wn=3u_W-r8^s3^Ccvkn7Ig>K7upS@vaVdYqW9J9*y6um4@O5VwKEK&=fsJ#9wBNf zVmEjuafYP8o{cf?{rmSXlnqGi-6>!^ifjj%&J(6MX#{`K29`7o@RYa@-x?#sx_v5(JzR}UDl}MDGc+>As(TPZ# zT`2NOJruYLGEg9=XJ;=JMB^-Jyq46wN1P>=SZBql-s10o9hs)zY3e$FMUBBII*Pp& zfCkI6o69>o_ThY-_V73{7cpzK)}^V7rh{|fDi_Y6)X~Ty&vzliKrZn!9zU0WK#=ao zk!!l?*T3B<-gwy3qMhiXprFw6`-ERebo3K!@c~o^y^m&;=&T}GPJ~??dkf;OOxHfFJ6=~ z_GTC=3^%!`6qR~mF@;4$E&^~M#+%ri`&|ijd5Ld<8iYV zKt@l|^EtV>ABanGb1SD&#!me(6FVSvmqfq7K@se#+2Z>3>leN_-3~r|isE7pzOkgK z=>@N(ynKxFi@|Gqj+`rxmUWgIIK)7?zOmt&qn~A>nke{JEOHn3sh|=+YG#+5t%;E% z=b{3zcw!aM7GinN5f7D5`@_BG&*>W1E;6H`*6l+*j}*7y)43#oGeNLXT;mRwml1e& z5l&|nyf+Vct}W`g9KQrr07Ria`{ehQ7RKVO%`ZwD&$sw$m&D`OcJ0~~QJ2^WDq&}5 zH&_V`;!nGwH_()pCJwSK77~@NKUmdH`y(VKiKs+li<7tFG)*w$~!lQ zj=!NOI$Tf5xqhMaG#T({4U0V**f$#fIt9{E3xh(J`^B59)F5^$=;j1vIuonpwlaGd zb*ggy%`OtnR}%EDD!z0&rkaC^DCYGFTiVGPXt4s?C$l~37H9LDn3qdCZ;Dd*Dq`izF{jn90es@V`Yew-P{`TZqZKaH<$ z3sUuSH8nM5xY)a+4V-n0zMX<96pb3Gk9X(Z`sIUv$luxynIMw+;`B=N2WsHT&oqyY z>LfE-{FtkcRS?$|=JH(!2ICSJ6El%HF$o0dv-kxt3BZ-DBz#B1>cV(qimtH4&9+_5 ziJE1gGBYc47K&?(O`zO#2M^XsR06?_53W%8GTxwNmsi0i`}pzWVC7HL?dR^llC<6v z&9+V|Y=@UTFv#-CifyGnKAc}S-ONTeCN)(+BSPf9)#+2=Li$ps4u52h#(QsVE)Rtp z4py#Dd2f}WORBQ@N9Z}p0J>4Ov8!K8{UTgWwEDX61d>dz4Y!_zlT3Bq3Z;O%Xt&Qp zLVQC)7@<~Wm3$_iuR)>Sb9v{fo}Y~0M~dD~VC_IS&n8?_QB}1Kqru4_gYv@PDMiuf zI2)eMkZ?s$PozT5b5(n~2qXlsYi6o=i>fD=4+ohJJxzISabl=4G9sd+qGIT#&ttmy zjsAfFG+Ej}6`vP})xi;%KxNie70^acc&+PYn&qRxqFG;je~vBRR)Cgi1z73_WaYnf<=nQHog!1>?FL+ zkj9;<8u(Po6o+fa_%q?Ksc{0Zd92teuAz;b1f}Wg>*F|{4sNJd;K2K}T-Qgaw_eDg zFaTVe;?=vuon`;i4F`gLqj%mD-ZHqPr6ujG1GZ>_vgi{OOcyWRQ|$c=9gM_q_yH)W zp*QpJmQD7@kEI|RGm8_~6juxFM`%E<$kG1tZ9VD)TmA=S6`_980Mz7*9=GZGj|1NB zlxVC}3`l?L`>aaOIVQ8EX>fe_=WCz5Bx~%zVU1;yllgW-NB_Ki6R-L>9u3d%2s5bC zz5M)@_OdyAg+Cr4C$z6To9UeOxLbmYe~_iMU#I3 z(Gz&x*xLHhzkjz1J=gX^2>I+dz85>}?qrv=pYD{Kt83i3XqgX?n$*GsDAm=~N5{wi z(n7M@0oeW#kqV)Qpo4f%vrp?E~OD4yc?sdjbLikR)ipNb~OWf~k|@dMa{m zw%^@ccYSh>YGi1LxLyE1$YoXSTQ<;C`T6-34ZS|znj3j_VC1D*0yqe-MHdd&4*rpq zv;_6=c!(~~&m1DFJadR4+p^KeD)d#Z0eKPNpQv%^jx!0f$4{d1vqB}_YrZSFbhhv4 zV3%(~T5YYyx7C5NU%w)g94c^-$+o(~U%!5gj%eET+1760z<~o7(yks$P*-5+&X4W> z>dp+zP+sJ@7D4;sGMSv5oQs=VX?Hgp`2SJ;0tpDN#hX*OcLG(%$a_8ljOs@Tk+L7& zWzTCd`xa_X&4wqfNB#)V+4A^SZ*EeN)r$owOG+>9UZ@am-Y6tW4HOHr0|1K z@5CNKd-sa=e~-ze}R#qzu zUZf;Y9bIPn$p}Fl8+`!s#+h^H+D5I9Bm% zql)MBypR0t?9#lJL28(uo<7?BC9f+20v%DUir)Gj4Mfp2jpq0i;>jPBZdm*@C}>w5 z)6T!CYZ*`G=jR);t+WWqtEZ>O&d}!SwQGc61F=R4rDz)ow9WE-`;kohk#k^DDw+O4 z+eml5fhJG3xdLI^%O!BKukW7M#wyY8{94FuiM8jqy1*m%?%hk2QK)I8yV&Iq5M{3^L7nWklF)hV^Tu?2 z*_LD->cqrEvdSUD^Qg@dw>s!b!rh8c14?nkBE1j(UBqGic3Ebq=Db}s_nj{rdC8a4 zsif8us; zaYpVAE5%35!cU=Y$LpkAwwq!D3pZ3ZfKD+pzBC1$Mz7dQj(~3t@;?6l8wfemyk_sM&g{UX`5VTCy%hO1 zvay90Egq@Gd#G!=G@CO>*-?UFEO1#c$O;KPRm-R6B9SROZFZ-($owkr=+IDtPorfl zAk(||@9irCbG9qCpGmm117#bWB|^k_JD`7M{)-I@w1x|xZfI&m%P_$dvh4btMe%l{ zacNI7(Ep)BhY0^dL35Guon>SEXm7CskVffBx45`?8L+V^Zf5&SIkKe7Y5T*3^dD7K zo!Q62GP5d>0>RM;8biS2$I1hhPa=8l_VQ~b?%GLvFzEL0+&KIfm7?Ov)c)A(o+r6a zMuxCOE$WD>VDTr%@ym7l;A%ipQpy%Rs#G;z;vXB!KEgr)vnwDlkiPJaqtUNlx(RAb z-&W@q7l(uLohDuxZOnX|^^|iMeQqh-feNzq>D4EW>%toW!}POWPRrBA1S-bXX!~IH zOq);j`%|_V9JV+-KdK{-YC?D);7*Ky;x)dk{a{9MK9yxsAvI8B_+h%gf;#Gi>x(&i z0Si(lCj$cmLfkYlHN6P)$zaYB%^Wpq;F-eaNp0;ArMczOL>x^*5QkPLjiuqe^o~MF zNh$MYyAYwt&k4}SpMWBhSfQXKf3vY`;xjeyaTqQ36O`&8Saq0DCJQXrce+5dm z)-PsucJ?0Om(+yobGI@x^^L&4sHiA9h{su`-|gC7522p3K!73?*yce+7HkVccHf=5 z_T9tZ!xd5avv}+FZ9;6m@$=QjeEscPx29oRc{D5!c1{qk<5Z+r^SxG@nt?c1Z zXe4a@n2G-(;02*_9le_Uf#bF{HG1afFJJ5{v!ax@d;I!SHq?=28XxoBcDR-$QS7RK zsSZIo7QVg9b+C<`u3_DaRvxZ-8o}*xOZl zURzb)b^6)Cp&;A4cN;$M5af+0n6yYXv$PC=fyXH!p`FQ`*w)q-5D-uT>iJ>&cG56k z4X?AqQ$w+1+|R}G3m=2OTAFUxYT|Fz*OSlUnutS zyx4h!5P%~4_5Q!*zKorSRqij;CBz^>3ywYUDFA%iQ-v4ch+`k0PH`*Jf*o78FOIgq z`7jtj8JfG!N1g7bCI+a`>u!=k`>b0&+>cZCr|L|Mi8;t~E{Z~3y(VJ|Vz|;+t6ML` z%W~MQq1FV7;J=(o=Xu&_bMk%Z^LaF_PhoMG^laq=yyuw_r7v_;peV>cNmm019> zMuPI;o;TY_n`idykr-N28`Nsw&TIBoLug;~ z_43}Ewc0N};5cYdPg7B&;zUI3gD@Y^RP^M@?!7|Smt#j>l%_*HhUWDAgXg||`;1`Z zYaF(uR9N`iYO3ZoI6N#S7?zm-+QherCY6vxR-Vp*{4I}X6z>>+NvA}~9xCPZZ=e0{ zT09p*Yy-zshN7r?FmhNN&Y@ct?(gOd`CGs3+qa8Yw;WZ}jjc1^XFH6rdLY0T6&5}-)zk#b>QAYOBGjmDfUWsbCxw%mZ zSA0z@EQr&W@=o|RSEyQJvJQXUXE+R1o-~4%OZ9oFsi~GDWyjqX|M9M_B%C{U4s{0y z_%`^RsK@f%(D?+M-i{7EK4xJK)H?W7KD>+21rZ474|TPnJd@nfMX`rgX%0l-g z8i*{6?-Z1(wzP_J>HdU-hWepAyfrNL(wHG?Pg4T5jN@Nln1lW0fqMw#jMN0j?3rWd zQ8FV8CVTVkPe0$pCfOlp;irE0Zl>jJ;ETvH4Jy&mu`y%ldH8nn$=+gN%ikuG+Smk4 zaI<*+Qi-83`TF`o&VA870>UfeJbArm#EM7~07AKJtR4eIGQw&Azlb0C`S0I9IySZ^ zs1Si}JwXNY|9-t3yG7rpp5`9*s#IXe;?ku{5v$th7kN^q$euUEu=hCj` zT=?qdm?)Our;2k2FZ?^p_s|B{>Ar0*UcMx{bG|KV5+P4!i2jWS9(e=Dh05E2=Orh? zC0KhA5s~MtYd8XYUC)G);NdkteR{`pbDagctcaLc|5w>GNYX^vB79$iSZ;+EY6%h8 zhI1^Ea9S)L;dv{V=#vW#4-fBC@H#P4S_%=YAEJrR{8@?>Zx{zzAi;qCDps;bkDf_l zZYSy|kaLEZ2HZ4Q$IDk=uVA-)cA4QKI5&z{9|RDYmF|FL0oQs8o)CL2z*Jwj^yTEI)K_n9cs}PG&$r8c|a8_*>l{H9@k@ zlYQvIE}QGppkX98Z{E~S)}{nmsTJP4YxizZ$G_V6RaBZ!pFY__H9z4pO@cD!bN~J} zC<|neWesF!3D}H>IMW#^X;Mxx9IXfmi;$8DTLb5Db9(MLNK0|Cf{eo`2{?V-qIFwp zAmSfmU6SM2lJO{s8d*pN8S{CQdHfPBQ`PZzDE8huh@TH>n90h>Bn$rGZgcEwBF?0p z%K4ZR-%v=fle7{N6HVqv8zYY0+&eNA1cm+$8Y!{uVH^d+SOXaY4+eZL{qZBPJw6a5 z(bwO9005?X^BCi0xaoEKbUY2g!)jRu`ua$cw39>6`jnm|8l0)7C02RT~Wm|_l#Kgqz{_Dt!t;8`1|0EZwQ5jWR|MRE$Bdx<> z_KvVnBAuR3bYwjc|D%;-ts^BZ&3WutsB2KcDZWsy6DOjahkW7abBc=6L;O;@dbP8C zEiWhM7=bR{o!tYw;A8?5OE%^B29eJqE(rK-8qIoZJ*oz#3CaWq4Vs0!&aj5P(j3sYp^9{MKeglK|SjHC;@X#`2^J{{+x$F@`?}>u~`Uz344jr znjon#eAeCM)o$G20m<}*-8KMNXRRMC_z?1dc1zEwtIfpzb>>jx za)hTxKHuq;C%Fd!g-~=)%%sD`Bubg%cw5%)>)UXTL}Y^cdW9+cYt$9dSblAAV)o77 zIK-I_W0!7qeWoXLfj{*Lmw5Ldv-S<&-)1xk3RfKBTL}$wDtns zb`qTZArH!W=aGmD<%Kk}U>820QWcSd0yYSMu+85co2ag)R*FQICTq0Xa8D92Zp-T2ZfcmjthjzkE2+brE<9@n}N|p6s*uXHoK=`w7DXvRVU9 z<@S_Y?-CO5)ON!%8=;+GZd-f8g@z#lc}e1SX9({m?k@rfF#9zLXH)J)$LH@2zPd#n zp6xAkeSrR`xXKNsIV|`?13)D5p+@+sYESy&((SQG>snA zmWKD|+4HaE#-4EX0b}Pad?bkz1V5())Xe+UzimZ_er|5A-NDk6!bLQ*4j=kMwmf@} zZU6pimLo5J5Nrhw`8k`9Bkowd(~!=j6$pgsFx3;Cudhi2c>)3`U?z$bhsfIY??4x; z>>^jcWEeW~G;6-XuFdzkwk;bKSMV7TEOFiHKk)axx7#y$3hw^dF5^6z`hs-u<%<^$ zNm@s8j<{nPrPTkDB(D|SxN$=)ZBu(;DYWW+-CCqf<{|gl@fq*fe=CtN#CGkMpzx<* zTV3rn6Jw!alkuJG{_+;$A&^=`o$j%|x8^lrQD5TmmrjtaTMV!$#9h{XhBbQ9u=s8| zbLg2v1i-LgM@ydmeW#cy;@?US8cPG(@0JH`Rrp_O0Ubt=*~q=cMZhX>ZkCOg7LkA; zFkbe}b{g2WmwrgUE~u`o+&MEdQ+swN31O7m2YS8wl10BJQ)P-Q3%2{+O3g?yzjk+O zB?<-DR9O(6O~9*sGDcsXIfP?WhI5tWzGOpC;QUkX6K4Rx;nqgJ*dZ4A&!0)kPaotv zQf>PQ_r+ZhXD*Ls_Tjt`?(CR|0<@CsJH0W^?AM>ND?EiBAzDmAxPCTWpTDKh!h6E` z5pO5)La<`){sV!8mV3go-T#?C$Kkd5sizYa9w4tAuHsN-&h6iOp(s%;#8HArPk(3k zo?cywh>3an;loh_;a7SL@??i;D@tY?_=bP!^=h>`9zBDnKf*uKF|0|-=cbCZ#@=?aj% z-T5Ez^*3gg1V;s+8V-^L>}#%`^AM=l0@c+RN^uB=X)e!$9b%qvN18?qG6X8IOFa6JQjNU{wM|SgV-Fya-zoOAdC2zJ|ujU za2j0MgOY{Jt3y__J;}RvZrBOA24Wl8~r<#G4CK*=JL> z7QqQL0oShr!9UEP1r4;;qj%b_%$gg-N<02#Y<}=6Elsf5rVuu{T_toD21rmE1N>Fk zf|<4hr}9N1YhHD~cMDONET@U91_@%2Bpz@oKjaV>f2nKuDs0+#OkF3XPTQ5uE74)B ziC{oogdIt_hljDVH5$#R0{$}3)isoZlfaBBH)Cnr!gnU8zOSF1dg`=nxzn+?zQxac zGX4y2E$kCSwswkJ)Zu9ra4GXMdU$$9)@7h4l4m$&T+jD$Uz)V7%t5S6_e%jG!fV(9 zD3#*xBc1X#YEeK%kZwv;b@ba-v%$m9uO7E!HGrNQ*^Y+@LaRPJRb-4>0$ysexxS+D zc>65j>Yyk42&a-#jdW>-w#RV@Ud=uUuWzvO1Z-2B$O{F+N&y~z_UChVy37s|Cir70 zOmPH*;9p)5laNqBJ8b-LkqG&mdp;3)9VEyfI>4|Cp($Rw_7-7S4O-#e>YqPVp^o%& z{>?_)u|HU_n*?z58{lW?0bXzP3cj5K$ShJdGtG zbEI{MxF_Mn6HOcNH=r~2ql7KwUVh8>^n8En9GJ=%C4+JG6*~56`-;jCyegfjtq;_NZaeiHv$eY{BOZeBJX@ z)i~;lRjK1qq)@eZSFuy97D}0wvdIp6wEP2fmGWAb^4eI?bwErX!jI3=pTB<}DQqs2 z!g#0qDp`yUI1=ZlbOl)LpuES27e(2s(K3!wra-(z{^r~2b%f=J52#bo0$3tbUj_u? zo6iR|h>~%9G-kYl^aNFLzzNscLxg^ipYo%!^3-H(JCN(#iF;W50cie(-jdiAs$)OiY2-VAe<38wuCP81;k7u)siQ=zl49%xT6@$ zN*r=~H>4J}ladnLtY_k83NldfpleaKKzbFhtaglv7hfW;xpKJR9~_>lpFf8@uzBox z5UBMBc1f``+d+cM^&>#%RKX8tB&^YHRN@AY{_OU8_jG*v>$>=*pZK*(h}BPu-ur%_ z2z6*CK`}>~nn>^xzl?}PKR(bWeY?o<#q74KEW0}X<@GA+6 z3A*B+p`i+gqC>$Mgyuv^QZ&>x`_*gXm6gSXnlQnfM6=Iy$dyF&6Tv0K3aFb#fOlGQ z_bI*f*j$ga`t}BMD#P`$&tR6s!PdI!Is8E~69M25UM-?L_MCl)_&frRhJOx`{_Nh2 zmC3-|f{%|>uRgpAQy3{e^QS5PBx=ceAX}g!Yq<b3tp9kJt19tR?GKA~#F_=r~Y z0K#pQO}%-GQ@!=B_ijPfG_th(;2_tHkRI=XYuM@_$@3R4;vE#OC+yGX@rNrIwE?eH zDbs8}Nur%I!l~Z~rDI&{jFXd7goG7C;n%OO-dK}Q`{dlRo37PfIjFMSqH}p~O{AsL zR7aEV`1AUP209coJ6!?N5_a$PxcLp$-yk_0JUkCqR8!&p<3@?`1tLZWk&3WYk;5gX zY@ojXZ_bYR<#1OVg-5tFF027pSUgfFC}rRiL9D@D#{?5brMjkiMUJ~<%{BsUA%Zv!vC;}p99~Y zIn2LYG`Nvc14GxguVfo>8zte&J)RyO1Sliy$T(&^{D%=@=2Re{hx8;3Lm>f)LZuMPiXt=p%{GxEq}Y#ged&%%4& zc24#hX;;igeUJ6t#SBOm5d;%CJ@4T`;fy3*$47+|%Y}vV?p@o953mKQ8 zocNCFYARd+FnXVd3-Bs@%y^-ny*B;zDh^4_AH80@@JlXHxi2NOp*BZLSHQi8g7B?`3C|J76+@kbCf!`_>`DI)dV5@Rxh&yL8*yt3!Ksifpn&Fn;fsbfsL z^mMx%a1C%&1=1RjRf!QdgkekPo%{rewb^FNll`UkspH^7*-n}0yMiR+j* z5vVda;jubTiL`THSMa4m7u$qA^3~}r#;zKVU)*Uf#2rGoZG%l^^*2nBKTic}1PYh*g|f^9v0LF;4~zscNGE^FHB^*i!CGS>6P(O;}O9ZBx>dadmyX5mb6 z@cmJ|DLaKZeOV8CWQS<*D8rj14wd(&2Usy13TYJi{^6SlrVuk=Obg}6hCahUP6H_i zd6++a*aIh~(3qII$Z2C1Zf0|5=d7suU_?#OoOxTHeGELy>2=w}xZCv|6~t4NZ9njx zsrndMXBt#7W{=a`YPPikl`v<^eYb4UoG!&@R`1m5pw7xKvPtN{2-e^O--1aVmDVX-5@w?S@aya z95^)ybzvL@IFkkY`G`xg_Uh;s5E(U4J#xGcIjH;5D@E|c9VR-Nh{Ppsi)>$ljh&NI zCAu-A+on32F63D<1@=!Ob=?v(G7w|qu~2rVKyE=`rB|~x1NI}(NRDc41pd?U$$}OM z-Uv1KZH6CbP>=VzIy?fw0!b7jC??|k&DNK9LS2XwRmwQAwzo!^vSwfYQQ0d-n#)Jk ze^G|gDez~(CMtnaGePbzDH+SVHA0Uid4NLEO@;MsTK9l zZ>^zaT*P7Yf|QI*^%KI=B2))r#4Ao7|2EP@uXAgCMSPA%#hi?c%(fDkfCVi~?XdeS z%o9Sv0qyv6Vie!1mq5uLHpL$+CRS}U=FcGC-_)`enfMBGLBP4hJW!(e7d_ZX#I!2R z=`z5r9adVuVT}g4UX0~~Lqdf<*1Y09C!pXi>a{a_Zm^h;2nd1&2h2w>h#xmVO!q*< zGQs)u$xc!yoIymXX1#=d!ft@+V*9T{^kSt>$FR*S7dE6J;Dh{h4QqnPGd(}1dU6Qgia2tB00?u+gb7Xxpg1c{k0A^o=%~z2;XMphL^{bT*6YE3-pc&|)uEKFUVt=}ur{>lEx5$;0(P&fbabsAF>-4MRufIPnlIG!U#) zIo~kcyXW(V)vo)%>|S!DitSc^H#C~luIDqrFy42}I>hL(gMgr5meIHEh~NHousT6F zzkd&wo`*Reht@`nM7GF= zX(AR!&wZ){0VcvHey6E_0kQ?gksdECpfihsJ@8xSe=n7AZf+TGNKj|4`zu63+*o7m zoxQ>awTyYliy*JA+LA>Ve-<{eDUkt0nI@t$_Ct@68bi*7XY~GS$ekD`^EEnrbx`>K zWC14Vodi;t%Dax0&R$UB=j%ukr>{|JrH$+T_~}y_B9<=2dNLqT@$vC0y{f^8rF(B} zgnx>$MZ;6^3`XGG7tqGOas$Cttq-1>MKrIpoh~#3s0EI#eQ}+;@of!*KC%|2-w{;B z?N(wEiEL`i0(De+Pxk8S>Ia>aus8l)UKwCOn8+Fo(wc`Y+&s7zDJg~T1tu;Ei^$E) zyilNt`9O_Wc{U8H`0&K$Jn{D@w_n)lXxW_jvyY`&{K^h)K*lnrxRIx@FGr5g@{K^Fgpl09BtfO32K+@6p> zeSIY?_*YJ;l(DGGjL9!(A>im0x`<{luVR|06!LPWO}9+w#Pn+K*5>!f>7;9ULYT-9 zy2{IlYK!oYZ6)t4UA$oX{q=x^`EmfQyXgAg*1TXuG&MCzu`_gcck6)oXf{X!m9~WM zgvC7&boTst<^_SG(npgPrBy$E5Vaqm!jBjd0f!-UeCzgmnExeuCDe$$ovT~Kbo3J4 z;4DV4v1A$I;d({lue3`iLDZr|@o*5W+XXJdtyk=!u3r7NIyRrL`V!Kb#t8a%d~p^g zurM)ExVp->;Y?H~U@i=Vlioj-?8$dIH2_#%Tuyn=ec>+?fh9h&Mfw>}Chl&(PZ$3y zL}BKs|3{@Q(fh);m#!q^4e97iJG| zM?4@(Z7l9;H<9rHj82|U001A6GR27N1!RXCD@!gl;fy|6QVx*RC!gg$a^y(eKGFI> z;}!i1u~VE`9)^g3QNsqjxO!Yt@)RaZr3UmW&o0NUMNVVqXJO|OJsuiP8T@_Q!76$` z<_#%XS#DJ9zKho62!Bafx18xNdkz3dWb_K<%U%@j8TU#FfUqE5v9h{K)p-X@jqIj+ zsDeF_X6-cQeE9?BnJAG>BqlqdYC27J1wvKgZHd9iAcBoN(?@gsVTeJ#A?7-V>yb$% zMJv^EeW4gWV$&!iz}N%kmjp_q*dr)Y!3u`b>0mZ`v3NFsW)ymK3s)Q;K3FWeTVo!oooE z$1A++t9v-F5C_M}=bQJ0zubm#%B$y|yc$Vb8q%nxf>{xaW%~fd#NnwEX(eK=8Mv76 zm})05(t6W@MKuc+D6;A^tIou10HF~4+3{M;!ErM2HnHXMQ5$&xA}MHSDus*JxzyHD z5Bs#Zj>^!tVQwJOx@v26Ji}+{=f_n{isv+h4P0PU|GA1NRI<^bzq+}%u0Y21m)?Z* zJNi3MSgT267g!qZdLW3%;4OR%ZUymBLs`Oz$!^&YyPn<`tTT%L^tU z!2ARWi?W51#jtLH?HYtuaJN#Iz&Mgj@kTx}mQ`uO|zwde8}G87o? zCl8CwzYxlSL;1mhRp~Rf07PhiVswUsg9M(t3hd8ji)+w6XGbN7Ni|@Xpg_XeCs6U2t8YEEi2eo4mEwIF_r+~+Rv??uPk8U%FJW{wvlUbC!^NyMd=8v^ z3=}y>`9S4hPnta1y?eKgjFpL{WfecmPoJTn!$>ZM@avvS@N!oUm>uf(_zrgj)p>j8*F(kkWQff;%3-Ajx@ z2Ej3Ac3?=sYf(_Uxdj9?OzXjMdzZz&`H%O7;~^l|j$uY2JFL7^WGvIq2rA4N9S zjKCNOg+>sniN;ufh*jEp!e-IYwcyFVfSeepXn z4}o#P2=R18BWf+oGd;qSbu-diY|f*@!&%k-Q}6w3$by6fk7!__bkPEl*L2n*sNo;t{txXk|m6jrt1l<}&YePUaTY;o= zbKCey%nA8r?E6TSX7KgZ+#eObP!j}>h!6!d!^3BaK^7>es7xLq?cz-~_R{hpLGuxW ziK0D&M)?iMC6a+^7R^qK?cM9(;QKf>M_YA`=Yf!k(OM+&U$8PGeogc=g`ny^7=1;Q zEZ(Hz5k9tbtoeQL^XK%goIvG{rxTWAn1k(dSBE8h~{(gN=SZ?F^Fl4$nPs@m{_H}+Gqq%ZJ*R#4j3X* zrie^ELQ@gh5GZN~u!UT4F_^PD6l;uejk?&g*qbPPRDRXUcpNhYc?65{2Y-KywuP4h zDc-%CsU+(&)s;^KvT6iHQ{KNPN6RI2txs~di+eFbJlh#}+;i0dQ;8*dvD>0QfBY~`c2~C^_Dr|TVQ{~1o?;PROWv{9zrhXBDr5`HfO-wT(O*S{a1?~R> zP9>oXBNRY@i6M)d9lw5kLuQFr5)+!<>ofjU-2Efy*5;e~L>vvb$=~t}IV9|s%IiKR zKVBRz>}+2ge{&O~DtK`TDS}2l3GD#Xk^RKLH4{_CIL9P$$wm_t+ydxETm6ybaq-A7?fJF!VFyipZ z%E}T$*8~vxAQu*H;i1-+c__K!LncQEE>HaMUZ;N@aXyV6ysYIPl@B3PHnx7U&D{fq z4I#NQ#SDt}p5GTTKVG;KE$xNkNCfcb3a3spYB{F z<3Lt8ro@XZuo($q1|hC;yxpX4cz7qS2vdh=|437*|B`NVf12BS2eIRtLghK^G7TnG z?X$YWHl1DsTmq@)>MV2>2ds-UAyP!3A$*QiacE57YJN!2h*q$pz`A;>+)(y@UIt{Cy^94zjAe2*zkos`Qo$El!w+lchMB#}qFtV?RB_61+8lcbW7 zl*EfH?jwvMi&QAM%~Jq6m_EwM%K8S^VH!mZIroFMwzeI4ci3^~2@St)5EJ8Y0wYWy zna_Z=&I)b+<2vfNKbv|9TZZS3_Twp(rRta4UlfSoqIiRukMnWt>RvI-MfBDK2~_*_q*||?+0%-k53oQ)iqNK z7rx=oD4e~QaV)m}{iiw^_45iF*+q*v83{}gIl2Yobi_rRUGwm1IdFNSk6giWNmZTv zW3f?wPV+fgO?KZ!!=z$2oE94?HrTSG=KlUVg>wD)m*h zpGUOnck!I z*OxDZyndZ>$76uCV7ipL`BnXwsiN0T?9)#h!YWKrT^-kFzB~8ddez$6ny|pqV1f+$ zYHNm9Xq(RKM618aDd|lt7ExJCW?p=uol_k!!Nz85gxmd?4L%@YoIQNW(6BdscCBan z#Jt0iXonYGGmi~D{vHbJooY`AH%Nw1JqkE}e*91;@N~1aH|Md~cl%_WQV+U~#!2dH zTE0p=r?BDRx%8!1bKJUWulLqkZ?p9?F(_totD|pYJDqC0j(~G!;C^n~bkB6&%owW` zuh$sg;o#(y3x1U}S0{TO$L=$RcHBy`FvZiTTfC~H87nV0vBwQc%*5ph5_f9sMGH*W z7mUQX(@0NZ$0QO=mi(a0NmQc~gUj`vllE4g-q$c;eswM+q^-5btJrX<$34TQXk~aK zCKKtH)Th$J5kgx<5^nRO*?hTMEA`&FDHE67zs@(Q6OV-U%0*6%j= zsjuOePZBXRxs}0}ZhiO3Y232ZME14l7R@s0+g30|Gc2CDq^$hFYazujA!nz?V;`UG z-7W)93jRD~)iy9lhkBlrm37e|L${)$V*hcQ>#zA8e~(Y(^`5)w$=NJ%%zjuyGeSfW zH@~cS{yMw+zpR3xuxm8q@vR%Ye0)v4n~QnMm$y8JF+>ZL;V=^IY>nFE-!%y+&?H0C zlWF|m*6(vS)8$q+63u(ZsQkEm+acuIm1n z|Ha;0$3?kCZNn%QD4>Ldq#%vJ2+}RxEiKY54MQplg2KR1(%mwIbSga{UDDmc&>im{ z&+$CZ_x<_){m$>CbI(2ZUVE>#u63;#uPrNWj0wHupk!u{iUJ}V6%*Nj@hy`~K{pCd z$9jF;IyQlJI@c`1nKBbJsM< zYpdE0aSN#1kkQrYXj$9k`HF~$Ww?fl%AXS)tM7!oCNYRv4Gy;pFgV#$&VHbT5=?4{ z&o3xAst~rev{V7w67uO2w^=744k;v4(fQ+x$ERz`e&gBCwPf&67MpuuZ3XG+j|=@q zEs{O60ZPdpHS|(+sM`qyqC7HWbI^%FmxlrPyaCLseC@ER9<%zOodF*>;1_^592L3T z!2|57nxdlO`b=XZTCI~D+eky&7vcrn?PIk(v(%?(T@3^(A8Kl9p3Vl~;d&CC##toi zfvOe>!>LPPR&op;KtON8#p!6{2q3M&NqASE1|*>&CiWI+ABiIH%!BWeM+~8BPr!d` zUL6=+4QEe~2Bra?JllYVS{8)K8h~*LD#x6t^ZW*gvn-H+qjLIc6<_naw994g1FpfdumL`|Efy4y+JrEHAFz8a^9sTv$p`FSrzLt0o|G6aRQ1f; zYhl0^0H=^Iaz2M=$N&AAqBAN;Mf#IehQT4t+n+M@k*9Nbez`z;Fgxo2^n4I7uqRt$ z`TnQY{S2xL8Kh~cM8)Xn6fh_J>$w>N!f(g>Q8b8+^{rae)~+>M(db0h*#;~4gWDp< zZz+BDRYCaucyr=rfLN06>6%rgjlh?fkhH^9wq6Nk*B>{D85tN>!WYo4=VHsfQD9N? zpyZ_jfE9iTu$zH+RF}a7vmjUo)}WMC9#qC#X~%EEHfm~sF&wOU?E|vj@t_okrXAE< zE1>n)5csd>-C00eD<_>kQF<;$JfF$|eHoP}bhDSgDhfe3Zve7)BERkC20cV-kZ2d;3G`$`me> zx2e3*X~=Rbq0ow3^hsub7$)O)$wk|8r3q;+vSB>GV~Hv6y>5z{shkvFT|h=Dc-8f; z3^L^;rlW0^#7ab15S8!CoMfo=_(pu9_b$@QC6q27TCN?MFjL z2@mU+o|WWK)gHvGToXO|K_+Z~?!~MDqY4MDZTg6|s#hrO#!8F?#m0HpYED+kFyv$ z9yJ2RKU3G$%?DinnN_9BnhaR;5P*+0-i_bW>d@C|&uwG7$pD!n1G|q|%L{3*IDRb`OT&}F zi6|R?T{%K9;{c@%o5Gkixgl&|3fcf_mg8;8K)&j8&%#^~)d+xi@P5A34KOiJ8OR_A zKlnxL=3s>#fJ`DbgSvP!y#S2u10bXa?2U?^ly}~3(vi79@lQ} zQI}IMdpi97Zl0O1z=t8!k1)v*z)qliP+riBgHZt=Bal5AQT96>bepOGB`D3hFOA&B z%&>1xz!$8djqIL*OjGddX ze*kMoLnogVftj`Nhl%Jr$2OiXDZdw@>`fEct~_Wt1g(zzS@pFGynjqHpyJ$DTLS^k z@`xqR(a_Xf%TBPj)_yZMIPCxx0B6(xdrsFAe5`IzoyIfe5(&x(`ktIkf=Qr=hEr>_ zZ$!Z_(#~{%{2KPN*w+AP*(~#6)hT@e4h>V*PlMF2Uln2v+;nmbiN!2A1V z<>lpQ!*Q@8a#gL~@LdahvB1m;Zm$vh&a@XQi~A{As5Pi3w41(ER~E_w8<4L)-cBxK zWtE4hnh$Z)L{HUY-(-oO0b+RW;AaH*ypd>a!!fIrG>{hW)6_O-U15Ntl~Q1~4MxIMVJ{x*7{9g&$0lV%Lr2ji6C8g-@)2i9xN@tEWjU$;jo0XB*088ltGKZ!e zjW1;jno9HXWYLxaR1{~2eM!z-E?xmvO!aZZD*Wy=IGz*+Z+_g2=X1^mG2H0#1SmmS z2Pbvdb<`jSU~BJr)PPm&c(PkB7*kY-j%2`ry$x5OKNw88ba4m@3iF*zfvz*5gQXOx zH-9JCAs2v`sI=aUMov4NUI)9d?|MU+6yh)~XaJ5z4G0S+CTX7=0Gw6>{Eh2cR&2$_ zEJ3}zt82M^_0q#B-?L3Hp~)o3t};Dc+f$}NkeNk(RYUU`7|~+BN69T?b&VTsxlIO^ggGixhr(T9d1eY3NeO=e(SG zfI5fyotxAanHzpH4{bPKV&7m8Ig!ml>{WuCH9Fwz1NuL;b=L^YAxQT-U!V#i2jrQc z&+%N)=6HL9uCN3ejOGK%PoiS1uP+rmp1jf7_$dFr5BVxHd)@Xsu+7-@C(8*G73QXz zn$c*Zgx0;aaOSsYk97nNnz5Y?m|gG(ZFxPtJ%0doMY|xUNnrW-e+zBC$=ti#*gJ9Q z;akZpuLtD)S^-#^aix*7fi@ZgH|&Hu{Kg^Y|JIblJyC%+Kdb2I52%;q#XNCiAFxhk zAbFsvt<6Ff+F4=8&BbL20!S#(YrvPV8hG!t*6en&;Qhj`O--E*KeI=jCi{Wibs1FT zp*ZB123WUdt7b#Ef2-&jlOv98i2y2(Bzqf5<3h{v=Ws4MM=NMx*S~8O~n8 zz0b)2Yc!9;7I@M4a~~c09xuQ~SA>uFl028=f?V|^hs%M&Hh^paG>e4 z-!E;a>o6+{Frx4QC{JZb@!s{l@&!ksW+6-f*GuFKdbU}403?HsriX44>!*T3k_yj9 zXd3~_JBs{3xD(R)nnGAQl?AZovNLDXM_|kf2Rd#&1+KLK?WZ@RVq&a8nJDOKQwl0# z-$k<Bu8 zcCl5Gm!6uoeI|u2$5{-Fo2#owUat6EO0zc{rz2|CnE{4V3^dMk)f;t12T4Fu@?g?< z%5g0scYACU1PcQVGq)G^PBirOz56(krn|+u=fM6c1D_l5v}X0O&ziiE8c1-BSAx>^ z%1aPotmowcwaKD-TUf-LuQ3E0{5C;wdTE86R!$HfVPh+7_2NUf1Ncn+KxdA4Qea&5^spFboTV1U8NZyR}7v!c>>M{NCQV-?#4E{ z=t?FVlYlyjD8O1~(uVPhgQ}eokeP~(jm;6Irf!^Jmj#!Dzw(QUMnV1q9h-wPPaEKx z0jcYplUT>0sGf3lzT$d$va<1!HZ0tj1eoUxbfnjvEL1E1REqKG(-Dxw=LQc8((Xz? z!a$trAg+BJ@o{})1K6O-qY`vWD5`RG*jqRyOkj%_48fC?ru57NVYY^bMke5`bz-t! zvQ`{bIe}z^Zi9C<$m?eA?(RN~160KY$XanJCi1ER395sT6Ft4}=nULA2cRX;%p!wo zIJ4I+?CRqKG>FT%RgM+VYBEqF4ayf%!O$&FLCO!!#=w2#fz1JP;)Z~l3;bTc*fIsP zdC^oLF26arH9Gj`H}wPD2?#HT0hz!BYUV6)c{k1LEwD=Fs?O- zKuH@{dpYi*j|Bf#)q)GqZyUe_GCzH)#YhNmUr>d_owx8sf{d#bNG#}rZt~do%yly^ z%IKqd_YU}h5%jAj*rupnYgFI4Tde(Ol7M#Ql$#!L_Zh!;(V4r?@fPt}U_4msMUd3mlDU~?$_GG0JR(Sw8D?z)hUq=a0@z+6H;3rP@DgWNh z>Wi>X4W-BIHKDzq&(P7_;*JNdS3;VK42T=Ul>~QMB*H@57ofnI;d-TDV5GW3zzpp* zb142lPct=zw&7NwE5^$YQCK(({M7z>L6J2`eb|l1SjF>$r5qGG_{f70$!cnOEhl9J z;PzkH7huH=0spRe_P!FJYK6|Xn{S_=<>xb_Cj+8Y4&?FBS_}p$GeyYA!0$DysH#SQ z!Lol`20A3Zg-ibB@X~#2G7osCmk~0H#i+YL6iI(YfjbAFMLl4aCzmHc!!Ur3H?O~S zE4o;yK>)hZ9384{)(C-5Ji=`pWBs!tQTFFn1DS3ggy4T9QJ4Z6*dH8%rFCMH4G^MdN1_Fi&5f4+`3_sJgfSgo&1a6xx9#_H7H<&RT~h!~;CJ|&?8 z4M6Nmf|ShWbj(H#nmYvXTsjyXr4u2OiD?0TBd7w?w z2DIdmK}gm-R4$TB3$QA}NB!J;l}g5XT3S zrFTQPtzl#T?;SB*XtRxFyxvi?yNcMOvW3!MblPzRyK4{M_8OMC{0A8qX2RQ6VgfvWFY5!>>;(5o!-sZPv_vdy zeMu+wF7KcIecRtY*VPQBt9evL77oI{b^Eu#I{fnz|DvWCRWt zsIGYby#MzrQi*G3-`#ZqQKLDyM;4lPLecj55TTpt-hglt$EL!ya|MwoBlj)!L z;2V@2M`JTrZg|^QXAna#(PdA_e@2udqpFH`P<>TLUpA15^fuXSM>rGG>fq`pCLXHU zWAj>^^xs|I#|K5$amnJaKD8v1-wBgd;|%AVM<*95j|6`PAH1qN^#7TW1t0SA#w~C&cD*Y@EKtUAd_}d zAJ?pwWQl#M0Wo7Cg5`6Pt1G%jpW=~xO?>ybJZirxjHQ|Dju(c@-7=Sd&vV~Om3}SODtBbrwX588x>2**F0xHo*bws;PWWQyLP^wTZtK?452cYi^%ES53+fY?{t9VL zXq@%k5CH3V&}{+gHNL{(_(^Y?u;P-{Qp$bK+++tpRG$kv2hcGWX)-`p_43Y|VTGoG z={N%tfBxbmi2^I&d?w0z)`wFNhO zjT4Lxu76hR6_EVMz6zX(AC%zB;hCWK<+qQ$p~u`!fV{mNNNxZ#)*Nk@Go(=|zof@w z-E~?{=DZlezupp=AVEGFtsntsd3Jy3Shn3}Y(P?u9$uO5%?LXQoO2q?`q#!Y70CWjAEi>~4&*YnchV2jRt01QgrXzoY2mw4(^O06NkWS*v zoEfpv$?@68cY2~g5%E>|7AK73 zaYgjY&2VE9w9t8<{bQ%X zNkMv$*jO3Q4KUCuaW^qm2_`Y$3!OQUYdZ~}%ZJ??v(BH&gDp2^BrQEE^Vzc=w$;lq z{i=%CkU`Lr!i~S|#;c93t8tHPUU~!s(jX&DI~MS)k8^1k4|K6jPo6O3m1nUK*?o;P zt^(jbRgd})hB-|I$}a}`NP)+F^Tqt6k1+1sK8_~pRP|MjNbk?pVl$*3bKF!6)Bjfe zN+uBWN~~)O>W`)AgMLLOeEXsGXey*q+fqgH9SqYuf2>vCZNS9)b?y`PiJ^Bt7gW>% z%ZHJwUKPaabKeGtpKae>B2^9azfk(L#bl{#@$vx3{d}i8D6$T+6eiJqzUS z@nUa}HgcPm3;NsRfJ)j3ncg8{%D>U|e<@AO)|Jc)26HCmI+A_nz+W_}jiL`QB5&f)!+vI38+62Y0Cl?W4o%)>~*|6uD zOMigN>UE2SN;~O|9Fz{w{Jw+<&>RfNLuGl zurZZeh!i%F4;Ii!1R)o8m<6I})x$bR3e~F84&PAS#Nf64S1}}5DyLW86DW1;69Ooq z!WJ#Sc2kh;TKEP(Tn%nh;OL(9u#(KGNcc)OL3tfhp zF_k)8T0#mI+e@Wku=#X&3!!ErQUAK1o-{kpLoh3Fd`h>(v|;g=m;GpdUZOE`)QnNK z6%!8+2#iyka9nkF`tgy9KJ&tTOE{w1|Jc{l`%THyd6}8-`)-3+g5p&~G7OVIJJ47j zQJ8&dFy7!8D(taGRDaodSGUqB7+&(xc2u>~&K|?!OW;WKQ_$3-r>nWbRcRJ!+_7-i zdVbNwY=UWwNiT4&!;Mukos*mExs|(5edkD&Rd;Et6NNM+Q8|+*_=QGBj}KH1BtC)R)#7>NNPzmsCBhJBz_D`A8=XuV0C! zMQY~0N)3zS(uC;q1y|*}M-|ki>pJR%NG-^{Xx2TQ^WOYbA&L0L(Bf!2*3Vz4&!t=v zXaMSOexw@lReQn{2G%uM2w~4V!{vWrQqu~?C8J%CKSF{?2BoQ{247Z`rFj3pyWSR{k@qSPCk ze3@5ci;^ZPbA8=IJ9!HGb2Av^5X1S4+12Of+aKq~8_bflo)(19?JyPbN>?PQG2?3* zn7oV`&EYXhD17JJioLYR7_E?xaH~`RqHTP9a-mbYnR)J;a;`HL!aZ!g7PRNm#B@c| zl`xzIqsNfZ_zTNcAL>^lXxo+Y^Go$nbvrfF&;{2e;$_ChE76kxPk8hbBz!@anVeT& zTA5es$14>R7+FRJ0|f}>-dfv+$Y(1fJv69%c#U>ytdW*^+YxjUPETMA@&sWbk|!4- zgg-mM`l3fsu?zx?6T5k7oR5pl@*GE%q8;>erUW{dc3xr=5wS3^8)Yx`BjRZ& z$`CfYv0|-9qeV95>=>*3|2(UYj90!Wnpg#1(yht%4K=7NwcCTrqu+(%1CL^&ECkC~ z?xa+&&3Ct43qs|&X-CiZe`Fo(o4DI@f}k+h@xkm zA>XwBYh*4yA}y_1x}#Wd_e>CSPaUZt&aJ759kkHd!xWxW3If+CicWQ(Df>d55)Htb zX}K9j=vSUl4$K1`{Ksg&Q2{l|L!f@@nNX;3P9fTS3LzQxU@`PB!mQo33%t9`PtFa2 zp+k_{J!Ki*en6|C4=MHh+K+#qboca|>rjdM{`BN1A&zvk9KG2@#qTJ#K`tU#n?{3U zKxYu{V6I8_maO4V*pZFgwML_{AFO=+Uz*&U!%fXj7Hh&PG`BRa=C6_Q=E{WPxQ>_D z6oYPk46${%(FXx{OWz!gGHME5ZNFkD<)^<8w z4Y;|V=hsvimWL{aw503q&UxFh={;o_ryf<3L9p;)ZBCcSnr)0QMiSQqX=MO@|nBJ z9S!pI+sC|S?m#hIp8tmfr`{QVk)xjnwT~G z^5rojp~RsOQVIyXr&(1ZCcxZD1Y=m-I|0tG;Ay-X9eKY%QFnj78C8Cob-{Xmh0WNz zYUl-(U#ty7w0d|^`sIa2coNtXvv@-tN?6?wTjVz5LuF(IYg|m0CGXc4g4w2Zs@aj@ zy(Ww##ZeT+Q3Tk`>_wuKgQ{cW+#!;*-Re^TeYZs|(*Htc|Ifd^rS}+87AYITq)WhW zMMwm(-0x81B8xH8(f#I>ck3Q`X46{<-Kp2gH$&I@kC6=4?T1d1O*CUM+E}u}?V5rE znQbx}Cww$)$s)?~!ur(B9A+eHhW25*pF*N2u#u=Hu@DA0oK-S`to%G9i~r*HTL_zS0UIxz<)*Wf z3z!=`ZXlpsVk#H76u~B~MJ+$~CUW*514j#QN$5B-=qKwZisHW(?DI~~aZn@jZYq2HrwgL1~WyBKC!<+D~9Rkg)-emDJf@flNz{o z{&cm3L?CXg)fY(pm|WmSnf2J~1NN<=YZB5n4$#+CP852>(G!aY9vV?e8Jpz?P6paB z?eNmls1PZQ8uNfaSaEr+d2GI$CQGy&vW)d4U<|@4Pg!I{IT&p$<7AMfk95UBMkT(K zD<2jp6Pi_pJQ&5wdD!)+Bj#R_!eI1T^zQX)U_3euE1i^wm0yM)xa!uf(<<`MX~e~d z(84(V8-D!U2LZ^R*S?~Cfyh`zfk!7$V2CL)JkNs_K_TESlg-psYI<5q6xvc|d0Cr3 zsY@^LAU5&Kyka>3B@tTeXEL6i)npLc;y|2L2B2mnfvjC{hVZPH10(U}HX7vxx)8z6 zPNb@qeX_T2<8|Q_ao?1XyPvr7GhaNpxZPn92MJx)i8qA3X3}2Lt7IM+${ir;P79+$ zavYvR%ses4_zoG(f}Au|!r7a-%3QnX?F<{W5H{*ln5lz*=~oQuXOqhuttED?1dgo> zj+9=LAElxqBMV+B zgOR#zvm(&<(APj~NV%m2YN+-8-Y!aIChA=f;bl=O-qHt08rx3k~zc zBm$XP1dK9;G59fw{^j>EY7%Q1emfdS2b+p3hAPTEQO73Q*M`KYK;pt}a!fmidng1J z`4Qx!5u;QZoiS<^1=*)l`FUecK+>wnF9Q2EAqz>TDnO$#?0N_fNVNr3g~A{UjE5Th z)wK{|72k<_!)39ip7?U{J zN>|viJp9B$j>|%h#S*2Ry53pnloSPbb0&vdV%wZm6q0E`UI?cs2fsI}NYZG$h8dl- zu2{*z|_L{9RIOBpIU!(^i=+yx` zt}|BcWUHsdJS_N&qpZL>C!Xw)sfYLO$pvH)xMtZ zIqt<}GgZT_svrgh!2YLJkC0I)u~g_HeyUQICIufnrQBlL-^nwT304>c1+W3)lCQ!~?ebQ+uC zH5CTM2W+a;MF_iObkM6b2G_4vl0ziH&2*du!|EDraVQ`v&Fx`Y_V#bd+gU3^|JDMG4lfrH zjZdktOmLc!#ISZ{1is0raF9o?99TJp;Xj(4p#Kj99yciz&J(RyxFx1z_ zC=eHwCHs?1dU z3eD0~iotmPxDvCNrhOftyl3TVk6iILv05Kh)DH$h{tjw~G;zulvIe)p&exoq9$VE4 z%2@vvHGAQiJG|I+goOXe})+ z<);>>{MHZ$Wth>{xUa6qC^vt)%jI!=XNmY>hvPj`5aqdYRq-12TV^x`N0C=nPbG}* z79g0?n^aT^VhU9pkq>r{b&F0+WFXPe0-^+A0&RfB!M*5@b=Qh8cI(gL$e_95Qh1Xc7l-h z*PV*=gm^qm11cis+ zZLy@_UgMQ~G_655!1(P+xsz?{g6!~!#@eP|PruHJL8^+cpKREqhC-;Gw$0diWf^pg zpNT#5tFJ_qOeSI2i(o)^GG3>m4scRaYY?eD!MMHpin1$1Tsfxnw?gk9U+u4Kjo6AH z*M=y_$ElUvZdZ)iiyy8W}c$aicm8-^q9Wt%6Nu2nS7^-=WNg` z#iZvKwjbQJ*P69c`qz)9HPw9zOR;Yk7$Jk50DGNg3K=`V6ZAI>{SWEIT2~(qbK#)z zUg=^4OXCc~M2{L{RECFO8UW~^C``roZGPt?vudmpHi?^jzMF{2?DT7xni_&HLChEN z<|X%VEn(-b_3!?GCxh(BQ;!s_7%3`l+45R~?%7eZ9OFYDf=p*9iI(p}?4* z2?gp`dv|wF1<#^pUUsst7s)axsN1=g$ET~t#b^W6Yo-ekGStZ~gCcL|pIDYKcgdGK zPdvOSQQb-A^gcw2^2xKPB8{dPyV{T!3r+^ofyVt~IHE!SM3vw)hN}h|cXF|L)(hXf z9_A!Y1FDcfGWtm*){`?Fm4z)b$wv!vS#U_e81@HNO^2C$F$t;8SR(i+u|{`TpQmLI>)bMuY3O3WQMxsFo{O zCd?j&3I}RSgpm}@r?F(N$Jg6U&6ni5X`(c$++x*`RnK{bJ8a~tTQj&9e+73wCCPj* z7}7dl8tKS~C@^JZtq#*4eY|n4kLG_tS}QUDOtY;zOF?~y^xLogPHKE|Pa;b^EAPeI!e2lDmjqXS4Dp8ht%^?9l_L{ zw+Vi-jFhNn=R(i4TCLrgNMRjH*@W9(gjUuXfK(UuzEb?KdzUNK^o6rEovis@-q7zv zam6oA@3dGAGfz*U;Fg90Zd*~KZx-=P^NjjMiNYS`oTtBzoA&qC87sv}`TauNjrqyo zeuoKvsk$sUQ(bT9zE!)De-OsNz5N!i53>s1`A7|Ft*O=W|sse zwdjTCxveriyDH$&axfQm__NA6N$c^&sq?j^lL@ywgrQPTCSvfhkQ>p0l%TMnSyuw- zm~~KVa=J2}JDnFkGOC*|51pv5_aQpQ=YKrYA19I78-`=8@z#i5+V_uP0*&)exN=JvRCg>}9xQO#&zIy+Xl7++7KrvSv^z$9lpcPmO;FaJR#ioHUT|Q){#Wy;*$rVm#!tmNBe$MI^9bWaG}Y??3JzV@xG($g$+B zpCY|veOyT9(e<+@X6>MJr-r47h4&b4^d@{RTR$K(Ny75 zOY)fS0^d!;QWD+_jD!`J<@NLtWW{KWJ~=p$MJSOjM+Q0lsUs0(H!gcmp8cfDX=%p; zO}-^WW|%?%JD#TT7?J*?xxB!;J{|cU8$TPn)Tyi>TMi)D{_qDTrUGH&Y5JS_c>}vy zcU{N#znMWxK?4`0u9J;C6{}rQ9fCj76C!tlc?}8p<$J)TR=c_awmsrHr9`b8;Mi!Fzec_f!zD%S@^gM zzI1>r7L?0UbD9!jTUcGWHOm2#!g9H0+V(H+I!orB|#3o81xs4@aMnj>` zMux2i&{aCI(6IZ{-UOFhUVWpepee6nTG}trB*w5A$Hv~D56@F(SUgOoY>|#Fw}i_d z`5p%P*Sa&h@eqct{;tr|K?Xmp<3OE^N5FH;=k6xGV{ZvLbC=R9y+!l>zW5#Rk9q52 z(o>Sc;HLZAFZCcQ_f!b^B$FeS_{@qV9WLpFPCo~7w=G1SECk68@XN;Iw_rKKAl}~ov)E9G8`MA4ruT>Bluw(wIwm)IEb+xGhnaN2 z)8?4ykG9O-SYM|gQ^B^8znA>Aqxd-;`!&pnjRm1E)YN5R)SvsM2&6a{B5UIswxkF{ z26Po>3&`d0sc2fv!oN#@EJ$=M?yKH!pW(daZ18d`sot*oZmXu@4`;qkd*aGc@xx`u z_+Iantmh3T#xOhKnV$sImK%MHH{ra%BB3iD#vS<(w`qt!YvBkH79aU9J)M zOuw9o=M%zwaNa#JtBtxdCg3vn+zZq3I|b(?|2khWfiEfxF5=m}-FTsy!tVD_N)5~B zU-5~1fALTuE98Egw~TryDXU7je@3bkqiQa|bSku~bk~MWqUP;r*awrMXFgpNytifX zzfIdYuV$^pjr&kE69|lvgnbixFcMU?(STVtF4S3?XK6$@-EKWQZ5_IMn3SN)DdwFmdT{p&2V7uSZaPgUt63 z>T!JOpGN1=d$dhbSY^z$IEwdOt#VP%;nw-g%*IZF2-{oOKj%#RBOWZjyGA;}ALGq* zL^hL|PPiFnl%!I`O4aL-=&$Y2MhW;3DHr!h?Z(d}!JgF~t1_%$IG~=18m{WwkN118 zxHWjI9w0D0-o&gWssC0G$89`k-njdTP)CV2jFc+b+=IiInpD(AvB+?s*9nr4!ODnQ z^^#1E^?zI$2I*zOmYfs2%_&BPe;dm%=RS8X_bpO#vUEd-@D|QClBkhX!s!4te6+NZ z(9*g?s#$*LEGXr3m2oCCecR9H*5z`B-nR=;3AP*GI9J-B%34~^u82(5uI;I(7wQaF zjmOtFj84=$wQ-ZKmXq!>u^onHa9!;ys{{n76sQ)AuCYkM6F0q%#+_0`JZOD;yA8hj zNNgW%-6c_a+Mp|Q&BUssh-$lz!{MZv_CX`mp)E86HTg~nt)gf>ts1cn8`0DyxJC2S zjaQGM_wKGBLl-3EtFqnKuKC~h@^s8RJl^G1_3X4p(uLkq9jBJtAoOhe9h_0OeGxEu z&`;HR9?QfbHvA&JPn<5#D4yJSZSQU$2nUUJMK%Y-H*V!6ZIpACVMnp;~^}k zh+J}wF)61k*>I#?0CpQf{2+@P{`LWxL5!lu`8QsTAF17No&d36tx4OV$CH$UlB!p?GL_fqa~w1r3abwUhv z{r!%xS=}n_MNkPxRl`J+!8}aK!ZIgKT_}pfL{HXV%|+_oD6GkSF8kNFv$X_JPhk{Y zJGP1}JcYA4hgOF${qaM4(oe^E8)t$}9Xl-v)nNDj6`HUqp`0cW`#57$pNWZdp;ku6 z-m^3q8J+VgX2#o zeJnGV7s{J~jaMc96AbxR^)ve4&JTYiiU`z{Z+KXhEFR%SC)zeOT=UqrKh8>+Lk?=L za%l#svw2uOIK*x8Q76j~?Cte3G%7S7^|mEe80Ib<*qh=JDy-AJ+V{_Pm_w4buZ^^t zJ@4W3E|PAj6L;IC+gwTh;Cpz9%iOiraE_0>5D|ZK;XAP7XiI3UK$KWttWiH_&SH5} z#Q9>$Zh_drU*z;!U0EHs4gOydBc$Y*K0kkk+YWBB!@>b<%Ttel2nl)FLb%e;vGI zGZgS%G{q;t9AC8Z&3wKA%Zb3u~Q#mvV zS}#?om7^su3y-1;#%lifourIY<67(u5%G^*v}h@Z!xWl|sP0tR1kJ~kyki%}Oq&0F zBvOxeIja0(vP^Z%*>rf99rvLg<)P@o(-=40?t6wkb32hCFw{uP+okry?`dXVgznXn zZQC4u7q5i=ygH`cW>0ymCq2h-^nFhA3%P%e#cYM+@si$LoM-O~2}esTrON8umUi7w zsH3# znTh`u@XlOjc@rOO1WLOfEMvnInoiyOEaWi*JEXLqKIfsu9sCbifh2bbVq%F&$w?(2 z3|J$+aq%>-Pcn_mZ>-MA-jcpWLPf<8avjbge)3)=VXrB$ESdl6aMJhabIg6yH?%u1>3nKcE}R8+J!Qv`%$Q{e#doT~C!^qT4WN zFKMIrogJk`<}@H!aAIK!q}FN6jn(oGRulbpxLocYS8vSm_;Q&az0$PywjJJ`P$u$T zP;4~QWI~xry?kFRjOy#K6+@OJV-KjjWM0W^p$BM63GeY#X#-!s4Y|8J;snjy<`{oH2@!j z+mB^UIPYuxupY^{hw0+;aeVd$J%XTxd%jEwPM3MWe-IkZAgd0i8#~U;_iW;zzH|LE zA|KkLvCr5eUUD#&baK&SG&Pq*50l+T`6?! z_TnvjZ<18mVSD-7Dt~96p_~`;5H#|w?!7vLulQ9F8ydc^c5`i0ED%4*jp+q6S30JT> zPW5CR8SYWeY|MATzs}@TOj*VKE4n*7G>bk&L;CX>JeP&fRc_K!mbH0EkOb1n%GDdf zEi|K*bqMb%R_F*`VoOdy)bO^;Y2bZ*TP{}aXZP_q2wO?88J!cq5qjdv4R(`@O=o;c zZ|Qfx`QVyPQ7^gB*Wh63HrYoeFAj|1x&gdl!I5RwQ!#Wy8?M%m3Mc1z>F-ITGt%9; z{*JoEGIWG2>mbf#P}kA0>R>BpzBI8iFLZ-%KuYN&9x;~p`>H@z*Ey6gjxUNBIw=$v zej~8a-48nLV?Gf!1BI*>TBN7_@LOXMegU(vD2IUZa|Fo zofd9H;MHX>YsuTjE3D%b5$vmd@UMnBj`5vJ)LWxkV&6SZOJZXErjw>{%Qts;_}?Xs zW67RhS{!4vJm?Q&g7>S=r_DVZ7Q#@sYNKg#_uOvX`(9H1c_U~+e!A@ui%;3E0zKcG zwTTCR&1l8o8J=IywCA@GX{HZHlvy~&_vc?r>(CKmVlGOGB`+;X5M(w-er4;%zY)UA zShCMlo?RC6b)tFVy2)8)+I6FO@8PEiX(9}}t@@U4*3V95-{*x6kdV_V+`1EKO|J~k zq_Ya;Qp_D*&$N=mZ>O`8BMEGAe9w7Jw_uMMn!hTSMo9di!nOkH71TpXd?#RfQ@^0n zJM9;5&ie1r;ZgkSSdN8ofWB>hT2o!tiUiDDy0qmSzPNGvo9ZGiW~nmyr|15`rjhjW ztLm%6;uZa#=7ne5J66Z#UWD=nRX#y0M#4BLiGj$#*VT7BJq`8!sb(-oLzy26guMOk zXqgv(=FAzTmP_{*ipeb;mK^_`!tcu2d#Huv_ZNRD%mG55o|Ae{!Umu9$1Gvf0ejoO z?&*touT2~;%l2X0laIZ-iS;*_A)cEYZCRguGy{K-m_W+7^n7cZQmiR%Gxx52Mf?ip zILSL|YDM+0<%^zDF$c&}V<|U7>BjmV>)K`xGAF!)_oc;)l5bfc9bQpsVg>m6vV_;A zR6V5gD5|k(a!sry?qy26cNAAEAYj0NJMp}b zkkQBdV%s;wwMWR}(Mn&zHy(pm5~wf3b(^upEg?;@IR`a?SL$G%CWc?8bICufY7NU+W6b+8|AYP6(*zYhBvTvA}+!(CQ zn{sB~jN@bM{3KFLO#xZO74E*1@{SZD$s9lAj|!eKrv9w^ylmn^a z%oS@&7GjB|$V!FhCeP?3o8>!0>D8cWm(ACmRc^w;zRFK zU1gnowChWSx)xN4YjL-;l)4MD`&GGUh5=P(S*cexZcqa#?62)pM?UZk`>K-hSUO>G z{Ybj)2lHgy6M-}Qt4Q0P2C;6G;L33q0oBh2<%)dR-IM8`Cq{aBLE5w1ohQg{mQUNA z^CwFJ(%N&Y`L~}!mONQZ?np^t9c|KHu3m!{HHHbf9M8)+5w7~w%Hn!|-mcleYHRzR zNR>HR$udW4LXoUfb6#Oj>EYSG*B*42vhJ?9^G=$gJ=@jg(mNil*@m5WUhdDIdI|lt z3N5WrJ=`~Gas+}KpK?y7-5Wo2L4PLl|6r?}>1K1EuH9Mg3|)_Q4){>1g_X2deME`s z)k2ckZMPA$V>9mJ2i5EAr6@Fyw08~$GcU)xUHLcZ>+OlPmp!ygJ<~F+BP**tC2d?Of8kkLZP2%H z%YmQ(p-Rcy|NiO%OWBrHzCK^^7v49>k_ ze8a|J-ccSXVGQECW&hctI@e6K#T zN%!*j%@041;RTe*)Fw^{eTbSn2XG`XKb_Tf67(4obz`plsk*U9Wtv zH!SOfbnCoBnv`_n?el)U<=(ozbCRqf&&|%V{u|8S1*8e3haTaCl;-auOFst-omo|k zN0|k)uz8N;{B+)}6HT}uL~r|9g^Ds=m_s3I2y3CtdQ__jY{mhUXg5<Ks!Yu8z2FKtGVay-l&u!4X1mXpC}r#NhtJ)DUs>6Dbax-;bkvw$2-hnG zx#h@L){7U6WzTH%ZMZV+-CL1MEcBIXyFr5UR@G8;?Y>62RJm$IW>ogn);o8P{jl1Prvt(?zp_l&-!kmZME?o;hQ^+fIpBCD*1q{aJbiUg)bIDb0@Bjr(p>`5-JODnG*SyJT`S$) zAV_y3-2&1f4NFK%$I{*Td-?v&=R3oU1An+P&$IWr=bn4-ISzTeS19OUOf>>)tz>nx45ps&iaZvLX0IWEU4e+0jK&gEgGwdd?(>Pw$acx}k3ybx+LBW5 z^%Qn=v;aR!R1RIOX<-to1o#7y$Xn}k2Uv*63qmcyGlNLY;^Dg?bnAWV@+#KvmmU`$ zBAnI(k@51EFN0mN4q1QHImW3)@Xy<1YgJ4kz0?hye5s29%C9C=2Kh~1)R9-ROh6VE z4f+4zOX|1%dqv(Qhn#>t*J@a8X0K{2K@lsr_m`cMOjS?K>^#u58T(QLIZsveAM6F~ z)^A6T#bmBVpf_6@UP-xms64!qUtwP`$!?Ig`_knrTd=r9{XIgfAyW|h2!WpqTi6Cu z+*~Kg^M8IO_B@}8+ywS``>e?}`AXL0`}_>BsLVXSXobUKJJYSR){w|sm(I@l+V2Jb zhk3&)Tz!P9>vCn@01jb}K@e=wm_|B?dq+_B3x!^zgG;{+3ZYm?8h&Oy;vMrg`qL-CH62A$ zp|+3{Eom9}iMSAxkzFEaW}3qi%xPl1n(SMN{kV^vJ5)?FPyEZOM>$jjs&y@H<@0{%A(;HaES zAc#rz!Lg@jXLsqOB)hY+Lalx=sDaqr6iK#U-sMR8!w1}$sJx97cAsQ!Oi&mPHpPz` zNE3|Wq0`B2`eW0uFTz*TS5MOtKe9fX+28vVh`2`UJm{>M`^38P?> zZz>ty;l1GEf`rnlsH)ak&sK6}Q}8>i0`v|lRWEj3-5UxxoHQnQO3rPsWhH0iUfS~Y zK0$--$k@{T&QHCOv9T9l)@kWroSJVTH%ENi&6hErO^=nHsOto+?LVT7p`tNRjjafj z^`^A*IvsC2S+ZD}dD#bgA~CL-A;`705Jv7 zMhV*&yRJM^XiMI?BO{|CBLnCsftEydb$QXK{B~;*{|Llg_QRDhL|IvqJodk+0Y7xxf~hWbGwrIBvflE;d38HA*5n9& z7brLtIWL;?sPbeNmu^q|@`$eDBiw||-!~_Uz^l|Vp@I2r?Y&SGik?Nh3cke&4cpnM zc`xb9@X4I|m)v7aQ8WA<^M%WqXrZl8#=`KtZ|pH)8}FJ*r>&5TgFdBE{?P3Z(ECXE zs=_?-_pLzd=*~4p1OT^0=u0>_MF%@OUqH>WPX|SID5X&y599uo3Y{OzZ}uC5yu211 ze!VL6d|n(UcHuGd5dV&R{B#uMeSdYTwAABeS|C^VVxR4=;GrUFf-&RSLDltq+x<`1 zwyK#l_Lx&OX>NXb(aFGC+7T$K6slAn_p1suML-#@5>__G zXr^@wdSvnnM(GH9qwkYSB(QS|_PuWWD+{(r2%aYzYQ+|m+R#Z68XYN7|LX!5@w)h) zjUc(&&AK%9s9R#yS2IamN0e58Uh!IuAkK^^@HeHq+UGhu-cn}(K*fOb*lAJATx^X& znoxJ%?Qgmguc-RQ0WL%~!(ASIq1c{*RHKT;6v+lP!$A zW;7ExTflZ(UtH--CK{58gU{u43dF*Gfws^BP><1Pv@gPbwvzohQ zSfwKzrK=56Y;~>m17z2K`;SCsb4NV2(kv<*#`5dCe!K(CV|oFcY;);lDzqJ4C4rhf zgc5Un!6>TFB2ch+RL8kl{Pc;9q?Io3Qv_vL*c9=YPC}z!H}mUd+#gmILqVW?fCyw~ z4>HyWE@$kx6KorZ@-SDS6;c>U}l6?`+q0Im6r*#p=8r9wBV} zf3^H_QN+9VM?7_(k~Zu~x5Mpy@zY&TEb8mNwvfd$O1_k3-mB?D4Ax*otKiw_yf9LhH~RcWej2%C zdhd@l+EDTZhFtM<-l74-$2|^sBpat>n-Rje$EI}B8SGi})c7^X ztbaH~p`#&$v80$nZC@mPlrZ9MQ$aC9=v*Bq(1{(pp%xXa zj>DN0#>dWlcp(#uoMDX(p6aEgq6gXKuSqs`#g+a|Ui+wZ%sd5%$kmI}I9rwUt8qpK?=$_ zIa6cWIvHTtlU`|zce1xi5Do<`5QjMH)UEShg&jHJgE}zgNcP1_NeVw%q$xy)Ypk1_ z_oEE1p~}-{Gco^bn_2gmFZKWaGRr35v&p{VdsfAGM*0Fj2s0)so)>xWmvw<<5G%nD zfyL|66Ae`Gn0rMz!CcfWe!q5x;p$Hzd+>F8TZX7eq|Al}@=)!s+TQOgkAlT2nd{)} z2ab5!?Im+ef3d0sIVR_>c>zeWr~e| zM@FU;f%MCs}Hh@GV0SrU&$o#YnnuRmON2Fq(oG%bdQ(x zr7hBIV_lXBHAqA2fm9bB3g&OrSgFDh*6U-qoDO(N6=EiTwcKnoUJE zAoKQOhr6~E`Pv1CHVRaA+~Ki_UbDPVBi+aVyO~CX4=Mn~8SHvZ){JiD%$%m%(2fAv*2hIap8Tro^sJ55AUTYCDwmBNlXdP~S z#9@>p)vKSZ*Aq!N+vzrG1wS8gO!DVW*{ZpI7)Z`t3}iQvPi7fqtE**KTDq9v@5HzI zDA);BV~pD45GAN>`p7QKFPS9t`Hy&+pN|+~VM%P%M?#`PRy2etWz zIrWpFNZ9ElR23ZXqL9ZC6vvA^*KEz#W`GSRl}H)4Y&co2fpEX7I^7ol%W~->AYsZ; zak*z}96I=b&!Sni1-&!27dZKrT;2*5Uvqli(N>t_!-bpT3k%JXp7$KhAu7-nf7MBl z#mS6SHpVLf`wrWCgEHnV2Lpds0yBxMw-=rw84WD3_VCd=i&u`DYT|3)07`M|QH#=M zc+CC4TZ63{2!sez(!^GQ{;n;zx@eKnG^T`LgG%hm6gl4715Fmt6;DfdkY*M z`|Q<2U=`%SXt%8=3;G5t3ovKOth#8l|BpkMBSgU>T?JHz+D-1C0VSsqe?*kZxhJ63 z3i|*lGbtU)dYdgWz@;h@!wfyi;#UC?lYwV149Xh_++#E&3YIC!iF0T7>n0E4lU{k^ z^*0&NMaSUEF@PMP2OMc%{#aN@iUm*wm$7C)$8p?sUAbDJg|p?atL$<5YWw4 z$v1=ypH*8=haxw1`sRzi!YiK~Q#m3uJrir>0QRkMZDc3Krn%6=$OLyj`C9g8$* zWDP$$Z$y=#btB}0^49Jl_pUv!)#*H4`RT0$E`QOFM~u_X39kmz2(VEE@DX(0JgzxXS=qyC!eDj}%Ui2KjTNJaI+p3yMg8`&VW?wuQ~J;WYq$LOOwytjf? zl3``(pMicx^Z*N~-stVrEX(t@4C7LwL7W>OxtrxH@+Xhj4sYxoRxc^#7g2QV29e>> zn^*rpnx+7tzLmO{1}yYB0ajYrU!VW=;e(n4Kc7Q*nT1+M-H&z|+}G|^*E3{7iPL*J z=h(l0$Nwt$C8D<1Q#AwY8@J@%r3B%SsKhv(j{WyJ=csq%zogaim=W!QrGvRa#`7L& zeR=us%BvNp_RI4V&27F$t*zn4kh=$#&q^=_qao<-TMOThe9uS|=;{}}Qkcx;IN4K{ z7)neL+3=p09n+0H&&p#Qtj(}%R1zCT?M5vmDC8n|448EP+93{30aZdxef%#k&0Jy% z7_G|=ZOO4;e$4YysK8YtL|4URlq~y*PW@$^jbI{`xt&-Q&Ck-)rpGwJtbgEzT+Dks z>DS5`Ww1jdC!tbeTV{|D0I4A&29x$!IRW1K5(lV!Na{d_UquoYAx z61~Pzyp-b}MKSR6M`e-taUhU`=FkDrC!7~kQ&V1R7>27|C={mV=G%z#jY0ot#Y%FG z?wrqWu7II{Vz=8{$oNp6hQb8%Zt|-`&F^6Q)|d%&u%uP=OIeo#)0~OU-&CiSmLapM z;05a(rG(M|6m0EjI*yNX3C0+4Dj-I6!R0AcM5n5OT7<6{`-<^>jQ93U;oA%7N|De6 zGk-M6R@afyj7<{5XD+*@TNS(ZEzN)?msc<{jeCLPljV(!o`rZ}*pAB#P#%7e2hj#8 zyoQh&gFd}rt`HTXm+ib_Y?Hf(t_YW&@DofcXO6qst?&$F?cPsp+!Mw0%Pajp2)D;W zhJq4}J_l(G6S$Da{^sRg7OKrtwWFcGUiQP@|AQ=7GW)5!Km{iVunNNo(uOmlE8(Ot z<7J^yy^q$XBUpb27Zw)MI;qNLqdRCu-XhFOUCOe3+gW2SYj=2cAP$`94b|C9ry18p zGu}PnzauQ)+w;-c6!tt(Fz|Y^bkJC=7iQbJ`~^H-cNIJlcImaVeOtD_%Fah9#753` z`AYg@eoPsUOXdL9!&#|FP&*f#G;*~$X~^)OJ2LtSOm3wF*94iEh8W-^%3*cwoJy={ zO?J;8q}8HWG3t343oRAbBk0Py0)f|c^G>zFf)j$`zi9d}-AT$23Y ztAtoxGt9SKzjQf%rgK@kQR238wXJtk_v?9?i>9Mvi5G+`OLFG&{kC~(B!geEr8xwl zyK|MV`<-v0#|ChO;r{|YaX&fBp1g6yrSd|txA3GBn{cg;&lYxtfvvO@{{_+9(}fa9 zI1e~(fLJFRsL5vR{1%YIY_h#is{WUHt`==3G}~k~(z9(orC+P9z9ElgRm$?b^Ca~+ z)fuW4f62SQF`Plk&i@LaJMnEk`+jB}(T`If$t*e;i{sTY7ViHJZtZ@l!W0nwq6?8+ zM#surkF^L{>XX*$1x~3ohY<3Ba{wz;chpR9|ATN$*901U(ba0EnVBW78MiJ_b`zSb zp5O3w3>}f!ZT!@;r%~CTz8fQT`+a|Cb*tH+c@D2%#w$EBNinYA$ zw$Eg%prcz&m+8{C(`o{9z$``5%6s!8n%8p%s~R#3scxyFu~gO+(=|M7;cy|b36dmN zt>73P@*pe35XMRI3obN6wxS^wyc1j-2Ps+$lf&Q4-%$_O$q|vQ$mrXTXJ*mQJDM>U z1>qdW{&&pQ@RRb04Ez2<Q8hK%- zvxeI{%rGuKA*DCS=v0+&KCJ=V;F!C`mX^nxb*DMoN}r^4D*zL%Pb#abo&(aBw-E<= z-Q>VuC=wb88uf2P4RRBTSQ&IR7^p7MPeK*HfB$(NoZ)bqm(z4y!XeS1d# zIxH>$T}SbaHaTx`DNBN!1}fB2E5>3;E6c#R3AJBKypIOh`=schE=iL~1cw?SYM90B zd_u7CRmwm_o{Uj}DLb}fqdlqwa%zoW(cA@=BLN!uz7uhUpvk1fMEZQ1o*d!82ET?{ zO3s&QQM#-}i@V=0(UtWX_FYrN9_brbpera&l|eXqQvb1YiV`$IE{=s-)bA6Qx8ZS| zLTW%zhmKxca07;si|yHwsT1db1x6N--R*XL=njBF*|9-wNd3Z7`1;~IsrQCPLI5Q@ zl0x^u91?g#NZUXjsG5G?#1BYsy8BO{>*_zezxf|glK_5OUj_%Yiww|p+N3ui*A1NMb^S`(7c4r;>(p4l% zT7SSnLh8$jerd*N+ckbeAT?$(Yyxgql~}f)+W%>>{bgGdJ|`d|s|^znX_2fNNLk?U zAN6=~Ayga|YX9o3hEN^(NFPV0r-fhv`BA}&m;?dC*A`~wL(=?0jsx^)YLUV!3*HT zY;Mzlr^BnM?b^&kZvOb>0)J(z_mn0Fvk#QVZ*KZEAa?={=;yiX1YlVz1uW zWat{O6DM+eMUHcqrHXXTzb%c}JEvUk8E_U;;QT7I-1X#nOjZ6G3Pb%{56>6AUDx9G z*nER*GQ1qu#<)cDnJ#b$_nth{D5ZB=$3bMlt-S2+OH=LY%|1}bS5*UKhr+&dnzi+& zyWcw}eM_A$8E{y~S@FX^`qmp3mUAnn-(3&&@e<7uc9G@q?5vvYVGrvSanOe>xII&5@%wd7Iq-q<9Ca8mw~q_k572`wsvmg4;OOjU5b2V_vaQKEX~k=W3W=;sOP<-2nOe`ekM_EF zi?rxkFF#sDT^n(izBqhMKR0~RPQgIbj%Z)zDiflxG2)hTx5|%V_bYH>9i`V;nspBm z{kW?{G<*!rMny637qK~Ef9+A1Y>H`xnY&#`!?cE7^QB84gKJIuPvwrqTo$DvbCt4b z^EP!(?)J8ZcZwy^0-_p1jX-BpSsWNFQHZ{}Ltoy$5M*wBnw)BCjh#fU;M;z*kb=EK z-%@CkwFVKD;JSjBg*kebN$d()W=m9-Wxu-~e{7F-C2Z|UF5|anTI8yqfdeUug@vuo zeudT_SxJGI7=V9$UTnqHIUC3e0^<<|RjS5sN(WL5wN0M~dQ+jSK~28~H6($Cfo_*v zk>t}@+ldfNhwzt{hs^q880KHG29ZT9|9xZ{Y8usF|GxeF!hl>U1R-wpRxtZ^1oHDM z1yJ5K{b&~Xr>)!gwL@>d&(_1^KYHOG#lQw2Y9OL$ya09NJMo28VCtkvGlRl1L#VFr ze)JuITvgi`Kx(C{_s8b67P2^bR1Q{p--q{vUG0&|sQICVO(IA8Qz_$2_Qtt*{K=%} zVU?T~6e8(&FV{?|rF~D`ZAy_pYybIb4x_Qt!7O@a?;ZXn8GlE0D&pD+sE{#}hTXfK zt&7>End^BgYc zq%hLEq7_@?FZla+O?iQ?0>J*?r1NQefdd&~^7cFjZ-m-MK~$+gl}|nnPGrQmNuX95 zHbwE=fG{8f5eG`u>y1V~TZmSx1I!@ie-kbi(h-KuG@Ia-RaL{fha;tF3Jb@}`wO2G zE1N@JL?ageQ*L^!iy1rpf0dsk7Ab!x5EfsTZPRmMnwkr(&J=HJr=gxdJ;jGrwTj?qMyvfIqN0-EU0S_m`nq@S$Tf`aUAq6 zOX3;5v}*D_7nY>y46L)LAMgPW_j4rTq3B1q3a057H1;J2&8t?4=Ch;O^m=5byK}A% zN8C0+A}{{f4SGz)$i4fyv|}d z&Yp+QuUg+*G)zp6eohpnNBu#Es{}0`ti$3D<&b!j^pc*Pk%bpcd)KXxCQyq6j;|_$ z7FOJ!n(3Lito!{dEplOLf7<9z_UY75ze=A5BYA`C3ZhR&9IrjTsC3-o>F_Gnb*Pje z0PR@%DD_F*z=`lo%;=~I7>43L+UC1joLQt>Lya(NX*@=|?64+pgr~JwgWc%|hZJj1 zpUVkRxpYWG0b3e^9fd#Jqw+5@C48W;5&g^?n272IAi1mWsd z{{Dp_yx=KNK8No2%ep$aDM=4`p}2LlhDI1Z(CGvPuv5lJ$>ZBBBj!)&W;b_C5_dSh zG%;(y06QyUd{$I^6ii1Nxq%>1X_`(p;F;wiiD@nU;6K3XW+pAJ>G{x!F8d*PRN z!BSPvRGV>HLw4hn*-+?=ib)@VnxAktjtZ=+fI!4_F;Bi%N5Vss_m#&F_l?5CU-p(4 zJSyxC<83!z2QDC0caGzPD)cQ4c4cIs$)TM1``wM0hA0z`vZwN^^ecdFHRst1);Nmt%wSDMed-~W*KNlrzaCN5GQ|EO&JQy zC^Q?y)e~M}o~wCvzpwnXrh56TR5Y2|dqZjM}{j`I;=$R4uD*y;|PI zud24mxARU521_Yr4&_N=k2)EPyGNdJ{Wo#bsqy8+!Qapp5nes!=wp{vZ-HMPebvmE zgYF%kTF#N7w-!9b^_RCHdGe*1f=+^6s!-JbW&y-Q8bi9+Q4pi!Kz??Os=n-|&+Ui_ z4T2vamVmnR25%6cEX<6zqYro_So~Yp9A%9apSb=CMdT7rRem^1ovhaM>e>w)-_O$7@l7_ zkT_rLr~&HG;jCzx($c1$!%Et^8O1HNl1XM49*Bxy3*I!OWqi3L^EwHf5bb@3F|9Z6 ziV6$}K_2|cQ-%igVbl-3jP28uhL76K(4-NKXY%(u>g@dw=h>!5sraUC&mlF#(;>*H znt`~Bkfs}V^Nw4j`4fU*B5^bwwfMwugjAWWtIEHmA6Jpo?_H*BqSexH_7R3^X-8kn zSPmk8(M(EajEEOj;xLQB79Ml2H5Jz}u*8mKhMt~QH1KO_T=QF_b)!N=WGv<5gYp>B z^1^i6WLaavyT9?rSVTvCya>5KXK%WkJzP%|LTqtqBqFmtd)TcjoBd;~?^pA(8I4`E zK%_l#`{t#frF=(N^Zpax)LcXC%nj}6uZ^q676CUSzWeK#DXU)X?;p3()Ch1waOuk@ zju|?cVT4WXS{l;4if=@zsjJq7u7&7HLR3Yw9nNe9r|KMjBDU3gv=Vhc;kxzM-Bfxf z9SeY}t8#_ENK0={+i-{ZmpW|$zH-7B<5F7O`P+#LzuV?6e}w5^c*jtP`AF%ue6cxf zw%6F9rKVo|UKhe&IkAtub9q6dHh% zA|y0tjF?`}{rf5D)eLbf*QUFI4gtv8Z~=Zq%uz%POnT*-zMc^%Z$R>AKotouF(e2E&6Z;s>Bh&l zt{faZGQL+VqE?f`pN3Ro4a_Z~kBwJsX$pGCjdW5nw=PoYJj_B(SPJXv<>TPM1hN{j zF23iSkTc3?9N|*ptGSl@JAHQC<|2ZdurQlWGTY&3ntyFgu*=#J$QRxIqT<#^8k;>#>l)*+9PO9OH+IQnMgd3PM zx{AVum!|HDNm@_`c4X@+t-T(rb+Bfc7mEbWYFq!kU;PQlFrRRmDKctn*^g6oa58~b zf$2P;v-cuYV9N~=Or7^*kX>P}?U^z&@l8k{y9+$s;>h!L1DkjJ-7cI_5oG_t!OEPF z#6uFill)~UFD;Op&oisOBLKrhklEX2&eX>xxHf|Uopo6V0kNmN0D8193_W_)ts5BL zhSI#B<;lbW0?+i6zZEmXo%cZZlHUBK6dz=GS7^8n&3-05_PuzFij6fqyE*ms&cKh& zUcG)=z2pdOo?Hy*|A3c(_n~=60mnp7q_Dt=e zV2U`q3l{BMXr%@pSOu&4H4sL1-TMu;-S1xCV|tL)vhYqp8H*DX{o`-Gw2l|eaj^}PA@?)2lhneSlJ<=4x&L!8S(fK;aEhP4V z>*-A0cMy<8Zn|#w4BzK~dF>L#JTGo|0bY$;TE353mb~dN0H@AxiSy3BF+fn)a!@?1 zqEx-R;QzXV(;q{&0cc=&|F(@G7x}dYUJgrwXyM&u@H?7_1OdJa>*Kjn!Y7@G>Fst} zc>e|bFbJ^^Cny=Kgf%i@>y}7x7^7acKjm**vTR*2Hj1g`5W51JlN>?FpFQWKq$C|3 z{q?Dp8~S2v9s{Tm_LiYn(w8atuFKf!Vt#KIdHj}4NMxNhC7YsCj)PQ0E9IcMfS6}m z`BXk7O~ZHuweBUoOvT`O#M;O$(LtpnJu%Ooqjfi-rNJgV;t*soBh4Pk>`@P*JcmJ8vJPu#=#-r zIJf~AL~{e5OZ0Rq_SEmT?|$6j%Vv1<@b+dNEH)hb97qB2x{&-m4z$xaL@!HJ*D_ir zRHdY)rFmBYyPesBZZq2}*l@6@*24Rv-f(=awyfx1@#Bz+SBn=H7ao*6z&OlAz8s(M z{f(ckO2OuA3P?lbp*TLjwV^a8{hxr zBg5E6P7Z)R@T600jbsG};+LEjJwungP{#;gYGX z#G^C-%5ddxT;OCy1?KtCCo+n8YADjNcfKa=RM29EGAFpJ=$D^Vz+u&VKWgs9zuRYI z86W8<>sn{r!c`pG4LP-Ss1?vPIhFV)dP8t^vbabwcU?jVK&{pvDXMV$UgwQ(1iX+7 zzb4!lb_A^>DrLPPkWn!py!l};s_OJo0>rU{m68SQxGo-lTBfNTWdd&5cCC2jaZ321 z4*Ptu<8e{g>tK=uL~)ad?XXDJc4QqYwwTRMzTcY z#>pYue`ZViaq~w7wWW6Sr_U-FnO>)KPmm>fS+~O=?as&@WgkF6f7V~vzt(^^#3%kf zFK2Q*8<__ruNik|Rg z;NR1gpI?Q^Tt=OeUuL1`+VbP7!hqp@vl(P*lH}9|K_2z|WJ_Me@z|`=brjr%lzH z7T@FJT6@4=M)dkO%<*hf!DpM|2~+*P$PFMKIr>h(Vs~J@Ruf#H#KY6lb*`HLlZ*Le z{7bYV4)e+_O`{Y8;Mbja9-H3ju?rmxpMSvX_v}COCCybDYNtBA{i60X zfzNzbN<(-N!Zer&>>+FHx%IF5#8*oNxcamw^9t%(N4g&n>PC@)*?$U}OTqT-fm$F9 zGAXHof_g6n4<`sAMKJd71zvZ-T&*rE23Yi2t9srpWOJiK-I$Fl-W2YZ1BB)dG7?oI zxhy}3BB@L*(k{+3=D(&Qx*k)L+O7qL)ea0q2ILJeas}pYS{vS3x1S|eL60shBZPs4 zf}|uuZ5@LG0}LW-z7)N^lQerzvc|Tn#ggg$UPon6u-kFv`QI$1)M-U}$ZV;nWB_~K zvIUorYgQaQdt*5JzUszAT#XPjk`&C+t}JkpCUkSgmjyX`K(FLb;W`O24!X=@bU-o= zyQFd?jVBBV{%sb4V1n+oYSFO3Z_QNEMexe*lBZ8R%`~CRo&dr+BT&n2=3dfcG)Hqa zzK;zgd;+(M(1)-QJT1CUQ;}zl=v9kjfKe9OkUS6Ai<-Ya_3NGAXsO zIWF3&A1u{{vWGc}77XCk*3weYer*x)!U@3Gg)kZFroay*#||@t5QkXje7To-neGspY(1=vVz=ZWiH`6$N+$I_?S{Y9k7pR?hKyOXRwACBJdtN2* z=G0Rame^e*7vM-EbuBFB77RF@2}4qVhxq=&)BCJ7XXV&9I(KE?Vei&bcHJ*LyaofB z5=d+&TEOT;YMne*?P3}%LcJJ@K!H2Y>$BQLvD&ufc^j$v_{w)*?uoF?Csx(_PW@qg zjl$&l>G1`UMCa`}oGD`6EcW!aSQJ*({;cKRL$aLHDF?in=}nqY&-V~khxri!-o>%Q z-!Er0LqvfQkpBu-f;&isaK=*bkyrMX5OY6l(Y_ zlq=)Q1ECT#{@-@%_*I+ik~Z~>_exi>G3uC}EMDNOv2h3U!qqYeeCH1WmhwRn??Ru^ zfFA;ePO?FjT-y87?h>NOzqp}TsJqv9pgQ6rxBi_?yQ9`?o`dE?a^ea{-9z5|L*8iF zKt^B;HI_#sy^jm;|uV2Gzx8Rsgh=QVl z$9kMv9$qVU>1Cw`ra-9w9^g{s7n@&2%qoN(z1&R>v(Z-nhNKh8O77THHe4i0!llI^JSv3%g zJz@J~#6A_rp3P?8TW8&ksM9KRxA=(9cCdO5CV=oD4U!ZehO z9SFdo&AyfysHefMaC*)ByX0h{6&F7* zN5|AW79tXoGTrD`SQ*Am^&=zA?ybS&QlNgMz^JW6vs%)1k3bQ1l%|d4*+~mkAXp~J zNx(KXQRa0D`4g0wQUK)9JHhAt)eae%CAX4cwz?q9$~W;_)sR=q!uYQLk5pdl6L zBd*RWKt1g%M;0MG7U|O+%A@R$2Ucv;rYPu5&BYtfUneDN4b){AK*Cjum9j46Co@=- z1}DF^nGF5HfpoQGAgX&3Wm|Ae{_yvwX09=ojw>|XtrpbEQX}}iC(QUS&=UW9{t2+7Wxi%?6CGZ!3@Q-Wx!#t!EnDfj%A3seZ`54SwEud&AfN{2H)&7jq=2 z5^MjXvk*}j2|Sy_P2^C|%EGeLC1|r^8c=u6#MI!*#gMA~%Y7KNW4IwNFFi6{T0W!| zX;a{2k{BCbVd~h2(+*a@?-$Yv#_@-YQ;hFIFq7c!m5X4@lAbOhJIL(QqGfCho`+n= z;@ZP*)f5}PtR8DdEGQ_ZxzOzCz=7pIxdf5pP;oRa#5lFbRh9-!G6F?X>s*t6o|QkL$En$Fv2ac9!&<@$k7;t&*6 zESoNxu)zyivr^(i>03@2&wF>O^PFFYbzC~maPqS7oZp_~Pxv~nN%nV4K~o*s3bnw= z?`8rzX@KVqNUE_;vT?DvZjx?TeX^c*6r=@@5 zUVy%KKnR*p+9~3gueA!`NM}(#1&xL(P!Q9j1z9y3OCfRJrucK?x_Ly-~9Hy zj(qs;d#8HSMR6m6Ma~~~opla{-`-?5s(AP zauffyYPoP~IP1loO=lU)%2DjkeLz3vu!DbGO2g+b=ef@QzJi*45 zM_p2laifagp;UAsN&e&hr?@>$J;}-2sX!I_)I|`<%=}eq=S|4z4C?6sBMo>11m0m` zjW?(3p@v-DPGtyrCkewWWkWiJ)(5yqFC3Pqe$39d_==$%Kk@=x&DDUYKN~3DpR++Kt;M@-CcQC6}Lkd3@8Vi!>k9RQv zFZ7B);I3eCiKIX83o+AjOgWcZ0<4Wp3*;20Mz2tGm??Mmh5|* zJgZbZ+xm#IGG=}3$-3;haLBvzxU@3b|9sxxd^on)^xSaWvB__Lzud^dE7&LZe3B0! zoTm&f2y8V2{M9Dm*z4T&Z0z|m^RM&$m*j)-;9&1+?lh^g-w6H6$VNZk_AKCC246pGV5Ua8SPeR zf-!1>#$_mn+wti#u-@39oB8{kM{_LOcz{_c3foLWgMVpJlop@|Y6Be+P?0?{%7--DLxgY8a{D!NiW%cy#b zieQmL-U`h~j|$BOr*m@arKGkO)=*c3f3z#kMEvmJa& zR2#);VVqIU+D?jE`36w!{jw_;e+C-A`SX!cHmzd)wxjRg!GEk@CN=!@p>tP@XOOC` z&0&O|QJ0XjYDr~r(y+0bsjUNTd0=ZaZd2g3;?UXMm?&P{s51T~@&X*YI@)-*pBeOk^V%p@^QmjHh*<-)IFEN&ZFTG7!~2z2^|q%TAi(;g^7yv*GD!uI?-_%E8;f z)(QN>@3c7(Qs(uKFaG;5vyhzV2laV`%m|j(XlTTo2N_Sl8+}FP*fu!%mq_ru?xKac zoaLIm4-YBJG-Z7Ewftnllaahyw{M0REWQ2l!@;tU43ySvoXK%pGVCK?hy!Pl8a5Cg zME0B>On-ToHxCY|d&Ur!ws4D%d=T*+qdUB=A~QUWNHF6QTxg2se{8T`2o1Abhky{_ zDw*5SE0^9u4fHgJyui|GpJq>%OPP#*BpaG%RP##!t2G~4lPzKPX=5S-`(`-nfjIl% zs967a>O+l+?V;8Mm`8WDX}MY0x?rF94(l=r0AZ@8lN{#!3_4(`T<{s#7X)TzvavCi z@p1u1r>ILL8Od$Us&EX(GfeG@i*0Q zlNAre?_+Pl0f%ko@l_a+fM9;F}V zGM^+Td(1WfVkJi^6zlY)2iyLVlh>3>qF>fWt~qVPkXcpa@=pjtHjP}&2_T`o?Dq!X z;5GGz1%?{NyB4O$`!#JBft_s3@Vs|XVe7=ke<{P{s-chpb69O_lXyIRLGVAR98>wE z!nt5~Ogi7E;%p<>vdCZ0m8D)aGJSE=7Pn)C?^KqWc-;Gcy8jgbc;?$lOc;!lLCvXk z2MewwD;`I~50}0o3V`f`0-j0s)IO1N+@~TYI=bPuj9ChgZ#5z)L}b}HB7#FZJHbO) zx@{^TV({mi*hUWl;8Y`1($apdr}F5TaT#OVw06S*JM@J= zr&Wp3q8-d7+IT?Up~s_86|L{{8-^L(@)~}v23L$8qf2HJCiGL|uvnUaJJc1o8Lku` ze_A3<+o7nE0DsL$VI`ei3BjGyX-IqbK{NC(^ms`*CKgW?3rx1_AfA>$5ZrHy7?IaI zhoFZk;C;mcHzx$@OF-7oL3^}*@C;b2d6Q9x8K1%T9Noy(P7DA5RZc;{zMUOL8k!G4 zQKCkmaX41K#M@(D-mpL0Qd$s!+LMwqQ@|Y~5sw%{tvY}qWdN`-R-q^#&Cz5Oc=r2) z2;3Dr#3*-NYZA1rOMX-NHxlrtMH4sZMgyBu>*kTNfX>2>_pLP2cLjQ41tE{jY5UCZa? zVjOp_DqJ(I1hl^O1}fMw%=2Fknj;okn*jq?ySuxuD_pIttcGWqsj2y9=nh8}wKP&v zN~hC#ewN;ywEsG#KG))e+DM$BA8;$HHr}$iP9^IVF<1=cZ*!)-vh2vu^OkvfVR zxLL;vO^q9UJ6efw!C&Dvh(L?xr+;0?xzNLeCYvOXKBX&D4{>t-4S&Q%GwQGg)L_{I z!z#eaML7*-kJV3Aobs_AG}P{}CJxE}N8DFN#kmA+LI{uqmmonePH+gW!8MTJ?h;&r zYl3@VAUFgM&fxAaK#%~z-CZUFgAB4SSH9hI_UHcCK65w&yfaA379mYUPK(v( zNajEgm`NK&^C}iCc;=a|(Ap>5i6NdpZ9(`k?oUmFJR4p(WcH)FX!;Y#q<()#;-#!c z`;6v^6IiV8Cc2kQyWK;qYYrn>-!2|iOecrgqC($)v`k!h*ZE%ZYSUk0O?1rrXuEQs zujMyQBlq9lAm9*^)v3Ss13Cq`8Y|Fvxq_o)p@q~uVn)xuqT#RTya?)NWm-<}rEhnn zj>MeNjjxv!vL9v|NzQ#U#|dggil<-Y@=nrW(%t|kv77{5H>2JxW4B(OY@hg^JRyF& zrjsqI+L)8LtGNhb!gOA#ZPKWy(kkO|KjU-k-0iriE}o{;ciNn>=Zm!CG9_6r*T?Z~ zaCIDyCN&3;Zad5sbZM8jw02*uNoBI9Y+@5J(VIAF&i-OASC5ubR@0o;V4E#H>-P?? ze>?qU)VusrvtL84eh1@=Gw*NkAy3Sg=>~sCcm38^NP?$a18eQQBDmK^FV*Bp9GF{7i(^x)mr4-=nBoC`bmX)jLGz zHQD;^koT_RT6YQm{O!=_HtS#Y7iBXp{4qJqUCW4>|N6HM7DI!kB@S^cUJa4xX zDqk^v^t|`S3-J-lQq_jfHLSp`b6rBl%U@$@k=i@~EN{@H%R~S;i0n_BPL-ZVa}}@iFi6TIu&1^`6mYUzq5AH0qLM6!3V4 zu~K~45$rYn;`WUb^P}81R;IRwizHRA4a89(-%dW3cA0sj>Y zXtGh2@hiA}EuSNCs~TzT!osN5@k~Uwceq=2omN>-cHZ|v*afMy9oy_o<(*z@L;XQU zeGW2l54oK-OT*EPU1JOW$N?|69rLKAWM*_=8->&xJa2EncKu!WZ1Sf$A5(om*gfmb zI~(>mWw%_}pNbRhVh-qK)&rW2R;JgAO1yI;&D+D2w~}sR2`9|zM;$Iu{bs3og)5Mk z4(LNvIrUFBXS{)}bA(h4T_KPB9s|A8bvF9PI!4lu@sqZVq*PS-%eFk++>-h4Lq%5{ z#?wSOikXHlUS}Nm=#_H`>_Ww;F{Gku3Rt64j#`PfNX)gYS?4cs2aL$q$~FI_M)ziF zcd#$swL}gkKY~90%&Es{^OpyJ1FZv@t@g39=C*vfc*pr>8R@MZbIc@?au*WnsJx3( zf>VmOB>16tz^Hh`#He4O^jxtn7Yh2YC=tpiq!SZLJws744Su~g$P;$=*Nl%VW?BU_ z%L(C_zS(LM2b^UF><%I;T(+IEZJcHCZ7X|i?jbpcl7hx!mn=4*w`41^nVHY3#PkzG znDqNobGC9VvdNC{Mc!cXck+vt{Bare_eqw$uVbEzyeB6Z;N7qy z6Lw2CbxJE=&F4f#!yzOb;~60c>-}O>{8O=U4J*7Od}q!AfG6U(8uaD?!8uBfbnRFg z2@Ic^l}bYdqC=;vi~aTo?1sjpOWiRwziNDgzw9MP6{Ts!{vQkeiT-#zj$E*2ziZdF zCl81~9J~U?)m267OWc44R6x28Zi%JdCuy#ku?@V60Z+5OI(*h!I$W$(Mj(Ut78gH+ zR|tcLb#(kIPK$*Mc*TRYI*cZc#NlWcK6_lWLTQZSI{<-vY+S6)dZ2ua zWTDw~AezNl2j{a^St81P7NcV^-7ic!*&T}GjE;^p9X&P=Z5dKD%kz`d=rd@PQ-tJs-ZmP5=TQ>h4dDYkv7~WH! zPC*X1)Fid{mKD049mEfp3&bR-A~deL|IMk&E+Dbmk$VilAAC!C$F2w`hVwK4uE+(F zdegslAM@@SV1T^l%4M##J4q7kMtLe~N`epJ8npsxwf4`=34lPLqlNYis9`JVYHfVv zohN6@CDPmcSS%V_+RZnMpf`(~bqnS(ak0ifj+%eOX4Km8_#W9ltC`l80CKtSmH7X* z!QL`B08>MYW4&d51T%xBBuenp-Y?C1YkdrVAo=7cgQy4DV#7 z;2c=jE>p{d30MPQ%u{3+a$qO{Xw}g=B)~UjeeP+nV|caTTawV&RfwrA?0V!+PSDt;S2pYt2hM2pNCrqUV9 zvG-N8Hg8`2wsW_=0KDXi7rt$fim{_+UA?Br2m=n=eTGNt;EM4cqe_WF=#z~)LKHq{ zPPXD5r>O0qN=Q%y>P^Xd)IN~&4sJjFk#cBb||6hCYnk^}S`{&gW6`I%fzxDQN z=Yu{Tlgz$8_dcJH<8Q|Xnx6b%be+ZD z*E4Z0^||A;@gg<*FaRyLm)5P+LXZT5u}@KYsHtDjzPj)MPAHl$XuhfEt741;_V;%Q zhl4$Mx8J)1nMGM3V0bLep+5>2l^poa=9Rr3ho=`ue1rf97xve7ZKbG2Pk=TYIylUX z`PAc>l=lk8yT@@pi_F{W(I&ya`kp?!DN?QlH)!jOh-ee~*Mc;DWpR-4VDVb}jLz47 z`UoPqi*jHGJkmJ(bEl?59&tndNj>LUEvR`#uTHpO#chcsbvzi`yi`B=g%997K%6d~ z{5{>b27CZ2gMiQZo)(As;v-Y(-&HGP;QNC$R8qqH$XUAg0T{ea0!aX0^ij?G zcV7bT$P3MFRR!IS+s%R0pJIS|RK0uTrUIprWYopG1b|QMeOBuaz1d2wXTIdehRJ1A zoC94lFEp*3oq~9xF%P5}UOs|eKmpE&&lKo32bkK^Kj-)==`6ej?O-kqUnKw5d_3g; z8qXRkMqEDnyZIH66C@Y&^HSQ`VtV{ip#1m9kNy3Rl>X=ML&eG}8-~%@H6Dpp8?P#C zHwkb4scYfCN;e*#0~%DmhF;k+j9&U{_p#ZDhl2lbcAT!f|F(-3hyRXd!i8-PkbZ;> z(#AV)^gRdY0?qWtLk*MlKmL4Hs@fd_F;;aC^I09&6Fdr(pdY__fckfpgK#cU(NSQq z2wxe{+Oe$wX6%ut&ifq1E@%4p+BI0A@^A0a%+BkbxwT7@0@DD6XXXAJ0kRzg6&?P6o^kT)+0nULhCtIoFKO{r8cXAB7qJ z2*md&5FoJkK}oTZyZ*m*xpMutP6@~KPy*_kS;N}s^V~Ih(pU9=dI4|#Eg>9Ot626u zTJ_tXHp}d{GuB-E+ousnxBylTkd7a>=3U@#5fxr$56(OytdFGzh3N?BnAocU{th5y z{;Hp};!C6dKg%~?@uQr42m8f2D+lz0Y>KC%0G#x%V`xF9J_me@_M=<%e^+a-{&%&C z{yRK5>r2gU`t6v_{h7j^apQhFJispr`q}?jQGg;O|JddBGjifL6BR~Zmdwtx3FayP zli!|)@m;3cV@(-VhyScfwodPu7 z1Is~`6aQ0RD&P-*$auQ{`NY6eTMXx|orqT3V}{w$aIy2h0xmrRJs;~M{?Bs*#Bv4s zjQg(if>gztr+ zX$;&)&3!Bhhf4f=GSZF#rT>N>|NMD={lAX-TaO}+od1ue0CIW={HHfrz-z^yr%cxsrOIqc>mAUk1cucW^I3C?@GNm9Uxh` zJMnbdcKxUBe|{QmTn6lVGDUsKV*+S5G~;EbcE*+p%{Qp!ft~L)*8kDt|Af1)FzVXA z9j>|^*5Y{k*!rNH>$Du?^VVRXefF6Ffk1aAuz=yMy&lE?PUC+X^8dXb{yz`H|7-QP zS{xEvEo6bIZV&L?eL>D~^4*5O%R@3Hp=Es?zwy)RYMj9w^CROs&irD&)`;NpTTndD z<-)Vc;fx zbNDMafw0k>>i|V+pWD;w2b}DcBhb7^WAwSoX#wI}BTo~|G0`J~Ch9xM#W1SbB#&K-1(Q~Qu}&y!as zS_CM}$oBn;Qi_WbPsmgb{e2I_#{Oc}*C{}}_#Wc<6{SA@mecoPuUUx-XQlrr|1_Tf z>Dn#k;U`tmU5^&)xsNwS^n=fZXGb?=4kms_e(|Yn_R%ALDI1WP7Kq^3ADE^ZoxSJ4 zzCDCgo-vq6KjeyU9$g*>T&TEJ_mbW&%|>M35niYUq~4Uw|8xqR@K66q`_s@Lr*vM!gfO~W5sR*jRgmS?(I&k1)4Kxegt@) zyN%=dUrhaeIC{v1D$c^Whfz)~w!1wi1CJZIGVRr$n)oO^oysYMH;bEW5l}6jpXP6G zT~2u;TK85veI8yT@fh^vT;tb|--*#aY+pY2$q;UcFc1VxQVJ;W+m5j)WFx_sX<77B zC&G!-=U^&BcqaQH`=lKY2|mAC41Hm$>ayFadkglg^;>luP7!&P(1?@Rh{Nr7EUa@Q z9Iu8bGd90{@Qrb{bW>{O0{Y<2d*@-Lb?==lhyR?61?cjt%8Jw}+o{>QTu%Nq)Y$A+ zJOH!U82~apGKuy*A4D+Z9(UG>Gn^n+V0UgiKhG%8QjsyGJqSDTWE@W4fvi$HzNLlEE5YTNz3ISSSTOZIn*zViViX&ME=l( zLf{+z6$FrahI$eP<`jkDZR?hS99#WsLf?6JYoY2RYAZvqT? z3~9pY#I$Wf&ef56#2NGh>+26JT!)jcqh*z8J41m#3TiG_k)rkCFyjkj_mxj2#CGmV zR{r~TZ$&!i-d#gbn#V!vFK2dANc_tqL(IpT4ULLkwJG!3)76y(*UUDuLzie=D+tf< zbS2(8@sB|oxYmP8Bv@wj{bw~OxR&RJ3y@9L4-OeT@uM?JR5-Z)5R+ArFdgS2kJRom zJqxX#SNTu~bjqEww=(CFa{1~2)!iZU>Vru3)ViHdHh*%j>iK+%;Hr+CEu4xiCKowV zDwxCtpZW1$n2*UumeEGnKa!gFjOKQoOz=bKXMm`DyF zj+a z1eQ)l=J+f`GVO)}93!ymWjakgxxBx+q+>JQFsR20la!u2kH=qrXi_sVYr|1BewfbE zIb!&jlCiHyHKQp0oOtbw8yrAJ@L6lAb55~;;=aGkx>T5Cz9Tr55#eq26sCdeWi)M-8`8KIJ!8eQ9K*A^|6O z=G1J^-1Sr`i;%TWcH5rjyj`2bczf(VSf+cPTE-fUi&ftDAk~1P>rZNdC^CD%Zi=#| zSoGzc38kijdtZ)!RsxoL?b|n-22_<(DD!TJRKM@f%Lth++@Qi$pih3FVIx$3X-7U( zKWQRvI6Hl@kwuS_jz$iN=L?X=?474slKb3;JJWX%#+$#J>a%Gk^mZxd+mW43#BfQX;j=j zrm8BjOt0V155*Tg0qJC+9A_I#P{YBbp3 zv_xbV_BlWK>qWTJC2Az#u(us7M$Dk-5Oy}cgst-nteS9NsIkl}`lrtRZg?ZTKGB|( zWnkalP1k%QGv;akmlpC+7+Z{k*hsq*`tIF}#X-~I6{GTtj*R{K;}A*&UjiEc$Kv?2 zS|`q9Z^~0&e~hP$ejyJ&`h0Wdrj)=O%`g;Pj4rfWZ2kofR%=&iDN3GjLTx@RHq@p+ zVwinE$>-_Lwjj|S_jtW}+}*U{&Z|&yvUb~OM5pJFSo!g1rqe?%`SUK#zRu>;57mtL z1-JFbUSHg1zbw&FdPlB1+0&UyOm@aXt0=pDy*iMh;`cn+QGw&gM9Z(P-zln&>VmjS zQ*BrJ_dsmQf=hj!_uRXXoPs}dk`>3wMV$@t6KN)@Z8c#Q!3_O zrLBEK0aY=n$ixh3$I`Y2ZoKP1ullBEQz*W+_sukJ+0-^fglXl?d&#{$GmLUg;whdv zHoXGdS2GGq4rPoxuf}_RNaUGAF)__NDli-0{M|-2Vvxhqb>$|U>biCNWw9&vA~r=( zoZu+(X~`U-s%f_#r8!s>Y3S_>U(e0Ebsh~$Dr9QS#j(MuiWE)sp~OA}7s8k6;IvyL zSq=`0h%m^1&9HFEm5l|T8;DnHwkBBNZ*@iYMcTL{Y`=VRd4GmFJZ2H6pxwX;zs-7+ zjS{mV;2n~8PZ@QC*kQE+9Mi$9UJKj1d>yp3kSWzKgqK!j*01#$I1qmZ4AoYP?Yj3L|}ir(}iW3-cn!A9AwUC_13tdCQDw5;j0<>s>((8 zQa2^iVl(?|xFaMBOO|f-6Ru*b>aX}ZZ}s7a!Ek# z9>QKiYV9N{86-2(i3GqAOV3_hMX>fz9t|Y3wW?Hpq(9Lc*3QsTiBIGV+M=fS53iy` zQqm_4Yzh5{Lahwt=unsrzfKx|5@U9M;9cs&)1B~1g^ZZe$fU*%qfpzyyj(Ejm}_3O zUuk?pFl~3>3+Sz)@x0KYu~&-=M#4gddm&)mXF1xf(04OxHjN76Up`!k6k7kWuNPX8 zx?b637EXD7Q=rwr1J_wAGAsiIX{nH0MVhJ<<@?%{a!(0V!IKaATg6`LXN5wM$R&@W zbxVHJ6XnVgyuBude8P?gR^BSAp*mLXHt9}qw2kFSJ_zf6#0Qf|2G%g!sa%jzb9uuZ zT_{TdzHs|OfK|~~Y8@x4JpW}{M&d_CRAanFrxV45+zvx+x-zfWum-$`+}{_VyhFZ1(tW@L%8n)!BC=j^i56*Kgk_PDRc z&O9!^m07s{SElFJ#LJp)Iul!!pGUBl2^mtzR0;jcaJ5$>*glmEW{0JJ9`xjRChF6a zu@--!CuOD!J7*}@`{mg1x#g{GE^CbG#|h`Wj|!L$Wl0cRmEO!>y00`8qfu?JM0dfM z71oDtweIoKPJ|aT3UhJ$NoORXJ}#oANb8+8qwGu}%-6feN!T3Ve%sq;+gVxjd@Kwz zMGmzvl*dTauVA(guL6lAw~0T)`PF{WRqe=~*PqW?8;uqLcmpD!iYv}G<#B?q&3r_t zop+SUJl&C#4D9w}%dzx^t{+cdAuIyics4=V^9Kd{h=-%77wH!5PH?xy{fyO9~XdSF>)zqbd6L<`Z_UKhZMfKOqf$)If>jbDfHod)Z5=L70Yp)U}@HPmU)ZPnU-o;{&9l5|vTAB-ueaT|ezAimI$f zW!TX)1dZ$ASNLILR#LXXk9a3I`GtctIU$ zm=&|YPCxS2n*}nl6V;yW@i%_Nvz%UW(RM7C;QZ?(B=ejwU8o+ zSSCsgae1gqcnM+avhYzsPrw@OBjYw_i{wN#M-d1PKlAglS!sB!&Fnxkv!v*!LIC15 zN-TOF$vF^;oXLoz?$?Ad+kEI97oEE6u3BMFd%Nqb5j?9gyk{oUGhD~RG1Kt9XFGuV)Na@mzpcxB za>fO976yk~RYF4gp2cxgW}?&c-z9bzKPdpAXdEqs>@G<%y7ROb#SY#OG1Q2|(hl7+ zF*a@rGA8rW(E(#cuGu#W_;x|qff7ShR!_)H4cgmDJ`*L5A%SJ7=&6hrMQ=XL;q$Dn z(mC*dCTm`GPR(n?QM>)cZuTxU;78WnqG-}ci5Vck4w_?mvY5a`;B;Cg{(f#bfdM^3 zAEHVpSU%anHqtr-4MyfffFi(-R2X!KT#g3XxKEokOPXwdATGSlv<@qd+8U7wMRPIG ztl75O$laN5aFc08jE32#(iPL}h&`7(RTIMWdi#uBXT?2!ZFrZ#Zw zFNkl+y*FcAW|}e(Z&6uXK_wbw)(hPVl-hO5^sBWRaeWFhhVK@cDO(Z<0`L+R`}e1^m5k;3#8W`3$_-H&>VA!Hc$NXn+seN7s*>8{mN7Q zPLVMVH8F6fl`=*N_WexT_s8wNN7NsGmDl>szo7hrJKAZ7wIc31_ga!{a!jYUlqXaC zToQ~le=N5?(!(VfsNY{HT)wC z+o{H1*zM3a)7ni+-O&)0xN4LpVk$llu%?47gD!T3BcA3Io-dirax1Pw3<-Cd+ZD)TpR3Qj#a@fx2#WRndVN^1{K3>JXNFSJ?U?hYZ_m-!XA z@PLJo+)CpTS?+4x-fhCxrXxpbTo;+wXcJSY=^;1GI){u7SCM?zE)TW|G6bp^;G-}< zIB1zL-q>H>EIF{@F1_|)&~VZm95+;Dafzphy*9!ayc2fD3Ee6*iDwg&Tt5@U{Mm!o zVlTP7G#KiDXwm^)&(94Yn6K;NdvfuP6hIdBIg#P%X+Jm>rt7$8xPqE@yLz0yd2oQO zjjh|bK<|$Q+(~Bl-AG)b>xw@!Klp6$I!=aVM5-XJKq$5?K1A2v8Olyxq2OYEZigT) z!oF#$5fNhRmyuQWbPdBwF9^!Kaq>4&mU#FvM2zE*)+^8jbCzu~hu#`=(+Z4Zo6#vJ z@&+(GNt>kuJEBWbg3{a3EA`|RD;9gt2#|}A^(}%nI&heTgj2l@S^SkN?dY{m88oMc z_p~q&@eS%pPF9T(gA`@hWu`?H{YYbnO`p-%V7-K)3u&c6=l%h#jD#bz?0skWfgU)t zWCt~yszCU7N7(n5re5@g2?o@bfZScWqaMe6%VoIAmcy4Ibu4A*zrCdVnQ&h`P~$8-hRY9;|-WwX8$7?4^!PqeY2X&4x< z>mBW*MO@`WwpO&U4UO^p%rH5?oh!Y2H!Vt=_q)5CG+#@xa50|B3z+y^5QXKO?5^Y^ z%XZEtd|c-il$?m9O_j=@bKz;fd7oF-Rsejq>a>@{C-Wu5P2=XbllfMwzSUwEVWy}g zH1g=s#7lk#JwoiabkFn1dSQ~~rSW#BT}KR%LWjc z79lLVU({mqP$+GxH9ELh`9rc;Iqztn?NUK0ziYrE zS%Hy{RYLXykoqAU8X($uM?J5qaGGfw)n^(N92`PfLTlKWwl{p2l+_&R_C$^V%sa1T z8HxPDY54NR=IxsZ|2x?asmcM{<7kUPAywcN#B)okixKfo zy&x{`C@guDl2_tW=d2yo2WJUQ<%P?i+)6(5&!WgrZ-9zv-KLzbi}8Bq z4ybIbi^hm7_ayaNlwQllTs~wEuRW>IR|F2sPf`%#3fkS(XFfg70YU9Pz|UAP{oQD% z!iM^a*!skMkY^JaD;&#<;g4Y@NwH9gk0pmpE=x|;E}Qs-wXsz>IBu(ynDkDM3OE4c zT1A=yytAV$zUf89a(|+$2&oj2+xN{%@;h`7qpGAeoF534Yhm)aB(lngj#$DRu;ho% zP={V?gtF7k$D2R>fka+U*VZ-fjg94(10EJ4ImxYYV=Q#j|I&Uzu(9eRN`TAl7eZy% z>sETmz?hnu$L%*~X$s#u?>3S#5DFVdQ zm+BtQEZf~>`oEI28(mC)vP;%8OdWb~!NaMiJDa^LY!g49x^>iGhxz;!z6&J&!w)Bdut9$Qp+m#ulNs+)< zi=4mpjK0(B^Kh?rqXW#ZDKz1DF`~8W##R{WiKy`vF&Y3TL{so|Q({2C%Nm_C?wZ?< zX;Z4_`W!qnbHiS4UhBgjb6v@YG=fMFsX79@GT2E5L4bGaJ2c$K8r`VmiG$y?_r zFKEhbu&DHDO(#6DH3}@oMYfPKa}3aZqo0V;T)#RkY6>KS)-!nV)4UvJiur41;3f*G$rKQa7% zJ5T38)mQsK`ug403rtV0%I$M{ z9IF*ib>oj#lN0XlxNBkD3K~9KH=gRSsdq12*}hB1soh)ggB={`FjLR@6MRmGDX#_e zo31Wm(-il%kSq~7xwjT4&}BZqh^U-&t6l z-n&6Qb}M4<7y{uE??Sum1|IIT0w2u<&ob=|bKv2t%hzLaHX%>A zc?#=(Dow5(aM{%0jEmpXhpHZJ+!it5V|VRa=7F;!2Rz2)(475mkSkY!X~SME&MvWs zOHbvAtAC1`9~Zs45Zdf1ECYL5_o1wT3vNM>V*FuYe{3m`6Vb=bsyWE<~ zK>h%9&%p4S$88}}g@b2nVYnULjb1u>Ftz}QTUKP5PlQLV7L;)Tw>zyyU9=f}e}OM= zel&xk`^1~!z2jtU*&PvFgh6lrMvGl!rcS=Am}(KcNOIDcf34M-|xUGp{Or~}< zapL_&G=)UYbJM#i5{AXFkKiNFFNo>*ek%SUn`e&4{A->#rU?w8u=$rRxGPsMO=mO% zj2Xn)-?`FycB;ZHzc1%+a5N`BJk=*1tT168G}QCWUvw&23?HqTWsSl2$5kt`$h&HK zS;8Z{gzeKBVJ&@{92X~-wEHuLwaknnA-U8<9%UCl=!LPA5f!NSo)9 z(R4(i*6+;i;E4l2KV2_DI4lD}M-bSINO!g_O46+x@dU4aYU-&3t;8oOcxEKEWoIhK z91m^GbpT^!)d|hcn=~&Q+M!iU8!>7cS3~7;tavNEL$Mqrgs-$+vYDu=a1jd4X)cNZgih0!=AB$Q3Ys-y0g755Nw)Jj0u!s;8m<#UIg z!;ET?v@V&J-*WcB@pEBpnN)}Q=XZBW6ek(hZCIN=yNpR!m$(-aEe)~jRM*a(t1?5y z?E(WmbL2)vhbVm+3(p;%aXN%B3-R`BmC7V~!jkOwO!l1oHQI#61H9sXKH;9l|D|NW z$LKbKb!E^IXNm9che1LVw-(S=Me+Ttlv?BEj5&}@lO~u#qvJa=YwJuIHpi%Nix|B4 z0PJOYZVy>46!;A=fv0dBt$OA``Jvy2G^X;?WX=IpR?h8GHTKQr@rbfuKPYu&@AU{z(C?8ZyF`zXG-9vx)HV)Z z73+94KlXSSmgnY;9|i#yOvGqjSwuLwI_p69b{8A>p!XWJ?-jM-ruA@8o<6rWAzrhR zV0t7Px6{BtBxTfY+3ngNtqVspl?n|%KLWjW23e*T9ih9&cZAzVx6UYn%PBj2*K{i( zH%#7T@rjK~$_V{P-UeL%>d2DGk=~MF2FYU;=~>VB^?}wW!&y)%jguVk19VJ_`=A}kw=0*$sitAD&y;+zWa=PPP+iVVeyv_%!Sz)l2?&Y;Sr!Rre2 zb;$UdnDDM&N`)mW$yt|j?W0&0Anj^f3T_t}Auaiw8vLQ`^e`>wkm_-? z=o&VCqBP9;II-S4IX6)=d|#*l?dLX0Qhsfkm}Q#Upv}@@^U@9A^ zDd>{qqV*GtncIp+{sMg}%qj5^SFabtzr0Q@{b*7uq>i1PvWFDv?bvPMCnkZ6j4zQl zfIiYl;*JejiqvPHoe~<{rcD^Vug^Lhuewm-j`0`KCQ6l=Xhmo8b|#+q0FpK#3-mi% zB)rcho{bdCWb|PYDrTj`YsM&)<)pDF*Br4VeIUhsb3&E z!s`MmA00D3fhGKaTJCUdpIq05+xev(Idusj5F$=b(YeOsB!c-bdoOvvrp_C8bp}89 zJ3|t)QQ0{Z2$~F&_W{WL^ZCMPp9qp^6k=yzlH0s3V*|7pQN^WjtsklR>3zEOwv%Z! zXv4twoZ)j)sK4t|^B+{ZR9{FMZ37z=Pwnxd*=mxo@l9Xcw4R-Nu5*>jmw%*h$&DQh z7E45Q7NB(_#HJngTTPGVJ^{hhfOPq1x=Yrll9WWW<_?p z=fpXS_>S*9)1`68GcYu`tUHU&?%pY;U*fvFZLy*S-z+DM*2)z|7>EOT;%|LDM~I-F z9qb}Ze&|I-L7ZV49w^{@vX14BjLz<89b)@K;b?N!d6U&A{n|p#EgL_9?EZchDW3yfkmyNEv zyLfX{Aj`^CiPzedM-K-+MT~^S0@&Czn{tKYXGTv`s#C~?0{;n4D<`o|7a^XmR${SB z%vT4ner!; zX4hP15KY17j)5MgGSZ_n1>7+vm9I$E5q`LA#QV5caC>eko&tXRB8WK%pJNJ}GX?id zL3@Tv6gCvvEoi4lJC~nQn&=?q-$ayNHWooO;JrXoGw?J&t|VF08P2ZrfZr?ypl3B2 z)-BA}dBIR0`HJieyiKb-upp1XJ2Ym&hF^U{JuW*uN25jnA|Y0teeTriB#E|H!6&gk z&-uHh`;6;af+BnU(BNtaV)4vZjC5oSDWP)(a@EqJ)E!qK(;fPjTna@XY}`^T>^3CZ zDW}u=F1A{Y+0%7jSA2FGZ5p~b<__Kn7j2rY$NOl{&>=I0 zFXa$UBm6J%nk&#;vR`#IEXXbVFyDAfwQXH_cgJ?TIw%eIpYq^qS_^RVeC>OH#)>w| zs!WGqMtExnX#S{WwckDY&c)z@GMQ<&An)fx4h+wVEOP)KhQ#Hx7x21*NyE;^9_V)$zm}iH= zwld+xW3N9Hf!=`Tq^@IC8)^;9=g^0!j%jwjNSg~2I9-g^a=2;v1@&yA5RUlm47Uwm6Pfh9{p5J0tE%#m@~hhQcT_To*mC_pGjsqPB%^C*vcYJ_OMjSh7F}dHAWkvY9UTA9AWOn=ZT~eA7AnW zwg==3h>1z`L(qS8sni6B64<4u8X%a!XdKMe6zfiR+7V)7QJd*ok%NDBueP3r#$Q(h zN1Qa8w>SDnB1e(B_oeIC=q3}%Pz9cCFTq#^qwr8mKWmUcpi)g8BW#@pY?-Sq;m-75 zG0g)eLwB9|E7b+{`cWzS(V9`jpqw7u6!(eQ-g7sxmFQd}7t$#S|z zz~*$;Z$tTqSlweylAi_cxr66d>x>z1Ldzq@__M6iPk^+~TL^O+ z_B4cOi?Kt9Y{WDq59HQ4*5d+y<5Bax4jc4_RaEyvNwE86v-?R5uTFyHfWS=bVI&e4 zqcUFu_gw(P_kScg~HV~NiXO5z}y0a$uSGv8#$<@1)yN|Q6&z-$)b&^ehJEz&3C&kH#Uy}>@({>>0 zYq`_J!LQ_3FRhhZzI#oe@`CDE)Jq*}d!n796i7Dhap{E|mSm6AVLjNy>@ z8FtoTG3R_w2y!F>g>GLxoDbM_z#vgKk)!J@?u&GKPrsypk)b1QLu>jQZ~2$>{Qhd9*P=Mj=n8yDxHc9h0U41m}%t3 zQWpKKxX~U!eogm-uMR)sBb!J-$cDQ1c&B}FKs--#LKE`-E2`(TIp16y@n5F!S@TJH zJAPrMnU&_!Ot8Z{$i1pnhRfe{$VJYe{Km7xv=~@`QYxx$sZ(()LaSP=eg+d5FZW&# zw1jqA2+EUp!&XMHIx_~RIPglEzj4C~`HGEoN==J8ok(U+iRN{xmol`wv5~@ZZ1Tn9 zQSPLvhLr~uuuTFyGKl{q-ZkCS&aTqZ<)RKaH?2NE zXX|&+fvs5TkT80v-z!+TrgT(ADvbLhp=0}?K88H;-h(Fo6Rvj?{R7u+oVD5V>CX`g{I^ko zt1A`l>5{j zHMY=A8ELvk%?jz-XxNzfvXW8(LW;kCKBRwNf{cJ4K7(LziS9Z6X?D6ono*AOvQSKVRGwJD^^BboFufJ!g zjmC*H8Bgv`u;3U2&DYb?N?1sV9lp?1o}M+dZRPX3F#6mu-oi9`?*;^s(Ky>YD>Hb@ zO8}`vZ!|yLRl7XiKgh0#W~4S@FxY#y`wD}xW9xq3yR?UxuoQX7VT@Q!(#oMD{wSiUdS?N+@f&ks zJuB(bnvuOwCG(;Ctz=n>v%1q&gg*=+?Pwyg7DaiE(Sb;#n{mj@+S}?~s0)_A=n)Uz z>J@%gF><>M_vWYPx5e4DvwH7!wQS!tK?lFOj7(v7ZdzxoVQ&4)rhs^s%Bsen^$0Gs zVV53(x)Ax4=w6Tvl)_h~T-GKheL@8Irx&IT{okg>Lr*EU%(6F)T8d&}iyn9-gMN52=h~c z!--O*7rQn%?Y|5lX9V6gSa#jlYT||AwF+WkIlrd#iNqKg)Z>p$3;fZ| zS8X6QyY2N&09mZtB5!{}IZvKO9{L4=zWenke+zV!`WO|_TsnJV=Ep@cuCA%7T7Vot z!CpqIf@E{eJr+18`N3(sdmqb4i@ zh+2v(9Ie~D8C>$IF4t+@u%B%T`FJ&K%q+aI?(8r)=v1*ON;a&?$s-U9fDcih7>{fG zX^9lOz>#JFZdx5Wr}ZT<<{^+iEV}Jo6M-A;_~`bLU1v#963;ozSk(2p2BdVk%I zPMBl3=Y`j71hBRYX!RfdimEMahzwtdu(vUtM5aS$+BZ~uaK(VMa;QybWJQp;OXu9v z@7~{u_1K}LwVS$fD^#AC_$`Ltg4^kZhpL&54h!h2I@ip~R6d0^EWok8XMQSG#jMrry$M57e?qY+a`ap7Mj)68kJp7gcl{wv}8j z_`(|OO<(W!sJ>J;79Kn+8W{(#fpXS#<9uZSe#rAow!SB6-$U*!E{_)aJ_z`Tccndb zCU6?AN{2T*#(Rqcb7RJ^;wsC<0!BF|?>p4jJIll~d1vhp5xxzHABh8(I>K#wZ?o7Y zrz;HRTB4o#pml3gCuOfIWAhO%@s{z%&7teNLaD=C---?wNf9dz^TT;Pt4G-?R?V5m zeX302*(yQKs3fZ%Uw^$a9y?UxwKqNQkDIT2g_`qeM}#rxZZoTVZ*)val#CS7%@U%$ z>vaM+qZv5d=dnL$Sd3OxCY~hkz~ciYb@{sa4VQ-p;r`NYn#V$ZeK`Ta>pMrU)LcU* zjqgAUEzwIBo_#*~gB6KzJ~t>w+cn1%I<^<_$NkB6NGj*={|r&*s<^974A1S1h%b%> zNDL*`zC?3z4*(tf`WfT+2lU1SAWXnk9ky=)_s}@A$l3lWq9AnC8N^y;UOEFw+O5gB z>3i0H>R9-vy+bC)n5H^3I*vXm1(*c^r?_#2juI66xqhn85N?1~98g+tHs^ITEpWkr z|DxV$o+1p9oFn+^;U%v%V>XRQ?I_P&B6|J-4y#C_=tMpqe@B^T@gq5!_p3o|G=~SD z`k$dwX3Ws;69(N)YgZK>An(2C{FTN!=s8XSMYP3SAL1}s6DW; z!(=9AhCEPv*{>4-AeaqMD0{Os{N{##nTvhMj{RTcz4cRE&l5IEaCdjN5Zno_!5xCT z1c%`65;SaZ_du}V?(P;G0*gDrg5N`u&-ZFMcyy8D@)=*Q#m z-XOA{{Bug8gOJ7P`*#+33Pjc4KZ%4&v(#|_>8#hl;61m~7uv7bO^JMf$~V@SK#J9x zR9BPVXf8%{Ba9;2I|r!5D_1RQvcKg`9!bP7C?kRD%meoWd@pv9>3yophswyhOBJ8Z z8(!v+YQ9!#fR}^vJJl`z{clf~*I700YUo`69}-=1Y&pd-4X8>IJveFb^wGi5M`-{2 z^%>Zm;16WPROxwf3UVkqL2MHbG;0dCHVX3X3;iG{%tN=cz5{MOx;xem{I0M>v$4X9 zMJ2KvpKqBLF-WyG@2~^)kBeVEwqoO-&^)Pi^=@%>Wd0TR@W}16uKd?Qi zIraLkitvHDLYr=H;9?001c&#YF5*V{d}fup;h0)J^K=YdmaI5g)%y#sgg)( zZPY%YFxJhyzHBpzuvnk&s+Jat5^3&(5nkfD-GH+gWmPZ>sa5e_4f)O)J$KL8M_;V- zO1-pQf=BQ3_8A@}m|x^H!t3L+9m~=sKSrrX>>uMNmC@(F`bG1m-tXV1M^s*p!|vFM zhnGC`iJ9)xSIisabi2e~`0?xy#{k|tJY*c&$yX?V4S^vp?wvn`jfEWppV+x@M`x60 zuoVX^{qf3>y4#Twz&^Qac%#RQRj_v?V)3S+dteJnq2}f}HK|V*4}KCLbmaxa`826> zVt9SCMldu|@p2Qc$kjuF!wr=d?tHk29nsMT>O>^X{mOEewY0)f+wS60&=}At6Me=CA-XvmlCl?v16Y7^Jv5 zjFEalInRTXGo~s_c@yaQDaB#`xp&4Dzm9AY_VSPBR;k-tg0*3&ZFn$CS3Ty8uQy0F ziT6zIZh6>Wktw}-m*PK>4HPr=TNr9P0MZygW|g%)S@{9Wr>udDm~ ziDQLmsc&$`PMbM#{|ga9`HII??z!Jveci9xALP=vjY<-S=O2;%%R(8#hi22bi+Q}5==yxBTxz14wM1eN?I3JR&A&oV51T{ik6 z6SZ_LRi%+2pqA1`cGJ?3TX>}U!y1#S(My2A-xA>vT0B$zaTOx;xTO)lgbIeb?6J3W zcb#Q`*Chhy*?hP4i&}l6K+|rqaX&wQghtBGZ>E&W1HBs3Iw?R6>v-4|%{NsB4aZvy z+s6hC?}vG1HLXYiZ9Lcr3CLoV`nBV^RL_%R^gd1-s-DFNW;md-+NH=>+ETXuI+$O^ zMcmw9QuJhO(>?fS8dpz_S!> zzS@4YTA)zJOvsp6+I>^7IeDL}y!QvU@tkFr*0lL&_D*hsqMzO5u`Z9i!UAIF1A^Eq zA)ye#7IfnSm9^&3V$|J@@~Mm7B&YWd(h) zg`p?iLeEz>d3r-G>F`Wb*Y-w&Y)#&$j?8A~O5r^|7%HVW7@Op{;BpJ4WC0VS$@D$8 zPb-nbnI$!;Ee)=fg|j)7+O~nJBDp{kUKYyc+bQvPrx?f@Z^wJ`a@+-ONQEW7HO2g1 zqNTNIrB=WKlF4Cr40p9eHyh%-_Ub`{Bm;RlH!vrHGqPrCx)wg=j)~uO7xDqt5{GHo zJ=o7SR`Up<4p zaz${cpOU!r*^ze&roTV}%9~yyAL_TMhn!-;DaH5fE|FMJI>2uCCeq|%GQG3?7OmPP z14eKnsh$!yhHKE=g4AYPW~y7Mdl2;kmhllDEZfADn#V8rzHH)tjHWQzwMmS(_hkM0 z%VM?rDzuun9EVKIi67kryBk>}JZWX7=)&pw);jjI&4rurPS-zjybyRruo7>~$9cR@ z@58CEpRcp&g)%KgnAgJZzbJq%Yc1-Le-A@xe=+zBR8WDLOO7c-T1%ctAnv^S)KReK zh?KCyO{-}+p6;x@ut`B|2+hF%#9Y{Mm}~U4LoSze*l$H{C~cG*4(qiq_3&x|gtt#f zQ0@dh|CIRt>B){~+F<5Dz4P`kjh&iP4@;*-`lD6N;@;jK#Lqb`!?w(18p`kRWVs!W z@#kMe3evsXJHF%zn42*DqPbXcnRt~Z0Kh~K4T%O4(^)j?yOO0lWSY{^gqDyUG=S6p z9h<`?+}-b1PW3DHSM?|}MoGrhQJ;+4M8(AMr&kujYmEPGQ@_QON&b=WJ@^eyH|bFR z!NR$v_9Ay@{f1wi@t>{?O+7$_3EUCb89VR7aei4zVE<8^axjYQiRNS@w8P|X0~M&2 zCm{t3^4dR1Mgco9A_iTnSo~go0bWcF#!;v@X4e*u0Qxp3t0r^-`qLH>-LO4eiCCze zDWjQ_!8oiI{{0-6O6b4FM9Bfiv-YJz$Y;fsw=#3}?7zs;*n|b-r}keViW%Fc6fpW~ zqXD$XX*oi2fT#6SQE$oi{mXvzt=Qs#|860Me^GAPNOy-8E!dvGP)uZ_@cKvEiu7{- z9lh{x!MAkM4#(#IJ@>z6T5_h?7mt=rl?{;#J>|V*0R4NG?U)@PtjEO~0gDLPO>M~= zn#!rAQtRbu62AcIbHpGQLFa}0GhNoQFTsnP<|${T&s%)4JG@(1{`{4MJ@)-^JH)>& z`G0;i2_gO-)IS{UdhSaNezxiIpV__B%UxU~b6egEF|&;MqrHRXCu?7q7HuL?v-InwJgAqZ!6LJoYf+nI-#P4`JA z7AI%pEdK8pzfgXWO^`2?p-D`QaGWB{i2|9bs@|GnMz z@R$8%uUFj5N7CtIQqs}`$F0Qwm-rLPS}#TnKg$-%6sl6IF{loi?SMzKKc;=WMq|A{ z*ZfZl|7!3cyOv`Mi;>XtamQoBvM&N4iSNh{hyIV1uYhclgaoyJnlSK}gQ}yWBqtyL zTULLc_I?N0FZ+MJ{{QzL(f$T#>B3|-({blg+GbGNrt$VS%RIzc@dn1zedKc&&}2VI z7$uJN?OW&cN>xCdC)h8R?M0x;UjV&xmM*Qh{^ii{Bn*7+S#o@U{rL$y`{@Swzy`WU`>$Nw zc$)8w7eA&J*ZzHU-oHl=(g2y3L6QwGJX;H^4Jp79jflFy{h9iN*Dn^dVKqjlDm6Eh z2-r&1lD>obcR^{X0jt@*jHu0sL;TM(-Rb@)6(9)bKbO+e>;88M@4rhsFGg+!m&d!y zA`I95MQEu1eN!g+S7aDX+x9@uNaQywfJ~Si{&z|7$g&?OaId~u>@0S@TP^0RFfKQnVMt~18h7StydYel+GYXG6 zScu*aRv1|IwZpf71sfl(2M|y|N8bU5I2dq2aYQ#~mQrFWzd`O1iNL@jpLeLUF&zA0 z#)TNjOcN6FA#1=S41TtdK;L@wSMqPB?U~H$#aB@aIToC2Dpz|w zgD+PC7I>03t;8oEY|Mo(S$g0pvZ}bT0YCJji~iJlUP@lSaTSQYm;wjIfqCOX2K1{^ z&$?s4ys_Z7B)^xsoQMaUgsAhiAvGWZss}sf_;)t_d<}Pl{CztRQLmKQf7~2D_<^11 z*yy1N`jAuoi+tku9MPnW5oy0+%`9lo1|>Bm|7_V-_fAECkOU7$WiRQ2#t?EHLbgjRcorMI6*o zT2XRa;JjGwqPh}cF29nr*cJcLQW(2T@)--wRSAAXw$uKj&4dH|MI1QWw?KRz4Y8^zv#Ldj{*b4r-WPxu1L)&$b~WU96uTkFg;AUotVG+`tR(U^i`3U~|l7BAZy9WqDz#JgxgnLTIX-Kou&DMkB2S8l|y5lRFM za=?@Qye{}3$ zrR&=xRk3P^@3-Pb@7@wzdOS18jLfi6*F$!Sjqmvu#a;@^OZm~r#zAF6VM9?UF)cBk z$_af}K}NL^t;#OtIzLM$Dn@ELSC5BolA=xr+zgo9^Q+)k0_xEO@1ihyFeL^@`l=8G zK6j*AM%-C?JurXge@7cb2UxTJM*IEj?`VBEOFkSQvR{KE+1TGfxFDxPbIzLhrFbn2 z()Xu~L!y8UxD4c3v8yv1tEwBuw|=LD1T<+W!>1h7qfII*<>-5oCwJ%BO{|80Ri&LD zZd|A47sX-xY~lP>&?}0ehc!oMaJ6%PpMYV`K(MIaq&g*knh6>){wvs&jZ*d0_n-`` z8-I~Dep+O?9;Byz@43z~asqxAzNkLe*&ZsP((ZXeeyqFgvQzJcCHma@5kv(-8%c-=Eg z`6m*9MU02%157pj+kKdH1eO(Gwt2@B11m}XsCmBeNhL=lyh}xLCYC&?T86BLFCXRC z33Civmz~gr`ewrvftV34h3(to*7Rj*+t->Alf54678J0yA5Z1mtZbXn(tBgX#t}43 zYxbvXSDHM-b$J|S?6~pGap_FdCNRXQ`|nHxlFDZgf+=XA>2)Nt%e0tPWld_!>bQcq(^Iw+>8|kENIQ)1kZAyiT(`zmPYs0Rtv`8Sw3(rw$@FmO5j#JC7b;A#`gZ#QM131b5XQl zhzYsG*SslIiV(hGJD$?A5DW3suoZ@NE8F|VcsD3*39W{Pk7EM%S1@24Av$$XH`w?()eqbJyKD*bYr6f4Rs8 z=)jq3@j`q1J9>_1f%& zLESmmnsTIvM)*A0FHIHEZuzqdsp(}AJB(^&$HX$zmJ_pqz4x0_=Ka>wLs#P6+&^oaj6lhz%c2{J=a0Fz z`e)JJ5=)4=nn#OuHZ@jMGqbdaji`^}E$%P7WKDsqUC*L}g5;~6hD+|MOxZp+@l0aV zS+um1r&fI7TPimIH})++N#oy-R)Nph#6Km3i*@WT+Ilr>D7jB3hD#9XDz>0FRR)^$ zGKElHvahx4XnN4$ z14nQ-KJ8}R2|W`lwZF;uslZ?+<&1kh$OO8GFZtli>xNTgz=;%N!^toJ%sT>dTRvC>Q_llfegL)thEN^j3qI#snzRK)Ze1PRBFh}KBule!`R+* zv+K$vDqy$71u=XWn#I@zd9mn&w_!KUjwdk-L|kpvf)gw7Ru5c}PRmUy2d?knmu&#Y zSG|c!HsIuEmGuR1@BX^;F9v~>x!uk2#V~{q7SNE-t-4GM)O@nUMh^<%TSDgDh2?Ws zhQbnc+w3a!Hanuif|^YpLq{jYztTy2&HUVN1M;n2lY!nPdO?D{K*RzK%p(R4;B)$VLTx^4Ow^V0mJR9jx*3r8j4Hxcj9WHXtJy_dS zs>T1~0&q_RE`IyL8e01I7lj+fnWF2=axyS5#Nc~rF-@tV`A$E31|(5|Eo%m^gm~REG8iX zQuxPWfi&Jdq|Y0GFIfDe$ew4F9B;-1e12`>tnmsN&s8FP5@AFCR7;_`VH#~?M9Exgx+Yk&3;#ck?7R&)nS4jRpH#o zWS4||87c$IJGz`hqJM>zqwkV*eqs;#^VjFNAs?<9BZ&NkYL_+Tn|am#To}=Nv5V0CNV(35mytccYLg0`tH+KBX@2y` zapP@rpE0VjYyMYU00k2hn9y(K?- z6FG*7PtTCslpBc@wo)@}bB$K%xBxFc1Z|CujU!&Hn;x1DL0KoPiY@`AgBdpG(VzlR z%I2Wqh*9n7k1m!HlD^89P8+IX74)0j{RjP$!YJj0ugNO!c##W;$Q&DG5$EWDG_izJ zP)j$#!RG|Pf=7)%0T2kc3D*2ybmzkhSb{&RV|R*jQ2R*uG>1U=+X~gsL2Arb6wn_( zy32?9Zaaos$EWNik$l%V z3e@x0qy|v%DWHR3E37)3yGK~`Oc$Z;Ggi#!=xwau(Q=LjB~zo<_L&VWP8yGdIpZ%5 zewG+o^FcGB7%8Q89QV|R56QbyUD&J^v{ z!I4-vt0_!*3oH-E?zvUaB|0%5IHWz32fcH(8%yxHxKgV2y;;cv%pA@iEWGZchx9*a zh!$2!^4AK!^|C!UWN&(F(J;YXf86fdzrdV}$hn-t<-LxYy{b@@(qNrl9?x;C912Tv zKQ|Z)F80&8K`}n!DA4JPtaeah2>m>eJ$0<+OpzR@`e8I(CMHfm8wZ#3hy}OR)8`Wv zk#=ORf_NETZY0^SoyR(K`X2`0qepejUf<+=E*Zat;;TkwP(3*K*Mq~DiMa*RzkEfN}*GIW(v zy{o|p9vxn$emW*?X!fP0n6S`_2gaU!7R&?qzVo25UM+v{YoA*=!>zk3o49+`KcPS* z5b@#|3jFZ~8R*KLkSXwtIrxlH1agm(axuzkl2X!fsg$Dhh3H~t&Y%UenuK!i-u@@y z8E>7UHO{&?1r?fJ?LKrh?7m)QWTG*NChQ#2q9_^-!-eC(!~o0?GcNu&Hnh91UJGjS z|EkJEwqd&3YR@;L!lAP6&r2xWJ(3m4o4O7KeIceqA|wngfJ%c4l7uDF=6M}fBn`FI zHKs77bT1u>f*Rr@G9ZW# z5+U@)UeNH+Ch%ZlJ8wu0Q8}`M{A1p6w0;r*Uq6Vn8o7}E^Pa6d?QXnre*%jP=^^Y6 z8dL1~Z~-Y-8)$@@eA9UxN;UZudwmhza5)^{q*4uWvuK;L`vYqHE+&xtrZj`8nQjWP z?Chg-vJyjT1{MQK0cX4#WpOVnatZ+hjq^|lenjs9Kfyg543=1Q2)UI?H@+b*j0_Y7 zT8P(qZ+&5e$}E1^D;)C#94Wlnl6BkQrGETcJ;cv3jSFk@Di7a1c+mh|dHDzYI-V~TGNu2kt2)zzJt06aCp=CDVyZko zS7RZi7gD3l9uvdX?E=3(pI=_Zxdm?BwWCB6E)tifI0UE9nW9);k$?oe;#`4Y%V+5< z8^Shj=RH1kE)nzXQ?Hl5MJ;Wwao@;9hlmL8@sDq#tdS{FOyUIjTNX}Rdh+@>x~hs> z8EnClwxypeG9WMrmWdTMC%Avvzy850ov$!uSBRZvfq7aVGqw7a(*?K1nw-agCyQyj(CDNNY z5_ctvxI9_H`jafi@ASUw^T++*vLC)Q&}l`vb~znGisD}0n5`(AS z3uv_h1Q{X(Hq3OH=<}6@+4OZ(>G-NuspALy1MDu^l;QD5`~1bxl)kLv#-rG|+uO|k z@+hXc)r%bKB}Dc_@sextrRGl3$(eTpLV{;T7?!()bbcwjV@?@ysDI{?+@Q+S-(#cy z1qw5^yLtHkP3?IuZ0U_Zl1R}Z!Bfmq`bT3(z_UTPWtRk~(~Yj=OUvQB;$?xwA;}b& z6%qmxZuTv&wLz+b`4H++u|WfS*xyyCrx>F^c_0%|#yh~DHG9_57wN#{f~NBFYb@T{ zk8fp62$)orLzruzt8zsBh?Pojw`|g@nrE^~oGO__6MP>{DHS1x1=jqD4?`sp&o2@I zUv~9@G}~`)plL84zMiCopYAG4BPN5raBq*0FjE4oG{afKNHKVnlbRt|8j9{#&YSVc zU^(-d|5U)?Dm{a zCUf^WKI{66kS3#m5@FUt z;QO%v6{QPuS~P~e%iDzll|4nX^ep$f5`sJ!1TKS$D85im0uG(=^Kydu8h*tS@uH=SX-J=>$t$z61QE z&kRXJ6p7`CCOxc^CoD2FT2uYVH1V>8_ZSLz{VSFO>IkJ)$aNj@nt}8(C3c@>DNZjB zzY3<6CYAu{%eVAhN@FLfVDDbCE#Qz-FY|>x0zz+5g&}(vw7fShY%V|s)IjeA zGZPzB-8%kNj@!mfn{c%7za}m`R7Rvu{amU{PFw>4QyF>D_56sR$4!qYkzvq{aw%jf z&eGW#l&AYBR=>+-`Z3Ga`$8UamRdfAP!eT^HA~!rXOjAbg)VA2&x zgA>ArQB2(k`tnTPM7ED?eLj3-N8~UyBzCKCZKlP@vF0WHsax6FzY%xhbbo?ij^;JS zBo570nqbZIT^^nSlZhM?z5d*t&l1^GCXzmo91+nxIx?7_MXez1gDW`2eN2d_`SAeG3InI~6!IsZ2+`aO3$rt=>J#2iE=Ia0R>in4A77c; zQmvUCS##Lsn=0WGQFV=WMvb0isv<@b4ulajfu^k0Z|0^}^GoM8I6i)BK`9%H8uOBr zg-Wl;mxJ;>Aea`BMfkPV_?0;=jh6?}0I?b+U^0#JF`zeq%e$8|fRLD}+U+MRv`GN^ z7tI)WbZA6qoG1huX!aK`uCBWC?1l6KjUF_&nA*_bYC$fx2O24ay(CNRSbw`o1TVyxS zQjrY2Mb`K+HME#F2ZIT(OEC%05hr)9?h zv*T4`QCAV9q$rqP0UVLkv6#cB78W>-hwBuV@nw6BVhIfd!6-H;WfkJuu=5#4j8F!0 zr00`_+EU&(-9EyNVg8zF!pwTIo6g$)?~&+S@#-=dc?>ZcUB&p{cm#7Jw^lG{)DgY~ z%1b3uiuS{|E+x`&=SFezO@`5g1W2NDiDCDWqd-lC6xpe~=|z_o9icC*(q^JJkItAm zSWBZDErqA2)X?shdKGPFSm?AS+5I-#2sx#9o?-H~fH876f3EGUE7@OuBaZ zW72(&$(~USpI04P54ru%#)Q)h{cp9}2etekUn{Af_y0)(j@Lw0l8~bQbJ@5>`~yv) zY|b{gp7^FK7Rj)tD?~2OxT5r?{+Y*$qk@6zNIKY`xNkNh**=HsW%5f7HI3#4ymx)D zVg{+wzi0S5>k{W_Y9Tcx1`o@p5*9nQ&#<}}W!y$#$3H#EVat8#ONk<=8O@HZYG{=t zHyYBegdJ_tAI}jHFIQxz!(8t@NNeQ%#vxfOm_jrH{+l;0k+Hu+oNpv>1V(pP7YsFQ zvvJM{R3QRqDfHJz_g>J|e$;l?=g(M~jGt&RCF6^7D9t#c4?3gRepofoPWFcN=Jl+{uob|H?Ido&6I+N9s&^%3 zlWbwPV zFk2td-^D&b2mpn~e?UQ7e#)MU-R|BC7uKTAvZV)mpO!+o_AM)_J%2y;F*kw`m+ZG@ zUD}OKRrhjbN8mTjhgri1zBS%9xq20RH7YZ3U)lWc9*0Ma z?7LnrzfBHdF>A`=Llo)Ns1;7?F=b2w3T$(K|2T@9Jt-9e5?O_Um{-cPkRO6Re0{VR zE82Q1{j<(aT&~2F5DI$Z?2OXFv8qD}Br+aJo}R0o zd&gTMjXVgGly_bjoce+7s* zd_#e^gn#2qpV`6L4mhbdofe{SZuj-kneW}anjxUKg-Uav5)Z`}t|L<^mq$BiW%v@+ zq%;@`5h)~*Xv}l??Z4APGz;Yx#;a0pBd0-76$U1Pv0@dK-aGub)R$hr`8ID8Br0q+ z8v;U{&~KB%N-n6FOwQ8mC*?DB$QjzWn7&eSM#wD>biWY9!`d_%qD9g3-lt(UXckl5 z9-l&>vnFpqc?U8{Ri%tP$m2icJ|ZKnI`Q5#=vlOo#DY?QC;lKxZAr6OB&$gS7x z6Ip~nO;pN?2Pp=DlwlXUuq%k{M1m}|azzXkfe#Y;NzjO=K?4nd(p@Jk(i<4SeC~NpBXaZDuRP=eG5X6I-{g7j z686bMqz06-@@$*M_dJq;n(rm_fCFr29PZzkRTx<+Mm&AFG5XP6Z0r>gi4geEDSZgV zL{p!eV%C7!VmXD|=sO}CY5jF>^-{8h^Y2;shF*)+>cz_f3btrr-wukxtP0(k-B<GYLzmsq0&u=-JysyxM8&_ zJ9?iA<%qL0bJMJQt)eJ>Eig=u8O)>%*;gkoR_4mInI(ep`x{#z$}&9ekD!?ie`+3h zT#fNGx%iCIqS%JT8qbJk4<2$gQL8FHU3EOsCbI|+I6ns%51Mf)@({&pzFuqc?k!z+ zY!tsjoYisnPJQJ3b~ZKGP+92%n(jRGI)t zo9Diy&2LlA3vg^9o|d0aI-X^KdYW47b0TQ$bp3}b5ISUO0{-9QA7nPhD8Rj5r%5Wi z9{S21Paa6F>#n%UHQO${0)|Y}X^QSpM=Grw6h58UL!V}pv0|GA0SQDjWN{^Y7{oWJ z?)IxcPcmDWZj!b@45bC2Qi$CCr(ci^+XuW1fx&H`j#$u|^gycY*7(})MDd*)UFLZb z?f1vR<|@(j!$M;D-Gz-JVPX(z^{+U%t$%)OvxumxM4k0!E;7>?*AyJ^9bo6w`=GN# z``wC?F_4>+Q^JZ+F^u$DxBY&g^6Xyg3CDi}&oArIEjvlA*>B9E%|aV(uepZ_D&EDU z+G^KH`%QBGljc2HBtapyJb7(`h5yhMUgh}%aD4fZsaccWsF>dPoG5k>I=pT}Qu~Ow zBN~^igMh!r<)?h!!3C%f>hJ@*o$`n4ZfijCZ5;fPg1p5)|7U$K5`Y}_AINZ5XX8@6 z^{(@;ADaO(Q=}|^{g@CkX2G=y0SUp4v2J)+%=2nTq}~0+0tkcKUhqJ&=3d(Fc2PAEB@na-rVI#yMyWe$Kpwqxr z(W8f?KzVbv`dqP3bJoJ3rpeS;sbCazzIvk?P0@MC?O1!F4I1R}KQ)|MuZ_f@?=OWmOh%~EC8&e5-rz(p?92kwtL5K>WPd9T;#^987t>ahmn z+w|(W_qxd>L`VPdX=<~|jnz#nzh5@^9HsMUAC>Bl^*Vc1XeTc*~2f$V!8%vS#i^TcmHSI z*6RWPVP}7|-o0iNHt0NVZ50z_E0tM93t4oEUKNQ*ITP$KzZhk5#!taXjq9pH$<~`f zEGcIzE?Nk=Qk6h@_-k9Th;%WgYG20<_!nCZ<6bms?$QKZ-UnOLbu%BqI)~B=cFC48 zI-s&z{Zd)=LH58z;)XDMwtRj_$N;~)D`Nf|6?*;ximZQQ!eW9Rbs)#Uk9+aL)Nw67 z9j1QRtAGAvuTPqIRx=k%doEI{UBDfMnqVTu45L9+D6i-~*hGOMr}}|lI_$He=i&W& zzVM=>*9A9Q1CR|ihNz|~B#US&W*|Z(q*xH458IL%lWK>NyW&G0wjRAgyvH<@*t_Y02#5JN7Ymg+pR24)_ z6*oLU>7oglF!T%Lq&A7(O9{q}QgJS_BFB6$BSI)c{TZG%+{zjqsAfxThMD0_)>1$h zf&w+KWr{KOS*q@W16#I9#AKKx`5GNDOnN0IRpAvxV2ei&>+jk(K;74#8`x=WCFic5E*LWNwp?*rL#1V#PL42v zVVr~H@KE3F!_URaAZ?@1;1*Jm%V6h8;41VuFJej#T6f-sTniGyd|4{q4dUASfbvO% zf5r0Dmb^p-a*I~E_PQoApEU^uF`pxfpWFCj2YFCP0ELSUQDL+9N9S<}hDuhL_wcwx zstfUWuV)qCqsS6QV>*Z{oeE>i}+V$&x9j4d^vm=rKSkVo2yeV*H;LElD2z1L8er(`LB69-me~t;83;(DIAQe!evf=xI6P3eQ+MzCG#i zP1NdeNhESuF{^AF{oXbRV?$5tbE;d(3L^ay1iRf`_!{0c8%U9it~G$Aq;Sdz-Q8l@ zCb+nI?0sN^LP`-%Y@3NN_5e@c^O8)0^_)iHj!PrrS@&E?KFj)NMOT36|Ls5Ve)x8s zl=|tB{W0zCSM;NAN=PJIx1DqG!q(4{0oFPvqGb$LsoY}q;&@!ix)=B_A$<95-g2dR zq`NQVKQ6#IE|!=PjtYVnoh$s=N%L+5N(Kay1X+~8Dncx2)U zduC#WYP_>;MwzCmAl2JwD$D*k*RWn-nzJ86%T%f+)%jhFF#-{{fM3rf2Rj{n5~YLV z(_alwsex@`d&V&aKte*Es!ZGCWGnJ36TO?s9bQFvEXiaq`4dBpU>Ms}`^F zBpI3}-ASa~J0^B6L1PKke2T1>R_#L_H-%(i;fFeZxJbb=*PgNYb-v~(~<5^S3)PtZgizN8vzZl~$2rukj_;2hk zbU2ETVm8?QoV&s(Wbrxq$+z?={Nen38TI4b+$YuO*=jfrthD=n(lYc8&3;N1 zH}EU>CR znRa`$eW+)T=20UIj;-LE9HqfxZg)gc7+w`{r=Vxi^NHownja^Zh4==t7D?&FHeIHZ zc9T+&E>4(3AP*6-VsTno7eiJ0E#UwBTJIj&jBCxucg%|m9Sr#fE(N-I_Pl6y!{`)M z_zEoCKZmz5|9ow@?f*dbgy6p3I%4ddAiij-O;9!;=fU-aV9XHG)*ae&n1Uci&KW(P z&QNdn(Jm(8qoYt-oJ#Mq>s9MK2fLsug-?p*C_rcGy1$)2e%@liO7C7>PS9#k$vNi95; zNHGj$HEMVYSa@UZU-%l>iRh)g+_AYQ5oA$Qg*c}ft^NMj4eg^BEN>WK{eP9WWURHz z?`IVw-&>vR|B&6Ui05W;+WjHKVT~!~k3Gv4qGC zF<)uuZ?=2ay_;Q8eg20(e^GT_*W>+{fVcZq%FS;CU)18J&SDXRss6dk&6_0iZ6T!>L#{-tnW@wn-pwFQ$Pm?bm zcY4;`L5Qn+Z)X1ddsiMlgH@BcOsD!a$D4u;|EKIH7`$udvmvFE3pGQJ)I^_j6q_gu z`d2tq@SL=q67UJk@Rsxr*;$U7?EWWBc)Xw_o)%LBQy6%bZ9yU5ZGQJ)=fgej_n;9x z7U#nE)0YH23sxpMBCHYzO2}eH&ZDzzOpxN7z2rt#c8n5CQ6MKn&ztCqOIugWcp?RTZ22j^WX@GZ}4u{%8H>EcPIQeq&=Prp}2d( zG7yvCu8BnN*Za%iYT;;W0Ns6`dN`dtK99dAGf$sEtS7@T?X3@Bc4*uiAmMP&jt z>KBspF2k-h(*lIgFAQAjtp4-=O^Z^T_AMeJ&$c zcJ@{JbfT>()g}`{o{I=)3VP2_$ZxIArlDMT$o-ASMq=aWnCe$LU2D~Q$2KRm@ z;foq!Dcfjw`^>ZJV^ePHvAf?9SNmyW@AGttEQ?bsUT0)vekaiUrflH-2qLP?LRb6A z^7xCzsg#87mYK$Gp#~}n2e*2|sJcL(d1wTN&ZM>Jy;H$(c86n(Ai_f`$;G2vu=U1= z55H$aZ9WRNy6$4nbYEyy{#r4~-sNgKfna)(mKQ2yIW7aO zLCEzDMTSV5vbK|vv7u%8AvF8hiP^AeaQ|J;vV$Ejzjq?$T9KSP!5zwD|K1&kVhhhA zNWk_ktKw7ZuS_D_adtM~gf_zmHdwVEe8zT4Q>M&Jy4RbeX-F0XqHJR!rDx=@^e)1* z0jeLP9R$|Bi?40ch~Lh5SCvsKb|<99Bm~Yl>7N6|^q3m}V-}|r*BL=MKHhOv7S6Bl%pYXNB?A>o_Kz?L z&8gL6GO%dqoMnyrz1nt;0pLOAg?hsxHrOl0+veT7J%WdUvF3GX*Q`L9N@-?-OfEGH zRfz3OI>^9=99g3niCEcsr*H6dw0k>SY)FeD=xo%B&TtqwlAN?h`RmcRXUL)_9!mj> z!IB6dXU04({5q~lUqOs)1CLs6K~Cs<#?J41fPW}lBR=$AB{$92(HcGY9IhjZetmPjAF%D5?P}ma zbuaa}9f%qIJ|-vee)mqFn@o~CoeI)D|J5$o0}TM0M~yvzaaYaS`NQ#fd_B?2M@su- zr~k5}CBJ(fRcRb}{}*z)A^nDQG4@Yypjj^Afmq}ZRKHqPYdz?yRyktO8RTOtkdTec zz|v$_384?NB1a>bi-z8w-u@IJp;=6%S#0_75T)#jV1RCbn1sZ|=LR&^Z0Y*Lsb0s$ z*-Lhx<15i%+B^QU6*}gc4qFCs$lx}&E>Ww-I==1o3WxK|C+3D0j^;$1Z0~(@)Ff}8 z-6L-4ByG1)GCSsTs$|2T-;jOo_uhzM-KOpu?szVO`wvnaT>7&Q*z{SMYvpi{gRaD6 z6aw&VPP44vY9y#uslxYZQ;VlX9M|oA&t)QNejKb?pR}Qn@Yq;#DKU?YQ_`-4)wG17 zD<+{kymM*h-~Q;@zqlARcMyHG1G?J5r*XR3Llq}&d{{9rWhjnUjY}Gxy!ysNa%@t` z|J|)G6>fB+!sx;eI{VnoGI+SJA=4|XD&^@NSC(FM)?(6gWXtY8x(Ws zpe2hT6(>sNN?TX@$Y?0e19h_J#->Jl`uJ}@{_PJf14@Rz3H_AM{A5l*bIg4>CivoT zLGMpABaq1j+vK$pNcdv;VjvM)Djh^NL^cT~_`{qP(jUa-+}Ik|X-S_x$z68Q=V6b9 zR7uOGwiE4*bXpAd7UkGlak6j4nn(>HycUET3Ck7UzGMoRRka^SP)q)}E%NeX(_mPY?|HI&sjNaa*!| zVluWUGqGqn@#iwQb~?IZ1WdYWXg|^PcEwp{>Hd7$$_hh>nib9jU0CkO=gb&(kj@_6 zd5>p0eLYZ~My#E4n4nZOxXYmF&Y6B?C6vuHFmdMXUkVLQh!*DW_!B#s^k%XCwIp`m>(>Dx0^l`YkrE4VJ$-0yIB z$iC9z9Zo0Ux=SJED|@DivKpS->dGT12y&U5Dn}}Gg`XP~Y$iJ3HeczuMPqqyo`8~z zR^-YvVNCn10%dC>O;_9KJLK3b-0EqJz%Tg23YsjgSW1ZrF#>^nz#*g2Nf42L*{zA5 zG+6n5+H*yK>yG^j4U&O%nd!z!Lx6XcB%?(KS?SW6#RaLIJdcz;WB zI%}3Y?WaFWqmoM$w{5T)i57@9<=5Z-gvjS$)4OWHF=?3L9Nce)+>`Vl!NH@QfhIa+jK5KzR{{?z z*bW*F86zszlpyloPR&IT;O;^jqp8XC(Dm7JG4j zs6cklKc1*-md>~Q_lNbP^wgXL2sPdRR{nBtVoos*QJTVp3;4Kg4a+{}fR{9Z!RKw4 zCfH?*?b-C>2e(Y=cH4)W!2i-+WTfmMA(p$DdM6HIkHS8)|wC+vTQ?Rc_`FT$7Rkaw(Z< z!A0(G&D${cp9mw_0QsRpzo_U`5(W+IE7o|=FIOI(ZX29E1=ofKu|!|Is4g(K6t)~! zstBG=3Vo9%e4fq;tL z?*e$Q#U7MdWdWpYS4D4fOEPnY$i+D@aiL*iW`j34E!qC$#- zC)CcobWk#G)moM4=L&a8jq(?4)fpY57kW)m%91xREg!k>d}hTicemmbD-KonyEI%( zkD8{%u}~&D|F^vvTvAJ+DA)titKw zX;nUwAv|Y;f4zgOlqgRIx*RLi6ku*Ey4hQFtFP{S9Y5IeWbVc|GMssoTGF$>pIt9W zv}lEAT>1xvjC>7-c^@?`o4aKGW&iyEop~8Gjr?$g1#;%~Lra^t@$~^1qM;)SR5`yT zHOt%eorI8Q%kXhWjy~PS6TOYQgPnNJxjRVp_Ak~j!>DBZ>k|RU6r>;y4Vsx+#BWm@ z<1DY-KJV*Zi5_B?DHAVz>mB=@Tm4?AnEXVUbAH}yR*YOG-R4tpGlq#`dtHA*W z3sZY=s?D1t~ zWm^#+I3w=jtX)sd`E0-2nBsEME(igm?op%3d}GhwrtcpUTsza#>|4S)POlbnS=ck8 zs@IMu(F;|8pXGE-G_qYnyy1Ubt}WY3rh(zlg-5R^NX(hr6B#YDuAs_M*4)7i(k|HN z-UJ=AWA4Ze!`TW%`*L{#np_5#dLXfI$y zQN+s;X6rH#V1~zh%9*k*g?^(GLS!t$75)l*$*qo2dVjLNtiE3zU$Z4pyXC?@M4FBQ$Gj*tUOs2O zGJ4*fn0w5NbUf{nU2ZfgRZ}hxMsm)4+{YCpIh@C_G)@`QDe9}yN8vFXY$|Au!hbF; zt1M^3X7U^;D56uqgdVqWB>Rpg&p~W6&U&skI$~Z`S;nfTg*Iwa7+f%aSkvSazUVQ0 zR_&nSVO3lH9RVJlUoc7=4I)%qVoN&RlY2kZ z$5V7USSAfwb3rA0>EmDQV5kD6?QZNa-;Hsklx3P3Z&96lzl#XHT;8kp5f+Z;c|8iR z4~h#ZiP8BR48p=M<$<8>us5=MWawwCnJ?i5H%JeOt|ZJ%sg;NMioq^*R0d z-OQ)rs;!Ug?Q(x8 z-n63Cg++6fLrni>7>PU{GXQq3n7eXk{XNsSyYWnLRK6hukzbLL9_u_zJVym4*OFn7 z-MUcuRp{JGK7J-mU{2S#s%9W?Y=NCyX*!SfdmqM6wwG|iFTgmHNZVx@p?cIx3ND3_ z#V^~_W%bL9D12o*3@53J<5mS)T6)IzwK6Iw4`=Q7R}AlWlFr5s6>`dP6ni`FhCd4n zm{J;MjzP|R+YiS4zHf!T{patOg-usSys4nLnAZVMo?5r?{2_m5j}MY}8nk6>|(yR78Ce%v=E*y~dsJEmjVy^r3221-Ku1StYUMDT2Jd0^@^ z0H^`_A<+Ey-&K6^HYh2ATz7joI zADeJ>^BV+z)4?oVlo)OwgofeDr_x%>Gkza^nF=2x2R_;D4_YErK?xCdZx0Ik+{|!9j1LGJ3SN27c;Pl zv-5=?M)C3E>5sJ6dPFlFYyo{nrt#Hz)ykI0hKNe`R{E+1wQ=(c7 zfv{?-r46x93RpQIeFZb3vNR5cSYAS1{Xa8g1W@8s+HU)M$V*dKR9DC zjICuhDEmH3a@q7vh;i9LASEfOj0E!kpMP+8RFwre*T+>3KMDc|N<5?z$|tu5MiXoL z31(eP4Y7^8JY!TbOR8uFLeWXj1=T5eD6*}P@k>*f2|SM3_Q|ql zMVvG#CSMwt$$tnOTf^!wFrqdTvM(?i30THSRtXhWeB7nQ8Y(v(b5Hcp^Kj@=U&Pst z#}-%+98-0T(ktlhc%mYJBk7iaUBmY3BMcyeH6kpzmz7d~)5x~@vEL?T9RLg#*M$SJ z(mH+(r3Hm?RV_^{3MK$q5tn{n$B8noV}nX~xz(SW#EByPJMQIY(>Q9Wx1)d>OAG?H z$}zq7-f4N5VQ46cX5})|o&X&a((i0NI;$s4XcF4>zpS1#rqQC~Pt~t{#xufzW`$;M90pqnd4@^lP6_FGXPo*{ZRh}7gzf;i za)n1B3x%&6AS!@fkk0RqldJ$BQYCrtPt9EvD(sQ)bP5=_DGVn7K<=xuTSzq?5w?G& zC_A#GrRbVCNLrpTAb!%krob|v9j623$RmJVD?WCSk25~;Iz}{Wk3&)|n5o4}351|N z!Xu`F5(>;wccJ9)P`e$!_>MjS{}u2W-BB`5KM|vVD=eE}q|bR`iG$ZJn~+@c4|#R| zL*9pzLgCLuTwD0mMBJhXmm?5E-HQ73?<5~Se?46cDS1uJDYKbsDceHmPGZ`SR8cP5 zyA4$NzN06ivcq#;azq-XY6M`&{-8hw7bA*2r9KoCrfzqE0%g7}aik24W@>O)Ae9R*x3kj_`!!#{OR3sB(4zpQPm0?X}eq}iZ z#eCG{sZ-Y~rxQhWCdozeKgNO+l!vOP>JAFMjw`kWJ!Ey@x9s79v^^j)P+EB-Y*#`P zR!Tf_%0xyMiILji2K;8!nF*679{~W!Kdy&Gs#&5rzfsx=wlCQa2y}2L2!{hOhegdmX{HE%?Jj z&vsjH@y`+{GFU1L8%FcXjS;It!>$}@$~=_>br~2ec(^F_U{MCq%|GzGT-C`4Vf8rO z*kGFC+w2BOk&qSqKnoyH43}=HP)m;n)#dBZ_bLAnMj+3uImU7p{0v(}HC{fa3LTPW z!<3q==IQFq0m6HoN7`6znmn#-zjCm832JHf6CobEVCUTR|IU$_C0CY2z2RudVqINhlXke7El`@4nBISC zcO{9fh|avP52G}ql3rFoJVXPj6r01eSw7TMuKLRt%ZsV(NefUIUYi33GNHfRwcLz!nU>H5xa z%IS>@nnLeLG0h0)n1E_*fXt-65ocd2#SFIB*CL9I91!o1OG!|`z&zvBW6eiBhWx2f z+DK4)g>tj`-??I=Zt6N*Dw2?xj|rY|VV~~=IMZ?>yLU3YShJ+QSj!Dri*rZM#rM^P z5tMGqlYs={q**yr8)DR;uj(XAfdNr2{^i;6)WsvpLH&a@I&}1tT;yYHqJdOn7wVo| z=Oc@<`(Rwt(hegDCG`YOq?@m}`{{+8y6$gZ8{v&P2Q98wXzGgvCniKD{+)l#-sZ0Fjc;NdcU zYkGja@Eg^}<^oc&J|9W6oAn|l=?;>n9i}J18sVGdj%J-QG@DSoqM)%iy%}c&>GO%L z5`>FS(>YTAHtmObIg?4Yu3Dz&@d@^79-B`8eAlu2p;W1T$jcV2&tk5O4!}-XY)>0k zL!OlW&i6N?h@D+fB7Cq_h#`W3qui)1rFzc5=zLADjM#vhMWCC;0tA4O%4XDHcxo=> zKA0@ZFY3#(O6+m}mUF<(aqMz%BUrF+`I#Un+_YZF>Y(ULS>eqEM?%5!DJEM`361mX zhk!xPL9M?%eSs7^Wx5BS;{^5=bn+@G=Pam^pfTI-i+BViv+4%;L+at27gg;5lU;is zq}2DjiN1%cZz>m+1P(tciH6Gg!3c@kkU!$&H%$s%duDE3#0f7RC6Pm-Bvc9r7Gy&p z6oGv0Wu~CdJXamxlr=z9eU{v`A1!yoyw)gx@B+*D6C~b$q02PonWqVsMyR$rY_Kd) zLNMiT#HfYw21-vKF4})>%2C&wAM#@LOd85XF9|+U)z9=;E z++3nhTW}(@b7@n8Hv3^Sp4Tuld>?VfyqB8}xrImd-ZvF%`jj`S34et-tUXp6?83jh zp(Bq(1p44Z30&NuFTBr{7C(OBFtu*MfTo8_or%PT z(ZZeZ-r!ZZP1rInOJ@q9mb&f6(eS=*)XvPe>=Y;+Gr_yx+n$SHUt}x&BFOMQvBV>D z!&@FhB+m*-zcr?ELoe`}K-R=??gDtuO_fP#;^{P( zbiH66t5sal1q*D=u`?AN`)`uv+faSd2!0fB{>;!cL=<7wWvbuD`0dO*?iD-U+t1@! z%2jb-=R04i?H(_l-HPVTFNTnB#5R&oFIJw|~kU9jN*u!*gPIAqW0Su>NK~jlRjGKFGr-T=%Rg zeGtM`-cI2c8=bhheO>~<9(OQ<23{X&7ixX+AucCj(5q+Uo-A8Y`!Lt*gF2kOrJw|Z zo`zOX=xW_IKZ;xM<|+}^c;8h_O^sB$LkvUUL(qQ?GfwFsJYqM%watLb7V<9G{`tu2 z|9s@yiZN}eV%=Yu;Y8iuu?LlYMT8=&S|OO2IS-C22|9^Tbwn8#GT7Ykj3e3Ks#?~F z9bb;4=+SLaihk1kDwWodE4rl!lPyXaS{Y@m^DHBAPdrql!fm`nS`WBULONfe2Qm#z&9e_;+C|NmnJbzPB}rc{RT@?w@c2^pHtl`THRdg5ut|Mh z=dp* zY-f~e9brU3k1;k7EQHp>7qfn=epFAm*oV`RP(_NYn8~APGgmF~1wO=<^MG&gZ;EuL}7$olr^r!3b<%>4nNNOimPWE4uK1!2HX650XPkre$jpT@zNGr7u;6V886AYvAQ(aeGvgstyPx_Wd2zcY9Jf-DP0EhslFQh}XQk!5Ij+1Q8s3 z(bLX}Zu?#7(5BVx`n)30jvQp1-99=V8;=i*8gCpSM9*Te@VnR}KL3`~^|jyNuN;*9 zdVL6WEQ6F0g+8p#fa)>sjF$)&Nt`qu)>nRWt7V==s~8MQIEks#?TDZBP>89<<%8<{ zcUOnLue{+YaQX~?Gaw9n8fo?H+Ti^v;-uq=X~k6fGK)sOlVQ#;C-9PB zpJg3vPUh*~?5aQ5(MV=I!Ko?MC?ym(S!sFp{&%%b1DS33ei=r2ZgS)~kBi(b#?dbp zzYjxsAW;N7^#Ml$LgR{JRqs5B#vN7N$Vw7DiLO0^3C8z^D{K3Y8Y=OQ#Erk^c3se% zLntFXgfdpc3f=hK+uzDz*k|=hK~kGlAG&(B=El?8mUYl^*vNa%(F;xyy-^J!u5B<&5RyUW6JWK7nz_GqxmT9e^D*o&1 zwpbUo+u@81soNz`XRva+B|y_b65qMtXtaXC%0mCbRv(F^Cu?K!&fCO$0=xY)-&FiQ zuPxFN-Kb@+vylv3h5%0mAk$=%U)Z?)pvL?;A$jeCuAKA$n}tli_JXNnca!%|XbkK^XTtjuDyHTt~wg`hlc>iO%~`c!hJiPbVk`z~(u>xIgw zRY-NIYxOosNOESTc{=ujoeG?V&NiD|HbsCUSw2o!1VD5AROP1=Y#6W);IOs{9>j8} zK*FZ~+*~CLIT~LFC>HSHq zL3B$FsZ;hN04FSKZH&9q2aqyA?kBh;P~mQ zR(ZcOuW_ebFlg#aapO3rrAqpKSu3h`HcRO@>#O9qBV6~Jz=|FOXCT)NP$zSs{wPJX zYBtJ(9=Ec(B^-t)^?aa1Yu`>!u7*ReWOfP~)6(RvzM%3x*mm1U*f0K^$RT%F$vkbr zf#`1H=oLIOuSJC7cJolHWj&=mJie-+GmS0az6GdWHQOA5S`E%lzqjOx>c@!6Zk?l6 zVrmbATbg%!JGhq5SIE%P+FHJUk6lk8+CQDwALKrrPi{9BjtZmexW#wP$q*D1%O@6k z0gxpx4J_Nc6ZyK{zc%%;snPPaOpLbVW>7KCr6p5fPQ8H!kaMkZ5@GUo>{@dlRDDV&uAw8e;OH7DKcR5mKTU zQ~0mK)F98ee_Mp0qJHfjEF8{i^Mnf`KUl5$(p??EMxoM`X1%IrtPGpo;nrvPcYG2seHJwVHJuE!Copgt2x7~}_ zJwCu&o~CY>`o3~=5Hg{W@_acTMY4-^+8VWlEKgR$LCeQ64+mEYx(QdS{~FM$ddW7<@Qp@rp}eH=jI?PP6X_O3HBetH0x; z$Mf2G5-Zw8lc6#9zC@``$$9oW{LqrP6);$SUp)|O9mLxnO>g+#@hWiHg{kN=ryLLB zL0#2HFGbOzxp{(4EvIJi`52TlSH^yDOIJYo3KW~i9o16ku#QY>rLmxjdy|iUdO;CP z+RhpLdMFo(IePJ65y?ec&RZH_5SrVPQG4t;ZckYkw(nIrPWYHB*~s(U@pnlfw44T# z9T#m=Gv6%KU3nq2e-p#JBP|dO`Kqg{p4=(Q<9x2!_w!;?VoG3)X|I6|DlJm

n`^y0EVad(Iv?+2JXk4PiJ4??alPlFFD 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 Ce8j8( literal 0 HcmV?d00001 diff --git a/changelog/2024.8.0.rst b/changelog/2024.8.0.rst new file mode 100644 index 000000000..89ad59882 --- /dev/null +++ b/changelog/2024.8.0.rst @@ -0,0 +1,269 @@ +ESPHome 2024.8.0 - 21st August 2024 +=================================== + +.. seo:: + :description: Changelog for ESPHome 2024.8.0. + :image: /_static/changelog-2024.8.0.png + :author: Jesse Hills + :author_twitter: @jesserockz + +.. imgtable:: + :columns: 3 + + LVGL Graphics, components/lvgl/index, lvgl.png + Online Image, components/online_image, image-sync-outline.svg, dark-invert + APDS9306, components/sensor/apds9306, apds9306.png + + Home Assistant Number, components/number/homeassistant, home-assistant.svg, dark-invert + Home Assistant Switch, components/switch/homeassistant, home-assistant.svg, dark-invert + BME68x via BSEC2, components/sensor/bme68x_bsec2, bme680.jpg + + M5Stack Unit 8 Angle, components/sensor/m5stack_8angle, m5stack_8angle.png + LYWSD02MMC, components/sensor/xiaomi_ble.html#lywsd02mmc, xiaomi_mijia_logo.jpg + +Light and Versitile Embedded Graphics Library +--------------------------------------------- + +Or LVGL for short, has been worked on by :ghuser:`clydebarrow` (and multiple other users doing testing and documentation etc) +for quite some time now and is finally ready for releasing this month. It is a very powerful graphics library that +is able to be configured almost completely in YAML (There are some places that will require lambdas/c++). +The :doc:`documentation ` is very extensive and hopefully we see +some awesome dashboards being made with it. + +Online Image +------------ + +The new :doc:`online_image ` component allows your ESPHome device to download +images from the internet while it is running and show them on your display. This can also be combined with the new LVGL +component to show dynamic images for your dashboard. + +Home Assistant Switch & Number +------------------------------ + +New platforms have been aded for ``switch`` and ``number`` to allow importing of state and controlling +of switches and numbers that exist in Home Assistant (or another device via Home Assistant). +This greatly simplifies controlling remote entities and will hopefully be extended to other platforms. + +Thank you for your support +-------------------------- + +We would like to thank all Home Assistant Cloud subscribers for their support. It allows `Nabu Casa `__ to +employ two developers to maintain and further develop the ESPHome project. + +Full list of changes +-------------------- + +New Features +^^^^^^^^^^^^ + +- [update] Implement ``update.perform`` action and ``update.is_available`` condition :esphomepr:`7165` by :ghuser:`jesserockz` (new-feature) + +New Components +^^^^^^^^^^^^^^ + +- Feature/m5angle8: Add support for m5angle8 input device :esphomepr:`6799` by :ghuser:`rnauber` (new-integration) +- APDS9306 Ambient Light Sensor :esphomepr:`6709` by :ghuser:`aodrenah` (new-integration) +- [lvgl] base implementation :esphomepr:`7116` by :ghuser:`clydebarrow` (new-integration) +- Add runtime online image support :esphomepr:`4710` by :ghuser:`guillempages` (new-integration) +- [bme68x_bsec2_i2c] BME68X Temperature+Pressure+Humidity+Gas Sensor via BSEC2 :esphomepr:`4585` by :ghuser:`neffs` (new-integration) +- Add support for LYWSD02MMC Xiaomi device :esphomepr:`7080` by :ghuser:`juanluss31` (new-integration) + +New Platforms +^^^^^^^^^^^^^ + +- [homeassistant] Native switch entity import and control :esphomepr:`7018` by :ghuser:`Links2004` (new-platform) +- [homeassistant] Native number entity import and control :esphomepr:`6455` by :ghuser:`landonr` (new-platform) +- Correct offset calibration :esphomepr:`7228` by :ghuser:`descipher` (new-platform) + +Breaking Changes +^^^^^^^^^^^^^^^^ + +- Remove deprecated argument parser :esphomepr:`7151` by :ghuser:`jesserockz` (breaking-change) + +All changes +^^^^^^^^^^^ + +- [wifi] Fix EAP for IDF 5.1+, add test :esphomepr:`7061` by :ghuser:`kbx81` +- jsn_sr04t component: AJ_SR04M compatibility mode in checksum calculation :esphomepr:`7044` by :ghuser:`soeffi` +- [CI] compile entire web_server during tests :esphomepr:`7084` by :ghuser:`tomaszduda23` +- [CI] Add more ``improv_serial`` tests :esphomepr:`7081` by :ghuser:`kbx81` +- Bump docker/build-push-action from 6.3.0 to 6.4.0 in /.github/actions/build-image :esphomepr:`7089` by :ghuser:`dependabot[bot]` +- [CI] add web_server v1 test :esphomepr:`7090` by :ghuser:`tomaszduda23` +- [wifi] Hostname may not be set as expected on Arduino platform :esphomepr:`7050` by :ghuser:`NewoPL` +- Add host uart support for MacOS :esphomepr:`7095` by :ghuser:`clydebarrow` +- Bump docker/build-push-action from 6.4.0 to 6.4.1 in /.github/actions/build-image :esphomepr:`7102` by :ghuser:`dependabot[bot]` +- [code-quality] Add some ruff configuration :esphomepr:`7103` by :ghuser:`jesserockz` +- [web_server] move v1 code to separate file :esphomepr:`7091` by :ghuser:`tomaszduda23` +- [validation] Add ``host`` to ``require_framework_version`` :esphomepr:`7107` by :ghuser:`jesserockz` +- [code-quality] Tidy up some duplicate CONFIG_SCHEMA assignments :esphomepr:`7106` by :ghuser:`jesserockz` +- Move MQTT ip discovery to deticated config option. :esphomepr:`6673` by :ghuser:`Links2004` +- Feature/m5angle8: Add support for m5angle8 input device :esphomepr:`6799` by :ghuser:`rnauber` (new-integration) +- use cache to build tests for compoenents :esphomepr:`7059` by :ghuser:`tomaszduda23` +- [modbus_controller] Add on_command_sent trigger :esphomepr:`7078` by :ghuser:`leejoow` +- [ili9xxx] Rework delay handling :esphomepr:`7115` by :ghuser:`clydebarrow` +- Inherit `esp32_ble_beacon` from `esp32_ble` :esphomepr:`6908` by :ghuser:`jpbede` +- APDS9306 Ambient Light Sensor :esphomepr:`6709` by :ghuser:`aodrenah` (new-integration) +- Bump docker/build-push-action from 6.4.1 to 6.5.0 in /.github/actions/build-image :esphomepr:`7119` by :ghuser:`dependabot[bot]` +- Bump docker/setup-qemu-action from 3.1.0 to 3.2.0 :esphomepr:`7120` by :ghuser:`dependabot[bot]` +- Bump docker/login-action from 3.2.0 to 3.3.0 :esphomepr:`7121` by :ghuser:`dependabot[bot]` +- Bump docker/setup-buildx-action from 3.4.0 to 3.5.0 :esphomepr:`7122` by :ghuser:`dependabot[bot]` +- [fan] fix initial FanCall to properly set speed :esphomepr:`7113` by :ghuser:`kr0ner` +- Added ruff to pre-commit hooks :esphomepr:`7124` by :ghuser:`clydebarrow` +- Update webserver local assets to 20240724-013115 :esphomepr:`7126` by :ghuser:`esphomebot` +- [http_request] Allow configure buffer size on ESP-IDF :esphomepr:`7125` by :ghuser:`dentra` +- Give more info on import errors. :esphomepr:`7128` by :ghuser:`clydebarrow` +- [lvgl] base implementation :esphomepr:`7116` by :ghuser:`clydebarrow` (new-integration) +- Bump aioesphomeapi to 24.6.2 and cryptography to 43.0.0 :esphomepr:`7131` by :ghuser:`bdraco` +- [dependabot] Group docker action bumps into single PR :esphomepr:`7133` by :ghuser:`jesserockz` +- Add ``--version`` handler to cli :esphomepr:`7150` by :ghuser:`jesserockz` +- [code-quality] Organise ethernet related imports :esphomepr:`7152` by :ghuser:`jesserockz` +- [code-quality] Organise wifi related imports :esphomepr:`7153` by :ghuser:`jesserockz` +- [code-quality] Organise core imports :esphomepr:`7149` by :ghuser:`jesserockz` +- Remove deprecated argument parser :esphomepr:`7151` by :ghuser:`jesserockz` (breaking-change) +- Move ``CONF_ON_ERROR`` to const.py :esphomepr:`7156` by :ghuser:`jesserockz` +- [code-quality] Organise esp32 imports :esphomepr:`7154` by :ghuser:`jesserockz` +- Add microAmp and milliAmp to defined units :esphomepr:`7157` by :ghuser:`FreeBear-nc` +- Bump docker/setup-buildx-action from 3.5.0 to 3.6.1 in the docker-actions group :esphomepr:`7159` by :ghuser:`dependabot[bot]` +- LVGL stage 2 :esphomepr:`7129` by :ghuser:`clydebarrow` +- [pid] Add get_min_integral() and get_max_integral() :esphomepr:`7162` by :ghuser:`FreeBear-nc` +- [code-quality] Organise bluetooth related imports :esphomepr:`7155` by :ghuser:`jesserockz` +- http_request watchdog as a component :esphomepr:`7161` by :ghuser:`oarcher` (new-integration) +- [touchscreen] Allow binary sensor to have multiple pages in config :esphomepr:`7112` by :ghuser:`jesserockz` +- [matrix_keypad] Add `pin->setup()` to rows and cols :esphomepr:`7163` by :ghuser:`AAllport` +- [update] Implement ``update.perform`` action and ``update.is_available`` condition :esphomepr:`7165` by :ghuser:`jesserockz` (new-feature) +- [lvgl] PR stage 3 :esphomepr:`7160` by :ghuser:`clydebarrow` +- [api] ``homeassistant.action`` replaces ``homeassistant.service`` :esphomepr:`7171` by :ghuser:`jesserockz` +- ade7953_spi wrong size specified in read_array call :esphomepr:`7172` by :ghuser:`SimoPk` +- Bump improv library to 1.2.4 :esphomepr:`7174` by :ghuser:`jesserockz` +- Implement 'round to nearest multiple' filter :esphomepr:`7142` by :ghuser:`MrEbbinghaus` +- git ignore managed_components :esphomepr:`7180` by :ghuser:`oarcher` +- [core] Eliminate nuisance messages from `build_codeowners` :esphomepr:`7185` by :ghuser:`clydebarrow` +- [code-quality] More portable shebangs :esphomepr:`7189` by :ghuser:`jesserockz` +- Add support for doing update entity refresh/check via API. :esphomepr:`7190` by :ghuser:`jesserockz` +- [lvgl] Stage 4 :esphomepr:`7166` by :ghuser:`clydebarrow` +- [esp32_improv] Update Improv library to reference new repo/version :esphomepr:`7195` by :ghuser:`kahrendt` +- hydreon_rgxx: Fix parsing of data line :esphomepr:`7192` by :ghuser:`domob1812` +- Remove outdated version block :esphomepr:`7177` by :ghuser:`tomaszduda23` +- [lvgl] Stage 5 :esphomepr:`7191` by :ghuser:`clydebarrow` +- socket: socket::set_sockaddr() for IPv4 addresses in IPv6 builds :esphomepr:`7196` by :ghuser:`dwmw2` +- Adds MQTT component to Alarm Control panel component :esphomepr:`7188` by :ghuser:`heythisisnate` +- [lvgl] Final stage :esphomepr:`7184` by :ghuser:`clydebarrow` (new-integration) +- Move ``CONF_BACKGROUND_COLOR`` and ``CONF_FOREGROUND_COLOR`` to const.py :esphomepr:`7202` by :ghuser:`jesserockz` +- [helpers] Set default flags of ExternalRAMAllocator to ALLOW_FAILURE :esphomepr:`7201` by :ghuser:`jesserockz` +- Add runtime online image support :esphomepr:`4710` by :ghuser:`guillempages` (new-integration) +- Update i2s_audio_speaker.cppi2s_audio/speaker: Fix fallthrough compiler warning :esphomepr:`7167` by :ghuser:`Mimoja` +- Move CONF_ITEMS/CONF_FONT/CONF_TEXT to const.py :esphomepr:`7204` by :ghuser:`jesserockz` +- [lvgl] Fix compile error when using encoder with buttons only. :esphomepr:`7203` by :ghuser:`clydebarrow` +- Revert "Add null GPIO pin " :esphomepr:`6621` by :ghuser:`jesserockz` +- [remote_transmitter] Change default carrier_frequency to valid value :esphomepr:`7176` by :ghuser:`iannisimo` +- [code-quality] Organise script imports :esphomepr:`7198` by :ghuser:`jesserockz` +- [max31856] Use cv.frequency as validator :esphomepr:`7212` by :ghuser:`jesserockz` +- [code-quality] Organise base entities imports :esphomepr:`7208` by :ghuser:`tomaszduda23` +- [spi] Remove ``SPIDelegateDummy`` :esphomepr:`7215` by :ghuser:`jesserockz` +- [code-quality] Apply ruff linting suggestions :esphomepr:`7206` by :ghuser:`tomaszduda23` +- [code-quality] Organise logger imports :esphomepr:`7205` by :ghuser:`tomaszduda23` +- [code-quality] Apply ruff linting suggestions to core :esphomepr:`7207` by :ghuser:`tomaszduda23` +- [code-quality] fix clang-tidy sprinkler :esphomepr:`7222` by :ghuser:`tomaszduda23` +- [code-quality] __attribute__((packed)) :esphomepr:`7221` by :ghuser:`tomaszduda23` +- hx711: Check for DOUT going high after a reading :esphomepr:`7214` by :ghuser:`dwmw2` +- [mqtt] Add extended device info :esphomepr:`7194` by :ghuser:`dentra` +- [code-quality] NOLINT readability-identifier-naming :esphomepr:`7220` by :ghuser:`tomaszduda23` +- [code-quality] Organise time imports :esphomepr:`7219` by :ghuser:`tomaszduda23` +- [lvgl] Fix set state on updates :esphomepr:`7227` by :ghuser:`clydebarrow` +- add missing override :esphomepr:`7231` by :ghuser:`tomaszduda23` +- Add text_align_to_string :esphomepr:`7243` by :ghuser:`MrMDavidson` +- [sml] Fixed crashing sml parser :esphomepr:`7235` by :ghuser:`eNBeWe` +- Allow project name and version as improv_serial identity :esphomepr:`7248` by :ghuser:`AzonInc` +- [lvgl] Implement default group for encoders :esphomepr:`7242` by :ghuser:`clydebarrow` +- [bme68x_bsec2_i2c] BME68X Temperature+Pressure+Humidity+Gas Sensor via BSEC2 :esphomepr:`4585` by :ghuser:`neffs` (new-integration) +- [code-quality] clang-tidy media_player :esphomepr:`7238` by :ghuser:`tomaszduda23` +- Bump docker/build-push-action from 6.5.0 to 6.6.1 in /.github/actions/build-image :esphomepr:`7232` by :ghuser:`dependabot[bot]` +- fix build error :esphomepr:`7229` by :ghuser:`tomaszduda23` +- adjust to new python pre-commit hooks :esphomepr:`7178` by :ghuser:`tomaszduda23` +- add windows script/setup.bat :esphomepr:`7140` by :ghuser:`nielsnl68` +- [code-quality] add NOLINT haier_base :esphomepr:`7236` by :ghuser:`tomaszduda23` +- [code-quality] clang-tidy bedjet :esphomepr:`7251` by :ghuser:`tomaszduda23` +- fix name conflict with zephyr macro :esphomepr:`7252` by :ghuser:`tomaszduda23` +- [code-quality] Apply ruff linting suggestions :esphomepr:`7239` by :ghuser:`tomaszduda23` +- Add support for LYWSD02MMC Xiaomi device :esphomepr:`7080` by :ghuser:`juanluss31` (new-integration) +- [code-quality] fix clang-tidy web server :esphomepr:`7230` by :ghuser:`tomaszduda23` +- [test][web_server] Rejig test for v3 :esphomepr:`7110` by :ghuser:`RFDarter` +- [api] Error log when NONE Update command is sent :esphomepr:`7247` by :ghuser:`oarcher` +- [api] Add new flag to request state/attribute once from HA only :esphomepr:`7258` by :ghuser:`jesserockz` +- [homeassistant] Add ``HOME_ASSISTANT_IMPORT_CONTROL_SCHEMA`` :esphomepr:`7259` by :ghuser:`jesserockz` +- [const] Add some units for future use and adjust case :esphomepr:`7260` by :ghuser:`nkinnan` +- [online_image] add option to show placeholder while downloading :esphomepr:`7083` by :ghuser:`guillempages` +- [lvgl] Add initial_focus for encoders :esphomepr:`7256` by :ghuser:`clydebarrow` +- [code-quality] fix order in esphome/const.py :esphomepr:`7267` by :ghuser:`tomaszduda23` +- [code-quality] fix clang-tidy network :esphomepr:`7266` by :ghuser:`tomaszduda23` +- [code-quality] fix clang-tidy core optional :esphomepr:`7265` by :ghuser:`tomaszduda23` +- [code-quality] Fix variable naming in base_light_effects :esphomepr:`7237` by :ghuser:`tomaszduda23` +- [code-quality] fix clang-tidy mqtt :esphomepr:`7253` by :ghuser:`tomaszduda23` +- [code-quality] fix clang-tidy wifi related :esphomepr:`7254` by :ghuser:`tomaszduda23` +- Bump docker/build-push-action from 6.6.1 to 6.7.0 in /.github/actions/build-image :esphomepr:`7269` by :ghuser:`dependabot[bot]` +- [CI] Dont run full CI on ``build-image`` action changes :esphomepr:`7270` by :ghuser:`jesserockz` +- Implement ByteBuffer :esphomepr:`6878` by :ghuser:`clydebarrow` +- Add min and max brightness parameters for Light dim_relative Action :esphomepr:`6971` by :ghuser:`PaoloTK` +- [homeassistant] Native switch entity import and control :esphomepr:`7018` by :ghuser:`Links2004` (new-platform) +- [homeassistant] Native number entity import and control :esphomepr:`6455` by :ghuser:`landonr` (new-integration) +- [lvgl] Rework events to avoid feedback loops :esphomepr:`7262` by :ghuser:`clydebarrow` +- Add `color_filter_opa` style property :esphomepr:`7276` by :ghuser:`clydebarrow` +- [code-quality] fix clang-tidy wake_on_lan :esphomepr:`7275` by :ghuser:`tomaszduda23` +- [code-quality] fix readability-braces-around-statements :esphomepr:`7273` by :ghuser:`tomaszduda23` +- [mqtt] fix missing initializer in MQTTClientComponent::disable_discovery :esphomepr:`7271` by :ghuser:`oarcher` +- [code-quality] fix readability-named-parameter :esphomepr:`7272` by :ghuser:`tomaszduda23` +- support illuminance for airthings wave plus device :esphomepr:`5203` by :ghuser:`MadMonkey87` +- [micro_wake_word] Bump ESPMicroSpeechFeatures version to 1.1.0 :esphomepr:`7249` by :ghuser:`kahrendt` +- Implement the finish() method and action. implement the is_stopped condition :esphomepr:`7255` by :ghuser:`nielsnl68` +- Correct offset calibration :esphomepr:`7228` by :ghuser:`descipher` (new-integration) + +Past Changelogs +--------------- + +- :doc:`2024.7.0` +- :doc:`2024.6.0` +- :doc:`2024.5.0` +- :doc:`2024.4.0` +- :doc:`2024.3.0` +- :doc:`2024.2.0` +- :doc:`2023.12.0` +- :doc:`2023.11.0` +- :doc:`2023.10.0` +- :doc:`2023.9.0` +- :doc:`2023.8.0` +- :doc:`2023.7.0` +- :doc:`2023.6.0` +- :doc:`2023.5.0` +- :doc:`2023.4.0` +- :doc:`2023.3.0` +- :doc:`2023.2.0` +- :doc:`2022.12.0` +- :doc:`2022.11.0` +- :doc:`2022.10.0` +- :doc:`2022.9.0` +- :doc:`2022.8.0` +- :doc:`2022.6.0` +- :doc:`2022.5.0` +- :doc:`2022.4.0` +- :doc:`2022.3.0` +- :doc:`2022.2.0` +- :doc:`2022.1.0` +- :doc:`2021.12.0` +- :doc:`2021.11.0` +- :doc:`2021.10.0` +- :doc:`2021.9.0` +- :doc:`2021.8.0` +- :doc:`v1.20.0` +- :doc:`v1.19.0` +- :doc:`v1.18.0` +- :doc:`v1.17.0` +- :doc:`v1.16.0` +- :doc:`v1.15.0` +- :doc:`v1.14.0` +- :doc:`v1.13.0` +- :doc:`v1.12.0` +- :doc:`v1.11.0` +- :doc:`v1.10.0` +- :doc:`v1.9.0` +- :doc:`v1.8.0` +- :doc:`v1.7.0` diff --git a/changelog/index.rst b/changelog/index.rst index a6600f938..0d8b24982 100644 --- a/changelog/index.rst +++ b/changelog/index.rst @@ -2,7 +2,7 @@ Changelog ========= .. redirect:: - :url: /changelog/2024.7.0.html + :url: /changelog/2024.8.0.html .. toctree:: :glob: From 80e0a1e962e6e6a06e66e38b960c347ef5babcbd Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 14 Aug 2024 17:27:37 +1200 Subject: [PATCH 38/53] Update supporters for 2024.8.0b1 --- guides/supporters.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/guides/supporters.rst b/guides/supporters.rst index 92c41703f..1968e5a33 100644 --- a/guides/supporters.rst +++ b/guides/supporters.rst @@ -224,6 +224,7 @@ Contributors - `bleeisme (@bleeisme) `__ - `Jim Ekman (@blejdfist) `__ - `blindguynar (@blindguynar) `__ +- `BlueSkyB (@BlueSkyB) `__ - `Scott Smith (@blurfl) `__ - `Bruno Medici (@bmedici) `__ - `Bob (@Bmooij) `__ @@ -512,6 +513,7 @@ Contributors - `Jannick (@DutchDeffy) `__ - `David van der Leij (@dvanderleij) `__ - `dwildstr (@dwildstr) `__ +- `David Woodhouse (@dwmw2) `__ - `dxta1986 (@dxta1986) `__ - `dyarkovoy (@dyarkovoy) `__ - `Janez Troha (@dz0ny) `__ @@ -619,6 +621,7 @@ Contributors - `Fabio Pugliese Ornellas (@fornellas) `__ - `SmartShackMaster (@fototakas) `__ - `foxsam21 (@foxsam21) `__ +- `ESP32andmore (@fpovoski) `__ - `Fractal147 (@Fractal147) `__ - `Francis-labo (@Francis-labo) `__ - `Francisk0 (@Francisk0) `__ @@ -914,6 +917,7 @@ Contributors - `jsuanet (@jsuanet) `__ - `James Szalay (@jtszalay) `__ - `Jules-R (@Jules-R) `__ +- `Julian Stremel (@JulianStremel) `__ - `Julie Koubová (@juliekoubova) `__ - `junkie1969 (@junkie1969) `__ - `junnikokuki (@junnikokuki) `__ @@ -1218,6 +1222,7 @@ Contributors - `Chris Laplante (@mostthingsweb) `__ - `Matthew Pettitt (@mpettitt) `__ - `Michael P. Flaga (@mpflaga) `__ +- `Björn Ebbinghaus (@MrEbbinghaus) `__ - `Sam Hughes (@MrEditor97) `__ - `MrEditor97 (@mreditor97) `__ - `MRemy2 (@MRemy2) `__ @@ -1335,6 +1340,7 @@ Contributors - `ogatatsu (@ogatatsu) `__ - `Oğuzhan Başer (@oguzhanbaser) `__ - `Larry (@ojaksch) `__ +- `ojwc (@ojwc) `__ - `OkhammahkO (@OkhammahkO) `__ - `Oleg Tarasov (@olegtarasov) `__ - `Oliver Hihn (@oliverhihn) `__ @@ -1730,6 +1736,7 @@ Contributors - `Alan Lord (@theopensourcerer) `__ - `Simon (@theOzzieRat) `__ - `Brian Levinsen (@therealeldaria) `__ +- `thevogoncoder (@thevogoncoder) `__ - `Steve Scott (@thewishy) `__ - `Zachery Notz (@TheZackCodec) `__ - `Florian Gareis (@TheZoker) `__ @@ -1924,4 +1931,4 @@ Contributors - `Christian Zufferey (@zuzu59) `__ - `Zynth-dev (@Zynth-dev) `__ -*This page was last updated August 1, 2024.* +*This page was last updated August 14, 2024.* From e705457b4ac3825b0725f3e755bc86b5c5fbf066 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 14 Aug 2024 19:07:25 +1200 Subject: [PATCH 39/53] Fix links --- changelog/2024.8.0.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/changelog/2024.8.0.rst b/changelog/2024.8.0.rst index 89ad59882..6ea1e7d88 100644 --- a/changelog/2024.8.0.rst +++ b/changelog/2024.8.0.rst @@ -27,13 +27,13 @@ Light and Versitile Embedded Graphics Library Or LVGL for short, has been worked on by :ghuser:`clydebarrow` (and multiple other users doing testing and documentation etc) for quite some time now and is finally ready for releasing this month. It is a very powerful graphics library that is able to be configured almost completely in YAML (There are some places that will require lambdas/c++). -The :doc:`documentation ` is very extensive and hopefully we see +The :doc:`documentation ` is very extensive and hopefully we see some awesome dashboards being made with it. Online Image ------------ -The new :doc:`online_image ` component allows your ESPHome device to download +The new :doc:`online_image ` component allows your ESPHome device to download images from the internet while it is running and show them on your display. This can also be combined with the new LVGL component to show dynamic images for your dashboard. From 18f78de8dc9a1ae9035c173d58058bfe0edb30df Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Fri, 16 Aug 2024 13:38:07 +1200 Subject: [PATCH 40/53] Bump version to 2024.8.0b2 --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Doxygen b/Doxygen index 00714ae6f..a4725cdd3 100644 --- a/Doxygen +++ b/Doxygen @@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome" # could be handy for archiving the generated documentation or if some version # control system is used. -PROJECT_NUMBER = 2024.8.0b1 +PROJECT_NUMBER = 2024.8.0b2 # Using the PROJECT_BRIEF tag one can provide an optional one line description # for a project that appears at the top of each page and should give viewer a diff --git a/Makefile b/Makefile index be8260b94..be4f7b2b4 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ ESPHOME_PATH = ../esphome -ESPHOME_REF = 2024.8.0b1 +ESPHOME_REF = 2024.8.0b2 PAGEFIND_VERSION=1.1.0 PAGEFIND=pagefind NET_PAGEFIND=../pagefindbin/pagefind diff --git a/_static/version b/_static/version index 84b6e8968..7d221d472 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2024.8.0b1 \ No newline at end of file +2024.8.0b2 \ No newline at end of file diff --git a/conf.py b/conf.py index 6b16299ac..daa38bdfc 100644 --- a/conf.py +++ b/conf.py @@ -69,7 +69,7 @@ author = "ESPHome" # The short X.Y version. version = "2024.8" # The full version, including alpha/beta/rc tags. -release = "2024.8.0b1" +release = "2024.8.0b2" # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. From e2c043337733f73fcf1300a6bf7012df1e900064 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Fri, 16 Aug 2024 13:41:07 +1200 Subject: [PATCH 41/53] Update changelog for 2024.8.0b2 --- changelog/2024.8.0.rst | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/changelog/2024.8.0.rst b/changelog/2024.8.0.rst index 6ea1e7d88..c7dd2aa93 100644 --- a/changelog/2024.8.0.rst +++ b/changelog/2024.8.0.rst @@ -40,7 +40,7 @@ component to show dynamic images for your dashboard. Home Assistant Switch & Number ------------------------------ -New platforms have been aded for ``switch`` and ``number`` to allow importing of state and controlling +New platforms have been added for ``switch`` and ``number`` to allow importing of state and controlling of switches and numbers that exist in Home Assistant (or another device via Home Assistant). This greatly simplifies controlling remote entities and will hopefully be extended to other platforms. @@ -80,6 +80,16 @@ Breaking Changes - Remove deprecated argument parser :esphomepr:`7151` by :ghuser:`jesserockz` (breaking-change) +Beta Changes +^^^^^^^^^^^^ + +- remove extra number from pronto :esphomepr:`7263` by :ghuser:`ssieb` +- [api] Bump noise-c library version :esphomepr:`7288` by :ghuser:`clydebarrow` +- fix some small rtttl issues :esphomepr:`6817` by :ghuser:`nielsnl68` +- Fix overflow in ESPColorCorrection object :esphomepr:`7268` by :ghuser:`g-kiss` +- [validation] Allow ``maybe_simple_value`` to not have default key in complex value :esphomepr:`7294` by :ghuser:`jesserockz` +- [network] Always allow ``enable_ipv6: false`` :esphomepr:`7291` by :ghuser:`dwmw2` + All changes ^^^^^^^^^^^ @@ -216,6 +226,12 @@ All changes - [micro_wake_word] Bump ESPMicroSpeechFeatures version to 1.1.0 :esphomepr:`7249` by :ghuser:`kahrendt` - Implement the finish() method and action. implement the is_stopped condition :esphomepr:`7255` by :ghuser:`nielsnl68` - Correct offset calibration :esphomepr:`7228` by :ghuser:`descipher` (new-integration) +- remove extra number from pronto :esphomepr:`7263` by :ghuser:`ssieb` +- [api] Bump noise-c library version :esphomepr:`7288` by :ghuser:`clydebarrow` +- fix some small rtttl issues :esphomepr:`6817` by :ghuser:`nielsnl68` +- Fix overflow in ESPColorCorrection object :esphomepr:`7268` by :ghuser:`g-kiss` +- [validation] Allow ``maybe_simple_value`` to not have default key in complex value :esphomepr:`7294` by :ghuser:`jesserockz` +- [network] Always allow ``enable_ipv6: false`` :esphomepr:`7291` by :ghuser:`dwmw2` Past Changelogs --------------- From c1e554c28d672c5de1232ce257389535bcf98d16 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Fri, 16 Aug 2024 13:41:50 +1200 Subject: [PATCH 42/53] Update supporters for 2024.8.0b2 --- guides/supporters.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/supporters.rst b/guides/supporters.rst index 1968e5a33..a223be7c8 100644 --- a/guides/supporters.rst +++ b/guides/supporters.rst @@ -1931,4 +1931,4 @@ Contributors - `Christian Zufferey (@zuzu59) `__ - `Zynth-dev (@Zynth-dev) `__ -*This page was last updated August 14, 2024.* +*This page was last updated August 16, 2024.* From b93fcb3155dc22e82db6872ab690e45c4ed0a2b9 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Sat, 17 Aug 2024 07:38:54 +1200 Subject: [PATCH 43/53] Typo --- changelog/2024.8.0.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/changelog/2024.8.0.rst b/changelog/2024.8.0.rst index c7dd2aa93..1d12bc7d9 100644 --- a/changelog/2024.8.0.rst +++ b/changelog/2024.8.0.rst @@ -21,7 +21,7 @@ ESPHome 2024.8.0 - 21st August 2024 M5Stack Unit 8 Angle, components/sensor/m5stack_8angle, m5stack_8angle.png LYWSD02MMC, components/sensor/xiaomi_ble.html#lywsd02mmc, xiaomi_mijia_logo.jpg -Light and Versitile Embedded Graphics Library +Light and Versatile Embedded Graphics Library --------------------------------------------- Or LVGL for short, has been worked on by :ghuser:`clydebarrow` (and multiple other users doing testing and documentation etc) From 2a7058b529b68fcad3c30a2f7acfcb809687b6a9 Mon Sep 17 00:00:00 2001 From: Clyde Stubbs <2366188+clydebarrow@users.noreply.github.com> Date: Mon, 19 Aug 2024 08:44:29 +1000 Subject: [PATCH 44/53] [lvgl] Update layout docs (#4165) --- components/lvgl/index.rst | 37 ++++++++++++++- components/lvgl/widgets.rst | 91 ++++++++++++++++++++++++++++++------- 2 files changed, 110 insertions(+), 18 deletions(-) diff --git a/components/lvgl/index.rst b/components/lvgl/index.rst index 50648ea8a..16b903a30 100644 --- a/components/lvgl/index.rst +++ b/components/lvgl/index.rst @@ -436,11 +436,27 @@ It can arrange items into rows or columns (tracks), handle wrapping, adjust spac - **pad_row** (*Optional*, int16): Set the padding between the rows, in pixels. - **pad_column** (*Optional*, int16): Set the padding between the columns, in pixels. - - **flex_grow** (*Optional*, int16): Flex grow can be used to make one or more children fill the available space on the track. When more children have grow parameters, the available space will be distributed proportionally to the grow values. Defaults to ``0``, which disables growing. + - **flex_grow** (*Optional*, int16): Can be used to make one or more children fill the available space on the track. When one or more children have ``flex_grow`` set, the available space will be distributed proportionally to the grow values. Defaults to ``0``, which disables growing. + +.. code-block:: yaml + + # Example flex layout + + - obj: + layout: + type: flex + pad_row: 4 + pad_column: 4px + flex_align_main: center + flex_align_cross: start + flex_align_track: end + widgets: + - animimg: + flex_grow: 1 **Grid** -The Grid layout in LVGL is a subset implementation of `CSS Flexbox `__. +The Grid layout in LVGL is a subset implementation of `CSS Grid `__. It can arrange items into a 2D "table" that has rows or columns (tracks). The item(s) can span through multiple columns or rows. The track's size can be set in pixels, to the largest item of the track (``CONTENT``) or in "free units" to distribute the free space proportionally. @@ -482,6 +498,23 @@ Values for use with ``grid_column_align``, ``grid_row_align``, ``grid_cell_x_ali - ``SPACE_AROUND``: items are evenly distributed in the track with equal space around them. Note that visually the spaces aren’t equal, since all the items have equal space on both sides. The first item will have one unit of space against the container edge, but two units of space between the next item because that next item has its own spacing that applies. - ``SPACE_BETWEEN``: items are evenly distributed in the track: first item is on the start line, last item on the end line. +.. code-block:: yaml + + # Example grid layout + + - obj: + layout: + type: grid + grid_row_align: end + grid_rows: [25px, fr(1), content] + grid_columns: [40, fr(1), fr(1)] + pad_row: 6px + pad_column: 0 + widgets: + - image: + grid_cell_row_pos: 0 + grid_cell_column_pos: 0 + .. tip:: To visualize real, calculated sizes of transparent widgets you can temporarily set ``outline_width: 1`` on them. diff --git a/components/lvgl/widgets.rst b/components/lvgl/widgets.rst index 1700ee2b3..ea9ac7ee8 100644 --- a/components/lvgl/widgets.rst +++ b/components/lvgl/widgets.rst @@ -116,6 +116,67 @@ In addition to visual styling, each widget supports some boolean **flags** to in LVGL only supports **integers** for numeric ``value``. Visualizer widgets can't display floats directly, but they allow scaling by 10s. +Widget-specific properties +-------------------------- + +Some widgets have properties that are specific to that widget. For example ``label`` has a ``text`` property. The properties +specific to a widget are described in each section below. Some of these properties may also be updated with a corresponding +``lvgl..update`` action, e.g. ``lvgl.label.update`` allows updating not only the common style properties, +but also the ``text`` property of a label. + + +.. _text-property: + +Text property +------------- + +Several widgets have a ``text`` property, and the possible ways this can be specified are common to all ``text`` properties. +The text may be a Unicode string or other constant convertible to a string; if the string is enclosed in double quotes ``""`` then +standard escape sequences sucn as newline ``\n`` and Unicode codepoints will be translated. +The text value may also be a lambda returning a ``std::string`` or may be +specified with a ``format`` property utilising ``printf`` style formatting. There is also a ``time_format`` option +which allows use of `strftime `_ formats. + + +**Examples:** + +.. code-block:: yaml + + # Example label + - label: + id: label_id + text: "Text string" + - checkbox: + id: checkbox_id + text: "\uF00C" # Unicode check-mark + + + on_...: + - lvgl.label.update: + id: label_id + text: + format: "%d bells, %d things" + args: [x, 10] # x is a value from the enclosing trigger. + - lvgl.label.update: + id: label_id + text: !lambda return id(text_sensor).state; + - lvgl.label.update: + id: label_id + text: + time_format: "%c" # uses default time component + - lvgl.checkbox.update: + id: checkbox_id + text: + time_format: "%c" + time: sntp_id + - lvgl.label.update: + id: label_id + text: + time_format: "%c" + time: !lambda return id(sntp_id).utcnow(); + + + .. _lvgl-widget-animimg: ``animimg`` @@ -388,7 +449,7 @@ The button matrix widget is a lightweight way to display multiple buttons in row - **id** (*Optional*): An ID for the button in the matrix. - **key_code** (*Optional*, string): One character be sent as the key code to a :ref:`key_collector` instead of ``text`` when the button is pressed. - **selected** (*Optional*, boolean): Set the button as the most recently released or focused. Defaults to ``false``. - - **text** (*Optional*): Text (or built-in :ref:`symbol ` codepoint) to display on the button. + - **text** (*Optional*, :ref:`text-property`): Text to display on the button. - **width** (*Optional*): Width relative to the other buttons in the same row. Must be a value between ``1`` and ``15``; the default is ``1`` (for example, given a line with two buttons, one with ``width: 1`` and another one with ``width: 2``, the first will be ``33%`` wide while the second will be ``66%`` wide). - **control** (*Optional*): Binary flags to control behavior of the buttons (all ``false`` by default): - **checkable** (*Optional*, boolean): Enable toggling of a button, ``checked`` state will be added/removed as the button is clicked. @@ -522,9 +583,7 @@ The checkbox widget is made internally from a *tick box* and a label. When the c - ``lvgl.checkbox.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. - **id** (**Required**): The ID or a list of IDs of checkbox widgets which you want update. - - **text** (**Required**, :ref:`templatable `, string): The ``text`` option in this action can contain static text, a :ref:`lambda ` outputting a string or can be formatted using ``printf``-style formatting (see :ref:`display-printf`). - - **format** (*Optional*, string): The format for the message in :ref:`printf-style `. - - **args** (*Optional*, list of :ref:`lambda `): The optional arguments for the format message. + - **text** (*Optional*, :ref:`text-property`): Text to display beside the checkbox. - Widget styles or properties from the specific options above, which you want update. **Triggers:** @@ -799,7 +858,7 @@ A label is the basic widget type that is used to display text. - **text_letter_space** (*Optional*, int16): Extra character spacing of the text. Inherited from parent. Defaults to ``0``. - **text_line_space** (*Optional*, int16): Line spacing of the text. Inherited from parent. Defaults to ``0``. - **text_opa** (*Optional*, :ref:`opacity `): Opacity of the text. Inherited from parent. Defaults to ``COVER``. -- **text** (**Required**, string): The text (or built-in :ref:`symbol ` codepoint) to display. To display an empty label, specify ``""``. +- **text** (*Optional*, :ref:`text-property`): Text to display on the label. - Style options from :ref:`lvgl-styling`. Uses all the typical background properties and the text properties. The padding values can be used to add space between the text and the background. .. note:: @@ -810,9 +869,7 @@ A label is the basic widget type that is used to display text. - ``lvgl.label.update`` :ref:`action ` updates the widget styles and properties from the specific options above, just like the :ref:`lvgl.widget.update ` action is used for the common styles, states or flags. - **id** (**Required**): The ID or a list of IDs of label widgets which you want update. - - **text** (**Required**, :ref:`templatable `, string): The ``text`` option in this action can contain static text, a :ref:`lambda ` outputting a string or can be formatted using ``printf``-style formatting (see :ref:`display-printf`). - - **format** (*Optional*, string): The format for the message in :ref:`printf-style `. - - **args** (*Optional*, list of :ref:`lambda `): The optional arguments for the format message. + - **text** (*Optional*, :ref:`text-property`): Text to display on the button. - Widget styles or properties from the specific options above, which you want update. **Triggers:** @@ -1060,13 +1117,14 @@ The text will be broken into multiple lines automatically and the height will be **Configuration variables:** - **msgboxes** (*Optional*, dict): A list of message boxes to use. This option has to be added to the top level of the LVGL component configuration. - - **body** (**Required**, dict): The content of the body of the message box: - - **text** (**Required**, string): The string to be displayed in the body of the message box. Can be shorthanded if no further options are specified. - - Style options from :ref:`lvgl-styling`. Uses all the typical background properties and the text properties. - - **buttons** (**Required**, dict): A list of buttons to show at the bottom of the message box: - - **text** (**Required**, string): The text (or built-in :ref:`symbol ` codepoint) to display on the button. - - **close_button** (**Required**, boolean): Controls the appearance of the close button to the top right of the message box. - **title** (**Required**, string): A string to display at the top of the message box. + - **body** (*Optional*, dict): The content of the body of the message box: + - **text** (*Optional*, :ref:`text-property`): The text to display in the body of the message box. + - Style options from :ref:`lvgl-styling`. Uses all the typical background properties and the text properties. + - **buttons** (*Optional*, list): A list of buttons to show at the bottom of the message box: + - **text** (*Optional*, :ref:`text-property`): Text to display on the button. + - See :ref:`lvgl-widget-buttonmatrix` for other options for the buttons. + - **close_button** (*Optional*, boolean): Controls the appearance of the close button to the top right of the message box. **Actions:** @@ -1527,14 +1585,15 @@ The textarea is an extended label widget which displays a cursor and allows the - **max_length** (*Optional*, int): Limit the maximum number of characters to this value. - **one_line** (*Optional*, boolean): The text area can be limited to only allow a single line of text. In this case the height will set automatically to fit only one line, line break characters will be ignored, and word wrap will be disabled. - **password_mode** (*Optional*, boolean): The text area supports password mode. By default, if the ``•`` (bullet, ``0x2022``) glyph exists in the font, the entered characters are converted to it after some time or when a new character is entered. If ``•`` is missing from the font, ``*`` (asterisk) will be used. -- **placeholder_text** (*Optional*, string): A placeholder text can be specified, which is displayed when the Text area is empty. +- **text** (*Optional*, :ref:`text-property`): Initial contents of the textarea. +- **placeholder_text** (*Optional*, :ref:`text-property`): A placeholder text can be specified, which is displayed when the Text area is empty. - any :ref:`Styling ` and state-based option for the background of the textarea. Uses all the typical background style properties and the text/label related style properties for the text. **Actions:** - ``lvgl.textarea.update`` :ref:`action ` updates the widget's ``text`` property, to replace the entire text content. - **id** (**Required**): The ID or a list of IDs of textarea widgets which you want update. - - **text** (**Required**): The new text content to be displayed. + - **text** (*Optional*, :ref:`text-property`): The text to replace the textarea content. **Triggers:** From fe6599622630b8269a93c069e3790f5a8af46189 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Mon, 19 Aug 2024 13:10:02 +1200 Subject: [PATCH 45/53] Bump version to 2024.8.0b3 --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Doxygen b/Doxygen index a4725cdd3..b0e09e989 100644 --- a/Doxygen +++ b/Doxygen @@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome" # could be handy for archiving the generated documentation or if some version # control system is used. -PROJECT_NUMBER = 2024.8.0b2 +PROJECT_NUMBER = 2024.8.0b3 # Using the PROJECT_BRIEF tag one can provide an optional one line description # for a project that appears at the top of each page and should give viewer a diff --git a/Makefile b/Makefile index be4f7b2b4..fb12d0f37 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ ESPHOME_PATH = ../esphome -ESPHOME_REF = 2024.8.0b2 +ESPHOME_REF = 2024.8.0b3 PAGEFIND_VERSION=1.1.0 PAGEFIND=pagefind NET_PAGEFIND=../pagefindbin/pagefind diff --git a/_static/version b/_static/version index 7d221d472..f01e7962f 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2024.8.0b2 \ No newline at end of file +2024.8.0b3 \ No newline at end of file diff --git a/conf.py b/conf.py index daa38bdfc..83d7e1398 100644 --- a/conf.py +++ b/conf.py @@ -69,7 +69,7 @@ author = "ESPHome" # The short X.Y version. version = "2024.8" # The full version, including alpha/beta/rc tags. -release = "2024.8.0b2" +release = "2024.8.0b3" # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. From 0a9cf37b06524e7aec5ac4f0710dde4b28f57b1a Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Mon, 19 Aug 2024 13:14:16 +1200 Subject: [PATCH 46/53] Update changelog for 2024.8.0b3 --- changelog/2024.8.0.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/changelog/2024.8.0.rst b/changelog/2024.8.0.rst index 1d12bc7d9..0074908ca 100644 --- a/changelog/2024.8.0.rst +++ b/changelog/2024.8.0.rst @@ -33,7 +33,7 @@ some awesome dashboards being made with it. Online Image ------------ -The new :doc:`online_image ` component allows your ESPHome device to download +:ghuser:`guillempages` created a new :doc:`online_image ` component that allows your ESPHome device to download images from the internet while it is running and show them on your display. This can also be combined with the new LVGL component to show dynamic images for your dashboard. @@ -89,6 +89,10 @@ Beta Changes - Fix overflow in ESPColorCorrection object :esphomepr:`7268` by :ghuser:`g-kiss` - [validation] Allow ``maybe_simple_value`` to not have default key in complex value :esphomepr:`7294` by :ghuser:`jesserockz` - [network] Always allow ``enable_ipv6: false`` :esphomepr:`7291` by :ghuser:`dwmw2` +- Revert "[validation] Allow ``maybe_simple_value`` to not have default key in complex value" :esphomepr:`7305` by :ghuser:`jesserockz` +- [lvgl] Bug fixes :esphomepr:`7300` by :ghuser:`clydebarrow` +- [speaker] Fix header includes :esphomepr:`7304` by :ghuser:`nielsnl68` +- [microphone] Fix header includes :esphomepr:`7310` by :ghuser:`jesserockz` All changes ^^^^^^^^^^^ @@ -232,6 +236,10 @@ All changes - Fix overflow in ESPColorCorrection object :esphomepr:`7268` by :ghuser:`g-kiss` - [validation] Allow ``maybe_simple_value`` to not have default key in complex value :esphomepr:`7294` by :ghuser:`jesserockz` - [network] Always allow ``enable_ipv6: false`` :esphomepr:`7291` by :ghuser:`dwmw2` +- Revert "[validation] Allow ``maybe_simple_value`` to not have default key in complex value" :esphomepr:`7305` by :ghuser:`jesserockz` +- [lvgl] Bug fixes :esphomepr:`7300` by :ghuser:`clydebarrow` +- [speaker] Fix header includes :esphomepr:`7304` by :ghuser:`nielsnl68` +- [microphone] Fix header includes :esphomepr:`7310` by :ghuser:`jesserockz` Past Changelogs --------------- From 6e16a6ad95f43ce0c98032e2f336abac52d372e9 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Mon, 19 Aug 2024 13:15:00 +1200 Subject: [PATCH 47/53] Update supporters for 2024.8.0b3 --- guides/supporters.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/guides/supporters.rst b/guides/supporters.rst index a223be7c8..b43153024 100644 --- a/guides/supporters.rst +++ b/guides/supporters.rst @@ -643,6 +643,7 @@ Contributors - `frspp (@frspp) `__ - `Florian Trück (@ftrueck) `__ - `functionpointer (@functionpointer) `__ +- `Gábor Kiss (@g-kiss) `__ - `mr G1K (@G1K) `__ - `Aljaž Srebrnič (@g5pw) `__ - `Alex Hermann (@gaaf) `__ @@ -1931,4 +1932,4 @@ Contributors - `Christian Zufferey (@zuzu59) `__ - `Zynth-dev (@Zynth-dev) `__ -*This page was last updated August 16, 2024.* +*This page was last updated August 19, 2024.* From 8f6e39b20ed9bf86b527d8bc3031ee90027f64ed Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 21 Aug 2024 11:46:58 +1200 Subject: [PATCH 48/53] Bump version to 2024.8.0b4 --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Doxygen b/Doxygen index b0e09e989..c3e425798 100644 --- a/Doxygen +++ b/Doxygen @@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome" # could be handy for archiving the generated documentation or if some version # control system is used. -PROJECT_NUMBER = 2024.8.0b3 +PROJECT_NUMBER = 2024.8.0b4 # Using the PROJECT_BRIEF tag one can provide an optional one line description # for a project that appears at the top of each page and should give viewer a diff --git a/Makefile b/Makefile index fb12d0f37..699f6d6e2 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ ESPHOME_PATH = ../esphome -ESPHOME_REF = 2024.8.0b3 +ESPHOME_REF = 2024.8.0b4 PAGEFIND_VERSION=1.1.0 PAGEFIND=pagefind NET_PAGEFIND=../pagefindbin/pagefind diff --git a/_static/version b/_static/version index f01e7962f..8e05c9fe2 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2024.8.0b3 \ No newline at end of file +2024.8.0b4 \ No newline at end of file diff --git a/conf.py b/conf.py index 83d7e1398..c9f45bbd4 100644 --- a/conf.py +++ b/conf.py @@ -69,7 +69,7 @@ author = "ESPHome" # The short X.Y version. version = "2024.8" # The full version, including alpha/beta/rc tags. -release = "2024.8.0b3" +release = "2024.8.0b4" # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. From 72b9272bcf6e71c059d7ef9b7e39c0ef7d1973d6 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 21 Aug 2024 11:51:25 +1200 Subject: [PATCH 49/53] Update changelog for 2024.8.0b4 --- changelog/2024.8.0.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/changelog/2024.8.0.rst b/changelog/2024.8.0.rst index 0074908ca..8412a041c 100644 --- a/changelog/2024.8.0.rst +++ b/changelog/2024.8.0.rst @@ -93,6 +93,10 @@ Beta Changes - [lvgl] Bug fixes :esphomepr:`7300` by :ghuser:`clydebarrow` - [speaker] Fix header includes :esphomepr:`7304` by :ghuser:`nielsnl68` - [microphone] Fix header includes :esphomepr:`7310` by :ghuser:`jesserockz` +- Fix RP2040 Neopixel flickering issue :esphomepr:`7307` by :ghuser:`deCodeIt` +- add the ability to add more idf components to an existing setup :esphomepr:`7302` by :ghuser:`nielsnl68` +- Fix waveshare 2.13" epaper stride calculation error :esphomepr:`7303` by :ghuser:`serialx` +- [rtttl] fix STOPPED state :esphomepr:`7323` by :ghuser:`NewoPL` All changes ^^^^^^^^^^^ @@ -240,6 +244,10 @@ All changes - [lvgl] Bug fixes :esphomepr:`7300` by :ghuser:`clydebarrow` - [speaker] Fix header includes :esphomepr:`7304` by :ghuser:`nielsnl68` - [microphone] Fix header includes :esphomepr:`7310` by :ghuser:`jesserockz` +- Fix RP2040 Neopixel flickering issue :esphomepr:`7307` by :ghuser:`deCodeIt` +- add the ability to add more idf components to an existing setup :esphomepr:`7302` by :ghuser:`nielsnl68` +- Fix waveshare 2.13" epaper stride calculation error :esphomepr:`7303` by :ghuser:`serialx` +- [rtttl] fix STOPPED state :esphomepr:`7323` by :ghuser:`NewoPL` Past Changelogs --------------- From 69ee164bf73a16c8d155a666bbc94fd40ed55e19 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 21 Aug 2024 11:52:09 +1200 Subject: [PATCH 50/53] Update supporters for 2024.8.0b4 --- guides/supporters.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/guides/supporters.rst b/guides/supporters.rst index b43153024..6e435ec6d 100644 --- a/guides/supporters.rst +++ b/guides/supporters.rst @@ -429,6 +429,7 @@ Contributors - `DeadEnd (@DeadEnded) `__ - `Debashish Sahu (@debsahu) `__ - `declanshanaghy (@declanshanaghy) `__ +- `Ali Jafri (@deCodeIt) `__ - `Maximilian (@DeerMaximum) `__ - `definitio (@definitio) `__ - `deftdawg (@deftdawg) `__ @@ -1932,4 +1933,4 @@ Contributors - `Christian Zufferey (@zuzu59) `__ - `Zynth-dev (@Zynth-dev) `__ -*This page was last updated August 19, 2024.* +*This page was last updated August 21, 2024.* From f96cce839a35d9563fa5dcb712c261a89416d137 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 21 Aug 2024 14:20:30 +1200 Subject: [PATCH 51/53] Bump version to 2024.8.0 --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Doxygen b/Doxygen index c3e425798..e9c7a5d9b 100644 --- a/Doxygen +++ b/Doxygen @@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome" # could be handy for archiving the generated documentation or if some version # control system is used. -PROJECT_NUMBER = 2024.8.0b4 +PROJECT_NUMBER = 2024.8.0 # Using the PROJECT_BRIEF tag one can provide an optional one line description # for a project that appears at the top of each page and should give viewer a diff --git a/Makefile b/Makefile index 699f6d6e2..ed0590e92 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ ESPHOME_PATH = ../esphome -ESPHOME_REF = 2024.8.0b4 +ESPHOME_REF = 2024.8.0 PAGEFIND_VERSION=1.1.0 PAGEFIND=pagefind NET_PAGEFIND=../pagefindbin/pagefind diff --git a/_static/version b/_static/version index 8e05c9fe2..d20f6c523 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2024.8.0b4 \ No newline at end of file +2024.8.0 \ No newline at end of file diff --git a/conf.py b/conf.py index c9f45bbd4..4768be834 100644 --- a/conf.py +++ b/conf.py @@ -69,7 +69,7 @@ author = "ESPHome" # The short X.Y version. version = "2024.8" # The full version, including alpha/beta/rc tags. -release = "2024.8.0b4" +release = "2024.8.0" # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. From 7ced6e2363b07ac0904a11c9f2acf5de9bab21e7 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 21 Aug 2024 14:22:39 +1200 Subject: [PATCH 52/53] Update changelog for 2024.8.0 --- changelog/2024.8.0.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/changelog/2024.8.0.rst b/changelog/2024.8.0.rst index 8412a041c..93aef6410 100644 --- a/changelog/2024.8.0.rst +++ b/changelog/2024.8.0.rst @@ -145,7 +145,7 @@ All changes - LVGL stage 2 :esphomepr:`7129` by :ghuser:`clydebarrow` - [pid] Add get_min_integral() and get_max_integral() :esphomepr:`7162` by :ghuser:`FreeBear-nc` - [code-quality] Organise bluetooth related imports :esphomepr:`7155` by :ghuser:`jesserockz` -- http_request watchdog as a component :esphomepr:`7161` by :ghuser:`oarcher` (new-integration) +- http_request watchdog as a component :esphomepr:`7161` by :ghuser:`oarcher` - [touchscreen] Allow binary sensor to have multiple pages in config :esphomepr:`7112` by :ghuser:`jesserockz` - [matrix_keypad] Add `pin->setup()` to rows and cols :esphomepr:`7163` by :ghuser:`AAllport` - [update] Implement ``update.perform`` action and ``update.is_available`` condition :esphomepr:`7165` by :ghuser:`jesserockz` (new-feature) @@ -165,7 +165,7 @@ All changes - [lvgl] Stage 5 :esphomepr:`7191` by :ghuser:`clydebarrow` - socket: socket::set_sockaddr() for IPv4 addresses in IPv6 builds :esphomepr:`7196` by :ghuser:`dwmw2` - Adds MQTT component to Alarm Control panel component :esphomepr:`7188` by :ghuser:`heythisisnate` -- [lvgl] Final stage :esphomepr:`7184` by :ghuser:`clydebarrow` (new-integration) +- [lvgl] Final stage :esphomepr:`7184` by :ghuser:`clydebarrow` - Move ``CONF_BACKGROUND_COLOR`` and ``CONF_FOREGROUND_COLOR`` to const.py :esphomepr:`7202` by :ghuser:`jesserockz` - [helpers] Set default flags of ExternalRAMAllocator to ALLOW_FAILURE :esphomepr:`7201` by :ghuser:`jesserockz` - Add runtime online image support :esphomepr:`4710` by :ghuser:`guillempages` (new-integration) @@ -223,7 +223,7 @@ All changes - Implement ByteBuffer :esphomepr:`6878` by :ghuser:`clydebarrow` - Add min and max brightness parameters for Light dim_relative Action :esphomepr:`6971` by :ghuser:`PaoloTK` - [homeassistant] Native switch entity import and control :esphomepr:`7018` by :ghuser:`Links2004` (new-platform) -- [homeassistant] Native number entity import and control :esphomepr:`6455` by :ghuser:`landonr` (new-integration) +- [homeassistant] Native number entity import and control :esphomepr:`6455` by :ghuser:`landonr` (new-platform) - [lvgl] Rework events to avoid feedback loops :esphomepr:`7262` by :ghuser:`clydebarrow` - Add `color_filter_opa` style property :esphomepr:`7276` by :ghuser:`clydebarrow` - [code-quality] fix clang-tidy wake_on_lan :esphomepr:`7275` by :ghuser:`tomaszduda23` @@ -233,7 +233,7 @@ All changes - support illuminance for airthings wave plus device :esphomepr:`5203` by :ghuser:`MadMonkey87` - [micro_wake_word] Bump ESPMicroSpeechFeatures version to 1.1.0 :esphomepr:`7249` by :ghuser:`kahrendt` - Implement the finish() method and action. implement the is_stopped condition :esphomepr:`7255` by :ghuser:`nielsnl68` -- Correct offset calibration :esphomepr:`7228` by :ghuser:`descipher` (new-integration) +- Correct offset calibration :esphomepr:`7228` by :ghuser:`descipher` (new-platform) - remove extra number from pronto :esphomepr:`7263` by :ghuser:`ssieb` - [api] Bump noise-c library version :esphomepr:`7288` by :ghuser:`clydebarrow` - fix some small rtttl issues :esphomepr:`6817` by :ghuser:`nielsnl68` From fbfd804f9adf0f59e4115f1770cc0df1c630c8f8 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 21 Aug 2024 14:23:22 +1200 Subject: [PATCH 53/53] Update supporters for 2024.8.0 --- guides/supporters.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/guides/supporters.rst b/guides/supporters.rst index 6e435ec6d..45e36e397 100644 --- a/guides/supporters.rst +++ b/guides/supporters.rst @@ -1599,6 +1599,7 @@ Contributors - `Jason Sepinsky (@Sepinsky) `__ - `Sergey Popov (@Sergey-SRG) `__ - `Sergio (@sergio303) `__ +- `Sung-jin Brian Hong (@serialx) `__ - `Sergio Mayoral Martínez (@sermayoral) `__ - `sethcohn (@sethcohn) `__ - `Seth Girvan (@sethgirvan) `__