homebridge-iam-voc

A HomeBridge Plugin making the Applied Sensors iAM USB air quality sensor availible in HomeKit.

Installation

For use on an Ubuntu/Debian style Linux:

sudo apt-get install build-essential libudev-dev
sudo npm install -g --unsafe-perm homebridge-iam-voc

To allow homebridge to run without beeing root or using sudo a udev Rule needs to be added.

Create /etc/udev/rules.d/23-homebridge.rules and put in the following line, where you replace homebridge with the group of the user running homebridge on your system (e.g. pi on a raspian):

SUBSYSTEM=="usb", ATTR{idVendor}=="03eb", ATTR{idProduct}=="2013", GROUP="homebridge", MODE="0664"

Afterwards reload the rules with udevadm control --reload and replug the USB plug of your USB device.

Sample Config (Excerpt)

Configured as part of your homebridge configuration.

• name: Required, String; You need to configure the name of your accessory.

In addition to this you need to connect the device to your machine running homebridge.

{
  "bridge": {
    …
  },
  …
  "accessories": [
    {
      "accessory": "iam-voc",
      "name": "Living Room Air Quality"
    }
  ],
	…
}