-
-
Notifications
You must be signed in to change notification settings - Fork 127
1 Garage Door (with Eachen GDDC5)
This plugin can expose Eachen GD-DC5 devices to HomeKit for garage door functionality. It is important to have the Eachen's magnetic sensor mounted, as HomeKit's Door OPEN/CLOSED status is based off the true state of this sensor.
A basic single door configuration example:
[
{
"deviceId": "10009553c8",
"type": "garage_eachen",
"operationTime": 100,
}
]
- If using the Homebridge UI, it's easier to use the plugin settings screen to configure the simulation
- If using the HOOBS UI, copy and paste the example above into the 'Groups' box on the plugin settings screen
- If manually editing the config JSON, don't forget to change the first line to
"groups": [
Entry | Type | Required | Default | Explanation |
---|---|---|---|---|
deviceId |
string |
Yes | "" |
eWeLink Device ID. |
label |
string |
No | "" |
This setting has no effect except to be a helpful label for identifying which device this is when editing the configuration. |
type |
string |
Yes | "" |
In this case this must be set to "garage_eachen" . |
operationTime |
int |
Yes | 100 |
The time in deciseconds that the garage door takes to open/close. Must be 20 or more. |
obstructId |
string |
No | "" |
eWeLink Device ID of the single-channel device used for the obstruction detection (see below). |
overrideLogging |
bool |
No | "default" |
Override global logging setting for this device. Can be default (follows global setting), standard for standard logging, debug for debug logging or disable to disable accessory logging. |
It is also possible to use an additional single-channel device (i.e. Sonoff BASIC, MINI, etc.) to set the HomeKit 'Obstruction Detected' property of the garage. If this switch is ON then 'Obstruction Detected' will be set to 'Yes'. This can be configured by assigning the device under the obstructId
option. This feature has been tested by connecting an E3JK-R4M1 photoelectric detector with (NO/NC) switch circuitry, connecting the (NO) circuit to a Sonoff MINI to turn it ON if the beam is broken.
NOTICE: HomeKit itself does not block activation of a door even if 'Obstruction Detected' is set to 'Yes'. Therefore, to prevent door activation when an object is in the door's path, it is strongly advised that the (NC) circuit of the photoelectric detector be used as an interrupt for the Eachen's activation circuit when the photoelectric beam is broken.
A single door configuration example with an additional switch used for 'Obstruction Detected':
[
{
"deviceId": "10009553c8",
"type": "garage_eachen",
"operationTime": 100,
"obstructId": "10009553c0"
}
]
A multiple door configuration example, each with its own additional switch used for 'Obstruction Detected':
[
{
"deviceId": "10009553c8",
"type": "garage_eachen",
"operationTime": 100,
"obstructId": "10009553c0"
},
{
"deviceId": "10009553c9",
"type": "garage_eachen",
"operationTime": 100,
"obstructId": "10009553c1"
}
]