Lidl auriol docs

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         = 2025.5.0
+PROJECT_NUMBER         = 2025.6.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

Makefile

@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2025.5.1
+ESPHOME_REF = dev
 PAGEFIND_VERSION=1.1.1
 PAGEFIND=pagefind
 NET_PAGEFIND=../pagefindbin/pagefind

_static/version

@@ -1 +1 @@
-2025.5.1
+2025.6.0-dev

components/audio_dac/es8388.rst

@@ -0,0 +1,142 @@
+ES8388
+======
+
+.. seo::
+    :description: Instructions for using ESPHome's es8388 audio DAC platform to play media from your devices and to configure microphone inputs.
+    :image: es8388.svg
+    :keywords: ES8388, Audio, DAC, I2S, ESP32
+
+The ``es8388`` component allows your ESPHome devices to use the es8388 low power audio codec (`datasheet <http://www.everest-semi.com/pdf/ES8388%20DS.pdf>`__)
+This allows the playback of audio through two channel high performance audio DAC output via the microcontroller from a range of sources via :doc:`/components/speaker/index` or
+:doc:`/components/media_player/index` .
+
+It also allows your ESPHome devices to use the ``es8388``  high performance two channel audio ADC.
+
+This allows attached microphones to be used as a microphone input via :doc:`/components/microphone/i2s_audio`.
+
+The :ref:`I²C bus <i2c>` is required in your configuration as this is used to communicate with the es8388.
+
+Audio DAC
+---------
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    audio_dac:
+     - platform: es8388
+
+Configuration variables:
+************************
+- **address** (*Optional*, int): The I²C address of the driver. Defaults to ``0x10``.
+- **i2c_id** (*Optional*): The ID of the :ref:`I²C bus <i2c>` the ES8388 is connected to.
+- All other options from :ref:`Audio DAC <config-audio_dac>`.
+
+
+Select
+------
+
+The ``es8388`` select allows you to control the ``dac output`` and the ``adc input_mic`` of your :doc:`es8388`.
+
+.. code-block:: yaml
+
+    select:
+      - platform: es8388
+        es8388_id: es8388_parent
+        dac_output:
+          name: "DAC Output"
+        adc_input_mic:
+          name: "ADC Input MIC"
+
+Configuration variables:
+************************
+
+- **es8388_id** (*Optional*, :ref:`config-id`): Manually specify the ID for the :doc:`es8388` component.
+- **dac_output** (*Optional*): Control the DAC Audio output.
+
+  - ``LINE1`` (default)
+  - ``LINE2``
+  - ``BOTH``
+
+  All options from :ref:`Select <config-select>`.
+
+- **adc_input_mic** (*Optional*): Control the ADC Mic Input.
+
+  - ``LINE1`` (default)
+  - ``LINE2``
+  - ``DIFFERENCE``
+
+  All options from :ref:`Select <config-select>`.
+
+
+Automations
+-----------
+
+All :ref:`Audio DAC Automations <automations-audio_dac>` are supported by this platform.
+
+
+Configuration Examples
+----------------------
+
+**ESP32 Audio Kit**:
+
+.. code-block:: yaml
+
+    i2c:
+      sda: GPIO33
+      scl: GPIO32
+      frequency: 100kHz
+      id: bus_a
+
+    audio_dac:
+      - platform: es8388
+        id: es8388_dac
+
+    select:
+      - platform: es8388
+        es8388_id: es8388_dac
+        dac_output:
+          name: "DAC Output"
+        adc_input_mic:
+          name: "ADC Input MIC"
+
+    i2s_audio:
+      id: i2s_output
+      i2s_lrclk_pin: GPIO25
+      i2s_bclk_pin: GPIO27
+      i2s_mclk_pin: GPIO0
+
+    speaker:
+      - platform: i2s_audio
+        i2s_audio_id: i2s_output
+        sample_rate: 48000
+        id: speaker_id
+        i2s_dout_pin: GPIO26
+        bits_per_sample: 32bit
+        dac_type: external
+        channel: stereo
+        buffer_duration: 100ms
+        audio_dac: es8388_dac
+
+    microphone:
+      - platform: i2s_audio
+        i2s_din_pin: GPIO35
+        id: mic1
+        adc_type: external
+        pdm: false
+        sample_rate: 16000
+        bits_per_sample: 16bit
+
+    switch:
+      - platform: gpio
+        pin: GPIO21
+        id: mute_switch
+        name: "AMP Switch"
+        restore_mode: ALWAYS_ON
+
+See Also
+--------
+
+- :doc:`index`
+- :apiref:`es8388/es8388.h`
+- :apiref:`audio_dac/audio_dac.h`
+- :ghedit:`Edit`

components/display/max7219digit.rst

@@ -70,6 +70,48 @@ Configuration variables:
 - **chip_lines_style** (*Optional*): How are the lines in Multiline Mode connected? Possible values are ``zigzag`` and ``snake``. Defaults to ``snake``
 - **flip_x** (*Optional*, boolean): Flip the horizontal axis on the screen. Defaults to ``false``.
 
