Files
hermes-config/skills/smart-home/garage-control/SKILL.md
T
2026-07-12 10:17:17 -04:00

2.7 KiB

name, description
name description
garage-control Smart garage door control — MyQ API shutdown context, ratgdo/OpenGarage local hardware alternatives, ESPHome/MQTT/HTTP integration, and Hermes-powered automation.

Garage Control

Smart garage door open/close/status with local hardware — no cloud dependency.

Background: MyQ API Is Dead

Chamberlain (MyQ) shut down third-party API access in November 2023. Home Assistant removed their official MyQ integration in the 2023.12 release. There is no software workaround — the cloud API is intentionally blocked.

Do not suggest MyQ API integrations, Home Assistant MyQ add-ons, or cloud-based MyQ workarounds. They do not work.

Solution: ratgdo (Local Hardware)

ratgdo is a $20-30 ESP32 board that wires directly to the garage door opener's serial port. It gives full local control with no cloud dependency.

What it provides

Protocol Use
ESPHome Simple HTTP REST API — curl http://<ip>/cover/garage_door/open
MQTT Publish/subscribe for status and commands
Apple HomeKit Native Siri/Home app control (via homekit-ratgdo firmware)

Compatibility

Which ratgdo board depends on the opener's learn button color:

  • Yellow learn button (Security+ 2.0, post-2011): ratgdo v2.5+
  • Purple learn button (older Security+): ratgdo v2.0+
  • Red/orange learn button (pre-Security+): basic relay board or ratgdo v2.0

Installation

The board connects to 3 terminals on the opener: GND, data (serial), and optionally obstruction sensor. Powered by the opener itself (no wall wart needed). Takes ~10 minutes.

Hermes Integration

Once ratgdo is on the local network with ESPHome:

# Open garage
curl http://192.168.50.XXX/cover/garage_door/open

# Close garage
curl http://192.168.50.XXX/cover/garage_door/close

# Get status
curl http://192.168.50.XXX/cover/garage_door

Hermes can do all of these from the server via terminal, cron jobs (auto-close at night), or Telegram commands.

Alternative: OpenGarage

OpenGarage is a similar ESP8266-based device with an ultrasonic distance sensor (detects if car is present). HTTP API, ~$50 pre-built.

Pitfalls

  • Do NOT suggest MyQ API, cloud, or Home Assistant MyQ integration. All are dead ends since November 2023. Lead with ratgdo.
  • ratgdo firmware choice matters. ESPHome firmware exposes HTTP API; HomeKit firmware exposes Apple Home; MQTT firmware is for advanced automation hubs. Default to ESPHome unless the user has Home Assistant or wants Apple Home.
  • Wire order on the opener terminals matters. GND first, then data. Reversing can damage the board.