From 9c1d3d35735165d722b41df56ca9d300671fa1a7 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Tue, 13 Feb 2024 09:45:31 +1300
Subject: [PATCH 01/19] Bump version to 2024.2.0b1

---
 Doxygen         | 2 +-
 Makefile        | 2 +-
 _static/version | 2 +-
 conf.py         | 4 ++--
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/Doxygen b/Doxygen
index 8c5682359..0a1795ab7 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.1.0-dev
+PROJECT_NUMBER         = 2024.2.0b1
 
 # 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 299496721..730c90dcd 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = dev
+ESPHOME_REF = 2024.2.0b1
 
 .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 dd273dfb1..4164e16b3 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2024.1.0-dev
\ No newline at end of file
+2024.2.0b1
\ No newline at end of file
diff --git a/conf.py b/conf.py
index 6133991d7..cc188e211 100644
--- a/conf.py
+++ b/conf.py
@@ -67,9 +67,9 @@ author = "ESPHome"
 # built documents.
 #
 # The short X.Y version.
-version = "2024.1"
+version = "2024.2"
 # The full version, including alpha/beta/rc tags.
-release = "2024.1.0-dev"
+release = "2024.2.0b1"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From a1929814ea7d4936be2fa822428281fd2f81e503 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Tue, 13 Feb 2024 10:09:50 +1300
Subject: [PATCH 02/19] Update changelog for 2024.2.0b1

---
 _static/changelog-2024.2.0.png | Bin 0 -> 74547 bytes
 changelog/2024.2.0.rst         | 199 +++++++++++++++++++++++++++++++++
 changelog/index.rst            |   2 +-
 index.rst                      |   8 +-
 4 files changed, 205 insertions(+), 4 deletions(-)
 create mode 100644 _static/changelog-2024.2.0.png
 create mode 100644 changelog/2024.2.0.rst

diff --git a/_static/changelog-2024.2.0.png b/_static/changelog-2024.2.0.png
new file mode 100644
index 0000000000000000000000000000000000000000..b8544e42f2c1c409bb196a66eb358d7df3724a7e
GIT binary patch
literal 74547
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
HV-oydo-L*b

literal 0
HcmV?d00001

