Skip to content

carbonmonoxide Device

Erik Baauw edited this page Nov 27, 2022 · 1 revision

carbonmonoxide Device

A carbonmonoxide device exposes a CO sensor 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 Carbon Monoxide Sensor service. Through this service, you can monitor the CO sensor state in HomeKit, or even configure HomeKit push notifications.

The carbonmonoxide 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 contact detected when the GPIO pin is high instead of on low.
debounceTimeout integer Time in ms to ignore state changes after initial change. Default 20ms.