Merge branch 'current' into next

changelog/2023.7.0.rst

@@ -45,7 +45,7 @@ These 2 log lines may show up in the most recent version of ESPHome due to the l
 I made this change because changing the device log level to verbose just to see if these lines show up significantly slowed down
 the device due to all the extra logging it had to do.
 
-Please do not report new issues for this, but `comment on this issue <https://github.com/esphome/issues/issues/4714>`__
+Please do not report new issues for this, but `comment on this issue <https://github.com/esphome/issues/issues/4717>`__
 if someone has not already commented for that specific component.
 
 
@@ -86,6 +86,18 @@ Beta Changes
 - [LD2410] Remove baud_rate check :esphomepr:`5112` by :ghuser:`voed`
 - Fix silence detection flag on voice assistant :esphomepr:`5120` by :ghuser:`jesserockz`
 
+Release 2023.7.1 - August 1
+---------------------------
+
+- Dashboard: use Popen() on Windows :esphomepr:`5110` by :ghuser:`kuba2k2`
+- Swap ADC back to use 'int' because C3 :esphomepr:`5151` by :ghuser:`kbx81`
+- wifi: handle WIFI_REASON_ROAMING reason in event :esphomepr:`5153` by :ghuser:`stintel`
+- Slightly lower template switch setup priority :esphomepr:`5163` by :ghuser:`cvwillegen`
+- update "Can't convert" warning to match others in homeassistant_sensor :esphomepr:`5162` by :ghuser:`PlainTechEnthusiast`
+- Increase maximum number of BLE notifications :esphomepr:`5155` by :ghuser:`bdraco`
+- invert min_rssi check :esphomepr:`5150` by :ghuser:`Jorre05`
+- Fix graininess & streaks for 7.50inV2alt Waveshare e-paper :esphomepr:`5168` by :ghuser:`Egglestron`
+
 All changes
 ^^^^^^^^^^^
 

components/alarm_control_panel/index.rst

@@ -302,7 +302,7 @@ From :ref:`lambdas <config-lambda>`, you can call the following methods:
     id(acp1).arm_away();
     id(acp1).arm_home();
     id(acp1).arm_night();
-    id(acp1).disarm("1234");
+    id(acp1).disarm(std::string("1234"));
 
 
 Platforms

components/display/index.rst

@@ -231,7 +231,7 @@ Configuration variables:
     to translate the TrueType and bitmap font files into an internal format. If you're running this as a Home Assistant
     add-on or with the official ESPHome docker image, it should already be installed. Otherwise you need
     to install it using
-    ``pip install pillow``.
+    ``pip install "pillow>4.0.0,<10.0.0"``.
 
 .. _display-static_text:
 

components/ethernet.rst

@@ -193,6 +193,7 @@ Configuration examples
 
     Revision 5 and below of the wESP32 board use the LAN8720 Ethernet PHY. Revision 7 and newer of it use the RTL8201 Ethernet PHY. Support for RTL8201 is available from ESPHome version 2022.12 upwards.
 
+
 **OpenHacks LAN8720**:
 
 .. code-block:: yaml
@@ -210,6 +211,18 @@ Configuration examples
     program properly.
 
 
+**Esp32-Stick-Eth** and **Esp32-Stick-PoE-P** and **Esp32-Stick-PoE-A**:
+
+.. code-block:: yaml
+
+    ethernet:
+      type: LAN8720
+      mdc_pin: GPIO23
+      mdio_pin: GPIO18
+      clk_mode: GPIO17_OUT
+      phy_addr: 1
+
+
 
 See Also
 --------

components/light/index.rst

@@ -908,7 +908,7 @@ Available variables in the lambda:
               // stopping and starting the effect again
               static uint16_t progress = 0;
 
-              // normal variables lost their value after each
+              // normal variables lose their value after each
               // execution - basically after each update_interval
               uint16_t changes = 0;
 

components/sensor/atm90e26.rst