diff --git a/changelog/2024.2.0.rst b/changelog/2024.2.0.rst
new file mode 100644
index 000000000..7d5392702
--- /dev/null
+++ b/changelog/2024.2.0.rst
@@ -0,0 +1,199 @@
+ESPHome 2024.2.0 - 21st February 2024
+=====================================
+
+.. seo::
+    :description: Changelog for ESPHome 2024.2.0.
+    :image: /_static/changelog-2024.2.0.png
+    :author: Jesse Hills
+    :author_twitter: @jesserockz
+
+.. imgtable::
+    :columns: 4
+
+    micro Wake Word, components/micro_wake_word, voice-assistant.svg, dark-invert
+    AS5600, components/sensor/as5600, as5600.jpg
+    ST7567, components/display/st7567, st7567.jpg
+    BME280 SPI, components/sensor/bme280, bme280.jpg
+    VEML3235, components/sensor/veml3235, veml3235.jpg
+    Honeywell HIH I2C, components/sensor/honeywell_hih_i2c, honeywellhih.jpg
+    Combination, components/sensor/combination, function.svg, dark-invert
+
+
+Full list of changes
+--------------------
+
+New Components
+^^^^^^^^^^^^^^
+
+- feat: add AS5600 component/sensor :esphomepr:`5174` by :ghuser:`ammmze` (new-integration)
+- Support for ST7567 display 128x64 (I2C, SPI) :esphomepr:`5952` by :ghuser:`latonita` (new-integration)
+- BME280 SPI :esphomepr:`5538` by :ghuser:`apbodrov` (new-integration) (breaking-change)
+- Add support for VEML3235 lux sensor :esphomepr:`5959` by :ghuser:`kbx81` (new-integration)
+- Add support of Honeywell HumidIcon (I2C HIH series) Temperature & Humidity sensor :esphomepr:`5730` by :ghuser:`Benichou34` (new-integration)
+- Add combination sensor and remove absorbed kalman_combinator component :esphomepr:`5438` by :ghuser:`kahrendt` (new-integration) (breaking-change)
+- Add micro_wake_word component :esphomepr:`6136` by :ghuser:`kahrendt` (new-integration)
+
+Breaking Changes
+^^^^^^^^^^^^^^^^
+
+- PMSx003 add relevant device and state classes to default config :esphomepr:`5633` by :ghuser:`wheimbigner` (breaking-change)
+- BME280 SPI :esphomepr:`5538` by :ghuser:`apbodrov` (new-integration) (breaking-change)
+- convert cse7766 to non-polling :esphomepr:`6095` by :ghuser:`ssieb` (breaking-change)
+- Add combination sensor and remove absorbed kalman_combinator component :esphomepr:`5438` by :ghuser:`kahrendt` (new-integration) (breaking-change)
+
+All changes
+^^^^^^^^^^^
+
+- Bump esptool from 4.6.2 to 4.7.0 :esphomepr:`5935` by :ghuser:`dependabot[bot]`
+- Bump actions/download-artifact from 3.0.2 to 4.0.0 :esphomepr:`5936` by :ghuser:`dependabot[bot]`
+- Bump build-image action versions :esphomepr:`5954` by :ghuser:`jesserockz`
+- Revert "Bump build-image action versions" :esphomepr:`5955` by :ghuser:`jesserockz`
+- Revert "Bump actions/download-artifact from 3.0.2 to 4.0.0" :esphomepr:`5956` by :ghuser:`jesserockz`
+- Bump zeroconf from 0.130.0 to 0.131.0 :esphomepr:`5967` by :ghuser:`dependabot[bot]`
+- Add ability to lock to set mode :esphomepr:`5924` by :ghuser:`ysmilda`
+- feat: add AS5600 component/sensor :esphomepr:`5174` by :ghuser:`ammmze` (new-integration)
+- Add default substitutions for package includes :esphomepr:`5752` by :ghuser:`mknjc`
+- Add gradient option to addressable color wipe effect :esphomepr:`5689` by :ghuser:`lifeisafractal`
+- Added alarm processing for Haier component (hOn protocol) :esphomepr:`5965` by :ghuser:`paveldn`
+- Allow haier remote protocol to use lambdas :esphomepr:`5898` by :ghuser:`catlee`
+- PMSx003 add relevant device and state classes to default config :esphomepr:`5633` by :ghuser:`wheimbigner` (breaking-change)
+- Add waveshare 2.7in V2 model :esphomepr:`5903` by :ghuser:`gumulka`
+- Add support for waveshare 2.9in B V3 version :esphomepr:`5902` by :ghuser:`gumulka`
+- Fix pin reuse in test1 :esphomepr:`5978` by :ghuser:`jesserockz`
+- Add Waveshare 1.47in 172x320 to ST7789v component  :esphomepr:`5884` by :ghuser:`mrtoy-me`
+- (fingerprint_grow) Added on_finger_scan_invalid automation. :esphomepr:`5885` by :ghuser:`RubenNL`
+- Alarm panel: Add changes to support enhanced features :esphomepr:`5671` by :ghuser:`hwstar`
+- support default pins for adafruit esp32 feather v2 :esphomepr:`5482` by :ghuser:`sbrudenell`
+- Bug: Unwanted change resistance in x9c component :esphomepr:`5483` by :ghuser:`fizista`
+- Improvements to RF receiver for Drayton Digistat heating controller  :esphomepr:`5504` by :ghuser:`marshn`
+- Reduce memory usage with StringRef in MQTT Components :esphomepr:`5719` by :ghuser:`kahrendt`
+- Nextion allow underscore on names :esphomepr:`5979` by :ghuser:`edwardtfn`
+- Add Keeloq RF protocol :esphomepr:`5511` by :ghuser:`marshn`
+- Add a Binary Sensor Filter for state settling :esphomepr:`5900` by :ghuser:`cottsay`
+- Lint the script folder files :esphomepr:`5991` by :ghuser:`jesserockz`
+- web_server support for home assistant like styling :esphomepr:`5854` by :ghuser:`afarago`
+- [Touchscreen] Add expire of touch record. :esphomepr:`5986` by :ghuser:`Fabian-Schmidt`
+- Support for ST7567 display 128x64 (I2C, SPI) :esphomepr:`5952` by :ghuser:`latonita` (new-integration)
+- Add constants used by multiple display drivers to global const.py :esphomepr:`6033` by :ghuser:`clydebarrow`
+- Nextion queue size :esphomepr:`6029` by :ghuser:`edwardtfn`
+- Ble client additions and fixes :esphomepr:`5277` by :ghuser:`clydebarrow`
+- HaierProtocol library updated to 0.9.25 to fix the answer_timeout bug :esphomepr:`6015` by :ghuser:`paveldn`
+- GT911 touchscreen: Fix bug causing touch button release to fail :esphomepr:`6042` by :ghuser:`clydebarrow`
+- Display: Introduce `draw_pixels_at()` method for fast block display rendering :esphomepr:`6034` by :ghuser:`clydebarrow`
+- clang-format and clang-tidy scripts: More robust algorithm to find correct executable :esphomepr:`6041` by :ghuser:`clydebarrow`
+- Don't crash with invalid adc pin :esphomepr:`6059` by :ghuser:`ssieb`
+- Add questionmark to default glyphs. :esphomepr:`6053` by :ghuser:`RubenNL`
+- pylontech: fix voltage_low and voltage_high wrong unit :esphomepr:`6060` by :ghuser:`functionpointer`
+- Bump flake8 from 6.1.0 to 7.0.0 :esphomepr:`6058` by :ghuser:`dependabot[bot]`
+- Nextion enable upload from https when using esp-idf :esphomepr:`6051` by :ghuser:`edwardtfn`
+- Extends UART change at runtime to ESP8266 :esphomepr:`6019` by :ghuser:`edwardtfn`
+- Nextion draw QR code at runtime :esphomepr:`6027` by :ghuser:`edwardtfn`
+- Extend i2s config options :esphomepr:`6056` by :ghuser:`Hadatko`
+- Add getter for image data_start :esphomepr:`6036` by :ghuser:`clydebarrow`
+- Bump hypothesis to 6.92.1 :esphomepr:`6011` by :ghuser:`bdraco`
+- Bump recommended ESP32 IDF to 4.4.6 :esphomepr:`6048` by :ghuser:`bdraco`
+- Bump pytest from 7.4.3 to 7.4.4 :esphomepr:`6046` by :ghuser:`dependabot[bot]`
+- dashboard: refactor ping implementation to be more efficient :esphomepr:`6002` by :ghuser:`bdraco`
+- Bump pytest-asyncio from 0.23.2 to 0.23.3 :esphomepr:`6047` by :ghuser:`dependabot[bot]`
+- Bump black from 23.12.0 to 23.12.1 :esphomepr:`6018` by :ghuser:`dependabot[bot]`
+- Run python tests on windows and macos :esphomepr:`6010` by :ghuser:`bdraco`
+- BME280 SPI :esphomepr:`5538` by :ghuser:`apbodrov` (new-integration) (breaking-change)
+- Actions to enable and disable WireGuard connection :esphomepr:`5690` by :ghuser:`droscy`
+- hydreon_rgxx - fix missing cg.add(var.set_model(...)) :esphomepr:`6065` by :ghuser:`mrtoy-me`
+- Bump pillow to 10.2.0. :esphomepr:`6091` by :ghuser:`pfrenssen`
+- convert cse7766 to non-polling :esphomepr:`6095` by :ghuser:`ssieb` (breaking-change)
+- Use touch state from ft63x6 driver. :esphomepr:`6055` by :ghuser:`nielsnl68`
+- update script/setup so it works fine on windows  :esphomepr:`6087` by :ghuser:`nielsnl68`
+- add Pico-ResTouch-LCD-3.5 :esphomepr:`6078` by :ghuser:`nielsnl68`
+- Revert "add Pico-ResTouch-LCD-3.5" :esphomepr:`6098` by :ghuser:`nielsnl68`
+- Add triangle shapes to display component :esphomepr:`6096` by :ghuser:`mathieu-mp`
+- Fingerprint_grow: Trigger on finger scan start and on finger scan misplaced :esphomepr:`6003` by :ghuser:`alexborro`
+- Add continuous option to the graph :esphomepr:`6093` by :ghuser:`ssieb`
+- Add NFC binary sensor platform :esphomepr:`6068` by :ghuser:`kbx81`
+- Socket: Add recvfrom method to receive UDP with source address. :esphomepr:`6103` by :ghuser:`clydebarrow`
+- Add support for VEML3235 lux sensor :esphomepr:`5959` by :ghuser:`kbx81` (new-integration)
+- CV: tidy up Schema wrapper :esphomepr:`6105` by :ghuser:`jesserockz`
+- Add support X.509 client certificates for MQTT. :esphomepr:`5778` by :ghuser:`h2zero`
+- Fix color observation for triangle outline in display component :esphomepr:`6107` by :ghuser:`mathieu-mp`
+- Add support of Honeywell HumidIcon (I2C HIH series) Temperature & Humidity sensor :esphomepr:`5730` by :ghuser:`Benichou34` (new-integration)
+- Proposal: Test yaml for each component :esphomepr:`5398` by :ghuser:`Fabian-Schmidt`
+- WiFi fast_connect: save/load BSSID and channel for faster connect from sleep :esphomepr:`5931` by :ghuser:`rguca`
+- Fixes Waveshare 7.5in B V2 and V3 :esphomepr:`6079` by :ghuser:`Pofilo`
+- Add combination sensor and remove absorbed kalman_combinator component :esphomepr:`5438` by :ghuser:`kahrendt` (new-integration) (breaking-change)
+- Bump platformio from 6.1.11 to 6.1.13 :esphomepr:`6086` by :ghuser:`dependabot[bot]`
+- Bump actions/cache from 3.3.2 to 4.0.0 :esphomepr:`6110` by :ghuser:`dependabot[bot]`
+- Enable networking and some other components on host platform :esphomepr:`6114` by :ghuser:`clydebarrow`
+- Fix time component for host platform :esphomepr:`6118` by :ghuser:`clydebarrow`
+- Add quad spi features :esphomepr:`5925` by :ghuser:`clydebarrow`
+- add AM2120 device type :esphomepr:`6115` by :ghuser:`alexbuit`
+- Add support for Waveshare EPD 2.13" V3 :esphomepr:`5363` by :ghuser:`clydebarrow`
+- OTA 2 which confirm each written chunk :esphomepr:`6066` by :ghuser:`tomaszduda23`
+- Remove optional<> for pointer types :esphomepr:`6120` by :ghuser:`kroimon`
+- Improve temperature precision in BME280 and BMP280 :esphomepr:`6124` by :ghuser:`jxl77`
+- Nextion TFT upload IDF memory optimization :esphomepr:`6128` by :ghuser:`edwardtfn`
+- Add support for Pico-ResTouch-LCD-3.5 to ili9xxx driver :esphomepr:`6129` by :ghuser:`clydebarrow`
+- Ensure filename is shown when YAML raises an error :esphomepr:`6139` by :ghuser:`bdraco`
+- ILI9XXX: Restore offset usage in set_addr_window :esphomepr:`6147` by :ghuser:`clydebarrow`
+- Minimum 1 for full_update_every to prevent IntegerDivideByZero. :esphomepr:`6150` by :ghuser:`RubenNL`
+- Support tri-color waveshare eink displays 2.7inch B and B V2 :esphomepr:`4238` by :ghuser:`rnauber`
+- Synchronise Device Classes from Home Assistant :esphomepr:`6158` by :ghuser:`esphomebot`
+- dfrobot_sen0395: Use setLatency instead of outputLatency :esphomepr:`5665` by :ghuser:`jfroy`
+- Add some components to the new testing framework (A part 1) :esphomepr:`6142` by :ghuser:`kbx81`
+- WRGB or RGBW? WS2814 :esphomepr:`6164` by :ghuser:`mhetzi`
+- Add some components to the new testing framework (A part 2) :esphomepr:`6162` by :ghuser:`kbx81`
+- Bump aioesphomeapi to 21.0.2 :esphomepr:`6188` by :ghuser:`bdraco`
+- Add some components to the new testing framework (B) :esphomepr:`6173` by :ghuser:`kbx81`
+- Add "transformer_active" flag for use in effects. :esphomepr:`6157` by :ghuser:`TikiBill`
+- CSE7766: fix power and current measurements at low loads :esphomepr:`6180` by :ghuser:`twasilczyk`
+- host platform: improvements and bugfixes :esphomepr:`6137` by :ghuser:`clydebarrow`
+- WLED Sync fix and BK72XX support :esphomepr:`6190` by :ghuser:`ChuckMash`
+- Add missing vector.h for lightwaverf :esphomepr:`6196` by :ghuser:`kbx81`
+- Add some components to the new testing framework (C) :esphomepr:`6174` by :ghuser:`kbx81`
+- update docstrings in cpp_generator.py :esphomepr:`6212` by :ghuser:`nielsnl68`
+- Fixed group mask logic for WLED Sync fix :esphomepr:`6193` by :ghuser:`ChuckMash`
+- Add micro_wake_word component :esphomepr:`6136` by :ghuser:`kahrendt` (new-integration)
+
+Past Changelogs
+---------------
+
+- :doc:`2023.12.0`
+- :doc:`2023.11.0`
+- :doc:`2023.10.0`
+- :doc:`2023.9.0`
+- :doc:`2023.8.0`
+- :doc:`2023.7.0`
+- :doc:`2023.6.0`
+- :doc:`2023.5.0`
+- :doc:`2023.4.0`
+- :doc:`2023.3.0`
+- :doc:`2023.2.0`
+- :doc:`2022.12.0`
+- :doc:`2022.11.0`
+- :doc:`2022.10.0`
+- :doc:`2022.9.0`
+- :doc:`2022.8.0`
+- :doc:`2022.6.0`
+- :doc:`2022.5.0`
+- :doc:`2022.4.0`
+- :doc:`2022.3.0`
+- :doc:`2022.2.0`
+- :doc:`2022.1.0`
+- :doc:`2021.12.0`
+- :doc:`2021.11.0`
+- :doc:`2021.10.0`
+- :doc:`2021.9.0`
+- :doc:`2021.8.0`
+- :doc:`v1.20.0`
+- :doc:`v1.19.0`
+- :doc:`v1.18.0`
+- :doc:`v1.17.0`
+- :doc:`v1.16.0`
+- :doc:`v1.15.0`
+- :doc:`v1.14.0`
+- :doc:`v1.13.0`
+- :doc:`v1.12.0`
+- :doc:`v1.11.0`
+- :doc:`v1.10.0`
+- :doc:`v1.9.0`
+- :doc:`v1.8.0`
+- :doc:`v1.7.0`
diff --git a/changelog/index.rst b/changelog/index.rst
index 6549def71..f5beccf61 100644
--- a/changelog/index.rst
+++ b/changelog/index.rst
@@ -2,7 +2,7 @@ Changelog
 =========
 
 .. redirect::
-    :url: /changelog/2023.12.0.html
+    :url: /changelog/2024.2.0.html
 
 .. toctree::
     :glob:
diff --git a/index.rst b/index.rst
index ec3967c43..73b9ee187 100644
--- a/index.rst
+++ b/index.rst
@@ -385,7 +385,7 @@ Miscellaneous
     AS3935, components/sensor/as3935, as3935.jpg, Storm lightning
     Binary Sensor Map, components/sensor/binary_sensor_map, binary_sensor_map.jpg, Map binary to value
     b-parasite, components/sensor/b_parasite, b_parasite.jpg, Moisture & Temperature & Humidity & Light