+.. _display-max7219digit_actions:
+
+Actions
+-------
+The following actions are replicas of the LAMBDA functions shown in the next section. 
+
+.. _display-max7219digit_actions_invert_on_off>:
+
+`MAX7219.invert_on` & `MAX7219.invert_off` Action
+=================================================
+
+This action  ``MAX7219.invert_on`` will invert the display. So background pixels are on and texts pixels are
+off. ``MAX7219.invert_off`` sets the display back to normal. The background pixels are only set at the next update, the pixels drawn in
+the various function like print, line, etc. are directly influenced by the invert command.
+
+.. _display-max7219digit_actions_turn_on_off:
+
+`MAX7219.turn_on` & `MAX7219.turn_off` Action
+=============================================
+
+The display can be switched on and off "dynamically" with the actions `MAX7219.turn_on` & `MAX7219.turn_off`.
+
+
+.. _display-max7219digit_actions_reverse_off:
+
+`MAX7219.reverse_on` & `MAX7219.reverse_off` Action
+===================================================
+
+With this actions you can reverse the display direction from left to right to right to left.
+
+
+.. _display-max7219digit_actions_intensity:
+
+`MAX7219.intensity` Action
+===========================
+
+The intensity of the screen can be set "dynamically" within the lambda code with the following command: it.intensity(``0`` .. ``15``).
+
+- **intensity** (int): The intensity with which the MAX7219 should drive the outputs. Range is
+  from ``0``, least intense to ``15`` the brightest. Defaults to ``15``.
+
+
 .. _display-max7219digit_lambda:
 
 Rendering Lambda

components/esp32.rst

@@ -24,13 +24,13 @@ Configuration variables:
 - **flash_size** (*Optional*, string): The amount of flash memory available on the ESP32 board/module. One of ``2MB``,
   ``4MB``, ``8MB``, ``16MB`` or ``32MB``. Defaults to ``4MB``. **Warning: specifying a size larger than that available
   on your board will cause the ESP32 to fail to boot.**
-- **cpu_frequency** (*Optional*, string): The CPU frequency to use. One of ``40MHz``, ``80MHz``, ``160MHz`` or ``240MHz``. Defaults to
-  ``160MHz``. Not all values are available for all chips.
+- **cpu_frequency** (*Optional*, string): The CPU frequency to use. One of ``40MHz``, ``80MHz``, ``160MHz``, ``240MHz``,
+  ``360MHz`` or ``400MHz``. Defaults to ``160MHz``. Not all values are available for all chips.
 - **partitions** (*Optional*, filename): The name of (optionally including the path to) the file containing the
   partitioning scheme to be used. When not specified, partitions are automatically generated based on ``flash_size``.
 - **variant** (*Optional*, string): The variant of the ESP32 that is used on this board. One of ``esp32``,
-  ``esp32s2``, ``esp32s3``, ``esp32c3`` and ``esp32h2``. Defaults to the variant that is detected from the board; if
-  a board that's unknown to ESPHome is used, this option is mandatory.
+  ``esp32s2``, ``esp32s3``, ``esp32c2``, ``esp32c3``, ``esp32c5``, ``esp32c6``, ``esp32h2`` and ``esp32p4``. Defaults
+  to the variant that is detected from the board; if a board that's unknown to ESPHome is used, this option is mandatory.
 - **framework** (*Optional*): Options for the underlying framework used by ESPHome. See :ref:`esp32-arduino_framework`
   and :ref:`esp32-espidf_framework`.
 
@@ -73,7 +73,7 @@ ESP-IDF framework
 -----------------
 
 This is an alternative base framework for ESP32 chips; it is recommended for variants of the ESP32 like ESP32S2,
-ESP32S3, ESP32C3 and single-core ESP32 chips.
+ESP32S3, ESP32P4 and single-core ESP32 chips.
 
 .. code-block:: yaml
 

components/index.rst

@@ -163,6 +163,8 @@ Hardware Peripheral Interfaces/Busses
     OpenTherm, components/opentherm, opentherm.png
     SPI Bus, components/spi, spi.svg
     UART, components/uart, uart.svg
+    USB Host, components/usb_host, usb.svg
+    USB UART, components/usb_uart, usb.svg
 
 I/O Expanders/Multiplexers
 --------------------------
@@ -218,6 +220,7 @@ Air Quality
     AGS10, components/sensor/ags10, ags10.jpg, Volatile Organic Compound Sensor
     AirThings BLE, components/sensor/airthings_ble, airthings_logo.png, Radon, CO2, Volatile organics
     CCS811, components/sensor/ccs811, ccs811.jpg, CO2 & Volatile organics
+    CM1106, components/sensor/cm1106, cm1106.png, CO2
     EE895, components/sensor/ee895, EE895.png,  CO2 & Temperature & Pressure
     ENS160, components/sensor/ens160, ens160.jpg, CO2 & Air Quality
     GCJA5, components/sensor/gcja5, gcja5.svg, Particulate
