Skip to content

1 Garage Door (with Eachen GDDC5)

Ben edited this page Mar 10, 2021 · 14 revisions

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": [

Available Options

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.
operationTimeDown int No 100 If the garage door has a different operation time for up and down, use this setting to specify the operation time DOWN (in deciseconds) and the other setting to specify the operation time UP. Must be 20 or more.
obstructId string No "" eWeLink Device ID of the single-channel device used for the obstruction detection (see below).
overrideDisabledLogging bool No false If true, updates for this device will be added to the log, even if the general 'Disable Device Logging' setting is true.

Obstruction Detection

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.

Wiring Diagram

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"
   }
]