diff --git a/components/cover/he60r.rst b/components/cover/he60r.rst new file mode 100644 index 000000000..e5eb064be --- /dev/null +++ b/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 `. + +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` diff --git a/components/cover/images/he60r-sch.jpg b/components/cover/images/he60r-sch.jpg new file mode 100644 index 000000000..aaf74702c Binary files /dev/null and b/components/cover/images/he60r-sch.jpg differ diff --git a/components/cover/images/he60r.jpg b/components/cover/images/he60r.jpg new file mode 100644 index 000000000..025c76db6 Binary files /dev/null and b/components/cover/images/he60r.jpg differ diff --git a/images/he60r.jpg b/images/he60r.jpg new file mode 100644 index 000000000..716336263 Binary files /dev/null and b/images/he60r.jpg differ diff --git a/index.rst b/index.rst index 043912f93..48da583de 100644 --- a/index.rst +++ b/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 ----------------------