honkmaster / homebridge-airrohr

HomeBridge module for the DIY luftdaten.info particulates sensor. See http://luftdaten.info how to build your own

homebridge-airrohr

HomeBridge module for the DIY luftdaten.info air particulates sensor from OpenData Stuttgart.

It can be used to see the status of your own sensor in HomeKit. You can also use it to see another sensor if it's data is published to api.luftdaten.info (see here).

Setup

First follow the instructions for HomeBridge.

Install homebridge-airrohr using (sudo) npm install -g homebridge-airrohr.

Configure your AirRohr sensor in the homebridge settings file. See conig.sample.json. All settings except update_interval_seconds are required (defaults to 120 seconds).

To run this project you have two options

Option A: The sensor & homebridge in your (home) network

To do this set json_data to

http://feinstaubsensor-<YOUR_SENSOR_ID>.local/data.json

using the same local network as your sensor.

Note: If you use a HomeKit hub (like a Apple TV or a iPad) you can still access your data from outside your home. See Apple's documentation for details.

Don't set public_temperature_json_data or public_airquality_json_data in this scenario.

Option B: Use the luftdaten.info API

This allows you to add any sensor not only your own. To get the same functionality as above you need to set two IDs/URLs:

• Set public_temperature_json_data to the URL where to find the temperature data: http://api.luftdaten.info/v1/sensor/<YOUR_TEMPERATURE_SENSOR_ID>/

• Set public_airquality_json_data to the URL where to find the air particulates (PM10, PM25) data: http://api.luftdaten.info/v1/sensor/<YOUR_AIRQUALITY_SENSOR_ID>/

Don't set json_data in this scenario.

Note: If you set json_data the public_… settings will be ignored.

Demo