Skip to content

A native HomeKit implementation of a Security+ 2.0 garage door controller based on ratgdo hardware

License

Notifications You must be signed in to change notification settings

Avi0n/homekit-ratgdo

 
 

Repository files navigation

What is HomeKit-RATGDO?

HomeKit-RATGDO is an alternative firmware for the RATGDO v2.5-series WiFi control boards that works over your local network using HomeKit, or over the internet using your Apple HomeKit home hubs, to control your garage door opener. It requires no supporting infrastructure such as Home Assistant, Homebridge, MQTT, etc, and connects to your garage door opener with as few as three wires.

This firmware supports only Security+ 2.0-enabled garage door openers and RATGDO v2.5-series ESP8266-based hardware.

Important

This is a work-in-progress implementation that is ready for beta testing only. I am pretty sure it won't leave your garage open to thieves and light your cat on fire, but it might.

Stability is a top priority, but you should expect to need to update your device from time to time while this firmware is improved.

What does this firmware support?

  • Opening and closing multiple garage doors independently in the same HomeKit home.
  • Light Control and Status
  • Obstruction sensor reporting
  • Motion sensor reporting, if you have a "smart" wall-mounted control panel.

That's it, for now. Check the GitHub Issues for planned features, or to suggest your own.

How do I install it?

Note

The installation process is still being improved. You may need to reload the flasher tool page after each of the following steps in order to proceed.

For each of the following steps, use the online browser-based flash tool:

  • Install the HomeKit-RATGDO firmware, and then wait 20 seconds.
  • Connect the RATGDO to WiFi. There is currently a known issue where the RATGDO will timeout on connect. Just retry the connect. This is only known to happen on initial provisioning.
  • Click "Visit Device", and then begin the process of adding a device to HomeKit. Scan the QR code, or manually enter the setup code 2510-2023.

That's it!

How do I upgrade?

In v0.8.0, Over-the-Air (OTA) updates were added. Follow the steps below to update:

  1. Download the latest release, by download the .bin file on the latest release firmware
  2. Navigate to your ratgdo's ip address where you will see the devices web server, Click Update Firmware webserver
  3. Upload the firmware that was downloaded in step 1, by clicking Choose File under Firmware:. ota Note: Ignore the FileSysyem Update Options.
  4. Click Update Firmware to proceed with upgrading uploaded
  5. Update Successful, ratgdo will now Reboot success
  6. After a firmware update, you may have to go through the process of re-pairing your device to HomeKit. If your device is showing up as unresponsive in HomeKit, please try un-pairing, reboot, and re-pairing.

Automatic updates are not supported (and probably will never be), so set a reminder to check back again in the future.

Help! aka the FAQs

How can I tell if the ratgdo is paired to HomeKit?

Use the online browser-based flash tool, and follow the "Visit Device" link. If you see a big QR code, the ratgdo is not paired.

I added my garage door in the Home app but can't find it

This is a common problem. Be sure to check all of the "rooms" in the Home app. If you really can't find it, you can try un-pairing and re-pairing the device, paying close attention to the room you select after adding it.

How to do I re-pair my ratgdo?

Use the online browser-based flash tool, and follow the "Visit Device" link. If you see a big QR code, the ratgdo is not paired. Click the "Un-pair HomeKit" button, and then delete the garage door from within the HomeKit app (or vice versa, order does not matter). It is also recommended that you reboot the RATGDO after un-pairing. You can then re-pair the device by adding it again as normal.

Where can I get help?

If your question has not been answered here, you can try the Discord chat.

Click this link to follow an invite to the server. Server rules require a 10 minute wait after signup.

Now that you've signed up, go here to join the discussion:

the Discord logo.

Please also feel free to open a GitHub Issue if you don't already see your concern listed. Don't forget to check the closed issues to see if someone has already found a fix.

How can I contribute?

HomeKit-RATGDO uses PlatformIO for builds. You'll want to install PlatformIO first.

After you've checked out this repo:

git clone [email protected]:ratgdo/homekit-ratgdo.git

Initialize the submodules from the root of the repo:

cd homekit-ratgdo
git submodule init lib/secplus/
git submodule update

The x.sh script is my lazy way of not having to remember PlatformIO-specific pio commands. The important ones are run, upload, and monitor.

Who wrote this?

This firmware was written by Brandon Matthews, with lots of inspiration from the esphome-ratgdo project and critical dependence on the secplus decoder library.

Special credit goes to the Chamberlain Group, without whose irredeemably stupid decision to close their API to third parties, this firmware would never have been necessary.

Garage icons created by Creative Squad - Flaticon

About

A native HomeKit implementation of a Security+ 2.0 garage door controller based on ratgdo hardware

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 72.0%
  • C 14.2%
  • HTML 7.2%
  • Python 3.4%
  • CSS 2.5%
  • Shell 0.7%