@@ -21,7 +21,11 @@ Configuration variables:
 
 - **cs_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The pin CS is connected to. For the 6 channel meter main board, this will always be 5 and 4. For the add-on boards a jumper can be selected for each CS pin, but default to 0 and 16.
 - **line_frequency** (**Required**, string): The AC line frequency of the supply voltage. One of ``50Hz``, ``60Hz``.
-- **meter_constant** (**Required**, float): The number of pulses per kWh. The ATM90E26 internally works based on pulses and this value converts a pulse into Wh, which are emitted as `forward_active_energy` etc. Matching it against an existing meter is useful in that it allows visual confirmation for some devices that blink an LED for each pulse. Common values are 1000 pulses/kWh, 1666.66 pulses/kWh, or 3200 pulses/kWh. See also **gain_metering** which determines after how much energy a pulse is emitted.
+- **meter_constant** (**Required**, float): The number of pulses per kWh. The ATM90E26 internally works based on pulses and 
+  this value converts a pulse into Wh, which are emitted as ``forward_active_energy`` etc. Matching it against an existing 
+  meter is useful in that it allows visual confirmation for some devices that blink an LED for each pulse. Common values are
+  1000 pulses/kWh, 1666.66 pulses/kWh, or 3200 pulses/kWh. See also **gain_metering** which determines after how much energy
+  a pulse is emitted.
 - **voltage** (*Optional*): Use the voltage value of this phase in V (RMS).
   All options from :ref:`Sensor <config-sensor>`.
 - **current** (*Optional*): Use the current value of this phase in amperes. All options from

components/sensor/dsmr.rst

@@ -117,6 +117,42 @@ Configuration variables:
   - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
   - All other options from :ref:`Sensor <config-sensor>`.
 
+- **electricity_sags_l1** (*Optional*): Number of voltage sags in phase L1.
+
+  - **name** (**Required**, string): The name for the electricity_sags_l1 sensor.
+  - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
+  - All other options from :ref:`Sensor <config-sensor>`.
+
+- **electricity_sags_l2** (*Optional*): Number of voltage sags in phase L2.
+
+  - **name** (**Required**, string): The name for the electricity_sags_l2 sensor.
+  - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
+  - All other options from :ref:`Sensor <config-sensor>`.
+
+- **electricity_sags_l3** (*Optional*): Number of voltage sags in phase L3.
+
+  - **name** (**Required**, string): The name for the electricity_sags_l3 sensor.
+  - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
+  - All other options from :ref:`Sensor <config-sensor>`.
+
+- **electricity_swells_l1** (*Optional*): Number of voltage swells in phase L1.
+
+  - **name** (**Required**, string): The name for the electricity_swells_l1 sensor.
+  - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
+  - All other options from :ref:`Sensor <config-sensor>`.
+
+- **electricity_swells_l2** (*Optional*): Number of voltage swells in phase L2.
+
+  - **name** (**Required**, string): The name for the electricity_swells_l2 sensor.
+  - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
+  - All other options from :ref:`Sensor <config-sensor>`.
+
+- **electricity_swells_l3** (*Optional*): Number of voltage swells in phase L3.
+
+  - **name** (**Required**, string): The name for the electricity_swells_l3 sensor.
+  - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
+  - All other options from :ref:`Sensor <config-sensor>`.
+
 - **voltage_l1** (*Optional*): Voltage Phase 1.
 
   - **name** (**Required**, string): The name for the voltage_l1 sensor.

components/sensor/fs3000.rst

@@ -16,9 +16,9 @@ sensors with ESPHome.
     :width: 30.0%
 
     FS3000 Air Velocity Sensor.
-    (Credit: `Sparkfun <https://www.sparkfun.com/products/18377>`__, image compressed)
+    (Credit: `SparkFun <https://www.sparkfun.com/products/18377>`__, image compressed)
 
-.. _Sparkfun: https://www.sparkfun.com/products/15805
+.. _SparkFun: https://www.sparkfun.com/products/18377
 
 The FS3000 is a solid state air velocity sensor that communicates over over I²C. It is based on a MEMS thermopile sensor. There are two subtypes available: the FS3000-1005 measures air velocities between 0 meters/second and 7.23 meters/second, and the FS3000-1015 measures air velocities between 0 meters/second and 15 meters/second.
 
