Merge pull request #3838 from esphome/bump-2024.5.0b6

2024.5.0b6

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.5.0b5
+PROJECT_NUMBER         = 2024.5.0b6
 
 # 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 = 2024.5.0b5
+ESPHOME_REF = 2024.5.0b6
 
 .PHONY: html html-strict cleanhtml deploy help live-html Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png minify
 

_static/version

@@ -1 +1 @@
-2024.5.0b5
+2024.5.0b6

changelog/2024.5.0.rst

@@ -19,6 +19,22 @@ ESPHome 2024.5.0 - 15th May 2024
     Template Datetime, components/datetime/template, description.svg, dark-invert
     WeiKai SPI/I²C UART/IO Expander, components/weikai, wk2168.jpg
 
+Valves, Events, and More
+------------------------
+
+This release brings a new ``Valve`` component, which can be used to control valves.
+A ``Valve`` can be opened, closed, or a specific position set if supported.
+
+``Event`` entities were added to Home Assistant in `2023.8 <https://www.home-assistant.io/blog/2023/08/02/release-20238/#introducing-the-event-entity>`__.
+They allow better structure and also history and logging of the events sent from ESPHome to Home Assistant compared to just using publishing events onto the
+Home Assistant event bus with the ``homeassistant.event`` action.
+
+ESP32 ADC Attenuation
+---------------------
+
+The attenuation configuration option for ESP32 ``adc`` sensors has had a deprecation in the underlying ESP-IDF framework with the ``11dB`` option.
+The value to replace ``11dB`` with is ``12dB``. There are no functionality changes otherwise. There will be a warning in the logs when installing if you
+are using ``11dB`` and it will be removed in **2024.8.0**.
 
 Full list of changes
 --------------------
@@ -58,6 +74,7 @@ Beta Changes
 - Fix ESPHOME_PROJECT_VERSION_30 :esphomepr:`6731` by :ghuser:`jesserockz`
 - Voice-Assistant: Start-order change for VAD disabled: start va-pipeline when microphon… :esphomepr:`6391` by :ghuser:`gnumpi`
 - Add ANNOUNCING state to media_player. :esphomepr:`6691` by :ghuser:`gnumpi`
+- [adc] Fix 11db deprecation warning :esphomepr:`6749` by :ghuser:`jesserockz` (notable-change)
 
 All changes
 ^^^^^^^^^^^
@@ -204,6 +221,7 @@ All changes
 - Fix ESPHOME_PROJECT_VERSION_30 :esphomepr:`6731` by :ghuser:`jesserockz`
 - Voice-Assistant: Start-order change for VAD disabled: start va-pipeline when microphon… :esphomepr:`6391` by :ghuser:`gnumpi`
 - Add ANNOUNCING state to media_player. :esphomepr:`6691` by :ghuser:`gnumpi`
+- [adc] Fix 11db deprecation warning :esphomepr:`6749` by :ghuser:`jesserockz` (notable-change)
 
 Past Changelogs
 ---------------

components/sensor/adc.rst

@@ -62,8 +62,8 @@ ESP32 Attenuation
 -----------------
 
 On the ESP32 the voltage measured with the ADC caps out at ~1.1V by default as the sensing range (attenuation of the ADC) is set to ``0db`` by default.
-Measuring higher voltages requires setting ``attenuation`` to one of the following values: ``0db``, ``2.5db``, ``6db``, ``11db``.
+Measuring higher voltages requires setting ``attenuation`` to one of the following values: ``0db``, ``2.5db``, ``6db``, ``12db``.
-There's more information `at the manufacturer's website <https://docs.espressif.com/projects/esp-idf/en/v4.4.2/esp32/api-reference/peripherals/adc.html#_CPPv425adc1_config_channel_atten14adc1_channel_t11adc_atten_t>`__.
+There's more information `at the manufacturer's website <https://docs.espressif.com/projects/esp-idf/en/v4.4.7/esp32/api-reference/peripherals/adc.html#_CPPv425adc1_config_channel_atten14adc1_channel_t11adc_atten_t>`__.
 
 To simplify this, we provide the setting ``attenuation: auto`` for an automatic/seamless transition among scales. `Our implementation
 <https://github.com/esphome/esphome/blob/dev/esphome/components/adc/adc_sensor.cpp>`__ combines all available ranges to allow the best resolution without having to compromise on a specific attenuation.
@@ -117,7 +117,7 @@ For users that don't need a precise voltage reading, the "raw" output option all
       - multiply: 0.00026862 # 1.1/4095, for attenuation 0db
       - multiply: 0.00036630 # 1.5/4095, for attenuation 2.5db
       - multiply: 0.00053724 # 2.2/4095, for attenuation 6db
-      - multiply: 0.00095238 # 3.9/4095, for attenuation 11db
+      - multiply: 0.00095238 # 3.9/4095, for attenuation 12db
       # your existing filters would go here
 
 Note we don't recommend this method as it will change between chips, and newer ESP32 modules have different ranges (i.e. 0-8191); it is better to use the new calibrated voltages and update any existing filters accordingly.
@@ -188,7 +188,7 @@ You can only use as many ADC sensors as your device can support. The ESP8266 onl
 Measuring battery voltage on the Firebeetle ESP32-E
 ---------------------------------------------------
 
-This board has a internal voltage divider and the battery voltage can easily be measured like this using 11dB attenuation
+This board has a internal voltage divider and the battery voltage can easily be measured like this using 12dB attenuation
 on GPIO34.
 
 .. code-block:: yaml
@@ -198,7 +198,7 @@ on GPIO34.
       pin: GPIO34
       accuracy_decimals: 2
       update_interval: 60s
-      attenuation: 11dB
+      attenuation: 12dB
       filters:
         - multiply: 2.0  # The voltage divider requires us to multiply by 2
 

conf.py

@@ -69,7 +69,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2024.5"
 # The full version, including alpha/beta/rc tags.
-release = "2024.5.0b5"
+release = "2024.5.0b6"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.