Nebulous Program Mechanic

    homebridge-sunsensors

    0.1.2 • Public • Published

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

    Install

    npm i homebridge-sunsensors

    DownloadsWeekly Downloads

    3

    Version

    0.1.2

    License

    Apache-2.0

    Unpacked Size

    26.2 kB

    Total Files

    11

    Last publish

    Collaborators

    • mfkrause