https://github.com/ixy05/homespan-d5evo-gate
HomeKit gate controller for Centurion (Centsys) D5 Evo gate motor
https://github.com/ixy05/homespan-d5evo-gate
centsys centurion d5-evo d5evo esp32 esp32-s2 garage garage-door-opener gate gate-opener home-automation homekit homespan
Last synced: 11 months ago
JSON representation
HomeKit gate controller for Centurion (Centsys) D5 Evo gate motor
- Host: GitHub
- URL: https://github.com/ixy05/homespan-d5evo-gate
- Owner: ixy05
- Created: 2025-01-11T01:09:39.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-29T13:06:09.000Z (about 1 year ago)
- Last Synced: 2025-06-21T10:05:36.388Z (about 1 year ago)
- Topics: centsys, centurion, d5-evo, d5evo, esp32, esp32-s2, garage, garage-door-opener, gate, gate-opener, home-automation, homekit, homespan
- Language: C
- Homepage: https://f.mcgr.gr/g/HSgate
- Size: 2.35 MB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HomeKit Gate Controller for Centurion D5-Evo Gate Motor
**HomeKit gate controller for Centurion (Centsys) D5 Evo gate motor**
This project implements a HomeKit-compatible gate controller using an ESP32 microcontroller and the HomeSpan library, specifically designed for Centurion (Centsys) D5-Evo gate motors. It enables remote control and status monitoring of the gate with Apple HomeKit.
## Features
- ✅ **HomeKit Integration:** Seamless control via the Apple Home app using the HomeSpan library.
- ✅ **Gate Control:** Open and close the gate with a relay trigger.
- ✅ **Status Detection:** Real-time detection of gate states (open, closed, opening, closing).
- ✅ **Gate Status** Detects when gate opens/closes from a different source (e.g. remote control, intercom, keypad).
## How It Works
The system uses an ESP32 microcontroller to manage a relay and monitor the gate's operational state:
- **Relay Control:** The relay pin (GPIO 35) triggers the gate motor.
- **Status Monitoring:** The status pin (GPIO 39) monitors the gate's operation based on pulse patterns sent by the gate controller.
- **Flashing Patterns:** The gate signals its state using pulse patterns, where the duration of HIGH and LOW signals indicates whether the gate is opening or closing.
- **Logic Level Conversion:** A logic level converter is used to shift the gate's 5V status signal to a 3.3V input suitable for the ESP32.
The `DEV_GATE.h` class implements:
- `update()` – Triggered by HomeKit to open/close the gate.
- `loop()` – Continuously monitors the gate's state based on the input pin.
## Hardware Requirements
- ESP32 microcontroller
- Relay module (for gate control)
- Logic level converter (5V to 3.3V signal conversion on status pin)
## Wiring
```
+----------------------+
| ESP32 |
|----------------------|
| GND ----------------|-----> **Relay GND, Gate GND, LLC GND**
| 3.3V ----------------|-----> LLC LV
| 5V ------------------|-----> LLC HV, Relay VCC
| GPIO 35 -------------|-----> Relay IN
| GPIO 39 <------------|----- LLC LV OUT
+----------------------+
+------------------------+
| RELAY MODULE |
|------------------------|
| IN <---- GPIO 35 |
| NO -----> Gate TRIG |
| COM -----> GND |
| VCC <---- 5V |
| GND <---- GND |
+------------------------+
+---------------------------+
| LOGIC LEVEL CONVERTER |
|---------------------------|
| HV <---- 5V |
| LV <---- 3.3V |
| GND <---- GND |
| HV IN <---- Gate Status |
| LV OUT ----> GPIO 39 |
+---------------------------+
+----------------------------+
| GATE MOTOR |
|----------------------------|
| GND -----> ESP32 GND |
| TRIG <----- Relay NO |
| Status -----> LLC HV IN |
+----------------------------+
```
Only three connections need to be made to the D5 Evo Gate Motor:
1. Trig: this needs to be connected to ground for the gate to activate. I have connected this to a relay controlled by the ESP32
2. Status: this needs to be logic-level-converted from 5V to 3.3V. Connect to a GPIO pin of the ESP32
3. Com (ground, 0V): this is important for two reason: (1) status decoding and (2) triggering (activating) the gate. Because of (1), **the gate must share a ground with the esp32**.
## Software Requirements
- [HomeSpan Library](https://github.com/HomeSpan/HomeSpan)
- Arduino IDE (for programming the ESP32)
## Configuration
- **Wi-Fi:** Set credentials in `main.ino`.
- **HomeKit Pin:** Default pairing pin is `06533259`.
- **Pins:** Adjust `statusPin` and `relayPin` if necessary.
## Installation
1. Install the HomeSpan library in Arduino IDE.
2. Download and open both `main.ino` and `DEV_GATE.h` in an IDE.
3. Configure Wi-Fi credentials, HomeKit pairing code in `main.ino`.
4. Upload the files to your ESP32.
5. Pair the device with HomeKit using the code.
## Future Improvements
- **Obstruction Detection:** Currently not implemented.
## License
This project is open-source under the MIT License.
## Contributing
Contributions are welcome! Feel free to submit pull requests or open issues for improvements and bug fixes.