@@ -44,4 +44,7 @@ Configuration variables:
 See Also
 --------
 
+- :ref:`sensor-filters`
+- :apiref:`fs3000/fs3000.h`
+- `SparkFun FS3000 Library <https://github.com/sparkfun/SparkFun_FS3000_Arduino_Library>`__ by `SparkFun <https://www.sparkfun.com/>`__
 - :ghedit:`Edit`

components/sml.rst

@@ -171,6 +171,41 @@ This results in problems when using the sensor in combination with the `Utility
 The state template provided above checks for the sensor's availability and keeps the
 current state in case of unavailability.
 
+Holley DTZ541 Smart Meters
+--------------------------
+
+The Holley DTZ541 series of electricity meters have a faulty implementation of the SML protocol.
+These meters send multiple conflicting values with the OBIS code ``1-0:1.8.0``, the code for the meter's energy reading.
+Because the first value of every package is the correct value, in order to discard the erroneous values a throttle filter of 0.5s can be applied.
+
+.. code-block:: yaml
+
+    sensor:
+      - platform: sml
+        name: "Total energy Consumption"
+        sml_id: mysml
+        obis_code: "1-0:1.8.0"
+        unit_of_measurement: kWh
+        accuracy_decimals: 5
+        device_class: energy
+        state_class: total_increasing
+        filters:
+          - throttle: 0.5s
+          - multiply: 0.0001
+
+These meters can also measure the instantaneous power usage.
+
+.. code-block:: yaml
+
+    sensor:
+      - platform: sml
+        name: "Instantaneous power"
+        sml_id: mysml
+        obis_code: "1-0:16.7.0"
+        unit_of_measurement: W
+        accuracy_decimals: 0
+        device_class: power
+        state_class: measurement
 
 See Also
 --------

components/speaker/index.rst

@@ -23,11 +23,6 @@ Speaker Actions
 All ``speaker`` actions can be used without specifying an ``id`` if you have only one ``speaker`` in
 your configuration YAML.
 
-Configuration variables:
-
-**id** (*Optional*, :ref:`config-id`): The speaker to control. Defaults to the only one in YAML.
-
-
 .. _speaker-play:
 
 ``speaker.play`` Action
@@ -61,6 +56,10 @@ Configuration variables:
 
 This action will stop playing audio data from the speaker and discard the unplayed data.
 
+Configuration variables:
+
+- **id** (*Optional*, :ref:`config-id`): The speaker to control. Defaults to the only one in YAML.
+
 .. _speaker-conditions:
 
 Speaker Conditions
@@ -69,10 +68,6 @@ Speaker Conditions
 All ``speaker`` conditions can be used without specifying an ``id`` if you have only one ``speaker`` in
 your configuration YAML.
 
-Configuration variables:
-
-- **id** (*Optional*, :ref:`config-id`): The speaker to check. Defaults to the only one in YAML.
-
 .. _speaker-is_playing:
 
 ``speaker.is_playing`` Condition
@@ -80,6 +75,10 @@ Configuration variables:
 
 This condition will check if the speaker is currently playing audio data.
 
+Configuration variables:
+
+- **id** (*Optional*, :ref:`config-id`): The speaker to check. Defaults to the only one in YAML.
+
 
 Platforms
 ---------

components/touchscreen/tt21100.rst

@@ -39,7 +39,7 @@ Configuration variables:
 ************************
 
 - **id** (*Optional*, :ref:`config-id`): Manually set the ID of this touchscreen.
-- **interrupt_pin** (*Required*, :ref:`Pin Schema <config-pin_schema>`): The touch detection pin.
+- **interrupt_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The touch detection pin.
 - **reset_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The reset pin of the controller.
 
 - All other options from :ref:`Touchscreen <config-touchscreen>`.
@@ -51,8 +51,8 @@ Configuration variables:
     only configure the reset pin for the display and remove the **reset_pin** variable for the TT21100 touchscreen.
     The display component should be initialized before the touchscreen component, which has then already performed the reset.
 
-Additional Buttons
-------------------
+Binary Sensor
+-------------
 
 In addition to touch areas on the screen configured through the :ref:`Touchscreen <config-touchscreen>` component,
 the TT21100 supports up to four buttons located outside of the normal touchscreen area.

components/web_server.rst

@@ -56,7 +56,8 @@ Configuration variables:
 
 - **include_internal** (*Optional*, boolean): Whether ``internal`` entities should be displayed on the
   web interface. Defaults to ``false``.
-- **ota** (*Optional*, boolean): Turn on or off the OTA feature inside webserver. Strongly not suggested without enabled authentication settings. Defaults to ``true``.
+- **log** (*Optional*, boolean): Turn on or off the log feature inside webserver. Defaults to ``true``.
+- **ota** (*Optional*, boolean): Turn on or off the OTA feature inside webserver. Strongly not suggested without enabled authentication settings. Defaults to ``true``. Cannot be used with the ``esp-idf`` framework.
 - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
 - **local** (*Optional*, boolean): Include supporting javascript locally allowing it to work without internet access. Defaults to ``false``.
 - **version** (*Optional*, string): ``1`` or ``2``. Version 1 displays as a table. Version 2 uses web components and has more functionality. Defaults to ``2``.

guides/faq.rst

@@ -361,19 +361,16 @@ And a docker compose file looks like this:
 .. _docker-reference-notes:
 .. note::
 
-    By default ESPHome uses mDNS to show online/offline state in the dashboard view. So for that feature
-    to work you need to enable host networking mode
+    By default ESPHome uses mDNS to show online/offline state in the dashboard view. So for that feature to work you need to enable host networking mode. 
 
     On MacOS the networking mode ("-net=host" option) doesn't work as expected. You have to use
     another way to launch the dashboard with a port mapping option and use alternative to mDNS
     to have the online/offline stat (see below)
 
     mDNS might not work if your Home Assistant server and your ESPHome nodes are on different subnets.
-    If your router supports Avahi, you are able to get mDNS working over different subnets.
+    If your router supports Avahi (eg. OpenWRT or pfSense), you are able to get mDNS working over different subnets following the steps below:
 
-    Just follow the next steps:
-
-    1. Enable Avahi on both subnets.
+    1. Enable Avahi on both subnets (install Avahi modules on OpenWRT or pfSense).
     2. Enable UDP traffic from ESPHome node's subnet to 224.0.0.251/32 on port 5353.
 
     Alternatively, you can make esphome use ICMP pings to check the status of the device

guides/supporters.rst

@@ -24,6 +24,7 @@ Contributors
 - `2mikrobi (@2mikrobi) <https://github.com/2mikrobi>`__
 - `Pavel Golovin (@31337Ghost) <https://github.com/31337Ghost>`__
 - `David Martin (@3ative) <https://github.com/3ative>`__