-    Combination, components/sensor/combination, function.svg, dark-invert    
+    Combination, components/sensor/combination, function.svg, dark-invert
     Duty Time, components/sensor/duty_time, timer-play-outline.svg, dark-invert
     EZO sensor circuits, components/sensor/ezo, ezo-ph-circuit.png, (pH)
     FS3000, components/sensor/fs3000, fs3000.jpg, Air velocity
@@ -658,7 +658,7 @@ Display Components
     ILI9486, components/display/ili9xxx, ili9341.jpg
     ILI9488, components/display/ili9xxx, ili9488.svg
     WSPICOLCD, components/display/ili9xxx, ili9488.svg
-    
+
     Inkplate, components/display/inkplate6, inkplate6.jpg
     LCD Display, components/display/lcd_display, lcd.jpg
     MAX7219, components/display/max7219, max7219.jpg
@@ -694,7 +694,7 @@ Touchscreen Components
     XPT2046, components/touchscreen/xpt2046, xpt2046.jpg
     GT911, components/touchscreen/gt911, esp32_s3_box_3.png
     FT63X6, components/touchscreen/ft63x6, wt32-sc01.png
-    
+
 Cover Components
 ----------------
 
@@ -830,10 +830,12 @@ Home Assistant Companion Components
 
     Bluetooth Proxy, components/bluetooth_proxy, bluetooth.svg, dark-invert
     Voice Assistant, components/voice_assistant, voice-assistant.svg, dark-invert
+    micro Wake Word, components/micro_wake_word, voice-assistant.svg, dark-invert
     Sensor, components/sensor/homeassistant, home-assistant.svg, dark-invert
     Text Sensor, components/text_sensor/homeassistant, home-assistant.svg, dark-invert
     Binary Sensor, components/binary_sensor/homeassistant, home-assistant.svg, dark-invert
 
+
 Alarm Control Panel Components
 ------------------------------
 

From 3cdefb23fe64703d576f2680b3b91777a8b01387 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Tue, 13 Feb 2024 10:10:27 +1300
Subject: [PATCH 03/19] Update supporters for 2024.2.0b1

---
 guides/supporters.rst | 76 +++++++++++++++++++++++++------------------
 1 file changed, 44 insertions(+), 32 deletions(-)

diff --git a/guides/supporters.rst b/guides/supporters.rst
index 1268eab7d..b5b2707c8 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -30,7 +30,7 @@ Contributors
 - `Alessandro Campolo (@a13ssandr0) <https://github.com/a13ssandr0>`__
 - `Aalian Khan (@AalianKhan) <https://github.com/AalianKhan>`__
 - `Adam Liddell (@aaliddell) <https://github.com/aaliddell>`__
-- `Aapeli (@aapeliv) <https://github.com/aapeliv>`__
+- `Aapeli Vuorinen (@aapeliv) <https://github.com/aapeliv>`__
 - `Aaron Gamble (@aarongamble) <https://github.com/aarongamble>`__
 - `Aaron S. Jackson (@AaronJackson) <https://github.com/AaronJackson>`__
 - `Abel Matser (@abelmatser) <https://github.com/abelmatser>`__
@@ -73,7 +73,7 @@ Contributors
 - `Alexandre Danault (@AlexDanault) <https://github.com/AlexDanault>`__
 - `Alex Iribarren (@alexiri) <https://github.com/alexiri>`__
 - `Alex Mekkering (@AlexMekkering) <https://github.com/AlexMekkering>`__
-- `Alex Yao (@alexyao2015) <https://github.com/alexyao2015>`__
+- `Alex (@alexyao2015) <https://github.com/alexyao2015>`__
 - `Alfredo (@alfredopironti) <https://github.com/alfredopironti>`__
 - `Alibloke (@Alibloke) <https://github.com/Alibloke>`__
 - `Alessandro Ranellucci (@alranel) <https://github.com/alranel>`__
@@ -94,12 +94,12 @@ Contributors
 - `Andreas Hergert (@andreashergert1984) <https://github.com/andreashergert1984>`__
 - `Andrew J.Swan (@andrewjswan) <https://github.com/andrewjswan>`__
 - `andrewpc (@andrewpc) <https://github.com/andrewpc>`__
-- `Andrew Y. (@andrey-yantsen) <https://github.com/andrey-yantsen>`__
+- `Andrey Yantsen (@andrey-yantsen) <https://github.com/andrey-yantsen>`__
 - `Andrzej (@andriej) <https://github.com/andriej>`__
 - `Andreas (@anduchs) <https://github.com/anduchs>`__
 - `Andy2No (@Andy2No) <https://github.com/Andy2No>`__
 - `AndyRPH (@AndyRPH) <https://github.com/AndyRPH>`__
-- `Angel Nunez Mencias (@angelnu) <https://github.com/angelnu>`__
+- `Vegetto (@angelnu) <https://github.com/angelnu>`__
 - `Sergey Anisimov (@anisimovsergey) <https://github.com/anisimovsergey>`__
 - `Nikolay Vasilchuk (@Anonym-tsk) <https://github.com/Anonym-tsk>`__
 - `Anthony Keane (@anthonykeane) <https://github.com/anthonykeane>`__
@@ -129,13 +129,13 @@ Contributors
 - `Alexander Turlov (@aturlov) <https://github.com/aturlov>`__
 - `aus (@aus) <https://github.com/aus>`__
 - `AustinMorris (@AustinMorris) <https://github.com/AustinMorris>`__
-- `Denis Demchenko (@Avirsaam) <https://github.com/Avirsaam>`__
+- `Avirsaam (@Avirsaam) <https://github.com/Avirsaam>`__
 - `Arsène von Wyss (@avonwyss) <https://github.com/avonwyss>`__
 - `Andrew Weddle (@aweddle2) <https://github.com/aweddle2>`__
 - `Alexis Iglauer (@ax42) <https://github.com/ax42>`__
 - `Achilleas Pipinellis (@axilleas) <https://github.com/axilleas>`__
 - `Kamil Trzciński (@ayufan) <https://github.com/ayufan>`__
-- `Azimath (@Azimath) <https://github.com/Azimath>`__
+- `Nicholas Peters (@Azimath) <https://github.com/Azimath>`__
 - `Daniel (@azrael783) <https://github.com/azrael783>`__
 - `B48D81EFCC (@B48D81EFCC) <https://github.com/B48D81EFCC>`__
 - `Florian Mösch (@badbadc0ffee) <https://github.com/badbadc0ffee>`__
@@ -150,7 +150,7 @@ Contributors
 - `Bascht74 (@Bascht74) <https://github.com/Bascht74>`__
 - `Viktr (@BbIKTOP) <https://github.com/BbIKTOP>`__
 - `J. Nick Koston (@bdraco) <https://github.com/bdraco>`__
-- `Maxym Ocheretianko (@bearpawmaxim) <https://github.com/bearpawmaxim>`__
+- `Maxim Ocheretianko (@bearpawmaxim) <https://github.com/bearpawmaxim>`__
 - `beaudeanadams (@beaudeanadams) <https://github.com/beaudeanadams>`__
 - `Benjamin Freeman (@Beetix) <https://github.com/Beetix>`__
 - `beikeland (@beikeland) <https://github.com/beikeland>`__
@@ -175,7 +175,7 @@ Contributors
 - `Bert Hertogen (@berthertogen) <https://github.com/berthertogen>`__
 - `Brandon (@bgulla) <https://github.com/bgulla>`__
 - `Benedikt Hübschen (@bhuebschen) <https://github.com/bhuebschen>`__
-- `Stef (@Bierchermuesli) <https://github.com/Bierchermuesli>`__
+- `Bierchermuesli (@Bierchermuesli) <https://github.com/Bierchermuesli>`__
 - `bigwoof (@bigwoof) <https://github.com/bigwoof>`__
 - `Bill Church (@billchurch) <https://github.com/billchurch>`__
 - `Brian Kaufman (@bkaufx) <https://github.com/bkaufx>`__
@@ -197,7 +197,7 @@ Contributors
 - `Casey Olson (@bookcasey) <https://github.com/bookcasey>`__
 - `Borja Burgos (@borjaburgos) <https://github.com/borjaburgos>`__
 - `Brian Orpin (@borpin) <https://github.com/borpin>`__
-- `bouhaa (@BoukeHaarsma23) <https://github.com/BoukeHaarsma23>`__
+- `BoukeHaarsma23 (@BoukeHaarsma23) <https://github.com/BoukeHaarsma23>`__
 - `brabl2 (@brabl2) <https://github.com/brabl2>`__
 - `brainiac27 (@brainiac27) <https://github.com/brainiac27>`__
 - `brambo123 (@brambo123) <https://github.com/brambo123>`__
@@ -254,6 +254,7 @@ Contributors
 - `Chris (@chrismaki) <https://github.com/chrismaki>`__
 - `Christoph Wagner (@Christoph-Wagner) <https://github.com/Christoph-Wagner>`__
 - `Christian Taedcke (@chrta) <https://github.com/chrta>`__
+- `ChuckMash (@ChuckMash) <https://github.com/ChuckMash>`__
 - `Pavel Skuratovich (@Chupaka) <https://github.com/Chupaka>`__
 - `Chris Johnson (@ciband) <https://github.com/ciband>`__
 - `CircuitGuy (@CircuitGuy) <https://github.com/CircuitGuy>`__
@@ -393,7 +394,7 @@ Contributors
 - `dr-oblivium (@dr-oblivium) <https://github.com/dr-oblivium>`__
 - `Jean  Louis-Guerin (@DrCoolzic) <https://github.com/DrCoolzic>`__
 - `Drew Perttula (@drewp) <https://github.com/drewp>`__
-- `Angel G (@drmodding) <https://github.com/drmodding>`__
+- `drmodding (@drmodding) <https://github.com/drmodding>`__
 - `drmpf (@drmpf) <https://github.com/drmpf>`__
 - `drogfild (@drogfild) <https://github.com/drogfild>`__
 - `Simone Rossetto (@droscy) <https://github.com/droscy>`__
