homebridge-sunsensors

This is a plugin for homebridge. It allows you to create sensors (occupancy sensors) which will be turned on or off based on the current sun position (azimuth). This is especially useful to, for example, fine-control window coverings.

Installation

1. Install homebridge (if not already installed) using: npm install -g homebridge
2. Install this plugin using: npm install -g homebridge-sunsensors
3. Update your configuration file (see below).

Example Configuration

See config-sample.json for an example config. This plugin can also be configured through a GUI like homebridge-config-ui-x.

Platform Configuration

| Parameter | Note | | ---------- | --------------------------------------------------------------------- | | lat | Latitude of the location the sun position should be calculated for. | | long | Longitude of the location the sun position should be calculated for. | | sensors | Array of objects containing configuration for the sensors, see below. | | debugLog | optional, default: false, additional debug log output |

Sensors Configuration

| Parameter | Note | | ----------- | --------------------------------------------------------------------------------------------------------------- | | name | Display name of the sensor. | | lowerThreshold | Lower threshold in degrees between -360 and 720 (-360 to 0 and 360 to 720 can be used to create overlaps). | | upperThreshold | Upper threshold in degrees between -360 and 720 (-360 to 0 and 360 to 720 can be used to create overlaps). |

Thresholds example: If you want the sensor to turn on when the sun is between 0° and 90° azimuth, set the lower threshold to 0 and the upper threshold to 90. See the example configuration file for a basic set-up (north, east, south, west).