Merge branch 'current' into next

Author: jesserockz

components/display/ssd1327.rst

@@ -11,7 +11,7 @@ Over I²C
 --------
 
 The ``ssd1327_i2c`` display platform allows you to use
-SSD1327 (`datasheet <https://www.generationrobots.com/media/Ecran_OLED_0_96/SSD1327_datasheet.pdf>`__,
+SSD1327 (`datasheet <https://www.waveshare.com/w/upload/a/ac/SSD1327-datasheet.pdf>`__,
 `Waveshare <https://www.waveshare.com/1.5inch-oled-module.htm>`__) displays with ESPHome. Note that this component is for
 displays that are connected via the :ref:`I²C Bus <i2c>`. If your SSD1327 is connected via the 4-Wire
 :ref:`SPI bus <spi>`, see :ref:`ssd1327-spi`.

components/sensor/ld2450.rst

@@ -285,6 +285,12 @@ Configuration variables:
 - **presence_timeout** (**Required**, int): The duration, in seconds, for which the
   :ref:`presence states<ld2450-binary-sensors>` will persist even after the detection is cleared. Default is ``5``
   seconds. All options from :ref:`Number <config-number>`.
+
+.. note::
+
+    The ``presence_timeout`` value applies *only* to the :ref:`presence binary sensor states<ld2450-binary-sensors>`.
+    It does **not** apply to any other sensor data, such as target count or target details.
+
 - **zone_N** (*Optional*): Configuration for the zone (N = 1 to 3), defined as a rectangular area in front of and
   relative to the sensor. A maximum of three zones can be configured: ``zone_1``, ``zone_2``, ``zone_3``. The zone
   coordinates consist of ``x1``, ``y1`` (near-left) to ``x2``, ``y2`` (far-right) and are specified in
@@ -475,7 +481,7 @@ Here is the complete example configuration for :doc:`ld2450`.
         bluetooth:
           name: "Bluetooth"
         multi_target:
-          name: Multi Target Tracking"
+          name: "Multi Target Tracking"
 
     select:
       - platform: ld2450

components/sensor/ms5611.rst

@@ -6,17 +6,17 @@ MS5611 Atmospheric Pressure Sensor
     :image: ms5611.jpg
     :keywords: MS5611
 
-The ``ms5611`` sensor platform allows you to use your MS5611 atmospheric pressure sensors
-(`hobbytronics`_) temperature and pressure sensors with ESPHome. The :ref:`I²C <i2c>` is
-required to be set up in your configuration for this sensor to work.
+The ``ms5611`` sensor platform allows you to use the MS5611 atmospheric pressure-and-temperature sensor with  
+ESPHome (see the `datasheet`_ for technical details). The :ref:`I²C <i2c>` is required to be set up in your  
+configuration for this sensor to work.
 
 .. figure:: images/ms5611-full.jpg
     :align: center
     :width: 50.0%
 
     MS5611 Atmospheric Pressure Sensor
 
-.. _hobbytronics: http://www.hobbytronics.co.uk/ms5611-altitude-sensor
+.. _datasheet: https://www.te.com/commerce/DocumentDelivery/DDEController?Action=showdoc&DocId=Data+Sheet%7FMS5611-01BA03%7FB3%7Fpdf%7FEnglish%7FENG_DS_MS5611-01BA03_B3.pdf%7FCAT-BLPS0036
 
 .. figure:: images/ms5611-ui.png
     :align: center

components/stepper/index.rst

@@ -81,6 +81,20 @@ Configuration variables:
               number: GPIOXX
               inverted: true
 
+.. note::
+
+    TMC drivers are pin-compatible with the A4988, but instead of a ``SLEEP`` pin they expose an ``ENABLE`` pin.  
+    When using a TMC driver with the ``a4988`` platform you therefore need to invert the ``sleep_pin``:
+
+    .. code-block:: yaml
+
+        stepper:
+          - platform: a4988
+            # ...
+            sleep_pin:
+              number: GPIOXX
+              inverted: true
+
 ULN2003 Component
 -----------------
 

components/time/index.rst

@@ -30,6 +30,7 @@ Configuration variables:
   a cron-like syntax. See :ref:`time-on_time`.
 - **on_time_sync** (*Optional*, :ref:`Automation <automation>`): Automation to run when the time source
   could be (re-)synchronized.. See :ref:`time-on_time_sync`.
+- **update_interval** (*Optional*, :ref:`Time <config-time>`): How often to synchronize the device time from the source. Defaults to ``15min``.
 
 .. _time-has_time_condition:
 

cookbook/lambda_magic.rst

@@ -210,13 +210,19 @@ In this example a :doc:`/components/cover/time_based` is used with the GPIO conf
               if (id(my_cover).current_operation == COVER_OPERATION_IDLE) {
                 // Cover is idle, check current state and either open or close cover.
                 if (id(my_cover).is_fully_closed()) {
-                  id(my_cover).open();
+                  auto call = id(my_cover).make_call();
+                  call.set_command_open();
+                  call.perform();
                 } else {
-                  id(my_cover).close();
+                  auto call = id(my_cover).make_call();
+                  call.set_command_close();
+                  call.perform();
                 }
               } else {
                 // Cover is opening/closing. Stop it.
-                id(my_cover).stop();
+                auto call = id(my_cover).make_call();
+                call.set_command_stop();
+                call.perform();
               }
 
     switch: