A HomeKit Garage Door service. This can be used to manage your garage door driver, or be a stand-alone fully working driver.

If you don't use a sensor, or use only one, Door Working Time will be used to determine door state. If you use both sensors (for open and close: "f2" to "f5"), Door Working Time will be used as a security measure alerting when an obstruction is detected if the door does not complete operation before the working time expires. If you also define an Obstruction Detection Time then the sum of the Working Time and Obstruction Detection Time is used.

The following configuration is available for garage doors:

{
  "c":{
    "io":[[[12,13],2],[[0],6],[[14],6,1]],
    "l":13,"b":[[0,5]]
  },
  "a":[{
    "t":40,
    "d":18,
    "0":{"r":[[12,1,0.5]]},
    "1":{"a":0},
    "2":{"r":[[12,0,1.5],[12,1,0.5],[12,1,2]]},
    "3":{"a":2},
    "f3":[[14,0]],
    "f4":[[14]]
  }]
}

This is an example of a device used to control a garage door ("t":40). The door takes 18 seconds to open ("d":18).

The four key actions are defined; Door is opened and receives closing order ("0"), door is closed and receives opening order ("1"), door is opening and receives closing order ("2") & door is closing and receives opening order ("3").

The door control is done using GPIO 12 and actions "1" and "3" are duplicates of actions "0" and "2" respectively (see Copy Action).

GPIO 14 indicates the the closed state of the door i.e. when the door is fully closed "f3" is triggered. When the door begins to open "f4" is triggered indicating, via GPIO 14 that the door is no longer closed.

A garage door has a number of actions as documented below:

The Binary Outputs "r": [ ] for each should be configured to attain the desired state.

The door opening time is defined by the "d" key contained within the service object.

This option specifies the time needed for the garage door to completely open. It is an integer (no decimals).

Door Closing Time was introduced in firmware version 1.0.0

The door closing time is defined by the "c" key contained within the service object. If this key is not declared, the door opening time value will be used i.e. the value from the "d" key.

This option specifies the time needed for the garage door to completely close. It is an integer (no decimals).

Obstruction detection time was introduced in firmware version 0.8.7

Obstruction detection time is defined by the "e" key contained within the service object.

This option specifies the time allowed for the garage door to detect an obstruction when door open/close sensors are used. It is an integer (no decimals).

By default this option is disabled. When enabled, the timer begins when and wait until sensor detects movement, and once the Door Working Time has expired. The service then has the defined number of seconds to report an obstruction is detected.

When enabled, it simulates emergency stop function from Home App when Garage Door is moving and service is triggered again from Apple Home App, instead changing movement direction. It will exec Emergency Stop action.

The list of notifications "m" supported by a garage door are as follows:

See the general Service Notifications section for details of how to configure these notifications.

Binary Inputs "b" are supported by this service.

See Binary Inputs for details on how to define this mandatory option.

State inputs "f[n]" are supported by this service. The supported list is:

Refer to State Inputs for more detail and examples.

ICMP Ping inputs "p[n]" and "q[n]" are supported by this service. Refer to ICMP Ping Inputs for more detail.

The Initial Lock State about Service and Physical controls.

The Initial State key is supported by this service. Refer to Initial State for more details.