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

2024.5.0b6
This commit is contained in:
Jesse Hills 2024-05-15 16:25:34 +12:00 committed by GitHub
commit e7747603cf
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
6 changed files with 27 additions and 9 deletions

View File

@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome"
# could be handy for archiving the generated documentation or if some version # could be handy for archiving the generated documentation or if some version
# control system is used. # 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 # 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 # for a project that appears at the top of each page and should give viewer a

View File

@ -1,5 +1,5 @@
ESPHOME_PATH = ../esphome 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 .PHONY: html html-strict cleanhtml deploy help live-html Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png minify

View File

@ -1 +1 @@
2024.5.0b5 2024.5.0b6

View File

@ -19,6 +19,22 @@ ESPHome 2024.5.0 - 15th May 2024
Template Datetime, components/datetime/template, description.svg, dark-invert Template Datetime, components/datetime/template, description.svg, dark-invert
WeiKai SPI/I²C UART/IO Expander, components/weikai, wk2168.jpg 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 Full list of changes
-------------------- --------------------
@ -58,6 +74,7 @@ Beta Changes
- Fix ESPHOME_PROJECT_VERSION_30 :esphomepr:`6731` by :ghuser:`jesserockz` - 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` - 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` - 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 All changes
^^^^^^^^^^^ ^^^^^^^^^^^
@ -204,6 +221,7 @@ All changes
- Fix ESPHOME_PROJECT_VERSION_30 :esphomepr:`6731` by :ghuser:`jesserockz` - 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` - 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` - 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 Past Changelogs
--------------- ---------------

View File

@ -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. 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 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. <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.00026862 # 1.1/4095, for attenuation 0db
- multiply: 0.00036630 # 1.5/4095, for attenuation 2.5db - multiply: 0.00036630 # 1.5/4095, for attenuation 2.5db
- multiply: 0.00053724 # 2.2/4095, for attenuation 6db - 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 # 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. 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 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. on GPIO34.
.. code-block:: yaml .. code-block:: yaml
@ -198,7 +198,7 @@ on GPIO34.
pin: GPIO34 pin: GPIO34
accuracy_decimals: 2 accuracy_decimals: 2
update_interval: 60s update_interval: 60s
attenuation: 11dB attenuation: 12dB
filters: filters:
- multiply: 2.0 # The voltage divider requires us to multiply by 2 - multiply: 2.0 # The voltage divider requires us to multiply by 2

View File

@ -69,7 +69,7 @@ author = "ESPHome"
# The short X.Y version. # The short X.Y version.
version = "2024.5" version = "2024.5"
# The full version, including alpha/beta/rc tags. # 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 # The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages. # for a list of supported languages.