@@ -651,6 +654,7 @@ Audio DAC Components
     AIC3204, components/audio_dac/aic3204, aic3204.svg
     ES8156, components/audio_dac/es8156, es8156.svg
     ES8311, components/audio_dac/es8311, es8311.svg
+    ES8388, components/audio_dac/es8388, es8388.svg
 
 Button Components
 -----------------

components/logger.rst

@@ -106,13 +106,27 @@ Default UART GPIO Pins
       - N/A
       - N/A
       - 18/19
+    * - ESP32-C5
+      - TX: 10, RX: 11
+      - N/A
+      - Undefined
+      - N/A
+      - N/A
+      - 13/14
     * - ESP32-C6
       - TX: 16, RX: 17
       - N/A
       - Undefined
       - N/A
       - N/A
       - 12/13
+    * - ESP32-P4
+      - TX: 37, RX: 38
+      - N/A
+      - TX: 10, RX: 11
+      - N/A
+      - N/A
+      - 24/25
     * - ESP32-S2
       - TX: 43, RX: 44
       - N/A
@@ -155,9 +169,15 @@ the original ESP32 or ESP8266) continue to use USB-to-serial bridge ICs for comm
     * - ESP32-C3
       - ``USB_CDC``
       - ``USB_SERIAL_JTAG``
+    * - ESP32-C5
+      - ``USB_CDC``
+      - ``USB_SERIAL_JTAG``
     * - ESP32-C6
       - ``USB_CDC``
       - ``USB_SERIAL_JTAG``
+    * - ESP32-P4
+      - ``USB_CDC``
+      - ``USB_SERIAL_JTAG``
     * - ESP32-S2
       - ``USB_CDC``
       - ``USB_CDC``

components/lvgl/index.rst

@@ -153,7 +153,7 @@ The following configuration variables apply to the main ``lvgl`` component, in o
 
 - **resume_on_input** (*Optional*, boolean): If LVGL is paused and the user interacts with the screen, resume the activity of LVGL. Defaults to ``true``. "Interacts" means to release a touch or button, or rotate an encoder.
 - **color_depth** (*Optional*, string): The color depth 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%``.
+- **buffer_size** (*Optional*, percentage): The percentage of screen size to allocate buffer memory. If unconfigured, the default is ``100%`` with runtime fallback to ``12%`` if a full size buffer allocation fails. For devices without PSRAM, the recommended value is ``25%``.
 - **draw_rounding** (*Optional*, int): An optional value to use for rounding draw areas to a specified boundary. Defaults to 2. Useful for displays that require draw windows to be on specified boundaries (usually powers of 2.)
 - **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``.
@@ -202,7 +202,9 @@ Choosing a buffer size
 The ``buffer_size`` option is a percentage of the display size. For example, if you have a 320x240 display, the buffer size is ``320 * 240 * 2`` bytes (for RGB565) = ``153600`` bytes. If you set the buffer size to ``50%``,
 then the buffer will be ``76800`` bytes. If you set it to ``25%``, then the buffer will be ``38400`` bytes. The default value is ``100%``.
 
-When using larger displays on devices with limited RAM (i.e. no PSRAM), you may need to reduce the buffer size to avoid running out of RAM.
+When using larger displays on devices with limited RAM (i.e. no PSRAM), you may want to reduce the buffer size to avoid running out of RAM.
+If not specified, the buffer size will be 100%, but a fallback
+at runtime to 12% will be attempted if a full size buffer fails. If a specific buffer size is set, the fallback will not be attempted.
 A failure to allocate a buffer will result in an error message in the log and the LVGL component being marked "Failed".
 
 Generally speaking a larger buffer will provide better performance, but the effect of reducing the buffer size from 100% is not as bad as you might think. The LVGL library is designed to be efficient and will only redraw the parts of the screen that have changed.

components/lvgl/widgets.rst

@@ -1799,6 +1799,7 @@ The tabs are indexed (zero-based) in the order they appear in the configuration
     - **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*, dict): Settings for the items *part*, the buttons all use the text and typical background style properties except translations and transformations.
+- **content_style** (*Optional*): Style settings for the content area.
 
 **Actions:**
 

components/online_image.rst

@@ -69,6 +69,28 @@ Automations
 
 - **on_download_finished** (*Optional*, :ref:`Automation <automation>`): An automation to perform when the image has been successfully downloaded.
 
+The variable ``cached`` is a boolean available in :ref:`lambdas <config-lambda>` that indicates cache status:
+ - ``true`` if the image was loaded from cache (cache hit).
+ - ``false`` if the image was freshly downloaded (cache miss).
+
+Caching follows standard HTTP mechanisms (see `HTTP caching <https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching>`_), utilizing the ``Last-Modified`` and ``ETag`` headers.
+
+For example:
+
+.. 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:
+          lambda: |-
+            if (cached) {
+              ESP_LOGD("online_image", "Cache hit: using cached image");
+            } else {
+              ESP_LOGD("online_image", "Cache miss: fresh download");
+            }
+
 A good example for that is to update the display component after the download succeeded.
 
 - **on_error** (*Optional*, :ref:`Automation <automation>`): An automation to perform when an error happened during download or decode.