+- `3VAbdAVE (@3VAbdAVE) <https://github.com/3VAbdAVE>`__
 - `Alessandro Campolo (@a13ssandr0) <https://github.com/a13ssandr0>`__
 - `Aalian Khan (@AalianKhan) <https://github.com/AalianKhan>`__
 - `Adam Liddell (@aaliddell) <https://github.com/aaliddell>`__
@@ -145,6 +146,7 @@ Contributors
 - `Ben Hoff (@benhoff) <https://github.com/benhoff>`__
 - `Benjamin Aigner (@benjaminaigner) <https://github.com/benjaminaigner>`__
 - `Benno Pütz (@bennop) <https://github.com/bennop>`__
+- `Benny H (@benny-aus) <https://github.com/benny-aus>`__
 - `Benoit3 (@Benoit3) <https://github.com/Benoit3>`__
 - `Ben Shaner (@bens545) <https://github.com/bens545>`__
 - `Ben Suffolk (@bensuffolk) <https://github.com/bensuffolk>`__
@@ -160,6 +162,7 @@ Contributors
 - `Bill Church (@billchurch) <https://github.com/billchurch>`__
 - `Brian Kaufman (@bkaufx) <https://github.com/bkaufx>`__
 - `JDavid (@blackhack) <https://github.com/blackhack>`__
