From f30cc647cd4a2c455e0bc3df4e64a8a32bc7a7ea Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 11 May 2022 12:50:42 +1200
Subject: [PATCH 01/35] Bump version to 2022.6.0-dev

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

diff --git a/Doxygen b/Doxygen
index 3c3af8b6c..8780564ca 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         = 2022.5.0-dev
+PROJECT_NUMBER         = 2022.6.0-dev
 
 # 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 58edd6027..299496721 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2022.4.0
+ESPHOME_REF = dev
 
 .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 d102e49bc..da61ca8c4 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2022.5.0-dev
\ No newline at end of file
+2022.6.0-dev
\ No newline at end of file
diff --git a/conf.py b/conf.py
index 6aa9f2c58..eadb482c3 100644
--- a/conf.py
+++ b/conf.py
@@ -66,9 +66,9 @@ author = "ESPHome"
 # built documents.
 #
 # The short X.Y version.
-version = "2022.5"
+version = "2022.6"
 # The full version, including alpha/beta/rc tags.
-release = "2022.5.0-dev"
+release = "2022.6.0-dev"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From 306f5f55e8b5ca6a37836f9e4523579d22b4e4c8 Mon Sep 17 00:00:00 2001
From: swifty99 <swifty1101@gmx.de>
Date: Thu, 12 May 2022 06:53:37 +0200
Subject: [PATCH 02/35] TCS34725 automatic integration times (#1951)

Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
---
 components/sensor/tcs34725.rst | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/components/sensor/tcs34725.rst b/components/sensor/tcs34725.rst
index 251bfc42d..42dfa4af1 100644
--- a/components/sensor/tcs34725.rst
+++ b/components/sensor/tcs34725.rst
@@ -60,9 +60,10 @@ Configuration variables:
 - **illuminance** (*Optional*): Get the total illuminance of the sensor in lx.
 - **color_temperature** (*Optional*): Get the calculated color temperature of the light in Kelvin.
 - **gain** (*Optional*): Set the gain for the internal ADCs to work better in certain low-light conditions. Valid
-  values are ``1x`` (default), ``4x``, ``16x``, ``60x`` (highest gain).
+  values are ``1x`` (default), ``4x``, ``16x``, ``60x`` (highest gain). Will be overwritten if auto integration time 
+  is used
 - **integration_time** (*Optional*): The amount of time the light sensor is exposed. Valid values are
-  ``2.4ms`` (default), ``24ms``, ``50ms``, ``101ms``, ``120ms``, ``154ms``, ``180ms``, ``199ms``, 
+  ``auto`` (default), ``2.4ms``, ``24ms``, ``50ms``, ``101ms``, ``120ms``, ``154ms``, ``180ms``, ``199ms``, 
   ``240ms``, ``300ms``, ``360ms``, ``401ms``, ``420ms``, ``480ms``, ``499ms``, ``540ms``, ``600ms``, ``614ms``.
 - **glass_attenuation_factor** (*Optional*): The attenuation factor of glass if it's behind some glass facia. 
   Default is ``1.0`` means ``100%`` transmissivity. ``2`` means ``50%`` transmissivity etc.
@@ -70,6 +71,23 @@ Configuration variables:
 - **update_interval** (*Optional*, :ref:`config-time`): The interval to check the
   sensor. Defaults to ``60s``.
 
+For many applications, you can use AUTO timing or leave integration time empty to have the ESP select a suitable gain 
+setting based on the previous measurement. If light levels change dramatically this may cause the next reading to saturate,
+after which the gain will adjust down and subsequent readings will be in range.
+If auto is used in a dynamic environment an update rate of 1 second is best. Filters can be used to throttle the output and 
+prevent updates of marginal changes like:
+
+.. code-block:: yaml
+
+    illuminance:
+    name: "TCS34725 Illuminance"
+    filters:
+      - or:
+          - delta: 50
+          - throttle: 60sec  
+
+When using integration times lower than 154ms the accuracy of the sensor drops with no further gain in possible light 
+accumulation. Use faster timings only if fast readout is necessary with stable light conditions recommended.
 
 See Also
 --------

From ecd45454e96c1d5697f6f86e10a557017665271a Mon Sep 17 00:00:00 2001
From: Maxim Ocheretianko <bearpawmaxim@users.noreply.github.com>
Date: Sun, 15 May 2022 22:49:48 +0300
Subject: [PATCH 03/35] Add Tuya select documentation (#2075)

---
 components/select/tuya.rst | 69 ++++++++++++++++++++++++++++++++++++++
 index.rst                  |  1 +
 2 files changed, 70 insertions(+)
 create mode 100644 components/select/tuya.rst

diff --git a/components/select/tuya.rst b/components/select/tuya.rst
new file mode 100644
index 000000000..670adbd4b
--- /dev/null
+++ b/components/select/tuya.rst
@@ -0,0 +1,69 @@
+Tuya Select
+===========
+
+.. seo::
+    :description: Instructions for setting up a Tuya device select.
+    :image: tuya.png
+
+The ``tuya`` select platform creates a select from a tuya serial component
+and requires :doc:`/components/tuya` to be configured.
+
+.. code-block:: text
+
+    [08:51:09][C][tuya:032]: Tuya:
+    [08:51:09][C][tuya:043]:   Datapoint 1: switch (value: ON)
+    [08:51:09][C][tuya:045]:   Datapoint 24: int value (value: 220)
+    [08:51:09][C][tuya:045]:   Datapoint 16: int value (value: 22)
+    [08:51:09][C][tuya:049]:   Datapoint 2: enum (value: 1)
+    [08:51:09][C][tuya:045]:   Datapoint 19: int value (value: 40)
+    [08:51:09][C][tuya:045]:   Datapoint 101: int value (value: 1)
+    [08:51:09][C][tuya:045]:   Datapoint 27: int value (value: -2)
+    [08:51:09][C][tuya:049]:   Datapoint 43: enum (value: 1)
+    [08:51:09][C][tuya:049]:   Datapoint 102: enum (value: 1)
+    [08:51:09][C][tuya:051]:   Datapoint 45: bitmask (value: 0)
+    [08:51:09][C][tuya:043]:   Datapoint 10: switch (value: ON)
+    [08:51:09][C][tuya:041]:   Datapoint 38: raw (value: 06.00.14.08.00.0F.0B.1E.0F.0C.1E.0F.11.00.16.16.00.0F.08.00.16.17.00.0F (24))
+    [08:51:09][C][tuya:049]:   Datapoint 36: enum (value: 1)
+    [08:51:09][C][tuya:057]:   GPIO Configuration: status: pin 14, reset: pin 0 (not supported)
+    [08:51:09][C][tuya:061]:   Status Pin: GPIO14
+    [08:51:09][C][tuya:063]:   Product: '{"p":"gogb05wrtredz3bs","v":"1.0.0","m":0}'
+
+On this controller, the datapoint 36 represents the temperature sensor selection
+setting which is what we are interested in controlling using this platform.
+
+Based on this, you can create the select as follows:
+
+.. code-block:: yaml
+
+    # Create a select
+    select:
+      - platform: "tuya"
+        name: "Sensor selection"
+        enum_datapoint: 2
+        optimistic: true
+        options:
+          0: Internal:
+          1: Floor:
+          2: Both:
+
+Configuration variables:
+------------------------
+
+- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
+- **name** (**Required**, string): The name of the switch.
+- **enum_datapoint** (**Required**, int): The enum datapoint id number for the select.
+- **options** (**Required**, Map[int, str]): Provide a mapping from values (int) of
+  this Select to options (str) of the *enum_datapoint* and vice versa. All options and
+  all values have to be unique.
+- **optimistic** (*Optional*, boolean): Whether to operate in optimistic mode - when in this mode,
+  any command sent to the Select will immediately update the reported state.
+
+- All other options from :ref:`Select <config-select>`.
+
+
+See Also
+--------
+
+- :doc:`/components/select/index`
+- :apiref:`tuya/select/tuya_select.h`
+- :ghedit:`Edit`
diff --git a/index.rst b/index.rst
index 372c831c0..a1aabee4c 100644
--- a/index.rst
+++ b/index.rst
@@ -620,6 +620,7 @@ Select Components
     Select Core, components/select/index, folder-open.svg
     Template Select, components/select/template, description.svg
     Modbus Select, components/select/modbus_controller, modbus.png
+    Tuya Select, components/select/tuya, tuya.png
 
 Lock Components
 -----------------

From 01b6a6df8ef2333fa73325c1122bd35eabd8a06d Mon Sep 17 00:00:00 2001
From: Maxim Ocheretianko <bearpawmaxim@users.noreply.github.com>
Date: Sun, 15 May 2022 22:44:18 +0300
Subject: [PATCH 04/35] Tuya status gpio support (#2072)

---
 components/tuya.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/components/tuya.rst b/components/tuya.rst
index a458fe1ce..79f5d3818 100644
--- a/components/tuya.rst
+++ b/components/tuya.rst
@@ -40,12 +40,38 @@ Here is an example output for a Tuya fan controller:
     [12:39:45][C][tuya:032]:   Datapoint 9: switch (value: OFF)
     [12:39:45][C][tuya:046]:   Product: '{"p":"hqq73kftvzh8c92u","v":"1.0.0","m":0}'
 
+Here is another example output for a Tuya ME-81H thermostat:
+
+.. code-block:: text
+
+    [08:51:09][C][tuya:032]: Tuya:
+    [08:51:09][C][tuya:043]:   Datapoint 1: switch (value: ON)
+    [08:51:09][C][tuya:045]:   Datapoint 24: int value (value: 220)
+    [08:51:09][C][tuya:045]:   Datapoint 16: int value (value: 22)
+    [08:51:09][C][tuya:049]:   Datapoint 2: enum (value: 1)
+    [08:51:09][C][tuya:045]:   Datapoint 19: int value (value: 40)
+    [08:51:09][C][tuya:045]:   Datapoint 101: int value (value: 1)
+    [08:51:09][C][tuya:045]:   Datapoint 27: int value (value: -2)
+    [08:51:09][C][tuya:049]:   Datapoint 43: enum (value: 1)
+    [08:51:09][C][tuya:049]:   Datapoint 102: enum (value: 1)
+    [08:51:09][C][tuya:051]:   Datapoint 45: bitmask (value: 0)
+    [08:51:09][C][tuya:043]:   Datapoint 10: switch (value: ON)
+    [08:51:09][C][tuya:041]:   Datapoint 38: raw (value: 06.00.14.08.00.0F.0B.1E.0F.0C.1E.0F.11.00.16.16.00.0F.08.00.16.17.00.0F (24))
+    [08:51:09][C][tuya:049]:   Datapoint 36: enum (value: 1)
+    [08:51:09][C][tuya:057]:   GPIO Configuration: status: pin 14, reset: pin 0 (not supported)
+    [08:51:09][C][tuya:061]:   Status Pin: GPIO14
+    [08:51:09][C][tuya:063]:   Product: '{"p":"gogb05wrtredz3bs","v":"1.0.0","m":0}'
+
 Configuration variables:
 ------------------------
 
 - **time_id** (*Optional*, :ref:`config-id`): Some Tuya devices support obtaining local time from ESPHome.
   Specify the ID of the :ref:`Time Component <time>` which will be used.
 
+- **status_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): Some Tuya devices support WiFi status reporting ONLY through gpio pin.
+  Specify the pin reported in the config dump or leave empty otherwise.
+  More about this `here <https://developer.tuya.com/en/docs/iot/tuya-cloud-universal-serial-port-access-protocol?id=K9hhi0xxtn9cb#title-6-Query%20working%20mode>`__.
+
 - **ignore_mcu_update_on_datapoints** (*Optional*, list): A list of datapoints to ignore MCU updates for.  Useful for certain broken/erratic hardware and debugging.
 
 Automations:

From b443342e77c5ca933fcc5c68bd5f356eabfbc17c Mon Sep 17 00:00:00 2001
From: Dave T <17680170+davet2001@users.noreply.github.com>
Date: Wed, 18 May 2022 23:23:06 +0100
Subject: [PATCH 05/35] Add documentation describing new color pallet mode for
 ili9341 displays (#2087)

---
 components/display/ili9341.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/display/ili9341.rst b/components/display/ili9341.rst
index 04229e353..0e5339de3 100644
--- a/components/display/ili9341.rst
+++ b/components/display/ili9341.rst
@@ -60,6 +60,10 @@ Configuration variables:
   or to keep the existing display content (must overwrite explicitly, e.g., only on data change).
 - **pages** (*Optional*, list): Show pages instead of a single lambda. See :ref:`display-pages`.
 - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
+- **color_palette** (*Optional*): The type of color pallet that will be used in the ESP's internal 8-bits-per-pixel buffer.  This can be used to improve color depth quality of the image.  For example if you know that the display will only be showing grayscale images, the clarity of the display can be improved by targeting the available colors to monochrome only.  Options are:
+  
+  - ``NONE`` (default)
+  - ``GRAYSCALE``
 
 Configuration examples
 **********************

From 5238b5685668ff063f27afe1a76f4ed8ef7a1571 Mon Sep 17 00:00:00 2001
From: myml <wurongjie1@gmail.com>
Date: Thu, 19 May 2022 08:23:56 +0800
Subject: [PATCH 06/35] Update esp32_camera.rst (#2078)

Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
---
 components/esp32_camera.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/esp32_camera.rst b/components/esp32_camera.rst
index 4f2757bac..678cb87ca 100644
--- a/components/esp32_camera.rst
+++ b/components/esp32_camera.rst
@@ -147,6 +147,13 @@ White Balance Setting:
     - ``office``: White balance office mode
     - ``home``: White balance home mode
 
+Automations:
+
+- **on_stream_start** (*Optional*, :ref:`Automation <automation>`): An automation to perform
+  when a stream starts.
+- **on_stream_end** (*Optional*, :ref:`Automation <automation>`): An automation to perform
+  when a stream stops.
+
 Test Setting:
 
 - **test_pattern** (*Optional*, boolean): For tests purposes, it's possible to replace picture get from sensor by a test color pattern. Defaults to ``false``.

From 02007a12f2c32d49e35b824d4cb6b65c8f341bcf Mon Sep 17 00:00:00 2001
From: Martin <25747549+martgras@users.noreply.github.com>
Date: Thu, 19 May 2022 02:47:37 +0200
Subject: [PATCH 07/35] Sgp4x (#2016)

---
 _redirects                  |   1 +
 components/sensor/sen5x.rst |   2 +-
 components/sensor/sgp40.rst |  72 ------------------------
 components/sensor/sgp4x.rst | 109 ++++++++++++++++++++++++++++++++++++
 cookbook/iaq_board.rst      |   2 +-
 index.rst                   |   2 +-
 6 files changed, 113 insertions(+), 75 deletions(-)
 delete mode 100644 components/sensor/sgp40.rst
 create mode 100644 components/sensor/sgp4x.rst

diff --git a/_redirects b/_redirects
index 991abd4e3..f6b61f081 100644
--- a/_redirects
+++ b/_redirects
@@ -2,3 +2,4 @@
 
 # Moved components
 # e.g: /components/sensors/abc.html /components/sensors/xyz.html 301
+/components/sensor/sgp40.html /components/sensor/sgp4x.html 301
diff --git a/components/sensor/sen5x.rst b/components/sensor/sen5x.rst
index dd7904003..3e4e398c3 100644
--- a/components/sensor/sen5x.rst
+++ b/components/sensor/sen5x.rst
@@ -213,6 +213,6 @@ See Also
 - :doc:`ccs811`
 - :doc:`scd4x`
 - :doc:`sps30`
-- :doc:`sgp40`
+- :doc:`sgp4x`
 - :apiref:`sen5x/sen5x.h`
 - :ghedit:`Edit`
diff --git a/components/sensor/sgp40.rst b/components/sensor/sgp40.rst
deleted file mode 100644
index e4ed76322..000000000
--- a/components/sensor/sgp40.rst
+++ /dev/null
@@ -1,72 +0,0 @@
-SGP40 Volatile Organic Compound Sensor
-======================================
-
-.. seo::
-    :description: Instructions for setting up SGP40 Volatile Organic Compound sensor
-    :image: sgp40.jpg
-
-The ``sgp40`` sensor platform allows you to use your Sensirion SGP40 VOC sensor
-(`datasheet <https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/9_Gas_Sensors/Sensirion_Gas_Sensors_SGP40_Datasheet.pdf>`__) with ESPHome.
-The :ref:`I²C Bus <i2c>` is required to be set up in your configuration for this sensor to work.
-
-.. note::
-
-    This sensor need to be driven at a rate of 1Hz. Because of this, the
-    sensor will be read out on device once a second separately from the
-    update_interval.  The state will be reported to other components, or
-    the front end at the update_interval, saving wifi power and network
-    communication.
-
-.. figure:: images/sgp40.jpg
-    :align: center
-    :width: 80.0%
-
-.. code-block:: yaml
-
-    # Example configuration entry
-    sensor:
-      - platform: sgp40
-        name: "Workshop VOC"
-
-Configuration variables:
-------------------------
-
-- **name** (**Required**, string): The name for the CO₂eq sensor.
-- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
-- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``
-- **store_baseline** (*Optional*, boolean): Stores and retrieves the baseline information for quicker startups. Defaults to ``true``
-
-- **compensation** (*Optional*): The block containing sensors used for compensation. If not set defaults will be used.
-
-  - **temperature_source** (*Optional*, :ref:`config-id`): Give an external temperature sensor ID
-    here. This can improve the sensor's internal calculations. Defaults to ``25``
-
-  - **humidity_source** (*Optional*, :ref:`config-id`): Give an external humidity sensor ID
-    here. This can improve the sensor's internal calculations. Defaults to ``50``
-
-- All other options from :ref:`Sensor <config-sensor>`.
-
-Example With Compensation
--------------------------
-.. code-block:: yaml
-
-    # Example configuration entry
-    sensor:
-      - platform: sgp40
-        name: "Workshop VOC"
-        update_interval: 5s        
-        compensation:
-          humidity_source: dht1_hum
-          temperature_source: dht1_temp 
-          
-See Also
---------
-
-- :ref:`sensor-filters`
-- :doc:`dht`
-- :doc:`dht12`
-- :doc:`hdc1080`
-- :doc:`htu21d`
-- :doc:`sht3xd`
-- :apiref:`sgp40/sgp40.h`
-- :ghedit:`Edit`
diff --git a/components/sensor/sgp4x.rst b/components/sensor/sgp4x.rst
new file mode 100644
index 000000000..404b3ae79
--- /dev/null
+++ b/components/sensor/sgp4x.rst
@@ -0,0 +1,109 @@
+SGP40 Volatile Organic Compound Sensor and SGP41 VOC and NOx Sensor
+===================================================================
+
+.. seo::
+    :description: Instructions for setting up SGP40/SGP41 Volatile Organic Compound and NOx sensor
+    :image: sgp40.jpg
+
+The ``sgp4x`` sensor platform allows you to use your Sensirion SGP40 
+(`datasheet <https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/9_Gas_Sensors/Sensirion_Gas_Sensors_SGP40_Datasheet.pdf>`__) or SGP41 
+(`datasheet <https://sensirion.com/media/documents/5FE8673C/61E96F50/Sensirion_Gas_Sensors_Datasheet_SGP41.pdf>`__) with ESPHome.
+The type of sensor used is automatically detected.
+The :ref:`I²C Bus <i2c>` is required to be set up in your configuration for this sensor to work.
+
+.. note::
+
+    This sensor need to be driven at a rate of 1Hz. Because of this, the
+    sensor will be read out on device once a second separately from the
+    update_interval.  The state will be reported to other components, or
+    the front end at the update_interval, saving wifi power and network
+    communication.
+
+.. figure:: images/sgp40.jpg
+    :align: center
+    :width: 80.0%
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    sensor:
+    - platform: sgp4x
+        voc:
+          name: "VOC Index"
+        nox:
+          name: "NOx Index"
+
+
+Configuration variables:
+------------------------
+
+- **voc** (*Optional*): VOC Index
+
+  - **name** (**Required**, string): The name of the sensor.
+  - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
+  - **algorithm_tuning** (*Optional*): The VOC algorithm can be customized by tuning 6 different parameters. For more details see `Engineering Guidelines for SEN5x <https://sensirion.com/media/documents/25AB572C/61E961EA/Sensirion_Engineering_Guidelines_SEN5x.pdf>`__
+
+    - **index_offset** (*Optional*): VOC index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 100. 
+    - **learning_time_offset_hours** (*Optional*): Time constant to estimate the VOC algorithm offset from the history in hours. Past events will be forgotten after about twice the  learning time. Allowed values are in range 1..1000. The default value is 12 hour
+    - **learning_time_gain_hours** (*Optional*): Time constant to estimate the VOC algorithm gain from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hours. 
+    - **gating_max_duration_minutes** (*Optional*): Maximum duration of gating in minutes (freeze of estimator during high VOC index signal). Zero disables the gating. Allowed values are in range 0..3000. The default value is 180 minutes
+    - **std_initial** (*Optional*): Initial estimate for standard deviation. Lower value boosts events during initial learning period, but may result in larger device-todevice variations. Allowed values are in range 10..5000. The default value is 50.
+    - **gain_factor:** (*Optional*): Gain factor to amplify or to attenuate the VOC index output. Allowed values are in range 1..1000. The default value is 230.
+  
+
+  - All other options from :ref:`Sensor <config-sensor>`.
+
+- **nox** (*Optional*): NOx Index. Only available with SGP41. If a SGP40 sensor is detected this sensor will be ignored
+
+  - **name** (**Required**, string): The name of the sensor.
+  - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
+  - **algorithm_tuning** (*Optional*): The NOx algorithm can be customized by tuning 5 different parameters.For more details see `Engineering Guidelines for SEN5x <https://sensirion.com/media/documents/25AB572C/61E961EA/Sensirion_Engineering_Guidelines_SEN5x.pdf>`__
+  
+    - **index_offset** (*Optional*): NOx index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 100. 
+    - **learning_time_offset_hours** (*Optional*): Time constant to estimate the NOx algorithm offset from the history in hours. Past events will be forgotten after about twice the  learning time. Allowed values are in range 1..1000. The default value is 12 hour
+    - **learning_time_gain_hours** (*Optional*): Time constant to estimate the NOx algorithm gain from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hours. 
+    - **gating_max_duration_minutes** (*Optional*): Maximum duration of gating in minutes (freeze of estimator during high NOx index signal). Zero disables the gating. Allowed values are in range 0..3000. The default value is 180 minutes
+    - **std_initial** (*Optional*): The initial estimate for standard deviation parameter has no impact for NOx. This parameter is still in place for consistency reasons with the VOC tuning parameters command. This parameter must always be set to 50.
+    - **gain_factor:** (*Optional*)
+
+  - All other options from :ref:`Sensor <config-sensor>`.
+
+- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``
+- **store_baseline** (*Optional*, boolean): Stores and retrieves the baseline information for quicker startups. Defaults to ``true``
+
+- **compensation** (*Optional*): The block containing sensors used for compensation. If not set defaults will be used.
+
+  - **temperature_source** (*Optional*, :ref:`config-id`): Give an external temperature sensor ID
+    here. This can improve the sensor's internal calculations. Defaults to ``25``
+
+  - **humidity_source** (*Optional*, :ref:`config-id`): Give an external humidity sensor ID
+    here. This can improve the sensor's internal calculations. Defaults to ``50``
+
+
+Example With Compensation
+-------------------------
+.. code-block:: yaml
+
+    # Example configuration entry
+    sensor:
+    - platform: sgp4x
+        voc:
+          name: "VOC Index"
+        nox:
+          name: "NOx Index"
+        compensation:
+          humidity_source: dht1_hum
+          temperature_source: dht1_temp
+
+See Also
+--------
+
+- :ref:`sensor-filters`
+- :doc:`dht`
+- :doc:`dht12`
+- :doc:`hdc1080`
+- :doc:`htu21d`
+- :doc:`sht3xd`
+- :doc:`sht4x`
+- :apiref:`sgp4x/sgp4x.h`
+- :ghedit:`Edit`
diff --git a/cookbook/iaq_board.rst b/cookbook/iaq_board.rst
index cedaa11d1..53ae96af6 100644
--- a/cookbook/iaq_board.rst
+++ b/cookbook/iaq_board.rst
@@ -53,7 +53,7 @@ See Also
 - :doc:`/components/sensor/pmsx003`
 - :doc:`/components/sensor/mhz19`
 - :doc:`/components/sensor/sgp30`
-- :doc:`/components/sensor/sgp40`
+- :doc:`/components/sensor/sgp4x`
 - :doc:`/components/sensor/tsl2561`
 - :doc:`/components/binary_sensor/gpio`
 - :doc:`/components/sensor/template`
diff --git a/index.rst b/index.rst
index 3eaaabc10..21c9f0f9c 100644
--- a/index.rst
+++ b/index.rst
@@ -195,7 +195,7 @@ Air Quality
     SCD30, components/sensor/scd30, scd30.jpg, CO2 & Temperature & Humidity
     SCD4X, components/sensor/scd4x, scd4x.jpg, CO2 & Temperature & Humidity
     SGP30, components/sensor/sgp30, sgp30.jpg, CO2 & Volatile organics
-    SGP40, components/sensor/sgp40, sgp40.jpg, Volatile organics
+    SGP4x, components/sensor/sgp4x, sgp40.jpg, Volatile organics and NOx
     SM300D2, components/sensor/sm300d2, sm300d2.jpg, Air quality
     SPS30, components/sensor/sps30, sps30.jpg, Particulate
     T6613/15, components/sensor/t6615, t6615.jpg, CO2

From bd80ee67eb34701a54fe1e43f05e277955346c2b Mon Sep 17 00:00:00 2001
From: Sergey Dudanov <sergey.dudanov@gmail.com>
Date: Mon, 23 May 2022 11:51:50 +0300
Subject: [PATCH 08/35] midea: new power_toggle action (#2094)

---
 components/climate/midea.rst | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/components/climate/midea.rst b/components/climate/midea.rst
index 37d15bd77..9b4345046 100644
--- a/components/climate/midea.rst
+++ b/components/climate/midea.rst
@@ -40,7 +40,6 @@ The ``midea`` component creates a Midea air conditioner climate device.
     climate:
       - platform: midea
         name: Midea Climate         # Use a unique name.
-        transmitter_id:             # Optional. Add this option to use IR transmitter.
         period: 1s                  # Optional
         timeout: 2s                 # Optional
         num_attempts: 3             # Optional
@@ -83,7 +82,7 @@ Configuration variables:
 - **uart_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the :doc:`../uart` if you want
   to use multiple UART buses.
 - **name** (**Required**, string): The name of the climate device.
-- **transmitter_id** (*Optional*, :ref:`config-id`): Set if you use :doc:`../remote_transmitter` component for IR commands transmit.
+- **transmitter_id** (*Optional*, :ref:`config-id`): Defined and used automatically when using :doc:`../remote_transmitter` component for IR commands transmit.
 - **period** (*Optional*, :ref:`config-time`): Minimal period between requests to the appliance. Defaults to ``1s``.
 - **timeout** (*Optional*, :ref:`config-time`): Request response timeout until next request attempt. Defaults to ``2s``.
 - **num_attempts** (*Optional*, int): Number of request attempts between 1 and 5 inclusive. Defaults to ``3``.
@@ -121,7 +120,7 @@ Automations
 .. _midea_ac-power_on_action:
 
 ``midea_ac.power_on`` Action
-******************************
+****************************
 
 This action turn on power. The mode and preset will be restored to the last state before turned off.
 
@@ -134,7 +133,7 @@ This action turn on power. The mode and preset will be restored to the last stat
 .. _midea_ac-power_off_action:
 
 ``midea_ac.power_off`` Action
-******************************
+*****************************
 
 This action turn off power.
 
@@ -144,6 +143,19 @@ This action turn off power.
       then:
         - midea_ac.power_off:
 
+.. _midea_ac-power_toggle_action:
+
+``midea_ac.power_toggle`` Action
+********************************
+
+This action toggle the power state. Identical to pressing the power button on the remote control.
+
+.. code-block:: yaml
+
+    on_...:
+      then:
+        - midea_ac.power_toggle:
+
 
 .. _midea_ac-follow_me_action:
 
@@ -200,7 +212,7 @@ This action adjust the louver by one step. :doc:`../remote_transmitter` required
 .. _midea_ac-beeper_on_action:
 
 ``midea_ac.beeper_on`` Action
-******************************
+*****************************
 
 This action turn on beeper feedback.
 

From ef3a289d9cbdf4fc44fcaf4f5d9e7be5663722ec Mon Sep 17 00:00:00 2001
From: Michael Davidson <mrmdavidson@sadorangeproductions.com>
Date: Wed, 25 May 2022 13:44:46 +1000
Subject: [PATCH 09/35] Update thermostat documentation in line with changes
 for #3298 (#1966)

* Update thermostat documentation in line with changes for #3298

* Incorporate feedback

* Update docs in line with new style of thermostat preset configuration

* PR feedback; some RST corrections and linguistic improvements

* Add deprecation warnings to default_ in the and away_config

* Lint fixes
---
 components/climate/thermostat.rst | 112 ++++++++++++++++++++++++++++--
 1 file changed, 107 insertions(+), 5 deletions(-)

diff --git a/components/climate/thermostat.rst b/components/climate/thermostat.rst
index 45134929d..66e62fa8b 100644
--- a/components/climate/thermostat.rst
+++ b/components/climate/thermostat.rst
@@ -163,8 +163,8 @@ Default Target Temperatures and Mode
 
 These configuration items determine default values the thermostat controller should use when it starts.
 
-- **default_mode** (*Optional*, climate mode): The default climate mode the controller should use if it 
-  is unable to restore it from memory. One of:
+- **default_mode** (*Optional*, *Deprecated*, climate mode): The default climate mode the controller should 
+  use if it is unable to restore it from memory. One of:
 
   - ``off`` (default)
   - ``heat_cool``
@@ -180,14 +180,20 @@ than ``off``.  If this option is not configured, you'll need to manually change
 the front end (Home Assistant), an ESPHome action, automation, or from within a lambda elsewhere in your
 device's configuration.
 
-- **default_target_temperature_low** (*Optional*, float): The default low target
+- **default_target_temperature_low** (*Optional*, *Deprecated*, float): The default low target
   temperature for the control algorithm. This can be dynamically set in the frontend later.
-- **default_target_temperature_high** (*Optional*, float): The default high target
+- **default_target_temperature_high** (*Optional*, *Deprecated*, float): The default high target
   temperature for the control algorithm. This can be dynamically set in the frontend later.
 
 **At least one of** ``default_target_temperature_low`` **and** ``default_target_temperature_high``
 **must be specified.**
 
+.. note::
+
+    **default_mode**, **default_target_temperature_low**, and **default_target_temperature_high** are
+    deprecated and will be removed in a future release. You should migrate your configuration to using
+    a :ref:`preset <thermostat-preset>` which allows for more flexibility and customisation 
+
 Note that ``min_temperature`` and ``max_temperature`` from the base climate component are used to define
 the range of allowed temperature values in the thermostat component. See :doc:`/components/climate/index`.
 
@@ -309,7 +315,7 @@ Set Point Options/Behavior
 - **supplemental_heating_delta** (*Required with* ``supplemental_heating_action``, float): When the temperature
   difference between the lower set point and the current temperature exceeds this value,
   ``supplemental_heating_action`` will be called immediately.
-- **away_config** (*Optional*): Additionally specify target temperature range settings for away mode.
+- **away_config** (*Optional*, *Deprecated*): Additionally specify target temperature range settings for away mode.
   Away mode can be used to have a second set of target temperatures (for example, while the user is
   away or sleeping/at night).
 
@@ -321,6 +327,102 @@ Set Point Options/Behavior
 **If configured, at least one of** ``default_target_temperature_low`` **and** ``default_target_temperature_high``
 **must be specified in the away mode configuration.**
 
+.. note::
+
+    **away_config** is deprecated and will be removed in a future release. You should migrate your configuration
+    to using a :ref:`preset <thermostat-preset>` which allows for more flexibility and customisation 
+
+.. _thermostat-preset:
+
+Presets
+*******
+
+Presets allow you to define a combination of set points, climate, fan, and swing modes that can be recalled from
+the front end (Home Assistant) as a single operation for quick and easy access. This can simplify the user
+experience and automation.
+
+- **preset**: (*Optional*, list)
+
+  - **name** (*Required*, string): Name of the preset. If this is one of the *standard* presets (``eco``, ``away``, 
+    ``boost``, ``comfort``, ``home``, ``sleep``, or ``activity``) it is considered a *standard* preset. Any other
+    string will make the preset a *custom* preset. *Standard* and *custom* presets are functionally equivalent,
+    the only difference is that when switching the mode via :ref:`climate.control Action <climate-control_action>`
+    you will need to use the `preset` or `custom_preset` property as appropriate. The Home Assistant 
+    `climate.set_preset_mode` service treats them identically
+  - **default_target_temperature_low** (*Optional*, float): The default low target temperature when switching to 
+    this preset
+  - **default_target_temperature_high** (*Optional*, float): The default high target temperature when switching
+    to this preset.
+  - **mode** (*Optional*, climate mode): The mode the thermostat should switch to when this preset is activated.
+    If not specified, the thermostat's mode will remain unchanged when the preset is activated. One of:
+  
+    - ``heat_cool``
+    - ``cool``
+    - ``heat``
+    - ``dry``
+    - ``fan_only``
+    - ``auto``
+  - **fan_mode** (*Optional*, climate fan mode): The fan mode the thermostat should switch to when this preset
+    is activated. If not specified, the thermostat's fan mode will remain unchanged when the preset is activated.
+    One of:
+
+    - ``on``
+    - ``off``
+    - ``auto``
+    - ``low``
+    - ``medium``
+    - ``high``
+    - ``middle``
+    - ``focus``
+    - ``diffuse``
+  - **swing_mode** (*Optional*, climate swing mode): The fan swing mode the thermostat should switch to when this
+    preset is activated. If not specified, the thermostat's fan swing mode will remain unchanged when the preset
+    is activated. One of:
+    
+    - ``off``
+    - ``both``
+    - ``horizontal``
+    - ``vertical``
+
+.. code-block:: yaml
+
+    # Example climate controller with presets
+    climate:
+      - platform: thermostat
+        name: "Thermostat with Presets"
+        preset:
+          # Standard Preset
+          - name: sleep
+            default_target_temperature_low: 17
+            default_target_temperature_high: 26
+            fan_mode: LOW
+            swing_mode: OFF
+          # Custom preset
+          - name: A custom preset
+            default_target_temperature_low: 21
+            default_target_temperature_high: 23
+            fan_mode: HIGH
+            mode: HEAT_COOL
+
+- **preset_change**: (*Optional*, :ref:`Action <config-action>`): The action to call when the preset is changed. This
+  will be called either when a user changes the mode through the Home Assistant UI or through a call to ``climate.control``
+
+.. code-block:: yaml
+
+    # Example climate controller with preset and change action
+    climate:
+      - platform: thermostat
+        name: "Thermostat with Presets Actions"
+        preset:
+          - name: sleep
+            default_target_temperature_low: 17
+            default_target_temperature_high: 26
+            fan_mode: LOW
+            swing_mode: OFF
+        preset_change:
+          - logger.log: Preset has been changed!
+
+
 Additional Actions/Behavior
 ***************************
 

From 7ed383412b296e1f064372a97f7de15afc61c089 Mon Sep 17 00:00:00 2001
From: Jan Grewe <jan@faked.org>
Date: Mon, 30 May 2022 21:30:27 +0200
Subject: [PATCH 10/35] Prometheus: include internals (#2099)

Co-authored-by: Jan Grewe <jan.grewe@flixbus.com>
---
 components/prometheus.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/prometheus.rst b/components/prometheus.rst
index acc4b5fbc..315e23b10 100644
--- a/components/prometheus.rst
+++ b/components/prometheus.rst
@@ -27,6 +27,8 @@ Configuration variables:
 ------------------------
 
 - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
+- **include_internal** (*Optional*, boolean): Whether ``internal`` entities should be displayed on the
+  web interface. Defaults to ``false``.
 
 .. note::
 

From 58971143d1d726e9a31c7d95d03bcf58f2d0db3b Mon Sep 17 00:00:00 2001
From: Joe <jhansche@themeetgroup.com>
Date: Mon, 30 May 2022 23:45:10 -0400
Subject: [PATCH 11/35] Document new Bedjet `heat_mode` config (#2102)

---
 components/climate/bedjet.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/climate/bedjet.rst b/components/climate/bedjet.rst
index 3d7d91d4f..6f50ebbe7 100644
--- a/components/climate/bedjet.rst
+++ b/components/climate/bedjet.rst
@@ -41,6 +41,10 @@ Configuration variables:
 - **ble_client_id** (**Required**, :ref:`config-id`): The ID of the BLE Client.
 - **time_id** (*Optional*, :ref:`config-id`): The ID of a :ref:`Time Component <time>` which
   can be used to set the time on the BedJet device.
+- **heat_mode** (*Optional*, string): The primary heating mode to use for `HVACMode.HEAT`:
+  - ``"heat"`` (Default) - Setting ``hvac_mode=heat`` uses the BedJet "HEAT" mode.
+  - ``"extended"`` - Setting ``hvac_mode=heat`` uses BedJet "EXT HEAT" mode.
+  - Whichever is not selected will be made available as a custom preset.
 - All other options from :ref:`Climate <config-climate>`.
 
 lambda calls

From 3734e4a978fe703fc8e1d8f7b2402d4a0b278c7b Mon Sep 17 00:00:00 2001
From: jimtng <2554958+jimtng@users.noreply.github.com>
Date: Tue, 31 May 2022 14:45:23 +1000
Subject: [PATCH 12/35] Add documentation for parameterized !include (#2100)

---
 guides/faq.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/guides/faq.rst b/guides/faq.rst
index 3d6af6f9e..f5e9d5cee 100644
--- a/guides/faq.rst
+++ b/guides/faq.rst
@@ -13,6 +13,41 @@ Tips for using ESPHome
    ``!include`` and ``!secret``. So you can store all your secret WiFi passwords and so on
    in a file called ``secrets.yaml`` within the directory where the configuration file is.
 
+   An enhancement to Home Assistant's ``!include`` accepts a list of variables that can be
+   substituted within the included file.
+
+   .. code-block:: yaml
+
+       binary_sensor:
+         - platform: gpio
+           id: button1
+           pin: GPIO16
+           on_multi_click: !include { file: on-multi-click.yaml, vars: { id: 1 } } # inline syntax
+         - platform: gpio
+           id: button2
+           pin: GPIO4
+           on_multi_click: !include
+             # multi-line syntax
+             file: on-multi-click.yaml
+             vars:
+               id: 2
+
+   ``on-multi-click.yaml``:
+
+   .. code-block:: yaml
+
+       - timing: !include click-single.yaml 
+         then:
+           - mqtt.publish:
+               topic: ${device_name}/button${id}/status
+               payload: single
+       - timing: !include click-double.yaml
+         then:
+           - mqtt.publish:
+               topic: ${device_name}/button${id}/status
+               payload: double
+
+
    For even more configuration templating, take a look at :ref:`config-substitutions`.
 
 2. If you want to see how ESPHome interprets your configuration, run

From 2b3edea033ef6ffb2e0dfe39de7eff72f985fbc0 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 2 Jun 2022 17:00:24 +1200
Subject: [PATCH 13/35] Add docs for media_player and i2s_audio (#2107)

---
 Makefile                              |  2 +-
 components/index.rst                  |  1 +
 components/media_player/i2s_audio.rst | 54 +++++++++++++++++++++++++++
 components/media_player/index.rst     | 50 +++++++++++++++++++++++++
 images/i2s_audio.svg                  |  1 +
 index.rst                             |  8 ++++
 6 files changed, 115 insertions(+), 1 deletion(-)
 create mode 100644 components/media_player/i2s_audio.rst
 create mode 100644 components/media_player/index.rst
 create mode 100644 images/i2s_audio.svg

diff --git a/Makefile b/Makefile
index 299496721..36a481722 100644
--- a/Makefile
+++ b/Makefile
@@ -48,7 +48,7 @@ netlify-dependencies:
 copy-svg2png:
 	cp svg2png/*.png _build/html/_images/
 
-netlify: netlify-dependencies netlify-api html copy-svg2png
+netlify: netlify-dependencies netlify-api html svg2png copy-svg2png
 
 lint: html-strict
 	python3 lint.py
diff --git a/components/index.rst b/components/index.rst
index 2fb325b11..15a1cda2c 100644
--- a/components/index.rst
+++ b/components/index.rst
@@ -20,4 +20,5 @@ Components
     stepper/index
     touchscreen/index
     lock/index
+    media_player/index
     *
diff --git a/components/media_player/i2s_audio.rst b/components/media_player/i2s_audio.rst
new file mode 100644
index 000000000..b3543c8f1
--- /dev/null
+++ b/components/media_player/i2s_audio.rst
@@ -0,0 +1,54 @@
+I2S Audio Media Player
+======================
+
+.. seo::
+    :description: Instructions for setting up I2S based media players in ESPHome.
+    :image: i2s_audio.svg
+
+The ``i2s_audio`` media player platform allows you to play media from webservers and web streams
+via the I2S bus. This platform only works on ESP32 based chips.
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    media_player:
+      - platform: i2s_audio
+        name: ESPHome I2S Media Player
+        dac_type: external
+        i2s_lrclk_pin: GPIO33
+        i2s_dout_pin: GPIO22
+        i2s_bclk_pin: GPIO19
+        mode: mono
+
+Configuration variables:
+------------------------
+
+- **dac_type** (**Required**, enum)
+
+  - ``external``: Use an external DAC, for example the NS4168.
+  - ``internal``: Use the internal DAC
+
+- All other options from :ref:`Media Player <config-media_player>`
+
+External DAC
+************
+
+- **i2s_lrclk_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The GPIO pin to use for the I2S LRCLK signal.
+- **i2s_dout_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The GPIO pin to use for the I2S DOUT signal.
+- **i2s_bclk_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The GPIO pin to use for the I2S BCLK signal.
+- **mode** (*Optional*, string): The mode of the I2S bus. Can be ``mono`` or ``stereo``. Defaults to ``mono``.
+
+Internal DAC
+************
+
+- **mode** (**Required**, enum): The channel mode of the internal DAC.
+
+  - ``left``
+  - ``right``
+  - ``stereo``
+
+See also
+--------
+
+- :doc:`index`
+- :ghedit:`Edit`
diff --git a/components/media_player/index.rst b/components/media_player/index.rst
new file mode 100644
index 000000000..45005ea04
--- /dev/null
+++ b/components/media_player/index.rst
@@ -0,0 +1,50 @@
+Media Player Components
+=======================
+
+.. seo::
+    :description: Instructions for setting up generic media players in ESPHome.
+    :image: folder-open.svg
+
+The ``media_player`` domain includes all platforms that implement media player
+functionality.
+
+.. note::
+
+    ESPHome media players require Home Assistant 2022.6 or newer.
+
+.. _config-media_player:
+
+Base Media Player Configuration
+-------------------------------
+
+.. code-block:: yaml
+
+    media_player:
+      - platform: ...
+        name: "Media Player Name"
+
+Configuration variables:
+
+- **name** (**Required**, string): The name of the media player.
+- **icon** (*Optional*, icon): Manually set the icon to use for the
+  media player in the frontend.
+- **internal** (*Optional*, boolean): Mark this component as internal. Internal components will
+  not be exposed to the frontend (like Home Assistant). Only specifying an ``id`` without
+  a ``name`` will implicitly set this to true.
+- **disabled_by_default** (*Optional*, boolean): If true, then this entity should not be added to any client's frontend,
+  (usually Home Assistant) without the user manually enabling it (via the Home Assistant UI).
+  Defaults to ``false``.
+- **entity_category** (*Optional*, string): The category of the entity.
+  See https://developers.home-assistant.io/docs/core/entity/#generic-properties
+  for a list of available options. Set to ``""`` to remove the default entity category.
+
+See Also
+--------
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    *
+
+- :ghedit:`Edit`
diff --git a/images/i2s_audio.svg b/images/i2s_audio.svg
new file mode 100644
index 000000000..3c863aac7
--- /dev/null
+++ b/images/i2s_audio.svg
@@ -0,0 +1 @@
+<svg width="527.266" height="25mm" viewBox="0 0 139.506 25" xmlns="http://www.w3.org/2000/svg"><path style="fill:#000;fill-opacity:1;stroke-width:.133497;stroke-miterlimit:4;stroke-dasharray:none" d="M5 0h129.506c2.77 0 5 2.23 5 5v15c0 2.77-2.23 5-5 5H5c-2.77 0-5-2.23-5-5V5c0-2.77 2.23-5 5-5Z"/><g aria-label="I2S AUDIO" style="font-size:10.5833px;line-height:1.25;letter-spacing:1.08479px;fill:#fffffc;stroke-width:.264583"><path d="M10.138 20.666H6.48V4.86h3.658ZM18.99 17.685h6.796v2.98H13.842v-2.37l6.096-5.757q.97-.926 1.31-1.58.338-.678.338-1.333 0-.948-.655-1.445-.632-.52-1.874-.52-1.038 0-1.874.407-.835.384-1.4 1.174L13.12 7.525q.926-1.377 2.552-2.144 1.625-.79 3.725-.79 1.761 0 3.07.586 1.333.565 2.055 1.626.745 1.039.745 2.46 0 1.288-.542 2.417-.542 1.129-2.1 2.574zM34.57 20.937q-1.875 0-3.636-.497-1.738-.52-2.8-1.332l1.242-2.755q1.016.745 2.416 1.197 1.4.452 2.8.452 1.558 0 2.303-.452.745-.474.745-1.242 0-.564-.452-.926-.429-.383-1.129-.61-.677-.225-1.85-.496-1.807-.429-2.959-.858-1.151-.429-1.986-1.377-.813-.948-.813-2.529 0-1.377.745-2.483.745-1.13 2.235-1.784 1.513-.655 3.68-.655 1.513 0 2.958.362 1.445.36 2.529 1.038l-1.13 2.777q-2.19-1.242-4.38-1.242-1.535 0-2.28.497-.722.497-.722 1.31 0 .812.835 1.219.858.384 2.597.767 1.806.43 2.957.858 1.152.43 1.965 1.355.835.926.835 2.506 0 1.355-.768 2.484-.745 1.106-2.257 1.76-1.513.656-3.68.656zM67.987 20.666h-3.839l-1.4-3.387h-7.337l-1.4 3.387h-3.748L57.307 4.86h3.613zM59.09 8.45l-2.506 6.051h5.012zM77.403 20.937q-3.387 0-5.284-1.874-1.874-1.874-1.874-5.351v-8.85h3.658v8.714q0 4.245 3.522 4.245 1.716 0 2.62-1.016.902-1.039.902-3.229V4.861h3.613v8.85q0 3.478-1.897 5.352-1.874 1.874-5.26 1.874zM89.257 20.666V4.86h7.18q2.574 0 4.538.994 1.987.97 3.07 2.754 1.107 1.784 1.107 4.154 0 2.371-1.107 4.155-1.083 1.783-3.07 2.777-1.964.97-4.538.97zm7-3.003q2.37 0 3.77-1.31 1.422-1.332 1.422-3.59 0-2.257-1.422-3.567-1.4-1.332-3.77-1.332h-3.342v9.799zM112.649 20.666h-3.658V4.86h3.658zM125.135 20.937q-2.46 0-4.448-1.062-1.964-1.06-3.093-2.912-1.106-1.874-1.106-4.2 0-2.325 1.106-4.176 1.13-1.874 3.093-2.936 1.987-1.06 4.448-1.06 2.461 0 4.426 1.06 1.964 1.062 3.093 2.936 1.129 1.851 1.129 4.176 0 2.326-1.13 4.2-1.128 1.851-3.092 2.912-1.965 1.062-4.426 1.062zm0-3.116q1.4 0 2.529-.632 1.129-.655 1.761-1.807.655-1.151.655-2.619 0-1.467-.655-2.619-.632-1.151-1.761-1.783-1.129-.655-2.529-.655t-2.528.655q-1.13.632-1.784 1.783-.632 1.152-.632 2.62 0 1.467.632 2.618.655 1.152 1.784 1.807 1.128.632 2.528.632z" style="font-weight:700;font-size:22.5778px;font-family:Montserrat;-inkscape-font-specification:'Montserrat, Bold'"/></g></svg>
diff --git a/index.rst b/index.rst
index 21c9f0f9c..bc1ea6fc6 100644
--- a/index.rst
+++ b/index.rst
@@ -631,6 +631,14 @@ Lock Components
     Generic Output Lock, components/lock/output, upload.svg
     Template Lock, components/lock/template, description.svg
 
+Media Player Components
+-----------------------
+
+.. imgtable::
+
+    Media Player Core, components/media_player/index, folder-open.svg
+    I2S Audio, components/media_player/i2s_audio, i2s_audio.svg
+
 Misc Components
 ---------------
 

From c34c62430d741768eca1919f2fa0a80381b14c1d Mon Sep 17 00:00:00 2001
From: jimtng <2554958+jimtng@users.noreply.github.com>
Date: Fri, 3 Jun 2022 11:51:54 +1000
Subject: [PATCH 14/35] Add docs for mqtt.on_connect / on_disconnect (#2105)

---
 components/mqtt.rst    | 20 ++++++++++++++++++++
 guides/automations.rst |  3 ++-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/components/mqtt.rst b/components/mqtt.rst
index 9957d5509..fab2d1529 100644
--- a/components/mqtt.rst
+++ b/components/mqtt.rst
@@ -89,6 +89,10 @@ Configuration variables:
 - **keepalive** (*Optional*, :ref:`config-time`): The time
   to keep the MQTT socket alive, decreasing this can help with overall stability due to more
   WiFi traffic with more pings. Defaults to 15 seconds.
+- **on_connect** (*Optional*, :ref:`Automation <automation>`): An action to be performed when a connection
+  to the broker is established.
+- **on_disconnect** (*Optional*, :ref:`Automation <automation>`): An action to be performed when the connection
+  to the broker is dropped.
 - **on_message** (*Optional*, :ref:`Automation <automation>`): An action to be
   performed when a message on a specific MQTT topic is received. See :ref:`mqtt-on_message`.
 - **on_json_message** (*Optional*, :ref:`Automation <automation>`): An action to be
@@ -368,6 +372,22 @@ Configuration variables:
     When changing these options and you're using MQTT discovery, you will need to restart Home Assistant.
     This is because Home Assistant only discovers a device once in every Home Assistant start.
 
+.. _mqtt-on_connect_disconnect:
+
+``on_connect`` / ``on_disconnect`` Trigger
+------------------------------------------
+
+This trigger is activated when a connection to the MQTT broker is established or dropped.
+
+.. code-block:: yaml
+
+    mqtt:
+      # ...
+      on_connect:
+        - switch.turn_on: switch1
+      on_disconnect:
+        - switch.turn_off: switch1
+
 .. _mqtt-on_message:
 
 ``on_message`` Trigger
diff --git a/guides/automations.rst b/guides/automations.rst
index 7497d19e1..3465a249e 100644
--- a/guides/automations.rst
+++ b/guides/automations.rst
@@ -330,7 +330,8 @@ All Triggers
 - :ref:`light.on_turn_on / light.on_turn_off <light-on_turn_on_off_trigger>`
 - :ref:`logger.on_message <logger-on_message>`
 - :ref:`time.on_time <time-on_time>` / - :ref:`time.on_time_sync <time-on_time_sync>`
-- :ref:`mqtt.on_message <mqtt-on_message>` / :ref:`mqtt.on_json_message <mqtt-on_json_message>`
+- :ref:`mqtt.on_message <mqtt-on_message>` / :ref:`mqtt.on_json_message <mqtt-on_json_message>` / 
+  :ref:`mqtt.on_connect / mqtt.on_disconnect <mqtt-on_connect_disconnect>`
 - :ref:`pn532.on_tag <pn532-on_tag>` / :ref:`rdm6300.on_tag <rdm6300-on_tag>`
 - :ref:`interval.interval <interval>`
 - :ref:`switch.on_turn_on / switch.on_turn_off <switch-on_turn_on_off_trigger>`

From b79a5f633b4526c04ae9a9b135d5781f5a737040 Mon Sep 17 00:00:00 2001
From: Joe <madcoder@gmail.com>
Date: Thu, 2 Jun 2022 21:53:28 -0400
Subject: [PATCH 15/35] Document BedJet clock methods (#2098)

Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
---
 components/climate/bedjet.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/climate/bedjet.rst b/components/climate/bedjet.rst
index 6f50ebbe7..78b15134a 100644
--- a/components/climate/bedjet.rst
+++ b/components/climate/bedjet.rst
@@ -64,6 +64,30 @@ From :ref:`lambdas <config-lambda>`, you can call methods to do some advanced st
             - lambda: |-
                 id(my_bedjet_fan).upgrade_firmware();
 
+- ``.send_local_time``: If `time_id` is set, attempt to sync the clock now.
+
+  .. code-block:: yaml
+
+      button:
+        - platform: template
+          name: "Sync Clock"
+          on_press:
+            then:
+            - lambda: |-
+                id(my_bedjet_fan).send_local_time();
+
+- ``.set_clock``: Set the BedJet clock to a specified time; works with or without a `time_id`.
+
+  .. code-block:: yaml
+
+      button:
+        - platform: template
+          name: "Set Clock to 10:10pm"
+          on_press:
+            then:
+            - lambda: |-
+                id(my_bedjet_fan).set_clock(22, 10);
+
 Known issues:
 -------------
 

From 4214c29148c85ed073202347862e299e0c816d1b Mon Sep 17 00:00:00 2001
From: Eric van Blokland <8546466+Emrvb@users.noreply.github.com>
Date: Fri, 3 Jun 2022 05:37:07 +0200
Subject: [PATCH 16/35] Added documentation for the RC6 codec (#2103)

---
 components/remote_receiver.rst    |  9 +++++++++
 components/remote_transmitter.rst | 20 ++++++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/components/remote_receiver.rst b/components/remote_receiver.rst
index 84521c65c..689bbe169 100644
--- a/components/remote_receiver.rst
+++ b/components/remote_receiver.rst
@@ -43,6 +43,7 @@ Configuration variables:
   - **pronto**: Print remote code in Pronto form. Useful for using arbitrary protocols.
   - **raw**: Print all remote codes in their raw form. Also useful for using arbitrary protocols.
   - **rc5**: Decode and dump RC5 IR codes.
+  - **rc6**: Decode and dump RC6 IR codes.
   - **rc_switch**: Decode and dump RCSwitch RF codes.
   - **samsung**: Decode and dump Samsung infrared codes.
   - **samsung36**: Decode and dump Samsung36 infrared codes.
@@ -111,6 +112,9 @@ Automations:
 - **on_rc5** (*Optional*, :ref:`Automation <automation>`): An automation to perform when a
   RC5 remote code has been decoded. A variable ``x`` of type :apistruct:`remote_base::RC5Data`
   is passed to the automation for use in lambdas.
+- **on_rc6** (*Optional*, :ref:`Automation <automation>`): An automation to perform when a
+  RC6 remote code has been decoded. A variable ``x`` of type :apistruct:`remote_base::RC6Data`
+  is passed to the automation for use in lambdas.
 - **on_rc_switch** (*Optional*, :ref:`Automation <automation>`): An automation to perform when a
   RCSwitch RF code has been decoded. A variable ``x`` of type :apistruct:`remote_base::RCSwitchData`
   is passed to the automation for use in lambdas.
@@ -232,6 +236,11 @@ Remote code selection (exactly one of these has to be included):
   - **address** (**Required**, int): The address to trigger on, see dumper output for more info.
   - **command** (**Required**, int): The RC5 command to listen for.
 
+- **rc6**: Trigger on a decoded RC6 remote code with the given data.
+
+  - **address** (**Required**, int): The address to trigger on, see dumper output for more info.
+  - **command** (**Required**, int): The RC6 command to listen for.
+
 - **rc_switch_raw**: Trigger on a decoded RC Switch raw remote code with the given data.
 
   - **code** (**Required**, string): The remote code to listen for, copy this from the dumper output. To ignore a bit
diff --git a/components/remote_transmitter.rst b/components/remote_transmitter.rst
index 827f84907..87a2896d2 100644
--- a/components/remote_transmitter.rst
+++ b/components/remote_transmitter.rst
@@ -358,6 +358,26 @@ Configuration variables:
 - **command** (**Required**, int): The RC5 command to send.
 - All other options from :ref:`remote_transmitter-transmit_action`.
 
+.. _remote_transmitter-transmit_rc6:
+
+``remote_transmitter.transmit_rc6`` Action
+******************************************
+
+This :ref:`action <config-action>` sends an RC6 infrared remote code to a remote transmitter.
+
+.. code-block:: yaml
+
+    on_...:
+      - remote_transmitter.transmit_rc6:
+          address: 0x1F
+          command: 0x3F
+
+Configuration variables:
+
+- **address** (**Required**, int): The address to send, see dumper output for more details.
+- **command** (**Required**, int): The RC6 command to send.
+- All other options from :ref:`remote_transmitter-transmit_action`.
+
 .. _remote_transmitter-transmit_rc_switch_raw:
 
 ``remote_transmitter.transmit_rc_switch_raw`` Action

From 5b8b1b5321ba18c150b401aafb8762a2a4e71571 Mon Sep 17 00:00:00 2001
From: Samuel Sieb <samuel-github@sieb.net>
Date: Tue, 7 Jun 2022 03:42:20 -0700
Subject: [PATCH 17/35] add new ILI9341 model (ILI9342) (#2112)

Co-authored-by: Samuel Sieb <samuel@sieb.net>
---
 components/display/ili9341.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/display/ili9341.rst b/components/display/ili9341.rst
index 0e5339de3..07e86feb0 100644
--- a/components/display/ili9341.rst
+++ b/components/display/ili9341.rst
@@ -45,6 +45,7 @@ Configuration variables:
 
   - ``M5STACK``
   - ``TFT 2.4``
+  - ``TFT 2.4R``  (ILI9342)
 
 - **cs_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The CS pin.
 - **dc_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The DC pin.

From e910fd1170ab1a6381c1f02e06b2d7da15930897 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 8 Jun 2022 22:33:29 +1200
Subject: [PATCH 18/35] Docs for media player actions (#2118)

---
 components/media_player/index.rst | 31 +++++++++++++++++++++++++++++++
 guides/automations.rst            |  3 ++-
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/components/media_player/index.rst b/components/media_player/index.rst
index 45005ea04..48fc9d368 100644
--- a/components/media_player/index.rst
+++ b/components/media_player/index.rst
@@ -38,6 +38,37 @@ Configuration variables:
   See https://developers.home-assistant.io/docs/core/entity/#generic-properties
   for a list of available options. Set to ``""`` to remove the default entity category.
 
+.. _media_player-play:
+
+``media_player.play`` Action
+----------------------------
+
+This action will resume playing the media player.
+A future change will allow specifying the ``media_url`` for starting
+a new stream.
+
+.. _media_player-pause:
+
+``media_player.pause`` Action
+-----------------------------
+
+This action pauses the current playback.
+
+.. _media_player-stop:
+
+``media_player.stop`` Action
+----------------------------
+
+This action stops the current playback.
+
+.. _media_player-toggle:
+
+``media_player.toggle`` Action
+------------------------------
+
+This action will pause or resume the current playback.
+
+
 See Also
 --------
 
diff --git a/guides/automations.rst b/guides/automations.rst
index 3465a249e..ca1aada8c 100644
--- a/guides/automations.rst
+++ b/guides/automations.rst
@@ -330,7 +330,7 @@ All Triggers
 - :ref:`light.on_turn_on / light.on_turn_off <light-on_turn_on_off_trigger>`
 - :ref:`logger.on_message <logger-on_message>`
 - :ref:`time.on_time <time-on_time>` / - :ref:`time.on_time_sync <time-on_time_sync>`
-- :ref:`mqtt.on_message <mqtt-on_message>` / :ref:`mqtt.on_json_message <mqtt-on_json_message>` / 
+- :ref:`mqtt.on_message <mqtt-on_message>` / :ref:`mqtt.on_json_message <mqtt-on_json_message>` /
   :ref:`mqtt.on_connect / mqtt.on_disconnect <mqtt-on_connect_disconnect>`
 - :ref:`pn532.on_tag <pn532-on_tag>` / :ref:`rdm6300.on_tag <rdm6300-on_tag>`
 - :ref:`interval.interval <interval>`
@@ -392,6 +392,7 @@ All Actions
 - :ref:`pzemac.reset_energy <pzemac-reset_energy_action>`
 - :ref:`number.set <number-set_action>` / :ref:`number.to_min <number-to-min_action>` / :ref:`number.to_max <number-to-max_action>` / :ref:`number.decrement <number-decrement_action>` / :ref:`number.increment <number-increment_action>` / :ref:`number.operation <number-operation_action>`
 - :ref:`select.set <select-set_action>` / :ref:`select.set_index <select-set_index_action>` / :ref:`select.first <select-first_action>` / :ref:`select.last <select-last_action>` / :ref:`select.previous <select-previous_action>`  / :ref:`select.next <select-next_action>`  / :ref:`select.operation <select-operation_action>`
+- :ref:`media_player.play <media_player-play>` / :ref:`media_player.pause <media_player-pause>` / :ref:`media_player.stop <media_player-stop>` / :ref:`media_player.toggle <media_player-toggle>`
 
 .. _config-condition:
 

From 0e83fc94fe495452034f11133a47aca6b0347377 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 8 Jun 2022 22:46:20 +1200
Subject: [PATCH 19/35] Bump version to 2022.6.0b1

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

diff --git a/Doxygen b/Doxygen
index 8780564ca..9505c11fe 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         = 2022.6.0-dev
+PROJECT_NUMBER         = 2022.6.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 36a481722..9c743e8ed 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = dev
+ESPHOME_REF = 2022.6.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 da61ca8c4..dda065666 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2022.6.0-dev
\ No newline at end of file
+2022.6.0b1
\ No newline at end of file
diff --git a/conf.py b/conf.py
index c47417aec..fe73d5642 100644
--- a/conf.py
+++ b/conf.py
@@ -68,7 +68,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2022.6"
 # The full version, including alpha/beta/rc tags.
-release = "2022.6.0-dev"
+release = "2022.6.0b1"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From de9eaaaa4228e00a320e09d41c8a365133abda35 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 8 Jun 2022 23:13:07 +1200
Subject: [PATCH 20/35] Update changelog for 2022.6.0b1

---
 changelog/2022.6.0.rst | 178 +++++++++++++++++++++++++++++++++++++++++
 changelog/index.rst    |   2 +-
 2 files changed, 179 insertions(+), 1 deletion(-)
 create mode 100644 changelog/2022.6.0.rst

diff --git a/changelog/2022.6.0.rst b/changelog/2022.6.0.rst
new file mode 100644
index 000000000..1ca2cf0e0
--- /dev/null
+++ b/changelog/2022.6.0.rst
@@ -0,0 +1,178 @@
+ESPHome 2022.6.0 - 15th June 2022
+=================================
+
+.. seo::
+    :description: Changelog for ESPHome 2022.6.0.
+    :image: /_static/changelog-2022.5.0.png
+    :author: Jesse Hills
+    :author_twitter: @jesserockz
+
+.. imgtable::
+    :columns: 2
+
+    Tuya Select, components/select/tuya, tuya.png
+    SGP41, components/sensor/sgp4x, sgp40.jpg
+    Media Player Core, components/media_player/index, folder-open.svg
+    I2S Audio, components/media_player/i2s_audio, i2s_audio.svg
+
+
+We are almost half way through 2022 already! My, how fast time flies when we
+are having fun with ESPHome. This release is kind of small, but packs some big features.
+There will be no 2022.7.0 (July) release next month as I (:ghuser:`jesserockz`) will be away
+around that time. So lets hope we can make 2022.8.0 worth the wait.
+
+🎶🎶🎶 Media Players
+--------------------
+
+More info here...
+
+Link to `Media Players <https://esphome.github.io/media-players>`_.
+
+Join us in a live stream all about Audio in the Open Home!
+
+When: Thursday, June 16, at 7pm UTC / 12pm PST / 9pm CET
+
+.. raw:: html
+
+    <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/SEH-DxOsywg"
+            title="YouTube video player" frameborder="0"
+            allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+            allowfullscreen>
+    </iframe>
+
+Includes with vars
+------------------
+
+:ghuser:`jimtng` is a newcomer to ESPHome. While migrating everything from a certain other
+firmware, they found that they had to duplicate lots of yaml configuration for their many devices.
+Basically, they decided to upgrade the ``!include`` yaml "directive" to allow variables.
+
+.. code-block:: yaml
+
+    # device.yaml
+    binary_sensor:
+      - <<: !include
+          file: bin-sensor.yaml
+          vars:
+            pin: GPIO1
+            name: "Binary Sensor 1"
+            switch: my_switch_1_id
+            delay: 10s
+      - <<: !include
+          file: bin-sensor.yaml
+          vars:
+            pin: GPIO1
+            name: "Binary Sensor 2"
+            switch: my_switch_2_id
+            delay: 60s
+
+    # bin-sensor.yaml
+    platform: gpio
+    pin: ${pin}
+    name: ${name}
+    on_press:
+      - switch.turn_on: ${switch}
+      - delay: ${delay}
+      - switch.turn_off: ${switch}
+
+Now while this is probably not the best example, the variables act as ``substitutions``
+and can be used anywhere in the underlying yaml file and can very much DRY out your configurations.
+
+
+
+Flesh out breaking changes here (see list below)
+
+
+Full list of changes
+--------------------
+
+New Components
+^^^^^^^^^^^^^^
+
+- Add Tuya select :esphomepr:`3469` by :ghuser:`bearpawmaxim` (new-integration)
+- Add support for SGP41 :esphomepr:`3382` by :ghuser:`martgras` (new-integration) (breaking-change)
+- Implement Media Player and I2S Media player :esphomepr:`3487` by :ghuser:`jesserockz` (new-integration)
+
+Breaking Changes
+^^^^^^^^^^^^^^^^
+
+- Tcs34725 automatic sampling settings for improved dynamics and accuracy :esphomepr:`3258` by :ghuser:`swifty99` (breaking-change)
+- Add support for SGP41 :esphomepr:`3382` by :ghuser:`martgras` (new-integration) (breaking-change)
+- Remove deprecated fan speeds :esphomepr:`3397` by :ghuser:`kbickar` (breaking-change)
+- Output a true RMS voltage % :esphomepr:`3494` by :ghuser:`josephdouce` (breaking-change)
+- Add display_type property to DisplayBuffer :esphomepr:`3430` by :ghuser:`guillempages` (breaking-change)
+
+Notable Changes
+^^^^^^^^^^^^^^^
+
+- Add variable substitutions for !include :esphomepr:`3510` by :ghuser:`jimtng` (notable-change)
+
+All changes
+^^^^^^^^^^^
+
+- Tcs34725 automatic sampling settings for improved dynamics and accuracy :esphomepr:`3258` by :ghuser:`swifty99` (breaking-change)
+- Remove duplicate convert_to_8bit_color function. :esphomepr:`2469` by :ghuser:`davet2001`
+- Bump esptool from 3.3 to 3.3.1 :esphomepr:`3468` by :ghuser:`dependabot[bot]`
+- Bump pylint from 2.13.8 to 2.13.9 :esphomepr:`3470` by :ghuser:`dependabot[bot]`
+- Tuya status gpio support :esphomepr:`3466` by :ghuser:`bearpawmaxim`
+- Add Tuya select :esphomepr:`3469` by :ghuser:`bearpawmaxim` (new-integration)
+- MQTT cover: send state even if position is available :esphomepr:`3473` by :ghuser:`pyos`
+- Ili9341 8bit indexed mode pt1 :esphomepr:`2490` by :ghuser:`davet2001`
+- feat: esp32-camera add stream event :esphomepr:`3285` by :ghuser:`myml`
+- Add support for SGP41 :esphomepr:`3382` by :ghuser:`martgras` (new-integration) (breaking-change)
+- add support user-defined modbus functions :esphomepr:`3461` by :ghuser:`gazoodle`
+- Remove deprecated fan speeds :esphomepr:`3397` by :ghuser:`kbickar` (breaking-change)
+- Fix compile issues on windows :esphomepr:`3491` by :ghuser:`jesserockz`
+- midea: New power_toggle action. Auto-use remote transmitter. :esphomepr:`3496` by :ghuser:`dudanov`
+- Output a true RMS voltage % :esphomepr:`3494` by :ghuser:`josephdouce` (breaking-change)
+- [scd4x] Fix not passing arguments to templatable value for perform_forced_calibration :esphomepr:`3495` by :ghuser:`Wumpf`
+- Thermostat preset with modes :esphomepr:`3298` by :ghuser:`MrMDavidson`
+- Allow Prometheus component to export internal components :esphomepr:`3508` by :ghuser:`jangrewe`
+- [BedJet] Add configurable heating strategy :esphomepr:`3519` by :ghuser:`jhansche`
+- Add variable substitutions for !include :esphomepr:`3510` by :ghuser:`jimtng` (notable-change)
+- Change rain intensity sensor string :esphomepr:`3511` by :ghuser:`wtremmel`
+- Implement Media Player and I2S Media player :esphomepr:`3487` by :ghuser:`jesserockz` (new-integration)
+- Add mqtt.on_connect and mqtt.on_disconnect triggers :esphomepr:`3520` by :ghuser:`jimtng`
+- Refactor clock syncing :esphomepr:`3503` by :ghuser:`jhansche`
+- Added RC6 protocol support :esphomepr:`3514` by :ghuser:`Emrvb`
+- Add display_type property to DisplayBuffer :esphomepr:`3430` by :ghuser:`guillempages` (breaking-change)
+- Correct ADC auto-range for ESP32-S2 variant (13 bit adc) :esphomepr:`3158` by :ghuser:`CarlosGS`
+- Suppress first rotary encoder event :esphomepr:`3532` by :ghuser:`mmakaay`
+- Fix endless 'WiFi Unknown connection status 0' loop :esphomepr:`3530` by :ghuser:`mmakaay`
+- support rotated ILI9341 (ILI9342) :esphomepr:`3526` by :ghuser:`ssieb`
+- Fix sdp3x error checking :esphomepr:`3531` by :ghuser:`Azimath`
+- Fix percentage validation for wrong data type input :esphomepr:`3524` by :ghuser:`mmakaay`
+- Block Tuya light from reacting to dp changes if transitioning :esphomepr:`3076` by :ghuser:`VitaliyKurokhtin`
+- Cleanup deprecated EntityBase::hash_base() :esphomepr:`3525` by :ghuser:`mmakaay`
+- Fix bogus reading on no communication with MAX31865 :esphomepr:`3505` by :ghuser:`DAVe3283`
+- Implement the media player actions :esphomepr:`3534` by :ghuser:`jesserockz`
+- RG15 data is float/double, not int :esphomepr:`3512` by :ghuser:`wtremmel`
+
+
+Past Changelogs
+---------------
+
+- :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 56c0517e3..b395ce5f6 100644
--- a/changelog/index.rst
+++ b/changelog/index.rst
@@ -2,7 +2,7 @@ Changelog
 =========
 
 .. redirect::
-    :url: /changelog/2022.5.0.html
+    :url: /changelog/2022.6.0.html
 
 .. toctree::
     :glob:

From a1df33e5f1c44a07fea11fec2db0d4155f2be37a Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Wed, 8 Jun 2022 23:13:45 +1200
Subject: [PATCH 21/35] Update supporters for 2022.6.0b1

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

diff --git a/guides/supporters.rst b/guides/supporters.rst
index 94c2df205..7211496dd 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -132,6 +132,7 @@ Contributors
 - `cbialobos (@cbialobos) <https://github.com/cbialobos>`__
 - `Ciprian Constantinescu (@cciprian5) <https://github.com/cciprian5>`__
 - `Marco (@cdrfun) <https://github.com/cdrfun>`__
+- `Cellie (@CelliesProjects) <https://github.com/CelliesProjects>`__
 - `Kostas Chatzikokolakis (@chatziko) <https://github.com/chatziko>`__
 - `chris-jennings (@chris-jennings) <https://github.com/chris-jennings>`__
 - `Christian Taedcke (@chrta) <https://github.com/chrta>`__
@@ -203,6 +204,7 @@ Contributors
 - `Mark  (@Diramu) <https://github.com/Diramu>`__
 - `Dirk Heinke (@DirkHeinke) <https://github.com/DirkHeinke>`__
 - `Dirk Jahnke (@dirkj) <https://github.com/dirkj>`__
+- `Johann V. (@divinitas) <https://github.com/divinitas>`__
 - `djwlindenaar (@djwlindenaar) <https://github.com/djwlindenaar>`__
 - `Marcos Pérez Ferro (@djwmarcx) <https://github.com/djwmarcx>`__
 - `Dan Mannock (@dmannock) <https://github.com/dmannock>`__
@@ -242,6 +244,7 @@ Contributors
 - `EmbeddedDevver (@EmbeddedDevver) <https://github.com/EmbeddedDevver>`__
 - `EmmanuelLM (@EmmanuelLM) <https://github.com/EmmanuelLM>`__
 - `Emory Dunn (@emorydunn) <https://github.com/emorydunn>`__
+- `Eric van Blokland (@Emrvb) <https://github.com/Emrvb>`__
 - `Eric Muehlstein (@emuehlstein) <https://github.com/emuehlstein>`__
 - `Anders Persson (@emwap) <https://github.com/emwap>`__
 - `Bert (@Engelbert) <https://github.com/Engelbert>`__
@@ -272,6 +275,7 @@ Contributors
 - `Francis-labo (@Francis-labo) <https://github.com/Francis-labo>`__
 - `Francisk0 (@Francisk0) <https://github.com/Francisk0>`__
 - `Frank Bakker (@FrankBakkerNl) <https://github.com/FrankBakkerNl>`__
+- `Frank (@FrankBoesing) <https://github.com/FrankBoesing>`__
 - `Frank Langtind (@frankiboy1) <https://github.com/frankiboy1>`__
 - `Frankster-NL (@Frankster-NL) <https://github.com/Frankster-NL>`__
 - `Fredrik Erlandsson (@fredrike) <https://github.com/fredrike>`__
@@ -358,6 +362,7 @@ Contributors
 - `James Braid (@jamesbraid) <https://github.com/jamesbraid>`__
 - `James Duke (@jamesduke) <https://github.com/jamesduke>`__
 - `James Gao (@jamesgao) <https://github.com/jamesgao>`__
+- `Jan Grewe (@jangrewe) <https://github.com/jangrewe>`__
 - `János Rusiczki (@janosrusiczki) <https://github.com/janosrusiczki>`__
 - `Jan Pieper (@janpieper) <https://github.com/janpieper>`__
 - `Jarek.P (@JaroslawPrzybyl) <https://github.com/JaroslawPrzybyl>`__
@@ -384,6 +389,7 @@ Contributors
 - `Yuval Brik (@jhamhader) <https://github.com/jhamhader>`__
 - `Joe (@jhansche) <https://github.com/jhansche>`__
 - `Jim Bauwens (@jimbauwens) <https://github.com/jimbauwens>`__
+- `jimtng (@jimtng) <https://github.com/jimtng>`__
 - `Jérémy JOURDIN (@JJK801) <https://github.com/JJK801>`__
 - `Jonathan Jefferies (@jjok) <https://github.com/jjok>`__
 - `John K. Luebs (@jkl1337) <https://github.com/jkl1337>`__
@@ -455,6 +461,7 @@ Contributors
 - `Luca Gugelmann (@lgugelmann) <https://github.com/lgugelmann>`__
 - `Lubos Horacek (@lhoracek) <https://github.com/lhoracek>`__
 - `Juraj Liso (@LiJu09) <https://github.com/LiJu09>`__
+- `lingex (@lingex) <https://github.com/lingex>`__
 - `Lazar Obradovic (@lobradov) <https://github.com/lobradov>`__
 - `Barry Loong (@loongyh) <https://github.com/loongyh>`__
 - `LuBeDa (@lubeda) <https://github.com/lubeda>`__
@@ -468,6 +475,7 @@ Contributors
 - `Alex Peters (@Lx) <https://github.com/Lx>`__
 - `Michael Klamminger (@m1ch) <https://github.com/m1ch>`__
 - `M95D (@M95D) <https://github.com/M95D>`__
+- `maaadc (@maaadc) <https://github.com/maaadc>`__
 - `Marc-Antoine Courteau (@macourteau) <https://github.com/macourteau>`__
 - `Massimiliano Ravelli (@madron) <https://github.com/madron>`__
 - `Alexandre-Jacques St-Jacques (@Maelstrom96) <https://github.com/Maelstrom96>`__
@@ -699,7 +707,9 @@ Contributors
 - `Jan Čermák (@sairon) <https://github.com/sairon>`__
 - `sascha lammers (@sascha432) <https://github.com/sascha432>`__
 - `Nils Schulte (@Schnilz) <https://github.com/Schnilz>`__
+- `Wolle (@schreibfaul1) <https://github.com/schreibfaul1>`__
 - `Ville Skyttä (@scop) <https://github.com/scop>`__
+- `Stefan Seyfried (@seife) <https://github.com/seife>`__
 - `sekkr1 (@sekkr1) <https://github.com/sekkr1>`__
 - `SenexCrenshaw (@SenexCrenshaw) <https://github.com/SenexCrenshaw>`__
 - `Sergio (@sergio303) <https://github.com/sergio303>`__
@@ -742,6 +752,7 @@ Contributors
 - `Sympatron GmbH (@Sympatron) <https://github.com/Sympatron>`__
 - `synco (@synco) <https://github.com/synco>`__
 - `Marcel Feix (@Syndlex) <https://github.com/Syndlex>`__
+- `SyXavier (@SyXavier) <https://github.com/SyXavier>`__
 - `Teemu Mikkonen (@T3m3z) <https://github.com/T3m3z>`__
 - `Taigar2015 (@Taigar2015) <https://github.com/Taigar2015>`__
 - `Levente Tamas (@tamisoft) <https://github.com/tamisoft>`__
@@ -753,6 +764,7 @@ Contributors
 - `Greg Lincoln (@tetious) <https://github.com/tetious>`__
 - `Nejc (@thedexboy) <https://github.com/thedexboy>`__
 - `Thomas Eckerstorfer (@TheEggi) <https://github.com/TheEggi>`__
+- `Theexternaldisk (@Theexternaldisk) <https://github.com/Theexternaldisk>`__
 - `TheGroundZero (@TheGroundZero) <https://github.com/TheGroundZero>`__
 - `thejonesyboy (@thejonesyboy) <https://github.com/thejonesyboy>`__
 - `TheJulianJES (@TheJulianJES) <https://github.com/TheJulianJES>`__
@@ -776,6 +788,7 @@ Contributors
 - `TomFahey (@TomFahey) <https://github.com/TomFahey>`__
 - `tomlut (@tomlut) <https://github.com/tomlut>`__
 - `Tom Matheussen (@Tommatheussen) <https://github.com/Tommatheussen>`__
+- `tomle (@tomole444) <https://github.com/tomole444>`__
 - `Tom Price (@tomtom5152) <https://github.com/tomtom5152>`__
 - `tony (@tony-fav) <https://github.com/tony-fav>`__
 - `David Kiliani (@torfbolt) <https://github.com/torfbolt>`__
@@ -798,6 +811,7 @@ Contributors
 - `ukewea (@ukewea) <https://github.com/ukewea>`__
 - `Unai (@unaiur) <https://github.com/unaiur>`__
 - `user897943 (@user897943) <https://github.com/user897943>`__
+- `UT2UH (@UT2UH) <https://github.com/UT2UH>`__
 - `Vc (@Valcob) <https://github.com/Valcob>`__
 - `Nad (@valordk) <https://github.com/valordk>`__
 - `André Lademann (@vergissberlin) <https://github.com/vergissberlin>`__
@@ -824,17 +838,15 @@ Contributors
 - `Rick van Hattem (@WoLpH) <https://github.com/WoLpH>`__
 - `workingmanrob (@workingmanrob) <https://github.com/workingmanrob>`__
 - `Wojtek Strzalka (@wstrzalka) <https://github.com/wstrzalka>`__
+- `Wolfgang Tremmel (@wtremmel) <https://github.com/wtremmel>`__
 - `Wumpf (@Wumpf) <https://github.com/Wumpf>`__
-- `wysiwyng (@wysiwyng) <https://github.com/wysiwyng>`__
 - `Mike (@xsnoopy) <https://github.com/xsnoopy>`__
 - `Yaroslav (@Yarikx) <https://github.com/Yarikx>`__
 - `Marcin Jaworski (@yawor) <https://github.com/yawor>`__
-- `ychieux (@ychieux) <https://github.com/ychieux>`__
 - `Pavel (@yekm) <https://github.com/yekm>`__
 - `Atsuko Ito (@yottatsa) <https://github.com/yottatsa>`__
 - `Nico B (@youknow0) <https://github.com/youknow0>`__
 - `Yuval Aboulafia (@yuvalabou) <https://github.com/yuvalabou>`__
-- `zaluthar (@zaluthar) <https://github.com/zaluthar>`__
 - `david reid (@zathras777) <https://github.com/zathras777>`__
 - `Zebble (@Zebble) <https://github.com/Zebble>`__
 - `ZJY (@zhangjingye03) <https://github.com/zhangjingye03>`__
@@ -843,4 +855,4 @@ Contributors
 - `Michael Labuschke (@zigman79) <https://github.com/zigman79>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated May 24, 2022.*
+*This page was last updated June 8, 2022.*

From e7276f5efc3a07a6292e30db8a2e32fb6ebf1abf Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 9 Jun 2022 20:25:57 +1200
Subject: [PATCH 22/35] Remove svg2png from netlify build (#2121)

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index 9c743e8ed..3ebd5acbc 100644
--- a/Makefile
+++ b/Makefile
@@ -48,7 +48,7 @@ netlify-dependencies:
 copy-svg2png:
 	cp svg2png/*.png _build/html/_images/
 
-netlify: netlify-dependencies netlify-api html svg2png copy-svg2png
+netlify: netlify-dependencies netlify-api html copy-svg2png
 
 lint: html-strict
 	python3 lint.py

From 7be3b7605601b57cc907d75edb64b2ce5ad74538 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 9 Jun 2022 20:27:25 +1200
Subject: [PATCH 23/35] Bump version to 2022.6.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 9505c11fe..61f4f4495 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         = 2022.6.0b1
+PROJECT_NUMBER         = 2022.6.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 3ebd5acbc..8020558b1 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2022.6.0b1
+ESPHOME_REF = 2022.6.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 dda065666..677e9c706 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2022.6.0b1
\ No newline at end of file
+2022.6.0b2
\ No newline at end of file
diff --git a/conf.py b/conf.py
index fe73d5642..737984f07 100644
--- a/conf.py
+++ b/conf.py
@@ -68,7 +68,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2022.6"
 # The full version, including alpha/beta/rc tags.
-release = "2022.6.0b1"
+release = "2022.6.0b2"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From 1e160c2e8b7d7be82d07bfb0cacf07e90fbd6955 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 9 Jun 2022 20:27:59 +1200
Subject: [PATCH 24/35] Update changelog for 2022.6.0b2

---
 changelog/2022.6.0.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/changelog/2022.6.0.rst b/changelog/2022.6.0.rst
index 1ca2cf0e0..17f0ce2b3 100644
--- a/changelog/2022.6.0.rst
+++ b/changelog/2022.6.0.rst
@@ -107,6 +107,12 @@ Notable Changes
 
 - Add variable substitutions for !include :esphomepr:`3510` by :ghuser:`jimtng` (notable-change)
 
+Beta Changes
+^^^^^^^^^^^^
+
+- publish fan speed count for discovery :esphomepr:`3537` by :ghuser:`ssieb`
+- Nextion brightness setting requires an assignment :esphomepr:`3533` by :ghuser:`nagyv`
+
 All changes
 ^^^^^^^^^^^
 
@@ -147,6 +153,8 @@ All changes
 - Fix bogus reading on no communication with MAX31865 :esphomepr:`3505` by :ghuser:`DAVe3283`
 - Implement the media player actions :esphomepr:`3534` by :ghuser:`jesserockz`
 - RG15 data is float/double, not int :esphomepr:`3512` by :ghuser:`wtremmel`
+- publish fan speed count for discovery :esphomepr:`3537` by :ghuser:`ssieb`
+- Nextion brightness setting requires an assignment :esphomepr:`3533` by :ghuser:`nagyv`
 
 
 Past Changelogs

From 573e01eaa1154cebd4360ce3599657e7d50ee730 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 9 Jun 2022 20:28:32 +1200
Subject: [PATCH 25/35] Update supporters for 2022.6.0b2

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

diff --git a/guides/supporters.rst b/guides/supporters.rst
index 7211496dd..e2520e5fb 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -562,6 +562,7 @@ Contributors
 - `Kevin Uhlir (@n0bel) <https://github.com/n0bel>`__
 - `Erik Näsström (@Naesstrom) <https://github.com/Naesstrom>`__
 - `H. Árkosi Róbert (@nagyrobi) <https://github.com/nagyrobi>`__
+- `Viktor Nagy (@nagyv) <https://github.com/nagyv>`__
 - `Oskar Napieraj (@napieraj) <https://github.com/napieraj>`__
 - `Nate Lust (@natelust) <https://github.com/natelust>`__
 - `ueno (@nayuta-ueno) <https://github.com/nayuta-ueno>`__
@@ -685,6 +686,7 @@ Contributors
 - `Robert Alfaro (@robert-alfaro) <https://github.com/robert-alfaro>`__
 - `Rob Gridley (@robgridley) <https://github.com/robgridley>`__
 - `Robin Smidsrød (@robinsmidsrod) <https://github.com/robinsmidsrod>`__
+- `RoboMagus (@RoboMagus) <https://github.com/RoboMagus>`__
 - `RockBomber (@RockBomber) <https://github.com/RockBomber>`__
 - `RoganDawes (@RoganDawes) <https://github.com/RoganDawes>`__
 - `Roi Tagar (@roitagar) <https://github.com/roitagar>`__
@@ -810,7 +812,6 @@ Contributors
 - `Tyler Menezes (@tylermenezes) <https://github.com/tylermenezes>`__
 - `ukewea (@ukewea) <https://github.com/ukewea>`__
 - `Unai (@unaiur) <https://github.com/unaiur>`__
-- `user897943 (@user897943) <https://github.com/user897943>`__
 - `UT2UH (@UT2UH) <https://github.com/UT2UH>`__
 - `Vc (@Valcob) <https://github.com/Valcob>`__
 - `Nad (@valordk) <https://github.com/valordk>`__
@@ -818,7 +819,6 @@ Contributors
 - `Víctor Ferrer García (@vicfergar) <https://github.com/vicfergar>`__
 - `Vincèn (@vincegre) <https://github.com/vincegre>`__
 - `VitaliyKurokhtin (@VitaliyKurokhtin) <https://github.com/VitaliyKurokhtin>`__
-- `voibit (@voibit) <https://github.com/voibit>`__
 - `Xuming Feng (@voicevon) <https://github.com/voicevon>`__
 - `vxider (@Vxider) <https://github.com/Vxider>`__
 - `WallyCZ (@WallyCZ) <https://github.com/WallyCZ>`__
@@ -855,4 +855,4 @@ Contributors
 - `Michael Labuschke (@zigman79) <https://github.com/zigman79>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated June 8, 2022.*
+*This page was last updated June 9, 2022.*

From 04e247ec9ab14a323c8cdf88a4becdcb146d1e97 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 13 Jun 2022 13:29:35 +1200
Subject: [PATCH 26/35] Add volume actions for media player (#2124)

---
 components/media_player/index.rst | 57 ++++++++++++++++++++++++++++---
 guides/automations.rst            |  1 +
 2 files changed, 54 insertions(+), 4 deletions(-)

diff --git a/components/media_player/index.rst b/components/media_player/index.rst
index 48fc9d368..fa7a241ad 100644
--- a/components/media_player/index.rst
+++ b/components/media_player/index.rst
@@ -38,10 +38,21 @@ Configuration variables:
   See https://developers.home-assistant.io/docs/core/entity/#generic-properties
   for a list of available options. Set to ``""`` to remove the default entity category.
 
+Media Player Actions
+--------------------
+
+All ``media_player`` actions can be used without specifying an ``id`` if you have only one ``media_player`` in
+your configuration YAML.
+
+Configuration variables:
+
+**id** (*Optional*, :ref:`config-id`): The media player to control. Defaults to the only one in YAML.
+
+
 .. _media_player-play:
 
 ``media_player.play`` Action
-----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This action will resume playing the media player.
 A future change will allow specifying the ``media_url`` for starting
@@ -50,24 +61,62 @@ a new stream.
 .. _media_player-pause:
 
 ``media_player.pause`` Action
------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This action pauses the current playback.
 
 .. _media_player-stop:
 
 ``media_player.stop`` Action
-----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This action stops the current playback.
 
 .. _media_player-toggle:
 
 ``media_player.toggle`` Action
-------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This action will pause or resume the current playback.
 
+.. _media_player-volume_up:
+
+``media_player.volume_up`` Action
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This action will increase the volume of the media player.
+
+.. _media_player-volume_down:
+
+``media_player.volume_down`` Action
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This action will decrease the volume of the media player.
+
+.. _media_player-volume_set:
+
+``media_player.volume_set`` Action
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This action will set the volume of the media player.
+
+.. code-block::
+
+    on_...:
+      # Simple
+      - media_player.volume_set: 50%
+
+      # Full
+      - media_player.volume_set:
+          id: media_player_id
+          volume: 50%
+
+      # Simple with lambda
+      - media_player.volume_set: !lambda "return 0.5;"
+
+Configuration variables:
+
+**volume** (**Required**, percentage): The volume to set the media player to.
 
 See Also
 --------
diff --git a/guides/automations.rst b/guides/automations.rst
index ca1aada8c..fb457796b 100644
--- a/guides/automations.rst
+++ b/guides/automations.rst
@@ -393,6 +393,7 @@ All Actions
 - :ref:`number.set <number-set_action>` / :ref:`number.to_min <number-to-min_action>` / :ref:`number.to_max <number-to-max_action>` / :ref:`number.decrement <number-decrement_action>` / :ref:`number.increment <number-increment_action>` / :ref:`number.operation <number-operation_action>`
 - :ref:`select.set <select-set_action>` / :ref:`select.set_index <select-set_index_action>` / :ref:`select.first <select-first_action>` / :ref:`select.last <select-last_action>` / :ref:`select.previous <select-previous_action>`  / :ref:`select.next <select-next_action>`  / :ref:`select.operation <select-operation_action>`
 - :ref:`media_player.play <media_player-play>` / :ref:`media_player.pause <media_player-pause>` / :ref:`media_player.stop <media_player-stop>` / :ref:`media_player.toggle <media_player-toggle>`
+  / :ref:`media_player.volume_up <media_player-volume_up>` / :ref:`media_player.volume_down <media_player-volume_down>` / :ref:`media_player.volume_set <media_player-volume_set>`
 
 .. _config-condition:
 

From 856f2f301fe8a058c4cccf37722e3c65abc4f9f2 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 13 Jun 2022 13:32:45 +1200
Subject: [PATCH 27/35] Bump version to 2022.6.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 61f4f4495..935f0f618 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         = 2022.6.0b2
+PROJECT_NUMBER         = 2022.6.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 8020558b1..8e5591e0a 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2022.6.0b2
+ESPHOME_REF = 2022.6.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 677e9c706..1559d289c 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2022.6.0b2
\ No newline at end of file
+2022.6.0b3
\ No newline at end of file
diff --git a/conf.py b/conf.py
index 737984f07..5d4e88600 100644
--- a/conf.py
+++ b/conf.py
@@ -68,7 +68,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2022.6"
 # The full version, including alpha/beta/rc tags.
-release = "2022.6.0b2"
+release = "2022.6.0b3"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From b284b7414f269908da325aa10eed7b6be5932c11 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 13 Jun 2022 13:33:17 +1200
Subject: [PATCH 28/35] Update changelog for 2022.6.0b3

---
 changelog/2022.6.0.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/changelog/2022.6.0.rst b/changelog/2022.6.0.rst
index 17f0ce2b3..7671400c7 100644
--- a/changelog/2022.6.0.rst
+++ b/changelog/2022.6.0.rst
@@ -112,6 +112,7 @@ Beta Changes
 
 - publish fan speed count for discovery :esphomepr:`3537` by :ghuser:`ssieb`
 - Nextion brightness setting requires an assignment :esphomepr:`3533` by :ghuser:`nagyv`
+- Implement media player volume actions :esphomepr:`3551` by :ghuser:`jesserockz`
 
 All changes
 ^^^^^^^^^^^
@@ -155,6 +156,7 @@ All changes
 - RG15 data is float/double, not int :esphomepr:`3512` by :ghuser:`wtremmel`
 - publish fan speed count for discovery :esphomepr:`3537` by :ghuser:`ssieb`
 - Nextion brightness setting requires an assignment :esphomepr:`3533` by :ghuser:`nagyv`
+- Implement media player volume actions :esphomepr:`3551` by :ghuser:`jesserockz`
 
 
 Past Changelogs

From 8c562ad95aeba44d238180155a0732ea2f5b6b59 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 13 Jun 2022 13:33:51 +1200
Subject: [PATCH 29/35] Update supporters for 2022.6.0b3

---
 guides/supporters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/guides/supporters.rst b/guides/supporters.rst
index e2520e5fb..dafaf10e3 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -855,4 +855,4 @@ Contributors
 - `Michael Labuschke (@zigman79) <https://github.com/zigman79>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated June 9, 2022.*
+*This page was last updated June 13, 2022.*

From 1b2456a6cd863d551a59731a6ae2fd42db52d637 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Tue, 14 Jun 2022 20:41:47 +1200
Subject: [PATCH 30/35] Bump version to 2022.6.0b4

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

diff --git a/Doxygen b/Doxygen
index 935f0f618..913bd1d89 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         = 2022.6.0b3
+PROJECT_NUMBER         = 2022.6.0b4
 
 # 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 8e5591e0a..9e10afcb2 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2022.6.0b3
+ESPHOME_REF = 2022.6.0b4
 
 .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 1559d289c..695f04138 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2022.6.0b3
\ No newline at end of file
+2022.6.0b4
\ No newline at end of file
diff --git a/conf.py b/conf.py
index 5d4e88600..39ac72d71 100644
--- a/conf.py
+++ b/conf.py
@@ -68,7 +68,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2022.6"
 # The full version, including alpha/beta/rc tags.
-release = "2022.6.0b3"
+release = "2022.6.0b4"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From e20d168bc33fa1b7e3c64b677e4ed8896298e551 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Tue, 14 Jun 2022 20:42:06 +1200
Subject: [PATCH 31/35] Update changelog for 2022.6.0b4

---
 changelog/2022.6.0.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/changelog/2022.6.0.rst b/changelog/2022.6.0.rst
index 7671400c7..bd862ea8e 100644
--- a/changelog/2022.6.0.rst
+++ b/changelog/2022.6.0.rst
@@ -113,6 +113,8 @@ Beta Changes
 - publish fan speed count for discovery :esphomepr:`3537` by :ghuser:`ssieb`
 - Nextion brightness setting requires an assignment :esphomepr:`3533` by :ghuser:`nagyv`
 - Implement media player volume actions :esphomepr:`3551` by :ghuser:`jesserockz`
+- Fix compilation with ESP32-S3 :esphomepr:`3543` by :ghuser:`misery`
+- Bm3xx: Fix typo :esphomepr:`3559` by :ghuser:`martgras`
 
 All changes
 ^^^^^^^^^^^
@@ -157,7 +159,8 @@ All changes
 - publish fan speed count for discovery :esphomepr:`3537` by :ghuser:`ssieb`
 - Nextion brightness setting requires an assignment :esphomepr:`3533` by :ghuser:`nagyv`
 - Implement media player volume actions :esphomepr:`3551` by :ghuser:`jesserockz`
-
+- Fix compilation with ESP32-S3 :esphomepr:`3543` by :ghuser:`misery`
+- Bm3xx: Fix typo :esphomepr:`3559` by :ghuser:`martgras`
 
 Past Changelogs
 ---------------

From 226e896b0bea1e48587c7ffa714a514c02a59e2d Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Tue, 14 Jun 2022 20:42:40 +1200
Subject: [PATCH 32/35] Update supporters for 2022.6.0b4

---
 guides/supporters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/guides/supporters.rst b/guides/supporters.rst
index dafaf10e3..01d21de45 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -855,4 +855,4 @@ Contributors
 - `Michael Labuschke (@zigman79) <https://github.com/zigman79>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated June 13, 2022.*
+*This page was last updated June 14, 2022.*

From aa77b67881f05aa9ea51c2353141ad9555334b7f Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 16 Jun 2022 11:31:38 +1200
Subject: [PATCH 33/35] Bump version to 2022.6.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 913bd1d89..aa8b95949 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         = 2022.6.0b4
+PROJECT_NUMBER         = 2022.6.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 9e10afcb2..8a9cebdd3 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2022.6.0b4
+ESPHOME_REF = 2022.6.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 695f04138..1245b2d31 100644
--- a/_static/version
+++ b/_static/version
@@ -1 +1 @@
-2022.6.0b4
\ No newline at end of file
+2022.6.0
\ No newline at end of file
diff --git a/conf.py b/conf.py
index 39ac72d71..fe8ab960a 100644
--- a/conf.py
+++ b/conf.py
@@ -68,7 +68,7 @@ author = "ESPHome"
 # The short X.Y version.
 version = "2022.6"
 # The full version, including alpha/beta/rc tags.
-release = "2022.6.0b4"
+release = "2022.6.0"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From c058907a078defb08a075891eeb88948349a6404 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 16 Jun 2022 12:42:53 +1200
Subject: [PATCH 34/35] Update changelog for 2022.6.0

---
 _static/changelog-2022.6.0.png | Bin 0 -> 36546 bytes
 changelog/2022.6.0.rst         |  45 +++++++++++++++++++++++++++------
 2 files changed, 37 insertions(+), 8 deletions(-)
 create mode 100644 _static/changelog-2022.6.0.png

diff --git a/_static/changelog-2022.6.0.png b/_static/changelog-2022.6.0.png
new file mode 100644
index 0000000000000000000000000000000000000000..e612869e9a3dadbfaadac7ad12d976513d173255
GIT binary patch
literal 36546
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

literal 0
HcmV?d00001

diff --git a/changelog/2022.6.0.rst b/changelog/2022.6.0.rst
index bd862ea8e..88cf474b0 100644
--- a/changelog/2022.6.0.rst
+++ b/changelog/2022.6.0.rst
@@ -3,7 +3,7 @@ ESPHome 2022.6.0 - 15th June 2022
 
 .. seo::
     :description: Changelog for ESPHome 2022.6.0.
-    :image: /_static/changelog-2022.5.0.png
+    :image: /_static/changelog-2022.6.0.png
     :author: Jesse Hills
     :author_twitter: @jesserockz
 
@@ -24,13 +24,15 @@ around that time. So lets hope we can make 2022.8.0 worth the wait.
 🎶🎶🎶 Media Players
 --------------------
 
-More info here...
+ESPHome can now become a media player target for Home Assistant. This allows users to buy or build
+ESP32 based speakers and place them around the house.
 
 Link to `Media Players <https://esphome.github.io/media-players>`_.
 
 Join us in a live stream all about Audio in the Open Home!
 
 When: Thursday, June 16, at 7pm UTC / 12pm PST / 9pm CET
+More info here...
 
 .. raw:: html
 
@@ -40,6 +42,7 @@ When: Thursday, June 16, at 7pm UTC / 12pm PST / 9pm CET
             allowfullscreen>
     </iframe>
 
+
 Includes with vars
 ------------------
 
@@ -78,10 +81,36 @@ Basically, they decided to upgrade the ``!include`` yaml "directive" to allow va
 Now while this is probably not the best example, the variables act as ``substitutions``
 and can be used anywhere in the underlying yaml file and can very much DRY out your configurations.
 
+Breaking Changes
+----------------
 
+TCS34725 integration time
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Flesh out breaking changes here (see list below)
+The sampling settings for the TCS34725 have had a new option ``auto`` added and set as the default. This allows for better accuracy.
+You are able to set it back to the previous default value by specifying ``integration_time: 2.4ms`` in your configuration.
 
+SGP40 moved
+^^^^^^^^^^^
+
+While adding support for the SGP41 chip, the SGP40 was moved and they were both combined into a new ``sgp4x`` component.
+
+MQTT fan speeds
+^^^^^^^^^^^^^^^
+
+:esphomepr:`3397` removes deprecated MQTT fan speed state and speed command topics.
+These were replaced with speed level state and command topics in ESPHome 2021.10.0.
+
+AC Dimmer
+^^^^^^^^^
+
+Due to an output power calculation the perceived power might vary slightly specially in the lower and upper regions.
+
+DisplayBuffer
+^^^^^^^^^^^^^
+
+A new virtual method was added to the DisplayBuffer class for specifying the display type. This change only affects ``external_components``.
+See :esphomepr:`3430` for more details.
 
 Full list of changes
 --------------------
@@ -102,11 +131,6 @@ Breaking Changes
 - Output a true RMS voltage % :esphomepr:`3494` by :ghuser:`josephdouce` (breaking-change)
 - Add display_type property to DisplayBuffer :esphomepr:`3430` by :ghuser:`guillempages` (breaking-change)
 
-Notable Changes
-^^^^^^^^^^^^^^^
-
-- Add variable substitutions for !include :esphomepr:`3510` by :ghuser:`jimtng` (notable-change)
-
 Beta Changes
 ^^^^^^^^^^^^
 
@@ -116,6 +140,11 @@ Beta Changes
 - Fix compilation with ESP32-S3 :esphomepr:`3543` by :ghuser:`misery`
 - Bm3xx: Fix typo :esphomepr:`3559` by :ghuser:`martgras`
 
+Notable Changes
+^^^^^^^^^^^^^^^
+
+- Add variable substitutions for !include :esphomepr:`3510` by :ghuser:`jimtng` (notable-change)
+
 All changes
 ^^^^^^^^^^^
 

From bc6c34412eba44854f45eeb2e9bd6bdae9194139 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 16 Jun 2022 12:43:28 +1200
Subject: [PATCH 35/35] Update supporters for 2022.6.0

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

diff --git a/guides/supporters.rst b/guides/supporters.rst
index 01d21de45..755cd94ae 100644
--- a/guides/supporters.rst
+++ b/guides/supporters.rst
@@ -366,6 +366,7 @@ Contributors
 - `János Rusiczki (@janosrusiczki) <https://github.com/janosrusiczki>`__
 - `Jan Pieper (@janpieper) <https://github.com/janpieper>`__
 - `Jarek.P (@JaroslawPrzybyl) <https://github.com/JaroslawPrzybyl>`__
+- `Jason-nz (@Jason-nz) <https://github.com/Jason-nz>`__
 - `Jason2866 (@Jason2866) <https://github.com/Jason2866>`__
 - `Jason Hines (@jasonehines) <https://github.com/jasonehines>`__
 - `JasperPlant (@JasperPlant) <https://github.com/JasperPlant>`__
@@ -855,4 +856,4 @@ Contributors
 - `Michael Labuschke (@zigman79) <https://github.com/zigman79>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated June 14, 2022.*
+*This page was last updated June 16, 2022.*