homebridge-automation-switches
v3.2.1
Published
A platform for automation switches for HomeKit via Homebridge
Downloads
71
Maintainers
Readme
Automation Switches Platform
A platform that provides configurable switches for automation purposes. This platform can be created to provide time delayed responses in HomeKit rules or to simulate security systems.
Status
Why do we need this plugin?
This platform provides software based, optionally persistent, switches to create DIY HomeKit solutions. Each switch has specific purposes that are illustrated in their respective documents linked below.
The plugin provides four different types of switches: A basic on/off switch, a lock mechanism, an automation switch with advanced properties and a security system. All of them are configured ahead of their use through the configuration file and each one of them potentially saves their state to storage to keep their state even across crashes, reboots and such.
Installation instructions
After Homebridge has been installed:
sudo npm install -g homebridge-automation-switches
Example config.json:
{
"bridge": {
...
},
"platforms": [
{
"platform": "AutomationSwitches",
"switches": [
{
"type": "automation",
"name": "Automation Switch #1",
"period": 1800,
"autoOff": false
},
{
"type": "security",
"name": "Home alarm"
}
]
}
]
}
The platform can provide any number of switches that have to be predefined in the homebridge config.json.
Switch types
Please see the documentation for each type of switch this plugin is able to create:
An advanced configuration example containing all four switch types can be found here.
Storage
Every type of switch is able to store every state change to disk. This is useful if homebridge is restarted for whatever reason: The switches created by this plugin will retain the state they had before the restart.
For that the switches create individual files in the persist subfolder of your homebridge configuration folder.
Developer Information
There's documentation of the custom services and characteristics exposed by the switches.
Supported clients
This platform and the switches it creates have been verified to work with the following apps on iOS 11:
- Home
- Elgato Eve
Credits
See CONTRIBUTORS for acknowledgements to the individuals that contributed to this plugin.
Some asks for friendly gestures
If you use this and like it - please leave a note by staring this package here or on GitHub.
If you use it and have a problem, file an issue at GitHub - I'll try to help.
If you tried this, but don't like it: tell me about it in an issue too. I'll try my best to address these in my spare time.
If you fork this, go ahead - I'll accept pull requests for enhancements.
License
MIT License
Copyright (c) 2017 Michael Fröhlich
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.