From 27091c50ac0afc02a6440089d531058b6a2d75a4 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 20 Apr 2023 17:22:37 +1200
Subject: [PATCH 001/175] Add HA version requirement on release notes (#2860)
---
changelog/2023.4.0.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/changelog/2023.4.0.rst b/changelog/2023.4.0.rst
index aa863df177..4dd4ceeaf6 100644
--- a/changelog/2023.4.0.rst
+++ b/changelog/2023.4.0.rst
@@ -22,7 +22,7 @@ Voice Assistant
This year is the Year of the Voice for Home Assistant, and ESPHome is charging ahead with this in mind.
We've added a new :doc:`/components/voice_assistant` component that allows you to use ESPHome devices as an input
-for `assist `__ in Home Assistant.
+for `assist `__ in Home Assistant **2023.5 or later**.
With this also comes preliminary :doc:`microphone ` support, which has been built in a way that multiple
components, like ``voice_assistant`` can request start / stop of the microphone and get the data. We
From e978d12c67a3c1cbc3bbd332ce0b46051b1b4be7 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 20 Apr 2023 07:46:34 +0000
Subject: [PATCH 002/175] Add missing n
---
changelog/2023.4.0.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/changelog/2023.4.0.rst b/changelog/2023.4.0.rst
index 4dd4ceeaf6..10441a127e 100644
--- a/changelog/2023.4.0.rst
+++ b/changelog/2023.4.0.rst
@@ -42,7 +42,7 @@ Home Assistant is hosting a live stream all about the Year of the Voice - Chapte
Keith joins Nabu Casa
---------------------
-Nabu Casa is pleased to annouce that long time contributor Keith Burzinski (:ghuser:`kbx81`) is joining the
+Nabu Casa is pleased to announce that long time contributor Keith Burzinski (:ghuser:`kbx81`) is joining the
team as a full time developer to help out on ESPHome. Keith created the :doc:`/components/sprinkler`,
:doc:`/components/climate/thermostat`, a bunch of the ``ssd`` display components and a few other components
as well as fixing many bug along the way. I expect his house climate and garden area are kept well in line.
From bae288c994d6bf8b86c11e04b768ddc710acbfbf Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 20 Apr 2023 20:09:51 +1200
Subject: [PATCH 003/175] Fix mmc5603 filename (#2861)
---
_redirects | 1 +
components/sensor/{mmc5063.rst => mmc5603.rst} | 0
2 files changed, 1 insertion(+)
rename components/sensor/{mmc5063.rst => mmc5603.rst} (100%)
diff --git a/_redirects b/_redirects
index 8e185bd731..8532c1d698 100644
--- a/_redirects
+++ b/_redirects
@@ -9,6 +9,7 @@
/changelog/2022.12.4.html /changelog/2022.12.0.html 301
/components/display/ili9341.html /components/display/ili9xxx.html 301
+/components/sensor/mmc5063.html /components/sensor/mmc5603.html 301
/cookbook/brilliant-mirabella-genio-smart-plugs.html https://devices.esphome.io/devices/Mirabella-Genio-Wi-Fi-1-USB 301
/cookbook/zemismart-rgbw-downlights.html https://devices.esphome.io/devices/Zemismart-LED-RGBWW-Downlight 301
diff --git a/components/sensor/mmc5063.rst b/components/sensor/mmc5603.rst
similarity index 100%
rename from components/sensor/mmc5063.rst
rename to components/sensor/mmc5603.rst
From 83583e37bf1790a6a60c9e4906491321b845fc2a Mon Sep 17 00:00:00 2001
From: Samuel Sieb
Date: Sat, 22 Apr 2023 22:12:26 -0700
Subject: [PATCH 004/175] fix uart id in example (#2869)
---
components/sensor/growatt_solar.rst | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/components/sensor/growatt_solar.rst b/components/sensor/growatt_solar.rst
index f6f5c8855b..cd6bd18c99 100644
--- a/components/sensor/growatt_solar.rst
+++ b/components/sensor/growatt_solar.rst
@@ -22,13 +22,13 @@ to some pins on your board and the baud rate set to 9600.
# Example configuration entry
uart:
- - id: uart1
+ - id: gw_uart
baud_rate: 9600
tx_pin: GPIO1
rx_pin: GPIO3
modbus:
- uart_id: uart1
+ uart_id: gw_uart
flow_control_pin: GPIO4
sensor:
From 018e5bb6d9e121139a08f6725499ad3b58766a63 Mon Sep 17 00:00:00 2001
From: notsonominal <130870838+notsonominal@users.noreply.github.com>
Date: Sun, 23 Apr 2023 22:11:02 +0200
Subject: [PATCH 005/175] add initial_value to servo example (#2870)
---
components/servo.rst | 1 +
1 file changed, 1 insertion(+)
diff --git a/components/servo.rst b/components/servo.rst
index 2e680ddc00..7cca13f52c 100644
--- a/components/servo.rst
+++ b/components/servo.rst
@@ -150,6 +150,7 @@ configuration. See :ref:`Number ` for more information.
- platform: template
name: Servo Control
min_value: -100
+ initial_value: 0
max_value: 100
step: 1
optimistic: true
From feb79dae2403d2bc404511218d8fb098658eb20f Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 24 Apr 2023 09:11:08 +1200
Subject: [PATCH 006/175] Bump version to 2023.4.1
---
Doxygen | 2 +-
Makefile | 2 +-
_static/version | 2 +-
conf.py | 2 +-
4 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/Doxygen b/Doxygen
index 2bac0a7049..4c1007314b 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 = 2023.4.0
+PROJECT_NUMBER = 2023.4.1
# 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 3b07c93339..982705bb84 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2023.4.0
+ESPHOME_REF = 2023.4.1
.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 b0db10dad4..16df2afe30 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2023.4.0
\ No newline at end of file
+2023.4.1
\ No newline at end of file
diff --git a/conf.py b/conf.py
index 13647ccf81..b497fb96cb 100644
--- a/conf.py
+++ b/conf.py
@@ -69,7 +69,7 @@
# The short X.Y version.
version = "2023.4"
# The full version, including alpha/beta/rc tags.
-release = "2023.4.0"
+release = "2023.4.1"
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
From 64595d386c1b2ca053f626ef0fc2c92e7dc61f5e Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 24 Apr 2023 09:29:45 +1200
Subject: [PATCH 007/175] Update changelog for 2023.4.1
---
changelog/2023.4.0.rst | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/changelog/2023.4.0.rst b/changelog/2023.4.0.rst
index 10441a127e..cea775affa 100644
--- a/changelog/2023.4.0.rst
+++ b/changelog/2023.4.0.rst
@@ -49,6 +49,12 @@ as well as fixing many bug along the way. I expect his house climate and garden
Looking forward to working with you Keith.
+Release 2023.4.1 - April 24
+---------------------------
+
+- fix flip_x :esphomepr:`4727` by :ghuser:`ssieb`
+- Use proper schema for delta filter :esphomepr:`4723` by :ghuser:`jesserockz`
+
Breaking Changes
----------------
From 39110d4e2ed70b0cde54b9fbdb29fb52493061c9 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 24 Apr 2023 09:30:14 +1200
Subject: [PATCH 008/175] Update supporters for 2023.4.1
---
guides/supporters.rst | 10 ++++------
1 file changed, 4 insertions(+), 6 deletions(-)
diff --git a/guides/supporters.rst b/guides/supporters.rst
index 4c0d6ef55a..8923923ef9 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -135,6 +135,7 @@ Contributors
- `beaudeanadams (@beaudeanadams) `__
- `Benjamin Freeman (@Beetix) `__
- `beikeland (@beikeland) `__
+- `Bella Coola (@BellaCoola) `__
- `Ben-Schwabe (@Ben-Schwabe) `__
- `Ben Hoff (@benhoff) `__
- `Benno Pütz (@bennop) `__
@@ -203,7 +204,6 @@ Contributors
- `Cellie (@CelliesProjects) `__
- `Chris Feenstra (@cfeenstra1024) `__
- `cg089 (@cg089) `__
-- `Kostas Chatzikokolakis (@chatziko) `__
- `Audric Schiltknecht (@chemicalstorm) `__
- `chris-jennings (@chris-jennings) `__
- `Chris (@chrismaki) `__
@@ -618,7 +618,6 @@ Contributors
- `Karl0ss (@karl0ss) `__
- `Karol Zlot (@karolzlot) `__
- `Kattni (@kattni) `__
-- `Krasimir Nedelchev (@kaykayehnn) `__
- `Krzysztof Białek (@kbialek) `__
- `Keilin Bickar (@kbickar) `__
- `Keith Burzinski (@kbx81) `__
@@ -640,7 +639,6 @@ Contributors
- `Marcus Klein (@kleini) `__
- `Kevin Lewis (@kll) `__
- `KNXBroker (@KNXBroker) `__
-- `Koen Vervloesem (@koenvervloesem) `__
- `kokangit (@kokangit) `__
- `Petr Vraník (@konikvranik) `__
- `Kevin Pelzel (@kpelzel) `__
@@ -908,6 +906,7 @@ Contributors
- `Marc Seeger (@rb2k) `__
- `rbaron (@rbaron) `__
- `Robert Cambridge (@rcambrj) `__
+- `Russell Cloran (@rcloran) `__
- `Rebbe Pod (@RebbePod) `__
- `reddn (@reddn) `__
- `Alex (@redwngsrul) `__
@@ -915,7 +914,6 @@ Contributors
- `Regev Brody (@regevbr) `__
- `Alex Reid (@reidprojects) `__
- `RenierM26 (@RenierM26) `__
-- `Reuben (@reubn) `__
- `Robin Pronk (@rfpronk) `__
- `Robert Gabrielson (@rgabrielson11) `__
- `Rafael Goes (@rgriffogoes) `__
@@ -931,7 +929,6 @@ Contributors
- `rnauber (@rnauber) `__
- `Rob Deutsch (@rob-deutsch) `__
- `Robert Alfaro (@robert-alfaro) `__
-- `Rob Gridley (@robgridley) `__
- `Robinson1999 (@Robinson1999) `__
- `RoboMagus (@RoboMagus) `__
- `Roeland Lutters (@Roeland54) `__
@@ -1110,6 +1107,7 @@ Contributors
- `Ian Wells (@wellsi) `__
- `wifwucite (@wifwucite) `__
- `wilberforce (@wilberforce) `__
+- `wildekek (@wildekek) `__
- `Wingman3434 (@Wingman3434) `__
- `Emil Hesslow (@WizKid) `__
- `WJCarpenter (@wjcarpenter) `__
@@ -1139,4 +1137,4 @@ Contributors
- `Zack Barett (@zsarnett) `__
- `Christian Zufferey (@zuzu59) `__
-*This page was last updated April 20, 2023.*
+*This page was last updated April 24, 2023.*
From 0405df3e490c6d37f3d9a354a828f653dd14807f Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 24 Apr 2023 09:45:44 +1200
Subject: [PATCH 009/175] Fix examples with `uart1` in id (#2872)
---
components/sensor/havells_solar.rst | 4 ++--
components/sensor/ld2410.rst | 1 -
2 files changed, 2 insertions(+), 3 deletions(-)
diff --git a/components/sensor/havells_solar.rst b/components/sensor/havells_solar.rst
index 9e6992007e..5338e6f5ec 100644
--- a/components/sensor/havells_solar.rst
+++ b/components/sensor/havells_solar.rst
@@ -24,14 +24,14 @@ to some pins on your board and the baud rate set to 9600.
# Example configuration entry
uart:
- - id: uart1
+ - id: modbus_uart
baud_rate: 9600
tx_pin: GPIO1
rx_pin: GPIO3
modbus:
- uart_id: uart1
+ uart_id: modbus_uart
flow_control_pin: GPIO4
sensor:
diff --git a/components/sensor/ld2410.rst b/components/sensor/ld2410.rst
index dd07982399..813ef999b5 100644
--- a/components/sensor/ld2410.rst
+++ b/components/sensor/ld2410.rst
@@ -25,7 +25,6 @@ Use of hardware UART pins is highly recommended, in order to support the out-of-
# Example configuration entry
uart:
- id: uart1
tx_pin: REPLACEME
rx_pin: REPLACEME
baud_rate: 256000
From e25e952055ecf90ddaae2c11ed7409d73a2bdd6a Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 27 Apr 2023 19:36:22 +1200
Subject: [PATCH 010/175] Bump version to 2023.4.2
---
Doxygen | 2 +-
Makefile | 2 +-
_static/version | 2 +-
conf.py | 2 +-
4 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/Doxygen b/Doxygen
index 4c1007314b..315472e0a7 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 = 2023.4.1
+PROJECT_NUMBER = 2023.4.2
# 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 982705bb84..5dfbe5ed9f 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2023.4.1
+ESPHOME_REF = 2023.4.2
.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 16df2afe30..ea2cb525d3 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2023.4.1
\ No newline at end of file
+2023.4.2
\ No newline at end of file
diff --git a/conf.py b/conf.py
index b497fb96cb..84ad4f3577 100644
--- a/conf.py
+++ b/conf.py
@@ -69,7 +69,7 @@
# The short X.Y version.
version = "2023.4"
# The full version, including alpha/beta/rc tags.
-release = "2023.4.1"
+release = "2023.4.2"
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
From 9cb78b456a38b60f39aee6921ebed6d537e74f60 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 27 Apr 2023 19:36:43 +1200
Subject: [PATCH 011/175] Update changelog for 2023.4.2
---
changelog/2023.4.0.rst | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/changelog/2023.4.0.rst b/changelog/2023.4.0.rst
index cea775affa..8f19c3ac03 100644
--- a/changelog/2023.4.0.rst
+++ b/changelog/2023.4.0.rst
@@ -55,6 +55,14 @@ Release 2023.4.1 - April 24
- fix flip_x :esphomepr:`4727` by :ghuser:`ssieb`
- Use proper schema for delta filter :esphomepr:`4723` by :ghuser:`jesserockz`
+Release 2023.4.2 - April 27
+---------------------------
+
+- I2c scan recovery reset fix :esphomepr:`4724` by :ghuser:`gcopeland`
+- Debug component doesn't work on RP2040 :esphomepr:`4728` by :ghuser:`HeMan`
+- Only request VA port from first client that is subscribed :esphomepr:`4747` by :ghuser:`jesserockz`
+- Don't allow fingerprint_grow enroll cancellation when no enrollment started :esphomepr:`4745` by :ghuser:`itpeters`
+
Breaking Changes
----------------
From c4a1f4facd6783c70e53f30fbc4df48cf52a192b Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 27 Apr 2023 19:37:15 +1200
Subject: [PATCH 012/175] Update supporters for 2023.4.2
---
guides/supporters.rst | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/guides/supporters.rst b/guides/supporters.rst
index 8923923ef9..9dde51697c 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -944,6 +944,7 @@ Contributors
- `RubyBailey (@RubyBailey) `__
- `Rus Ti (@Rusti-gotrage) `__
- `rweather (@rweather) `__
+- `rwilson131 (@rwilson131) `__
- `Ryan Lang (@ryan-lang) `__
- `ryanalden (@ryanalden) `__
- `Lukas Bachschwell (@s00500) `__
@@ -1137,4 +1138,4 @@ Contributors
- `Zack Barett (@zsarnett) `__
- `Christian Zufferey (@zuzu59) `__
-*This page was last updated April 24, 2023.*
+*This page was last updated April 27, 2023.*
From 23aad5ce78b770e779f6bb9762834af43a2dd109 Mon Sep 17 00:00:00 2001
From: "imgbot[bot]" <31301654+imgbot[bot]@users.noreply.github.com>
Date: Mon, 1 May 2023 07:54:50 +1200
Subject: [PATCH 013/175] [ImgBot] Optimize images (#2784)
Co-authored-by: ImgBotApp
---
_static/changelog-2022.12.0.png | Bin 31349 -> 26168 bytes
_static/changelog-2023.2.0.png | Bin 168907 -> 167466 bytes
_static/changelog-2023.3.0.png | Bin 94808 -> 94492 bytes
components/climate/images/deadband1.png | Bin 130208 -> 92746 bytes
components/climate/images/deadband2.png | Bin 132159 -> 101802 bytes
.../output/images/sigma-delta-example.png | Bin 15418 -> 6213 bytes
components/output/images/x9c.jpg | Bin 18752 -> 17117 bytes
components/sensor/images/EE895.png | Bin 99832 -> 38141 bytes
components/sensor/images/as7341-full.jpg | Bin 137081 -> 137060 bytes
components/sensor/images/ld2410.jpg | Bin 3353 -> 3352 bytes
.../images/mopeka_pro_check_lippert.jpg | Bin 12758 -> 11629 bytes
components/sensor/images/sen21231.png | Bin 341657 -> 276941 bytes
cookbook/images/ehmtx.jpg | Bin 78391 -> 74577 bytes
images/as7341.jpg | Bin 38143 -> 38117 bytes
images/ehmtx.jpg | Bin 23667 -> 23663 bytes
images/garage-variant.svg | 2 +-
images/haier.svg | 26 +--------
images/head-lightbulb-outline.svg | 2 +-
images/ld2410.jpg | Bin 3353 -> 3352 bytes
images/matrix_keypad.jpg | Bin 15740 -> 15110 bytes
images/mics_4514.jpg | Bin 36642 -> 34923 bytes
images/resol_vbus_adapter_schematic.png | Bin 17730 -> 15105 bytes
images/sigma-delta.svg | 51 +-----------------
images/thermometer.svg | 2 +-
images/x9c.jpg | Bin 18752 -> 17117 bytes
25 files changed, 5 insertions(+), 78 deletions(-)
diff --git a/_static/changelog-2022.12.0.png b/_static/changelog-2022.12.0.png
index 7eff5ae2ee4407c9495aa16f85f6cb295c713f92..ec027251f137c699baea20cce4595e972f4999b9 100644
GIT binary patch
literal 26168
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
literal 31349
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