+- `blacktirion (@blacktirion) <https://github.com/blacktirion>`__
 - `blakadder (@blakadder) <https://github.com/blakadder>`__
 - `Branimir Lambov (@blambov) <https://github.com/blambov>`__
 - `bleeisme (@bleeisme) <https://github.com/bleeisme>`__
@@ -174,6 +177,7 @@ Contributors
 - `Mauricio Bonani (@bonanitech) <https://github.com/bonanitech>`__
 - `Casey Olson (@bookcasey) <https://github.com/bookcasey>`__
 - `Borja Burgos (@borjaburgos) <https://github.com/borjaburgos>`__
+- `Brian Orpin (@borpin) <https://github.com/borpin>`__
 - `BoukeHaarsma23 (@BoukeHaarsma23) <https://github.com/BoukeHaarsma23>`__
 - `brabl2 (@brabl2) <https://github.com/brabl2>`__
 - `brambo123 (@brambo123) <https://github.com/brambo123>`__
@@ -312,6 +316,7 @@ Contributors
 - `definitio (@definitio) <https://github.com/definitio>`__
 - `Christiaan Blom (@Deinara) <https://github.com/Deinara>`__
 - `Mickaël Le Baillif (@demikl) <https://github.com/demikl>`__
+- `denes44 (@denes44) <https://github.com/denes44>`__
 - `Dennis (@dennisvbussel) <https://github.com/dennisvbussel>`__
 - `dentra (@dentra) <https://github.com/dentra>`__
 - `Davide Depau (@depau) <https://github.com/depau>`__
@@ -642,9 +647,9 @@ Contributors
 - `Jonathan Adams (@jonathanadams) <https://github.com/jonathanadams>`__
 - `Jonathan Treffler (@JonathanTreffler) <https://github.com/JonathanTreffler>`__
 - `JonnyaiR (@jonnyair) <https://github.com/jonnyair>`__
-- `Jonny Bergdahl (@jonnybergdahl) <https://github.com/jonnybergdahl>`__
 - `Jonathan V (@jonofmac) <https://github.com/jonofmac>`__
 - `Joppy (@JoppyFurr) <https://github.com/JoppyFurr>`__
+- `Joris S (@Jorre05) <https://github.com/Jorre05>`__
 - `Jared Sanson (@jorticus) <https://github.com/jorticus>`__
 - `Joshua Spence (@joshuaspence) <https://github.com/joshuaspence>`__
 - `joskfg (@joskfg) <https://github.com/joskfg>`__
@@ -728,7 +733,6 @@ Contributors
 - `loadrunner42 (@loadrunner42) <https://github.com/loadrunner42>`__
 - `Lazar Obradovic (@lobradov) <https://github.com/lobradov>`__
 - `Barry Loong (@loongyh) <https://github.com/loongyh>`__
-- `Michael Bisbjerg (@LordMike) <https://github.com/LordMike>`__
 - `LuBeDa (@lubeda) <https://github.com/lubeda>`__
 - `Lucas Reiners (@lucasreiners) <https://github.com/lucasreiners>`__
 - `Joakim Sørensen (@ludeeus) <https://github.com/ludeeus>`__
@@ -777,6 +781,7 @@ Contributors
 - `MartinWelsch (@MartinWelsch) <https://github.com/MartinWelsch>`__
 - `M-A (@maruel) <https://github.com/maruel>`__
 - `MasterTim17 (@MasterTim17) <https://github.com/MasterTim17>`__
+- `Masterz69 (@Masterz69) <https://github.com/Masterz69>`__
 - `Christopher Masto (@masto) <https://github.com/masto>`__
 - `Mat931 (@Mat931) <https://github.com/Mat931>`__
 - `Mateus Demboski (@mateusdemboski) <https://github.com/mateusdemboski>`__
@@ -809,7 +814,6 @@ Contributors
 - `Jörg Thalheim (@Mic92) <https://github.com/Mic92>`__
 - `Michael Muré (@MichaelMure) <https://github.com/MichaelMure>`__
 - `Michal Fapso (@michalfapso) <https://github.com/michalfapso>`__
