1.0.3 • Published 8 months ago

@nklint/homebridge-gpio-garage-door v1.0.3

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
8 months ago

npm npm release license lint & build

Homebridge GPIO garage door

This plugin uses the GPIO output of the Raspberry PI to provide a HomeKit garage door.

:warning: This plugin is only designed for and tested on Raspberry PI. There's no guarantee, the plugin works also on other boards equipped with GPIO!

Configuration

keytypedescription
namestringThe name of the accessory.
gpioPinOpenintegerThe GPIO pin the plugin should use to open the garage door.
gpioPinCloseintegerThe GPIO pin the plugin should use to close the garage door. If empty, gpioPinOpen is used to open and close the garage door.
emitTimeintegerHow many milliseconds should the GPIO output be HIGH?
executionTimeintegerHow many seconds does the garage door to execute an open or close command?
allowCommandOverridebooleanIf true, the plugin will allow to send a new command (e.g. open) to the garage door while it's already executing another command (e.g. close).
reverseOutputbooleanIf enabled, a open signal will be sent as HIGH-LOW-HIGH, instead of the default behaviour LOW-HIGH-LOW.
gpioStateInputEnabledbooleanIf enabled, the plugin will read the current state of the garage door from the GPIO input.
gpioPinStateintegerThe GPIO pin the plugin should use to read the current state of the garage door.
gpioStateInputReversebooleanIf enabled, a GPIO HIGH state will indicate a CLOSED garage door.
webhookEnabledbooleanIf enabled, the plugin will listen on the configured port for a webhook to changes of the garage door state, emitted by an external sensor.
webhookPortintegerThe port the plugin should listen on for a webhook.
webhookPathstringThe path the plugin should listen on for a webhook.
webhookJsonPathstringThe JSON path to the value of the garage door state. A truthy value indicates an open garage door.
webhookJsonValueReversebooleanIf enabled, the plugin will reverse the value of the JSON path. E.g. a truthy value will become falsy.

Support & Contribution

This project is not commercially developed or maintained. Therefore, it might take some time after opening an issue until it is solved. But anyway: If you experience any bugs feel free to open an issue or create a pull request. Contribution is always welcome.