ratgdo 项目安装与使用指南

郭蔷意Ward

于 2024-09-14 08:19:46 发布

阅读量256

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00564/article/details/142243410

版权

ratgdo 项目安装与使用指南

ratgdo 项目地址: https://gitcode.com/gh_mirrors/ra/ratgdo

1. 项目介绍

ratgdo 是一个用于住宅车库门开启器的 WiFi 控制板，支持通过本地网络使用 ESPHome、HomeKit 或 MQTT 进行控制。它适用于几乎所有由 Chamberlain 或 Liftmaster 制造的车库门开启器，并且还提供对使用干触点控制门的其他品牌的基本支持。ratgdo 能够控制车库门并报告门的实际状态（关闭、开启、打开、关闭中）。对于“黄色学习按钮”的 Security + 2.0 车库门开启器，它还集成了障碍传感器、灯光、无线锁定甚至运动感应功能。

ratgdo 不是云设备，不需要订阅服务。其固件是开源的，任何人都可以免费使用。

2. 项目快速启动

2.1 安装依赖

首先，确保你已经安装了以下依赖：

2.2 克隆项目

使用 Git 克隆项目到本地：

git clone https://github.com/PaulWieland/ratgdo.git
cd ratgdo

2.3 编译固件

使用 PlatformIO 编译固件：

platformio run

2.4 上传固件

将编译好的固件上传到你的设备：

platformio run --target upload

2.5 配置网络

根据你的需求，配置 ratgdo 使用 ESPHome、HomeKit 或 MQTT。以下是一个简单的 ESPHome 配置示例：

esphome:
  name: ratgdo
  platform: ESP8266
  board: nodemcuv2

wifi:
  ssid: "your_wifi_ssid"
  password: "your_wifi_password"

mqtt:
  broker: "your_mqtt_broker_ip"
  username: "your_mqtt_username"
  password: "your_mqtt_password"

switch:
  - platform: gpio
    name: "Garage Door"
    pin: D1