Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

jtraulle/homebridge-tahoma

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

homebridge-tahoma

Supports TaHoma (Somfy), Connexoon (Somfy) and Cozytouch (Atlantic,Thermor,Sauter) platforms on HomeBridge

Installation

  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-tahoma
  3. Update your configuration file. See bellow for a sample.

Configuration

Minimal configuration sample:

{
	"bridge": {
		...
	},

	"description": "...",

	"accessories": [],

	"platforms":[
		{
			"platform": "Tahoma",
			"name": "Tahoma",
			"user": "[email protected]",
			"password": "MyPassw0rd",
		}
	]
}

Configuration parameters:

Parameter Type Default Note
user String null mandatory, your TaHoma/Connexoon/Cozytouch account username
password String null mandatory, your TaHoma/Connexoon/Cozytouch account password
service String 'TaHoma' optional, service name ('TaHoma' or 'Cozytouch')
refreshPeriod Integer 600 optional, device states refresh period in seconds
exclude String[] [] optional, list of protocols (hue,enocean,zwave,io,rts) or device (name) to exclude
exposeScenarios Boolean false optional, expose TaHoma/Cozytouch scenarios as HomeKit switches. Could also specify a list of string corresponding to scenarios names to expose
Alarm Object {} optional, Alarm configuration object (see below)
Alarm parameters Type Default Note
STAY_ARM String 'A' optional, active zones (A,B,C) in 'Stay' mode
NIGHT_ARM String 'B' optional, active zones (A,B,C) in 'Night' mode

Full configuration example:

{
	"bridge": {
		...
	},

	"description": "...",

	"accessories": [],

	"platforms":[
		{
			"platform": "Tahoma",
			"name": "Tahoma",
			"user": "[email protected]",
			"password": "MyPassw0rd",
			"service": "TaHoma",
			"exclude": ["hue","rts","Garage Door"],
			"Alarm": {
				"STAY_ARM": "A,C",
				"NIGHT_ARM": "B"
			}
		}
	]
}

Limitation

Some devices or configurations could not operate properly due to limited tests. Don't hesitate to open an issue if your device doesn't work properly.

Contribute

You are welcome to contribute to this plugin development by adding new kind of devices by adding implementation .js file in accessories folder or improving existing 'js' file. These documentations could help you developing plugin : Obtaining my config, HomeKit services and characteristics

I do not expect any reward concerning this plugin, however, some users ask me for a Donate button as sign of contribution. Feel free to use it.

About

Homebridge plugin for Tahoma and Cozytouch

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%