Homebridge Ratgdo

Ratgdo-enabled garage door opener support for Homebridge.

homebridge-ratgdo is a Homebridge plugin that makes Chamberlain, Liftmaster, and other garage door openers that utilize the Ratgdo hardware control board and commercial variants available to Apple's HomeKit smart home platform. You can determine if your garage door opener is compatible by checking the Ratgdo website.

Why use this plugin for Ratgdo (and similar devices like Konnected) support in HomeKit?

In a nutshell, the aim of this plugin for things to just work with minimal required configuration by users. The goal is to provide as close to a streamlined experience as you would expect from a first-party or native HomeKit solution. For the adventurous, those additional granular options are, of course, available to support more esoteric use cases or other unique needs.

What does just work mean in practice? It means that this plugin will discover all your Ratgdo (or Konnected garage door opener) devices that are running ESPHome firmware without the need for additional configuration.

I rely on this plugin every day and actively maintain and support it.

In the interest of the community seeking a solution outside of myQ, I've developed a full-featured Homebridge plugin that enables the following features:

• Control of the garage door opener. This includes, for those that have always wanted the feature, the ability to close the garage door without the requisite safety warning and delay that Chamberlain and Liftmaster garage door openers emit when being controlled remotely.
• A motion sensor and control of the light attached to the garage door opener - each enabled by default, and each can be turned off in the feature options if your opener doesn't have it.
• Obstruction detection.
• Occupancy sensor support.
• Ability to lock and unlock the garage door opener by locking out its wireless remotes - exposed on the garage door tile, and optionally as a standalone lock switch accessory.
• Read-only garage door opener support.
• An automation switch (open/close) and an automation dimmer (set the garage door to any position).
• For Ratgdo (ESP32) Disco devices: backup battery status, parking-assist laser and LED controls, and vehicle arriving, leaving, and presence sensors.
• For Konnected blaQ devices: a pre-close warning switch and a strobe switch.
• Support for all current Ratgdo-branded devices as well as for variants like Konnected blaQ that use ESPHome.
• A rich webUI for configuration.

Installation

To get started with homebridge-ratgdo:

• Install homebridge-ratgdo using the Homebridge webUI. Make sure you make homebridge-ratgdo a child bridge for the best experience.
• For Ratgdo devices, install the ESPHome Ratgdo firmware. You'll need to use Chrome for this as Safari doesn't support installing firmware through a USB serial port.
• Fully open and close the garage door one time. ESPHome Ratgdo will use this to determine how long it takes to open and close your garage door to enable precise control of the position of the garage door opener.
• If your device has the ESPHome native API encryption key enabled, set that key in the plugin's feature options (the Device.Encryption.Key option for that device) so the plugin can connect to it. Devices without API encryption need no key.
• That's it. Ensure homebridge-ratgdo is running and it will autodiscover your Ratgdo devices and make them available in HomeKit.

Documentation

• Getting Started

  • Installation: installing this plugin, including system requirements.
  • Changelog: changes and release history of this plugin.

• Additional Topics

  • Feature Options: options to allow you further tailor to your needs, particularly for those who want to have enhanced automation support.
  • MQTT: how to configure MQTT support.

Plugin Development Dashboard

This is mostly of interest to the true developer nerds amongst us.