From 524b74e8f80efcea8034436a45b3816604c1ae77 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 15 May 2024 13:01:43 +1200 Subject: [PATCH 1/3] [adc] Change 11dB references to 12dB (#3837) --- components/sensor/adc.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/components/sensor/adc.rst b/components/sensor/adc.rst index fdb43a66a..972f6b924 100644 --- a/components/sensor/adc.rst +++ b/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``. -There's more information `at the manufacturer's website `__. +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 `__. To simplify this, we provide the setting ``attenuation: auto`` for an automatic/seamless transition among scales. `Our implementation `__ 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 From 88dea1e7c6d64d36641bf1bddffcf1a031511736 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 15 May 2024 13:14:18 +1200 Subject: [PATCH 2/3] Bump version to 2024.5.0b6 --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Doxygen b/Doxygen index 4e9ce3a96..9f0201c20 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.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 diff --git a/Makefile b/Makefile index 23e9cad5b..cd55c663a 100644 --- a/Makefile +++ b/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 diff --git a/_static/version b/_static/version index 5aae6ebc1..ca1660e52 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2024.5.0b5 \ No newline at end of file +2024.5.0b6 \ No newline at end of file diff --git a/conf.py b/conf.py index 197149ae5..c83293820 100644 --- a/conf.py +++ b/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. From a0771bfe4a5fff97e7cc527fb874a5c8e9dc788a Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 15 May 2024 13:22:10 +1200 Subject: [PATCH 3/3] Update changelog for 2024.5.0b6 --- changelog/2024.5.0.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/changelog/2024.5.0.rst b/changelog/2024.5.0.rst index 323f15466..6b54269d7 100644 --- a/changelog/2024.5.0.rst +++ b/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 `__. +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 ---------------