@@ -404,7 +405,7 @@ Contributors
 - `Tom Soer (@dtx3k) <https://github.com/dtx3k>`__
 - `dubit0 (@dubit0) <https://github.com/dubit0>`__
 - `Mikkel Jeppesen (@Duckle29) <https://github.com/Duckle29>`__
-- `Sergey Dudanov (@dudanov) <https://github.com/dudanov>`__
+- `Sergey V. DUDANOV (@dudanov) <https://github.com/dudanov>`__
 - `David Girón (@duhow) <https://github.com/duhow>`__
 - `Duncan Findlay (@duncf) <https://github.com/duncf>`__
 - `David van der Leij (@dvanderleij) <https://github.com/dvanderleij>`__
@@ -425,7 +426,7 @@ Contributors
 - `Eli Fidler (@efidler) <https://github.com/efidler>`__
 - `egandro (@egandro) <https://github.com/egandro>`__
 - `Erwin Kooi (@egeltje) <https://github.com/egeltje>`__
-- `Egglestron (@Egglestron) <https://github.com/Egglestron>`__
+- `Maxime Michel (@Egglestron) <https://github.com/Egglestron>`__
 - `Eike (@ei-ke) <https://github.com/ei-ke>`__
 - `Elazar Leibovich (@elazarl) <https://github.com/elazarl>`__
 - `Eli (@eli-xciv) <https://github.com/eli-xciv>`__
@@ -459,6 +460,7 @@ Contributors
 - `Evan Coleman (@evandcoleman) <https://github.com/evandcoleman>`__
 - `Clemens Kirchgatterer (@everslick) <https://github.com/everslick>`__
 - `Evgeni Golov (@evgeni) <https://github.com/evgeni>`__
+- `evlo (@evlo) <https://github.com/evlo>`__
 - `Expaso (@Expaso) <https://github.com/Expaso>`__
 - `Malte Franken (@exxamalte) <https://github.com/exxamalte>`__
 - `f0rdprefect (@f0rdprefect) <https://github.com/f0rdprefect>`__
@@ -485,6 +487,7 @@ Contributors
 - `Clemens (@firegore) <https://github.com/firegore>`__
 - `Fredrik Jansson (@fjansson) <https://github.com/fjansson>`__
 - `Frédéric Jouault (@fjouault) <https://github.com/fjouault>`__
+- `FL42 (@fl42) <https://github.com/fl42>`__
 - `Sean Vig (@flacjacket) <https://github.com/flacjacket>`__
 - `Diego Elio Pettenò (@Flameeyes) <https://github.com/Flameeyes>`__
 - `Flaviu Tamas (@flaviut) <https://github.com/flaviut>`__
@@ -492,6 +495,7 @@ Contributors
 - `fluffymonster (@fluffymonster) <https://github.com/fluffymonster>`__
 - `flyize (@flyize) <https://github.com/flyize>`__
 - `风飘雨 (@flyrainning) <https://github.com/flyrainning>`__
+- `foltymat (@foltymat) <https://github.com/foltymat>`__
 - `Fabio Pugliese Ornellas (@fornellas) <https://github.com/fornellas>`__
 - `Fractal147 (@Fractal147) <https://github.com/Fractal147>`__
 - `Francis-labo (@Francis-labo) <https://github.com/Francis-labo>`__
@@ -572,6 +576,7 @@ Contributors
 - `Peter van Dijk (@Habbie) <https://github.com/Habbie>`__
 - `Dusan Cervenka (@Hadatko) <https://github.com/Hadatko>`__
 - `Hagai Shatz (@hagai-shatz) <https://github.com/hagai-shatz>`__
+- `hajar97 (@hajar97) <https://github.com/hajar97>`__
 - `Boris Hajduk (@hajdbo) <https://github.com/hajdbo>`__
 - `Gavin Mogan (@halkeye) <https://github.com/halkeye>`__
 - `Charles (@hallard) <https://github.com/hallard>`__
@@ -586,7 +591,7 @@ Contributors
 - `Jimmy Hedman (@HeMan) <https://github.com/HeMan>`__
 - `Hemi03 (@Hemi03) <https://github.com/Hemi03>`__
 - `HengYongChao (@HengYongChao) <https://github.com/HengYongChao>`__
-- `Andrei Solodovnikov (@HepoH3) <https://github.com/HepoH3>`__
+- `HepoH3 (@HepoH3) <https://github.com/HepoH3>`__
 - `Hermann Kraus (@herm) <https://github.com/herm>`__
 - `Herr Frei (@herrfrei) <https://github.com/herrfrei>`__
 - `highground88 (@highground88) <https://github.com/highground88>`__
@@ -609,7 +614,7 @@ Contributors
 - `Adrián Panella (@ianchi) <https://github.com/ianchi>`__
 - `Ian Anderson (@ianderso) <https://github.com/ianderso>`__
 - `Ian Leeder (@ianleeder) <https://github.com/ianleeder>`__
-- `Honza Pobořil (@iBobik) <https://github.com/iBobik>`__
+- `Jan Pobořil (@iBobik) <https://github.com/iBobik>`__
 - `igg (@igg) <https://github.com/igg>`__
 - `Ignacio Hernandez-Ros (@IgnacioHR) <https://github.com/IgnacioHR>`__
 - `Ivan Grokhotkov (@igrr) <https://github.com/igrr>`__
@@ -619,7 +624,6 @@ Contributors
 - `ilium007 (@ilium007) <https://github.com/ilium007>`__
 - `Iman Ahmadvand (@IMAN4K) <https://github.com/IMAN4K>`__
 - `imgbot[bot] (@imgbot[bot]) <https://github.com/imgbot[bot]>`__
-- `ImSorryButWho (@ImSorryButWho) <https://github.com/ImSorryButWho>`__
 - `imwoo90 (@imwoo90) <https://github.com/imwoo90>`__
 - `Dom (@Ing-Dom) <https://github.com/Ing-Dom>`__
 - `Ingo Becker (@ingobecker) <https://github.com/ingobecker>`__
@@ -666,6 +670,7 @@ Contributors
 - `jimtng (@jimtng) <https://github.com/jimtng>`__
 - `jivesinger (@jivesinger) <https://github.com/jivesinger>`__
 - `jj-uk (@jj-uk) <https://github.com/jj-uk>`__
+- `Jean J. de Jong (@jjdejong) <https://github.com/jjdejong>`__
 - `John K. Luebs (@jkl1337) <https://github.com/jkl1337>`__
 - `Jeppe Ladefoged (@jladefoged) <https://github.com/jladefoged>`__
 - `Jean-Luc Béchennec (@jlbirccyn) <https://github.com/jlbirccyn>`__
@@ -690,11 +695,12 @@ Contributors
 - `Joris S (@Jorre05) <https://github.com/Jorre05>`__
 - `Jared Sanson (@jorticus) <https://github.com/jorticus>`__
 - `JosephTang (@JosephTang) <https://github.com/JosephTang>`__
+- `Joshua Baran  (@joshbaran) <https://github.com/joshbaran>`__
 - `Joshua Spence (@joshuaspence) <https://github.com/joshuaspence>`__
 - `joskfg (@joskfg) <https://github.com/joskfg>`__
 - `Joscha Wagner (@jowgn) <https://github.com/jowgn>`__
 - `Javier Peletier (@jpeletier) <https://github.com/jpeletier>`__
-- `Jos Suanet (@jsuanet) <https://github.com/jsuanet>`__
+- `jsuanet (@jsuanet) <https://github.com/jsuanet>`__
 - `James Szalay (@jtszalay) <https://github.com/jtszalay>`__
 - `Jules-R (@Jules-R) <https://github.com/Jules-R>`__
 - `Julie Koubová (@juliekoubova) <https://github.com/juliekoubova>`__
@@ -732,7 +738,7 @@ Contributors
 - `Kevin P. Fleming (@kpfleming) <https://github.com/kpfleming>`__
 - `Karl Q. (@kquinsland) <https://github.com/kquinsland>`__
 - `Anandha Saravanan (@KratosMr) <https://github.com/KratosMr>`__
-- `Stefan Rado (@kroimon) <https://github.com/kroimon>`__
+- `kroimon (@kroimon) <https://github.com/kroimon>`__
 - `krunkel (@krunkel) <https://github.com/krunkel>`__
 - `kryptonitecb3 (@kryptonitecb3) <https://github.com/kryptonitecb3>`__
 - `Kendell R (@KTibow) <https://github.com/KTibow>`__
@@ -746,16 +752,17 @@ Contributors
 - `Anton Viktorov (@latonita) <https://github.com/latonita>`__
 - `Lawrie George (@lawriege) <https://github.com/lawriege>`__
 - `Ludovic BOUÉ (@lboue) <https://github.com/lboue>`__
-- `Luca Cavalli (@lcavalli) <https://github.com/lcavalli>`__
+- `lcavalli (@lcavalli) <https://github.com/lcavalli>`__
 - `Craig Fletcher (@leakypixel) <https://github.com/leakypixel>`__
 - `Dominik Wagenknecht (@LeDominik) <https://github.com/LeDominik>`__
 - `Benny de Leeuw (@leeuwte) <https://github.com/leeuwte>`__
+- `Thayne (@Legot) <https://github.com/Legot>`__
 - `Leonardo La Rocca (@leoli51) <https://github.com/leoli51>`__
 - `leoshusar (@leoshusar) <https://github.com/leoshusar>`__
 - `Leo Winter (@LeoWinterDE) <https://github.com/LeoWinterDE>`__
 - `Lubos Horacek (@lhoracek) <https://github.com/lhoracek>`__
 - `Liionboy (@Liionboy) <https://github.com/Liionboy>`__
