Skip to content

doorbell Device

Erik Baauw edited this page Sep 25, 2022 · 6 revisions

doorbell Device

A doorbell device exposes a door bell connected to a GPIO pin. Homebridge RPi configures the GPIO pin for input. By default, Homebridge RPi configures the internal pull-up resister for the GPIO pin. Homebridge RPi configures pigpiod to send real-time notifications when the GPIO state changes. Homebridge RPi debounces the input signal.

The device is exposed as a separate HomeKit accessory, with a Doorbell service. Home and Siri only support a Doorbell service on a video doorbell accessory, so this accessory is somewhat weird. The accessory won't show in Home, but when the doorbell is pressed, Home does issue a notification. This notification cannot be disabled, as the accessory and the Doorbell service aren't visible in Home.

Through the Doorbell service, you can configure actions in HomeKit, for Single Press, but this is a bit tricky. In Eve, go to the Rules tab in the Atomation window and issue Add Rule. Press Triggers, Add Trigger, and Other Value. Select the room where the Homebridge bridge resides. There you will find the Doorbell service. Note that you need a home hub for this.

The doorbell device uses the following config.json keys:

key type Description
name string The name for the device in HomeKit.
gpio integer The GPIO pin.
pull string The configuration of the internal pull-up/pull-down resistor for the GPIO pin: off, down, or up (default).
reversed boolean The device state is reversed, i.e. report the door bell as pressed when the GPIO pin is high instead of on low.
debounceTimeout integer Time in ms to ignore state changes after initial change. Default 20ms.