40 lines
2.2 KiB
Markdown
40 lines
2.2 KiB
Markdown
|
|
# ratgdo for ESPHome
|
|
|
|
This is a port of the ratgdo software for the v2 board to ESPHome.
|
|
|
|
[Visit the github.io page to purchase boards](https://paulwieland.github.io/ratgdo/#order)
|
|
|
|
## Moving from stock ratgdo
|
|
|
|
If you have not used the stock ratgdo firmware, and are starting with a fresh install of the ESPHome based firmware, [skip these steps](#fresh-install-when-the-stock-ratgdo-firmware-was-not-used-before).
|
|
|
|
- Use the [`Logs & Console`](https://paulwieland.github.io/ratgdo/flash.html) to view and make note of the current rolling code
|
|
- Flash the new ESPHome based firmware using the [Web Installer](https://esphome-ratgdo.github.io/esphome-ratgdo/)
|
|
- Use the `number` entity in Home Assistant or the built-in ESPHome web-server to set the rolling code.
|
|
|
|
<img width="560" alt="number_entity" src="https://github.com/RATGDO/esphome-ratgdo/assets/663432/e177029e-f42f-46a8-a87a-81fa04caaa57">
|
|
|
|
## Fresh install when the stock ratgdo firmware was not used before
|
|
|
|
- Flash the new ESPHome based firmware using the [Web Installer](https://ratgdo.github.io/esphome-ratgdo/)
|
|
|
|
## First use after adding to Home Assistant
|
|
|
|
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.
|
|
|
|
<img width="560" alt="position_demo" src="https://github.com/RATGDO/esphome-ratgdo/assets/663432/22a9873e-67bb-4b2f-bb32-70047cfe666d">
|
|
|
|
## Updating from versions older than 2023.07.07
|
|
|
|
When updating from older versions, save the rolling counter value and restore it via the number entity after flashing the new firmware. If you forget to save the code, check the Home Assistant history.
|
|
|
|
## ESPHome config
|
|
|
|
- [ESPHome config for v2 board with ESP8266 D1 Mini lite](https://github.com/RATGDO/esphome-ratgdo/blob/main/static/v2board_esp8266_d1_mini_lite.yaml)
|
|
- [ESPHome config for v2 board with ESP32 D1 Mini](https://github.com/RATGDO/esphome-ratgdo/blob/main/static/v2board_esp32_d1_mini.yaml)
|
|
- [ESPHome config for v2 board with ESP32 Lolin D2 Mini](https://github.com/RATGDO/esphome-ratgdo/blob/main/static/v2board_esp32_lolin_s2_mini.yaml)
|
|
- [Web Installer](https://ratgdo.github.io/esphome-ratgdo/)
|
|
|
|
|