-- `LiJu09 (@LiJu09) <https://github.com/LiJu09>`__
+- `Juraj Liso (@LiJu09) <https://github.com/LiJu09>`__
 - `Li Junru (@lijunru-hub) <https://github.com/lijunru-hub>`__
 - `lillborje71 (@lillborje71) <https://github.com/lillborje71>`__
 - `Caleb Pryor (@lilmansplace) <https://github.com/lilmansplace>`__
@@ -802,6 +809,7 @@ Contributors
 - `Ben Marengo (@marengaz) <https://github.com/marengaz>`__
 - `Marvin Gaube (@margau) <https://github.com/margau>`__
 - `maringeph (@maringeph) <https://github.com/maringeph>`__
+- `Mario Di Vece (@mariodivece) <https://github.com/mariodivece>`__
 - `Mark Hildreth (@markhildreth) <https://github.com/markhildreth>`__
 - `Mark Schabacker (@markschabacker) <https://github.com/markschabacker>`__
 - `marshn (@marshn) <https://github.com/marshn>`__
@@ -816,6 +824,7 @@ Contributors
 - `Mat931 (@Mat931) <https://github.com/Mat931>`__
 - `mathieu-mp (@mathieu-mp) <https://github.com/mathieu-mp>`__
 - `matikij (@matikij) <https://github.com/matikij>`__
+- `Matjah Sonneveld (@matjahs) <https://github.com/matjahs>`__
 - `Michel Marti (@matoxp) <https://github.com/matoxp>`__
 - `matt123p (@matt123p) <https://github.com/matt123p>`__
 - `matthias882 (@matthias882) <https://github.com/matthias882>`__
@@ -885,7 +894,6 @@ Contributors
 - `Martin Wetterwald (@mwetterw) <https://github.com/mwetterw>`__
 - `mwolter805 (@mwolter805) <https://github.com/mwolter805>`__
 - `myhomeiot (@myhomeiot) <https://github.com/myhomeiot>`__
-- `Igor Scheller (@MyIgel) <https://github.com/MyIgel>`__
 - `Mykle (@myklemykle) <https://github.com/myklemykle>`__
 - `Mynasru (@Mynasru) <https://github.com/Mynasru>`__
 - `Kevin Uhlir (@n0bel) <https://github.com/n0bel>`__
@@ -905,6 +913,7 @@ Contributors
 - `Nazar Mokrynskyi (@nazar-pc) <https://github.com/nazar-pc>`__
 - `Bergont Nicolas (@nbergont) <https://github.com/nbergont>`__
 - `neilger (@neilger) <https://github.com/neilger>`__
+- `Neil Martin (@neilmartin83) <https://github.com/neilmartin83>`__
 - `Nejc Koncan (@nejc-cc) <https://github.com/nejc-cc>`__
 - `Nerijus Baliūnas (@nerijus) <https://github.com/nerijus>`__
 - `Nicolas Graziano (@ngraziano) <https://github.com/ngraziano>`__
@@ -928,7 +937,6 @@ Contributors
 - `Greg Johnson (@notgwj) <https://github.com/notgwj>`__
 - `JJ (@notjj) <https://github.com/notjj>`__
 - `Geoffrey Mayo (@notmayo) <https://github.com/notmayo>`__
-- `notsonominal (@notsonominal) <https://github.com/notsonominal>`__
 - `nouser2013 (@nouser2013) <https://github.com/nouser2013>`__
 - `Paul Read (@nsolvepaul) <https://github.com/nsolvepaul>`__
 - `Nick (@ntompson) <https://github.com/ntompson>`__
@@ -944,7 +952,7 @@ Contributors
 - `Ockert Marais (@OckertM) <https://github.com/OckertM>`__
 - `Dave Walker (@oddsockmachine) <https://github.com/oddsockmachine>`__
 - `Odd Stråbø (@oddstr13) <https://github.com/oddstr13>`__
-- `Andrii Ganzevych (@odya) <https://github.com/odya>`__
+- `Andrey Ganzevich (@odya) <https://github.com/odya>`__
 - `ogatatsu (@ogatatsu) <https://github.com/ogatatsu>`__
 - `Oğuzhan Başer (@oguzhanbaser) <https://github.com/oguzhanbaser>`__
 - `Larry (@ojaksch) <https://github.com/ojaksch>`__
@@ -955,7 +963,7 @@ Contributors
 - `Onne (@onnlucky) <https://github.com/onnlucky>`__
 - `optimusprimespace (@optimusprimespace) <https://github.com/optimusprimespace>`__
 - `Oscar Bolmsten (@oscar-b) <https://github.com/oscar-b>`__
-- `Mauri (@Otamay) <https://github.com/Otamay>`__
+- `Otamay (@Otamay) <https://github.com/Otamay>`__
 - `Otto Winter (@OttoWinter) <https://github.com/OttoWinter>`__
 - `Maxime Dufour (@outscale-mdr) <https://github.com/outscale-mdr>`__
 - `Ben Owen (@owenb321) <https://github.com/owenb321>`__
@@ -1029,7 +1037,7 @@ Contributors
 - `RadekHvizdos (@RadekHvizdos) <https://github.com/RadekHvizdos>`__
 - `rafalstarczak (@rafalstarczak) <https://github.com/rafalstarczak>`__
 - `Florian Ragwitz (@rafl) <https://github.com/rafl>`__
-- `Ben Winslow (@raineth) <https://github.com/raineth>`__
+- `raineth (@raineth) <https://github.com/raineth>`__
 - `Ben V. Brown (@Ralim) <https://github.com/Ralim>`__
 - `Benjamin G. (@Randomblock1) <https://github.com/Randomblock1>`__
 - `randomllama (@randomllama) <https://github.com/randomllama>`__
@@ -1050,7 +1058,7 @@ Contributors
 - `Robert Gabrielson (@rgabrielson11) <https://github.com/rgabrielson11>`__
 - `Rafael Goes (@rgriffogoes) <https://github.com/rgriffogoes>`__
 - `rheinz (@rheinz) <https://github.com/rheinz>`__
-- `Richard Hopton (@richardhopton) <https://github.com/richardhopton>`__
+- `richardhopton (@richardhopton) <https://github.com/richardhopton>`__
 - `Richard Klingler (@richardklingler) <https://github.com/richardklingler>`__
 - `Richard Lewis (@richrd) <https://github.com/richrd>`__
 - `Rishab Mehta (@rishabmehta7) <https://github.com/rishabmehta7>`__
@@ -1062,6 +1070,7 @@ Contributors
 - `rnauber (@rnauber) <https://github.com/rnauber>`__
 - `Rob Deutsch (@rob-deutsch) <https://github.com/rob-deutsch>`__
 - `Robert Alfaro (@robert-alfaro) <https://github.com/robert-alfaro>`__
+- `Robert91911 (@Robert91911) <https://github.com/Robert91911>`__
 - `Robinson1999 (@Robinson1999) <https://github.com/Robinson1999>`__
 - `RoboMagus (@RoboMagus) <https://github.com/RoboMagus>`__
 - `Roeland Lutters (@Roeland54) <https://github.com/Roeland54>`__
@@ -1122,6 +1131,7 @@ Contributors
 - `signix (@signix) <https://github.com/signix>`__
 - `SiliconAvatar (@SiliconAvatar) <https://github.com/SiliconAvatar>`__
 - `Mark Lopez (@Silvenga) <https://github.com/Silvenga>`__
+- `James Chaloupka (@SirGoodenough) <https://github.com/SirGoodenough>`__
 - `Maximilian Ertl (@Sirs0ri) <https://github.com/Sirs0ri>`__
 - `Francisco J. Solis (@sisco0) <https://github.com/sisco0>`__
 - `Derek Hageman (@Sizurka) <https://github.com/Sizurka>`__
@@ -1152,7 +1162,7 @@ Contributors
 - `sticilface (@sticilface) <https://github.com/sticilface>`__
 - `Stijn Tintel (@stintel) <https://github.com/stintel>`__
 - `Mathias Stock (@Stock-M) <https://github.com/Stock-M>`__
-- `Daniel Jönsson (@Strixx76) <https://github.com/Strixx76>`__
+- `Strixx76 (@Strixx76) <https://github.com/Strixx76>`__
 - `stubs12 (@stubs12) <https://github.com/stubs12>`__
 - `sud33p (@sud33p) <https://github.com/sud33p>`__
 - `sumirati (@sumirati) <https://github.com/sumirati>`__
@@ -1206,8 +1216,9 @@ Contributors
 - `Thomas Langewouters (@thouters) <https://github.com/thouters>`__
 - `Transylvania High Tech (@thtro) <https://github.com/thtro>`__
 - `Thunderbiscuits (@Thunderbiscuits) <https://github.com/Thunderbiscuits>`__
-- `Tiago Freire (@tiagofreire-pt) <https://github.com/tiagofreire-pt>`__
+- `tiagofreire-pt (@tiagofreire-pt) <https://github.com/tiagofreire-pt>`__
 - `Tijs-B (@Tijs-B) <https://github.com/Tijs-B>`__
+- `Bill Adams (@TikiBill) <https://github.com/TikiBill>`__
 - `Tim Boldt (@timboldt) <https://github.com/timboldt>`__
 - `Tim Laurence (@timdaman) <https://github.com/timdaman>`__
 - `Aidan Timson (@timmo001) <https://github.com/timmo001>`__
@@ -1216,7 +1227,7 @@ Contributors
 - `Tinkerfish (@tinkerfish) <https://github.com/tinkerfish>`__
 - `TJ Horner (@tjhorner) <https://github.com/tjhorner>`__
 - `Christian (@Tntdruid) <https://github.com/Tntdruid>`__
-- `Philipp Riederer (@toelke) <https://github.com/toelke>`__
+- `Philipp Tölke (@toelke) <https://github.com/toelke>`__
 - `tomaszduda23 (@tomaszduda23) <https://github.com/tomaszduda23>`__
 - `Tom Brien (@TomBrien) <https://github.com/TomBrien>`__
 - `Thomas Combriat (@tomcombriat) <https://github.com/tomcombriat>`__
