ESPHome component for ratgdo — a WiFi control board for garage door openers that works over your local network. Compatible with most residential Chamberlain and LiftMaster openers, with dry contact support for other brands.
Purchase boards at ratcloud.llc.
Flash the ESPHome based firmware using the Web Installer.
The ESPHome firmware will allow you to open the door to any position after calibration. To calibrate the door, open and close it once without stopping.
| Board | Chip | Protocol | Config |
|---|---|---|---|
| v2.0 | ESP8266 D1 Mini | Security+ 2.0 | v2board_esp8266_d1_mini.yaml |
| v2.0 | ESP8266 D1 Mini lite | Security+ 2.0 | v2board_esp8266_d1_mini_lite.yaml |
| v2.0 | ESP32 D1 Mini | Security+ 2.0 | v2board_esp32_d1_mini.yaml |
| v2.0 | ESP32 Lolin S2 Mini | Security+ 2.0 | v2board_esp32_lolin_s2_mini.yaml |
| v2.5 | ESP8266 D1 Mini | Security+ 2.0 | v25board_esp8266_d1_mini.yaml |
| v2.5 | ESP8266 D1 Mini | Security+ 1.0 | v25board_esp8266_d1_mini_secplusv1.yaml |
| v2.5 | ESP8266 D1 Mini lite | Security+ 2.0 | v25board_esp8266_d1_mini_lite.yaml |
| v2.5 | ESP8266 D1 Mini lite | Security+ 1.0 | v25board_esp8266_d1_mini_lite_secplusv1.yaml |
| v2.5 | ESP32 D1 Mini | Security+ 2.0 | v25board_esp32_d1_mini.yaml |
| v2.5 | ESP32 D1 Mini | Security+ 1.0 | v25board_esp32_d1_mini_secplusv1.yaml |
| v2.5i/2.52i/2.53i | ESP32 | Security+ 2.0 | v25iboard.yaml |
| v2.5i/2.52i/2.53i | ESP32 | Security+ 1.0 | v25iboard_secplusv1.yaml |
| v2.5i/2.52i/2.53i | ESP32 | Dry Contact | v25iboard_drycontact.yaml |
| v3.2 | ESP32 | Security+ 2.0 | v32board.yaml |
| v3.2 | ESP32 | Security+ 1.0 | v32board_secplusv1.yaml |
| v3.2 | ESP32 | Dry Contact | v32board_drycontact.yaml |
| v3.2 Disco | ESP32 | Security+ 2.0 | v32disco.yaml |
| v3.2 Disco | ESP32 | Security+ 1.0 | v32disco_secplusv1.yaml |
| v3.2 Disco | ESP32 | Dry Contact | v32disco_drycontact.yaml |
Most ESP32 boards use the ESP-IDF framework. The project originally depended on Arduino, but PR #577 replaced the SoftwareSerial dependency with hardware UART and RMT peripherals, eliminating the need for Arduino on ESP32. Removing the Arduino layer saves ~1.5KB RAM and ~44KB flash since Arduino is built as an IDF component on top of ESP-IDF, and the smaller firmware means faster OTA updates.
The v3.2 Disco board uses the Arduino framework because its VL53L4CX distance sensor library and Wire I2C library require it.
ESP8266 boards continue to use the Arduino framework as ESPHome requires it on that platform.
Some v2.5 boards using ESP32 D1 Mini controllers may report spurious obstruction events. This is caused by the obstruction sensor "asleep" detection logic being inverted on these boards.
To fix this, add the following to your ESPHome config:
ratgdo:
id: ratgdov25
obst_sleep_low: trueThe id must match the id of the existing ratgdo component in your config (e.g. ratgdov25 for v2.5 boards). This setting tells the obstruction sensor to treat LOW as the "asleep" state instead of the ESP32 default of HIGH.