Add HE60R Garage Door Opener (#3413)

components/cover/he60r.rst

@@ -0,0 +1,109 @@
+HE60R Garage Door Opener
+========================
+
+.. seo::
+    :description: Setting up a Chamberlain HomEntry HE60R and similar garage door openers
+    :image: he60r.jpg
+
+.. figure:: images/he60r.jpg
+    :align: right
+
+The ``he60r`` cover platform allows you to control a HomEntry HE60R
+garage door opener. These units were made by Chamberlain and sold through Bunnings. It is *likely* that this
+component will also work with other older Chamberlain garage door openers. It is not currently compatible with
+newer Chamberlain units that use the Security+ 2.0 protocol.
+
+This component makes use of the HE60R keypad communication interface. This is a single-wire half duplex serial
+connection and requires a :ref:`uart` component to be configured. The uart **must** be set to 1200 baud, EVEN parity. See
+below for a sample hardware interface.
+
+.. code-block:: yaml
+
+    # Example configuration entry
+
+    uart:
+      - id: door_uart
+        baud_rate: 1200
+        parity: even
+        stop_bits: 1
+        tx_pin: REPLACEME
+        rx_pin: REPLACEME
+
+    cover:
+      platform: he60r
+      id: garage_door
+      name: Garage Door
+
+
+Configuration variables:
+------------------------
+
+- **open_duration** (*Optional*, :ref:`config-time`): The time required for the door to fully open from the closed position. Default 15s.
+- **close_duration** (*Optional*, :ref:`config-time`): The time required for the door to fully close from the open position. Default 15s.
+- All other options from :ref:`Cover <config-cover>`.
+
+The open and close duration serve to estimate the position to provide feedback during travel and for partial open/close
+requests. These can be adjusted according to your door's actual operation. Enabling DEBUG logging will report the
+actual open and close times which will help to refine these timings.
+
+Hardware Connection
+-------------------
+
+A sample circuit is shown below which also draws power from the HE60R - note that the 3.3V regulator must
+be a switching type, a linear regulator would draw too much current and run hot. You can of course simply power
+the ESP32 via USB from 5V. This circuit also includes a manual control button connected to a GPIO.
+
+Any microcontroller board supported by ESPHome should be suitable for this application.
+
+
+.. figure:: images/he60r-sch.jpg
+    :target: /_images/he60r-sch.jpg
+
+
+Note that this circuit inverts the TX line. A configuration for this would look something like:
+
+.. code-block:: yaml
+
+    # Example configuration entry
+
+    uart:
+      - id: door_uart
+        baud_rate: 1200
+        parity: even
+        stop_bits: 1
+        tx_pin:
+          number: REPLACEME
+          inverted: true
+        rx_pin: REPLACEME
+
+    cover:
+      platform: he60r
+      id: garage_door
+      name: Garage Door
+
+    binary_sensor:
+      - platform: gpio
+        pin:
+          number: REPLACEME
+          inverted: true
+          mode:
+            input: true
+            pullup: true
+        name: "Garage Door Manual Button"
+        # debounce the switch
+        filters:
+          - delayed_on: 50ms
+          - delayed_off: 50ms
+        on_press:
+          then:
+            - cover.toggle: garage_door
+
+
+
+See Also
+--------
+
+- :doc:`index`
+- :ref:`automation`
+- :ref:`gpio-binary-sensor`
+- :ghedit:`Edit`

index.rst

@@ -698,6 +698,7 @@ Cover Components
     Custom Cover, components/cover/custom, language-cpp.svg, dark-invert
     AM43 Cover, components/cover/am43, am43.jpg
     Tuya Cover, components/cover/tuya, tuya.png
+    HE60R Cover, components/cover/he60r, he60r.jpg
 
 Text Sensor Components
 ----------------------