@@ -1229,7 +1240,7 @@ Contributors
 - `Aleksandra M (@tort32) <https://github.com/tort32>`__
 - `tracestep (@tracestep) <https://github.com/tracestep>`__
 - `Trent Houliston (@TrentHouliston) <https://github.com/TrentHouliston>`__
-- `Felix E (@tribut) <https://github.com/tribut>`__
+- `Felix Eckhofer (@tribut) <https://github.com/tribut>`__
 - `Trick van Staveren (@trickv) <https://github.com/trickv>`__
 - `TripitakaBC (@TripitakaBC) <https://github.com/TripitakaBC>`__
 - `Tobias (@tripplet) <https://github.com/tripplet>`__
@@ -1255,6 +1266,7 @@ Contributors
 - `Vlad Yarotsky (@v-yarotsky) <https://github.com/v-yarotsky>`__
 - `Vc (@Valcob) <https://github.com/Valcob>`__
 - `Nad (@valordk) <https://github.com/valordk>`__
+- `Vicent Climent (@vcliment89) <https://github.com/vcliment89>`__
 - `Veli Veromann (@velijv) <https://github.com/velijv>`__
 - `André Lademann (@vergissberlin) <https://github.com/vergissberlin>`__
 - `Austin (@vidplace7) <https://github.com/vidplace7>`__
@@ -1279,7 +1291,7 @@ Contributors
 - `whimsee (@whimsee) <https://github.com/whimsee>`__
 - `wifwucite (@wifwucite) <https://github.com/wifwucite>`__
 - `wilberforce (@wilberforce) <https://github.com/wilberforce>`__
-- `Willem Vooijs (@wildekek) <https://github.com/wildekek>`__
+- `wildekek (@wildekek) <https://github.com/wildekek>`__
 - `Wingman3434 (@Wingman3434) <https://github.com/Wingman3434>`__
 - `Emil Hesslow (@WizKid) <https://github.com/WizKid>`__
 - `WJCarpenter (@wjcarpenter) <https://github.com/wjcarpenter>`__
@@ -1298,7 +1310,7 @@ Contributors
 - `Xose Pérez (@xoseperez) <https://github.com/xoseperez>`__
 - `WitchKing (@xvil) <https://github.com/xvil>`__
 - `Andrew Kroll (@xxxajk) <https://github.com/xxxajk>`__
-- `Yaroslav Heriatovych (@Yarikx) <https://github.com/Yarikx>`__
+- `Yaroslav (@Yarikx) <https://github.com/Yarikx>`__
 - `Marcin Jaworski (@yawor) <https://github.com/yawor>`__
 - `yousaf465 (@yousaf465) <https://github.com/yousaf465>`__
 - `Yuval Aboulafia (@yuvalabou) <https://github.com/yuvalabou>`__
@@ -1313,4 +1325,4 @@ Contributors
 - `Zsolt Zsiros (@ZsZs73) <https://github.com/ZsZs73>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated January 22, 2024.*
+*This page was last updated February 13, 2024.*

From 54d84e26c4ec84efa5fc2c4fa82d37cd5bc14dfc Mon Sep 17 00:00:00 2001
From: kahrendt <kahrendt@gmail.com>
Date: Sun, 18 Feb 2024 00:50:52 -0500
Subject: [PATCH 04/19] probability cutoff is a percentage (#3609)

---
 components/micro_wake_word.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/micro_wake_word.rst b/components/micro_wake_word.rst
index 21103d56e..68e0b4280 100644
--- a/components/micro_wake_word.rst
+++ b/components/micro_wake_word.rst
@@ -38,7 +38,7 @@ Configuration variables:
 
 The below two options are provided by the JSON file, but can be overridden in YAML.
 
-- **probability_cutoff** (*Optional*, float): The probability cutoff for the wake word detection.
+- **probability_cutoff** (*Optional*, percentage): The probability cutoff for the wake word detection.
   If the probability of the wake word is below this value, the wake word is not detected.
   A larger value reduces the number of false accepts but increases the number of false rejections.
 - **sliding_window_average_size** (*Optional*, int): The size of the sliding window average for the wake word detection. A small value lowers latency but may increase the number of false accepts.

From c473a1d6cd073c03a93c6c6430117e459bbf477f Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 19 Feb 2024 11:53:00 +1300
Subject: [PATCH 05/19] microWakeWord: Add minimum_esphome_version as optional
 field (#3612)

---
 components/micro_wake_word.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/micro_wake_word.rst b/components/micro_wake_word.rst
index 68e0b4280..c541f72cc 100644
--- a/components/micro_wake_word.rst
+++ b/components/micro_wake_word.rst
@@ -61,7 +61,7 @@ Model JSON
       }
     }
 
-The model JSON file contains the following fields that are all **required**:
+The model JSON file contains the following fields that are all **required** unless otherwise specified:
 
 - **type** (string): The type of the model. This should always be ``micro``.
 - **wake_word** (string): The wake word that the model is trained to detect.
@@ -74,6 +74,7 @@ The model JSON file contains the following fields that are all **required**:
   - **probability_cutoff** (float): The probability cutoff for the wake word detection.
     If the probability of the wake word is below this value, the wake word is not detected.
   - **sliding_window_average_size** (int): The size of the sliding window average for the wake word detection.
+  - **minimum_esphome_version** (*Optional* version): The minimum ESPHome version required to use this model.
 
 
 Automations

From 1d6cf403acae7fa4b828b9ad6c9075850761360c Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 19 Feb 2024 17:01:06 +1300
Subject: [PATCH 06/19] Bump version to 2024.2.0b2

---
 Doxygen         | 2 +-
 Makefile        | 2 +-
 _static/version | 2 +-
 conf.py         | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Doxygen b/Doxygen
index 0a1795ab7..a7512c2c1 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.2.0b1
+PROJECT_NUMBER         = 2024.2.0b2
 
 # 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 730c90dcd..1edd7b01f 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2024.2.0b1
+ESPHOME_REF = 2024.2.0b2
 
 .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 4164e16b3..4bd1e8a47 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2024.2.0b1
\ No newline at end of file
+2024.2.0b2
\ No newline at end of file
diff --git a/conf.py b/conf.py
index cc188e211..f8647991a 100644
--- a/conf.py
+++ b/conf.py
@@ -69,7 +69,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2024.2"
 # The full version, including alpha/beta/rc tags.
-release = "2024.2.0b1"
+release = "2024.2.0b2"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From 499ee69d07706a1a92438cb54b2b7940a6569fe3 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 19 Feb 2024 17:01:44 +1300
Subject: [PATCH 07/19] Update changelog for 2024.2.0b2

---
 changelog/2024.2.0.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/changelog/2024.2.0.rst b/changelog/2024.2.0.rst
index 7d5392702..80dbf36ab 100644
--- a/changelog/2024.2.0.rst
+++ b/changelog/2024.2.0.rst
@@ -41,6 +41,16 @@ Breaking Changes
 - convert cse7766 to non-polling :esphomepr:`6095` by :ghuser:`ssieb` (breaking-change)
 - Add combination sensor and remove absorbed kalman_combinator component :esphomepr:`5438` by :ghuser:`kahrendt` (new-integration) (breaking-change)
 
+Beta Changes
+^^^^^^^^^^^^
+
+- AUTO_LOAD ``sensor`` for ``shelly_dimmer`` :esphomepr:`6223` by :ghuser:`kbx81`
+- Add more debugging logs to microWakeWord :esphomepr:`6238` by :ghuser:`kahrendt`
+- Fix to RF receiver for Drayton Digistat heating controller :esphomepr:`6235` by :ghuser:`marshn`
+- WRGB Use correct multiplier :esphomepr:`6237` by :ghuser:`mhetzi`
+- Add optional minimum esphome version to microWakeWord manifest :esphomepr:`6240` by :ghuser:`jesserockz`
+- Fix xl9535 pin reads :esphomepr:`6242` by :ghuser:`jesserockz`
+
 All changes
 ^^^^^^^^^^^
 

From 13a8c8f3908483bd57fb136f35e6af944dda8b9a Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 19 Feb 2024 17:02:16 +1300
Subject: [PATCH 08/19] Update supporters for 2024.2.0b2

---
 guides/supporters.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/guides/supporters.rst b/guides/supporters.rst
index b5b2707c8..b79f65ef9 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -45,7 +45,6 @@ Contributors
 - `Andrea Donno (@adonno) <https://github.com/adonno>`__
 - `Adrian Fretwell (@AdrianFretwell) <https://github.com/AdrianFretwell>`__
 - `Adrien Brault (@adrienbrault) <https://github.com/adrienbrault>`__
-- `Ian Blais (@aeonsablaze) <https://github.com/aeonsablaze>`__
 - `Attila Farago (@afarago) <https://github.com/afarago>`__
 - `Kjell Braden (@afflux) <https://github.com/afflux>`__
 - `Alejandro Galfrascoli (@AGalfra) <https://github.com/AGalfra>`__
@@ -178,6 +177,7 @@ Contributors
 - `Bierchermuesli (@Bierchermuesli) <https://github.com/Bierchermuesli>`__
 - `bigwoof (@bigwoof) <https://github.com/bigwoof>`__
 - `Bill Church (@billchurch) <https://github.com/billchurch>`__
+- `bisbastuner (@bisbastuner) <https://github.com/bisbastuner>`__
 - `Brian Kaufman (@bkaufx) <https://github.com/bkaufx>`__
 - `JDavid (@blackhack) <https://github.com/blackhack>`__
 - `blackshoals (@blackshoals) <https://github.com/blackshoals>`__
@@ -226,6 +226,7 @@ Contributors
 - `Carlos Gustavo Sarmiento (@carlos-sarmiento) <https://github.com/carlos-sarmiento>`__
 - `Carlos Garcia Saura (@CarlosGS) <https://github.com/CarlosGS>`__
 - `Carlos Ruiz (@CarlosRDomin) <https://github.com/CarlosRDomin>`__
