homebridge-sun-protect
v1.0.18
Published
An homebridge plugin to protect home from sun
Downloads
21
Readme
homebridge-sun-protect
This plugin offer simple Homekit accessory to configure shades automations depending on sun position.
Installation
- Install homebridge using:
npm install -g homebridge
- Install this plugin using:
npm install -g homebridge-sun-protect
- Update your configuration file. See bellow for a sample.
Configuration
- Configure your lat/long coordinate
- Create plugin config with zone name (generally one by shade orientation) and trigger(s) restricted by azimuthMin, azimuthMax, altitudeMin and/or altitudeMax condition(s)
- Configure your shade closure in Homekit
Plugin will add 2 accessories : one switch to enable triggers computation and stateless buttons used to configure automation.
Activate the switch when wether is sunny (with luminosity sensor for eg.) and when you are wake-up (with motion sensor for eg.). The switch automatically move to 'off' when sun sets.
Configure the stateless button as following: There is one button by zone configured in plugin config.
- 1 press button is triggered when condition stops: no trigger match
- 2-3 press button is triggered when first trigger conditions matches
When main switch is switched off, 1 press button will be triggered for each zone. To avoid triggering, add silentSwitchOff
with value true
to the config.
LIMITATION : All zone must have 2nd trigger in config to activate 3rd press button
Full configuration example:
{
"bridge": {
...
},
"description": "...",
"accessories": [
{
"accessory": "SunProtect",
"name": "Sun",
"location": {
"lat": 46.123456,
"long": -1.123456
},
"silentSwitchOff": false,
"zones": [
{
"name": "1st floor - South East",
"triggers": [
{
"azimuthMin": 100,
"azimuthMax": 150
}
]
},
{
"name": "1st floor - South",
"triggers": [
{
"azimuthMin": 95,
"azimuthMax": 240,
"altitudeMin": 20
}
]
},
{
"name": "Living room",
"triggers": [
{
"azimuthMin": 150,
"azimuthMax": 260,
"altitudeMin": 10
}
]
},
{
"name": "Kitchen",
"triggers": [
{
"azimuthMin": 150,
"azimuthMax": 285,
"altitudeMin": 15
}
]
}
]
}
]
}