Skip to content

Homebridge plugin to create sensors that turn on or off based on the current sun position (azimuth).

License

Notifications You must be signed in to change notification settings

mfkrause/homebridge-sunsensors

Repository files navigation

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).

About

Homebridge plugin to create sensors that turn on or off based on the current sun position (azimuth).

Resources

License

Stars

Watchers

Forks

Packages

No packages published