homebridge-ratgdo v2.1.1
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 available to Apple's HomeKit smart home platform. You can determine if your garage door opener by checking the Ratgdo website.
Why use this plugin for Ratgdo 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 devices without the need for additional configuration beyond telling the Ratgdo device about homebridge-ratgdo
.
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 when it's available.
- Control of the light attached to the garage door opener, when available.
- Obstruction detection.
- Occupancy sensor support.
- Ability to lock and unlock the garage door opener through the ability to lockout wireless remotes.
- Read-only garage door opener support.
- Automation switch and dimmer support, allowing you to set the garage door to any position.
- A rich webUI for configuration.
Getting Started
To get started with homebridge-ratgdo
:
- Install
homebridge-ratgdo
using the Homebridge webUI. Make sure you makehomebridge-ratgdo
a child bridge for the best performance. - 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.
- That's it. Ensure
homebridge-ratgdo
is running and it will autodiscover your Ratgdo devices and make them available in HomeKit.
Plugin Development Dashboard
This is mostly of interest to the true developer nerds amongst us.