+- `Carlos Ortega (@carlosV2) <https://github.com/carlosV2>`__
 - `carlywarly (@carlywarly) <https://github.com/carlywarly>`__
 - `Carson Full (@CarsonF) <https://github.com/CarsonF>`__
 - `carstenschroeder (@carstenschroeder) <https://github.com/carstenschroeder>`__
@@ -524,7 +525,6 @@ Contributors
 - `gcopeland (@gcopeland) <https://github.com/gcopeland>`__
 - `Greg Cormier (@gcormier) <https://github.com/gcormier>`__
 - `GeekVisit (@GeekVisit) <https://github.com/GeekVisit>`__
-- `Ian Reinhart Geiser (@geiseri) <https://github.com/geiseri>`__
 - `R Huish (@genestealer) <https://github.com/genestealer>`__
 - `Geoff Davis (@geoffdavis) <https://github.com/geoffdavis>`__
 - `Geoffrey Van Landeghem (@geoffrey-vl) <https://github.com/geoffrey-vl>`__
@@ -684,6 +684,7 @@ Contributors
 - `jochenvg (@jochenvg) <https://github.com/jochenvg>`__
 - `Johboh (@Johboh) <https://github.com/Johboh>`__
 - `John Moxley (@johnmoxley) <https://github.com/johnmoxley>`__
+- `John White (@johnpwhite) <https://github.com/johnpwhite>`__
 - `Dave Johnston (@johnsto) <https://github.com/johnsto>`__
 - `joiboi (@joiboi) <https://github.com/joiboi>`__
 - `JonasEr (@JonasEr) <https://github.com/JonasEr>`__
@@ -848,6 +849,7 @@ Contributors
 - `Merlin Schumacher (@merlinschumacher) <https://github.com/merlinschumacher>`__
 - `Martin Flasskamp (@MFlasskamp) <https://github.com/MFlasskamp>`__
 - `Michael Hoffmann (@mghoffmann) <https://github.com/mghoffmann>`__
+- `Marcel Hetzendorfer (@mhetzi) <https://github.com/mhetzi>`__
 - `M Hightower (@mhightower83) <https://github.com/mhightower83>`__
 - `Michael Muré (@MichaelMure) <https://github.com/MichaelMure>`__
 - `Michal Fapso (@michalfapso) <https://github.com/michalfapso>`__
@@ -1102,6 +1104,7 @@ Contributors
 - `Sam Turner (@samturner3) <https://github.com/samturner3>`__
 - `Sender (@sanderlv) <https://github.com/sanderlv>`__
 - `Sanjay Govind (@sanjay900) <https://github.com/sanjay900>`__
+- `Marcin (@Santanachia) <https://github.com/Santanachia>`__
 - `sascha lammers (@sascha432) <https://github.com/sascha432>`__
 - `Davide Perini (@sblantipodi) <https://github.com/sblantipodi>`__
 - `sbur83 (@sbur83) <https://github.com/sbur83>`__
@@ -1318,11 +1321,10 @@ Contributors
 - `david reid (@zathras777) <https://github.com/zathras777>`__
 - `Brynley McDonald (@ZephireNZ) <https://github.com/ZephireNZ>`__
 - `Geek_cat (@zhzhzhy) <https://github.com/zhzhzhy>`__
-- `I. Tomita (@ziceva) <https://github.com/ziceva>`__
 - `Stefan Goethals (@zipkid) <https://github.com/zipkid>`__
 - `zivillian (@zivillian) <https://github.com/zivillian>`__
 - `Zack Barett (@zsarnett) <https://github.com/zsarnett>`__
 - `Zsolt Zsiros (@ZsZs73) <https://github.com/ZsZs73>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated February 13, 2024.*
+*This page was last updated February 19, 2024.*

From 6a9e138cecd43df90e3bc1d21c01c4d5104c078b Mon Sep 17 00:00:00 2001
From: Keith Burzinski <kbx81x@gmail.com>
Date: Tue, 20 Feb 2024 15:38:28 -0600
Subject: [PATCH 09/19] Update VA docs to add on_idle action (#3572)

---
 components/voice_assistant.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/voice_assistant.rst b/components/voice_assistant.rst
index c59d57a5f..b3c487f36 100644
--- a/components/voice_assistant.rst
+++ b/components/voice_assistant.rst
@@ -64,6 +64,8 @@ Configuration:
   (voice response) playback starts. Requires ``speaker`` to be configured.
 - **on_tts_stream_end** (*Optional*, :ref:`Automation <automation>`): An automation to perform when audio stream
   (voice response) playback ends. Requires ``speaker`` to be configured.
+- **on_idle** (*Optional*, :ref:`Automation <automation>`): An automation to perform
+  when the voice assistant is idle (no other actions/states are in progress).
 - **on_error** (*Optional*, :ref:`Automation <automation>`): An automation to perform
   when the voice assistant has encountered an error. The error code and message are available to
   automations as the variables ``code`` and ``message``.

From f20d38f1f76ac6fb18ee1d181eef25b220c2bfcd Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 21 Feb 2024 10:57:46 +1300
Subject: [PATCH 10/19] Bump version to 2024.2.0b3

---
 Doxygen         | 2 +-
 Makefile        | 2 +-
 _static/version | 2 +-
 conf.py         | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Doxygen b/Doxygen
index a7512c2c1..b556707f8 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.2.0b2
+PROJECT_NUMBER         = 2024.2.0b3
 
 # 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 1edd7b01f..3da249195 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2024.2.0b2
+ESPHOME_REF = 2024.2.0b3
 
 .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 4bd1e8a47..d135791e8 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2024.2.0b2
\ No newline at end of file
+2024.2.0b3
\ No newline at end of file
diff --git a/conf.py b/conf.py
index f8647991a..c437bda63 100644
--- a/conf.py
+++ b/conf.py
@@ -69,7 +69,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2024.2"
 # The full version, including alpha/beta/rc tags.
-release = "2024.2.0b2"
+release = "2024.2.0b3"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From f87dfbaf5f2df20ab30420693a46ca2a52a29835 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 21 Feb 2024 10:58:17 +1300
Subject: [PATCH 11/19] Update changelog for 2024.2.0b3

---
 changelog/2024.2.0.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/changelog/2024.2.0.rst b/changelog/2024.2.0.rst
index 80dbf36ab..eb23e32fb 100644
--- a/changelog/2024.2.0.rst
+++ b/changelog/2024.2.0.rst
@@ -50,6 +50,11 @@ Beta Changes
 - WRGB Use correct multiplier :esphomepr:`6237` by :ghuser:`mhetzi`
 - Add optional minimum esphome version to microWakeWord manifest :esphomepr:`6240` by :ghuser:`jesserockz`
 - Fix xl9535 pin reads :esphomepr:`6242` by :ghuser:`jesserockz`
+- hold interrupt disable for dallas one-wire :esphomepr:`6244` by :ghuser:`ssieb`
+- Fix tm1651 enum :esphomepr:`6248` by :ghuser:`kbx81`
+- Clear UART read buffer before sending next command :esphomepr:`6200` by :ghuser:`fototakas`
+- Voice Assistant: add on_idle trigger and fix nevermind :esphomepr:`6141` by :ghuser:`synesthesiam`
+- Tuya Fan component fix to handle enum datapoint type :esphomepr:`6135` by :ghuser:`sibowler`
 
 All changes
 ^^^^^^^^^^^
@@ -162,6 +167,17 @@ All changes
 - update docstrings in cpp_generator.py :esphomepr:`6212` by :ghuser:`nielsnl68`
 - Fixed group mask logic for WLED Sync fix :esphomepr:`6193` by :ghuser:`ChuckMash`
 - Add micro_wake_word component :esphomepr:`6136` by :ghuser:`kahrendt` (new-integration)
+- AUTO_LOAD ``sensor`` for ``shelly_dimmer`` :esphomepr:`6223` by :ghuser:`kbx81`
+- Add more debugging logs to microWakeWord :esphomepr:`6238` by :ghuser:`kahrendt`
+- Fix to RF receiver for Drayton Digistat heating controller :esphomepr:`6235` by :ghuser:`marshn`
+- WRGB Use correct multiplier :esphomepr:`6237` by :ghuser:`mhetzi`
+- Add optional minimum esphome version to microWakeWord manifest :esphomepr:`6240` by :ghuser:`jesserockz`
+- Fix xl9535 pin reads :esphomepr:`6242` by :ghuser:`jesserockz`
+- hold interrupt disable for dallas one-wire :esphomepr:`6244` by :ghuser:`ssieb`
+- Fix tm1651 enum :esphomepr:`6248` by :ghuser:`kbx81`
+- Clear UART read buffer before sending next command :esphomepr:`6200` by :ghuser:`fototakas`
+- Voice Assistant: add on_idle trigger and fix nevermind :esphomepr:`6141` by :ghuser:`synesthesiam`
+- Tuya Fan component fix to handle enum datapoint type :esphomepr:`6135` by :ghuser:`sibowler`
 
 Past Changelogs
 ---------------

From 6845bcfb9f8734be0ba01977ba8974daaf3bc97a Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 21 Feb 2024 10:58:49 +1300
Subject: [PATCH 12/19] Update supporters for 2024.2.0b3

---
 guides/supporters.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/guides/supporters.rst b/guides/supporters.rst
index b79f65ef9..55db7ba2d 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -143,6 +143,7 @@ Contributors
 - `balk77 (@balk77) <https://github.com/balk77>`__
 - `Paulus Schoutsen (@balloob) <https://github.com/balloob>`__
 - `Andrew Zaborowski (@balrog-kun) <https://github.com/balrog-kun>`__
+- `Josh Barnard (@barndawgie) <https://github.com/barndawgie>`__
 - `BarryMar (@BarryMar) <https://github.com/BarryMar>`__
 - `bartoszpierzchlewicz (@bartoszpierzchlewicz) <https://github.com/bartoszpierzchlewicz>`__
 - `BartoszPierzchlewiczMacrix (@BartoszPierzchlewiczMacrix) <https://github.com/BartoszPierzchlewiczMacrix>`__
