homebridge-influxdb-air v0.0.3

homebridge-influxdb-air

Homebridge plugin that exposes temperature, humidity, and air quality from an InfluxDB instance.

This project is forked from:

• tiphedor/homebridge-influxdb-temperature-humidity.

Usage

Install

Install the plugin using:

npm i -g /path-to/homebridge-influxdb-air

You may have to use either sudo or --unsafe-perm, or both, depending on your environment.

Configure

Add to the accessories field of your Homebridge config.json file (default location at ~/.homebridge/config.json) :

{
  "accessories": [
      ...rest of your accessories
      {
        "accessory": "InfluxAir",
        "name": "Air Sensors", // You can use any name, it's only for the UI
        "sensor_names": { // Optional names for each sensor
          "temperature": "Temperature Sensor",
          "humidity": "Humidity Sensor",
          "air_quality": "Air Quality Sensor"
        },
        "schema": { // For influxDB queries
          "temperature": {
            "field": "temperature",
            "measurement": "air"
          },
          "humidity": {
            "field": "humidity",
            "measurement": "air"
          },
          "air_quality": {
            "fields": {
              "pm2_5": "pm25",
              "pm10": "pm100"
            },
            "measurement": "pm"
          }
        },
        "influx": {
          "host": "127.0.0.1",
          "database": "homeserver"
        }
      }
    ]
}

Learn more at config.sample.json.

The influx configuration object is passed as-is to the influx npm library, so you can use all the options it supports. See here