-- `Micha Nordmann (@Michanord) <https://github.com/Michanord>`__
 - `Michel Munzert (@michelde) <https://github.com/michelde>`__
 - `Pauline Middelink (@middelink) <https://github.com/middelink>`__
 - `Joel Midstjärna (@midstar) <https://github.com/midstar>`__
@@ -856,6 +860,7 @@ Contributors
 - `nanoparticle (@nanoparticle) <https://github.com/nanoparticle>`__
 - `NanoSector (@NanoSector) <https://github.com/NanoSector>`__
 - `Oskar Napieraj (@napieraj) <https://github.com/napieraj>`__
+- `Patrick ZAJDA (@Nardol) <https://github.com/Nardol>`__
 - `Nate Lust (@natelust) <https://github.com/natelust>`__
 - `ueno (@nayuta-ueno) <https://github.com/nayuta-ueno>`__
 - `Nazar Mokrynskyi (@nazar-pc) <https://github.com/nazar-pc>`__
@@ -885,6 +890,7 @@ Contributors
 - `nouser2013 (@nouser2013) <https://github.com/nouser2013>`__
 - `Nick (@ntompson) <https://github.com/ntompson>`__
 - `Stephen Edgar (@ntwb) <https://github.com/ntwb>`__
+- `Matthias (@NuclearPhoenixx) <https://github.com/NuclearPhoenixx>`__
 - `Stanislav Meduna (@numo68) <https://github.com/numo68>`__
 - `Nuno Sousa (@nunofgs) <https://github.com/nunofgs>`__
 - `Maksym Lunin (@nut-code-monkey) <https://github.com/nut-code-monkey>`__
@@ -934,7 +940,6 @@ Contributors
 - `Philippe FOUQUET (@Philippe12) <https://github.com/Philippe12>`__
 - `Philipp Molitor (@PhilippMolitor) <https://github.com/PhilippMolitor>`__
 - `Philip Rosenberg-Watt (@PhilRW) <https://github.com/PhilRW>`__
-- `NuclearPhoenix (@Phoenix1747) <https://github.com/Phoenix1747>`__
 - `pieterbrink123 (@pieterbrink123) <https://github.com/pieterbrink123>`__
 - `Piotr Kubiak (@piotr-kubiak) <https://github.com/piotr-kubiak>`__
 - `Peter Kuehne (@pkuehne) <https://github.com/pkuehne>`__
@@ -948,6 +953,7 @@ Contributors
 - `poptix (@poptix) <https://github.com/poptix>`__
 - `Iván Povedano (@pove) <https://github.com/pove>`__
 - `Peter Provost (@PProvost) <https://github.com/PProvost>`__
+- `Q. Marchi (@preeefix) <https://github.com/preeefix>`__
 - `probonopd (@probonopd) <https://github.com/probonopd>`__
 - `Mike Lynch (@Prow7) <https://github.com/Prow7>`__
 - `Peter Tatrai (@ptatrai) <https://github.com/ptatrai>`__
@@ -1070,6 +1076,7 @@ Contributors
 - `Justin Gerace (@spectrumjade) <https://github.com/spectrumjade>`__
 - `Spegs21 (@Spegs21) <https://github.com/Spegs21>`__
 - `Eric Lind (@sperly) <https://github.com/sperly>`__
+- `Spencer Owen (@spuder) <https://github.com/spuder>`__
 - `Samuel Sieb (@ssieb) <https://github.com/ssieb>`__
 - `Stefan Staub (@sstaub) <https://github.com/sstaub>`__
 - `Stanislav Habich (@standahabich) <https://github.com/standahabich>`__
@@ -1221,6 +1228,7 @@ Contributors
 - `zivillian (@zivillian) <https://github.com/zivillian>`__
 - `Loïc (@zoic21) <https://github.com/zoic21>`__
 - `Zack Barett (@zsarnett) <https://github.com/zsarnett>`__
+- `Zsolt Zsiros (@ZsZs73) <https://github.com/ZsZs73>`__
 - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
 
-*This page was last updated July 19, 2023.*
+*This page was last updated August 1, 2023.*