@@ -460,6 +461,7 @@ Contributors
 - `EtienneMD (@EtienneMD) <https://github.com/EtienneMD>`__
 - `Evan Coleman (@evandcoleman) <https://github.com/evandcoleman>`__
 - `Clemens Kirchgatterer (@everslick) <https://github.com/everslick>`__
+- `Everything Smart Home (@EverythingSmartHome) <https://github.com/EverythingSmartHome>`__
 - `Evgeni Golov (@evgeni) <https://github.com/evgeni>`__
 - `evlo (@evlo) <https://github.com/evlo>`__
 - `Expaso (@Expaso) <https://github.com/Expaso>`__
@@ -1327,4 +1329,4 @@ Contributors
 - `Zsolt Zsiros (@ZsZs73) <https://github.com/ZsZs73>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated February 19, 2024.*
+*This page was last updated February 21, 2024.*

From a7aad1dfe825ea33d987b1eeb4e35c86ba6998d9 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 21 Feb 2024 12:51:13 +1300
Subject: [PATCH 13/19] Bump version to 2024.2.0

---
 Doxygen         | 2 +-
 Makefile        | 2 +-
 _static/version | 2 +-
 conf.py         | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Doxygen b/Doxygen
index b556707f8..3261a8bab 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.2.0b3
+PROJECT_NUMBER         = 2024.2.0
 
 # 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 3da249195..eac5f8ff8 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2024.2.0b3
+ESPHOME_REF = 2024.2.0
 
 .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 d135791e8..032892e0c 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2024.2.0b3
\ No newline at end of file
+2024.2.0
\ No newline at end of file
diff --git a/conf.py b/conf.py
index c437bda63..c13fb7248 100644
--- a/conf.py
+++ b/conf.py
@@ -69,7 +69,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2024.2"
 # The full version, including alpha/beta/rc tags.
-release = "2024.2.0b3"
+release = "2024.2.0"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From caa873a6a5f08cf625ba84c2ce3148be322c8c66 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen <balloob@gmail.com>
Date: Wed, 21 Feb 2024 10:48:31 -0500
Subject: [PATCH 14/19] Migrate ready-made projects to ESP Web Tools 10 (#3619)

---
 projects/installer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/projects/installer.html b/projects/installer.html
index 11d9b44bc..c8c36ddef 100644
--- a/projects/installer.html
+++ b/projects/installer.html
@@ -95,7 +95,7 @@
 </style>
 <script
   type="module"
-  src="https://unpkg.com/esp-web-tools@9/dist/web/install-button.js?module"
+  src="https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module"
 ></script>
 
 <div class="admonition note unsupported hidden">

From 9871113af2ef62e9ab37bac1a9e52c3c99864899 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 22 Feb 2024 14:30:15 +1300
Subject: [PATCH 15/19] Point to new microWakeWord specific firmware (#3623)

---
 projects/installer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/projects/installer.html b/projects/installer.html
index c8c36ddef..2eab8744a 100644
--- a/projects/installer.html
+++ b/projects/installer.html
@@ -142,7 +142,7 @@
 
 <div
   class="type type-voice hidden"
-  data-manifest-root="https://firmware.esphome.io/voice-assistant"
+  data-manifest-root="https://firmware.esphome.io/wake-word-voice-assistant"
 >
   <div class="question-prompt">
     Pick the device you want to turn into a voice assistant:

From 68adb55c792d85fa069d5bcb37649f6c05715aa3 Mon Sep 17 00:00:00 2001
From: MrEditor97 <dev@mreditor97.co.uk>
Date: Fri, 23 Feb 2024 06:05:04 +0000
Subject: [PATCH 16/19] Update I2C minimum bus speed (#3493)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: H. Árkosi Róbert <robreg@zsurob.hu>
---
 components/sensor/mcp9600.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/sensor/mcp9600.rst b/components/sensor/mcp9600.rst
index 6236961dd..5d5a6a809 100644
--- a/components/sensor/mcp9600.rst
+++ b/components/sensor/mcp9600.rst
@@ -11,9 +11,9 @@ The ``mcp9600`` sensor platform allows you to use your MCP9600 and MCP9601
 `Adafruit`_) to measure the temperature of a connected thermocouple while also measuring the ambient temperature around the sensor with ESPHome. :ref:`I²C <i2c>` is
 required to be set up in your configuration for this sensor to work.
 
-.. warning::
+.. note::
 
-    The :ref:`I²C <i2c>` bus must be set to a minimum of ``100khz`` due to the limitations of the MCP9600 and MCP9601.
+    The :ref:`I²C <i2c>` bus must be set to a minimum of ``10khz`` due to the limitations of the MCP9600 and MCP9601.
 
 .. figure:: images/mcp9600.jpg
     :align: center

From a2df0f7838ff76683c9ee27a5dc7dee0ee97108f Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Sat, 24 Feb 2024 08:10:06 +1300
Subject: [PATCH 17/19] Add some details to the 2024.2.0 release notes (#3629)

---
 changelog/2024.2.0.rst | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/changelog/2024.2.0.rst b/changelog/2024.2.0.rst
index eb23e32fb..749d281cd 100644
--- a/changelog/2024.2.0.rst
+++ b/changelog/2024.2.0.rst
@@ -18,6 +18,40 @@ ESPHome 2024.2.0 - 21st February 2024
     Honeywell HIH I2C, components/sensor/honeywell_hih_i2c, honeywellhih.jpg
     Combination, components/sensor/combination, function.svg, dark-invert
 
+micro Wake Word
+---------------
+
+ESPHome implements an on-device wake word detection framework from `microWakeWord <https://github.com/kahrendt/microWakeWord>`__.
+See the :doc:`component documentation </components/micro_wake_word>` for details on how to use it.
+
+Check out the live stream replay below for more details about how it works and came to be.
+
+.. raw:: html
+
+    <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/NQIv3nsu7dE"
+            title="YouTube video player" frameborder="0"
+            allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+            allowfullscreen>
+    </iframe>
+
+
+BME280 changes
+--------------
+
+:ghuser:`apbodrov` has added support for the BME280 sensor over SPI. This change is a breaking change for any existing configurations using
+the BME280 over I2C as the platform name has been changed from ``bme280`` to ``bme280_i2c``. There are no other configuration changes required
+to continue using the BME280 over I2C. See the :doc:`component documentation </components/sensor/bme280>` for the latest configuration variables.
+
+
+CSE7766 changes
+---------------
+
+:ghuser:`ssieb` has changed the CSE7766 sensor from appearing to be a polling component.
+It has a high update rate, so if you don't want to send a lot of data to HA, you can
+add the :ref:`throttle_average <sensor-filters>` filter
+with the time period you were using for the update interval (the default is 60s) to each
+sensor.  The example in the sensor doc page has been updated to show this.
+
 
 Full list of changes
 --------------------

From d3dab083db469ed926c4b79476c39ec94a4a811b Mon Sep 17 00:00:00 2001
From: Alex Boyd <alex@opengroove.org>
Date: Sat, 24 Feb 2024 05:00:42 -0700
Subject: [PATCH 18/19] Build Docker image for arm64 (#3630)

This is needed in order for the esphome-docs Docker image to run on Docker Desktop on MacBook M1/2/3.
---
 .github/workflows/docker.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml
index 56d3ab158..4d946d012 100644
--- a/.github/workflows/docker.yml
+++ b/.github/workflows/docker.yml
@@ -21,6 +21,9 @@ jobs:
       -
         name: Checkout source code
         uses: actions/checkout@v4.1.0
+      -
+        name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
       -
         name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
@@ -43,6 +46,7 @@ jobs:
         with:
           context: .
           push: true
+          platforms: linux/amd64,linux/arm64
           tags: |
             esphome/esphome-docs:latest
             ghcr.io/esphome/esphome-docs:latest

From 2037a12f8d8371edb96f4e11c1c55cdbbc639077 Mon Sep 17 00:00:00 2001
From: betz0r <s.betzinger@gmail.com>
Date: Sun, 25 Feb 2024 19:40:12 +0100
Subject: [PATCH 19/19] Fix typo liquit to liquid (#3638)

---
 components/sensor/ufire_ise.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/sensor/ufire_ise.rst b/components/sensor/ufire_ise.rst
index 1b9972ed8..d7fd587bf 100644
--- a/components/sensor/ufire_ise.rst
+++ b/components/sensor/ufire_ise.rst
@@ -9,7 +9,7 @@ uFire ISE pH sensor
 The ``ufire_ise`` sensor platform allows you to use your uFire ISE pH sensor with
 ESPHome. The :ref:`I²C Bus <i2c>` is
 required to be set up in your configuration for this sensor to work.
-It required also to have an temperature sensor in the liquit tank; this can
+It required also to have an temperature sensor in the liquid tank; this can
 be on the same board or external sensor linked to the uFire ISE pH configuration.
 
 .. figure:: images/ufire_ise.png
@@ -23,7 +23,7 @@ be on the same board or external sensor linked to the uFire ISE pH configuration
       - platform: ufire_ise
         id: ufire_ise_board
         temperature:
-          id: temperature_liquit
+          id: temperature_liquid
           name: Temperature
         ph:
           name: pH
@@ -63,7 +63,7 @@ of the calibration high solution.
       - sensor.ufire_ise_board.calibrate_probe_high:
           id: ufire_ise_board
           solution: 7.0
-          temperature: !lambda "return id(temperature_liquit).state;"
+          temperature: !lambda "return id(temperature_liquid).state;"
 
 Configuration options:
 
@@ -91,7 +91,7 @@ of the calibration low solution.
       - sensor.ufire_ise_board.calibrate_probe_low:
           id: ufire_ise_board
           solution: 4.0
-          temperature: !lambda "return id(temperature_liquit).state;"
+          temperature: !lambda "return id(temperature_liquid).state;"
 
 Configuration options: