• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

dubocr/homebridge-tahoma: Homebridge plugin for TaHoma, Connexoon, Cozytouch, En ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称:

dubocr/homebridge-tahoma

开源软件地址:

https://github.com/dubocr/homebridge-tahoma

开源编程语言:

TypeScript 100.0%

开源软件介绍:

homebridge-tahoma

Homebridge plugin supporting Overkiz based platforms :

Product Vendor Service
TaHoma / TaHoma Switch Somfy tahoma
Connexoon Somfy tahoma
Connexoon RTS Somfy connexoon_rts
Cozytouch Atlantic / Thermor / Sauter cozytouch
Energeasy Connect Rexel rexel
Kit de connectivité Somfy Orange tahoma

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": "My TaHoma Box",

			"service": "tahoma",
			"user": "[email protected]",
			"password": "MyPassw0rd",
		}
	]
}

Configuration parameters:

Parameter Type Default Note
service String 'tahoma' optional, service name ('tahoma', 'connexoon_rts', 'cozytouch' or 'rexel')
user String null mandatory, your service account username
password String null mandatory, your service account password
pollingPeriod Integer 30 optional, bridge polling period in seconds
refreshPeriod Integer 30 optional, device states refresh period in minutes
exclude String[] [] optional, list of protocols (hue,enocean,zwave,io,rts), ui name, widget name or device name to exclude
exposeScenarios Boolean false optional, expose TaHoma/Connexoon/Cozytouch scenarios as HomeKit switches. Could also specify a list of string corresponding to scenarios names to expose
devicesConfig Object[] [] optional list of device specific configuration (see below)

Specific device configuration

This option allows you to apply a specific configuation to device or group of device. One configuration is composed of a key attribute containing device name, widget, uiClass, protocol or unique identifier and as many parameter depending of device type.

{
	"key": "Bedroom door",
	"param1": "value1"
	...
}
Alarm parameters Type Default Note
stayZones String 'A' optional, active zones (A,B,C) in 'Stay' mode
nightZones String 'B' optional, active zones (A,B,C) in 'Night' mode
occupancySensor Boolean false optional, add an occupancy widget linked to the alarm
WindowCovering parameters Type Default Note
defaultPosition Integer 0 optional, final position for UpDown rollershutter after any command
reverse Boolean false optional, reverse up/down in case of bad mounting
lowSpeed Boolean / String false optional, use low speed for roller shutter supporting it. If string, specify slot time with format "HH:MM-HH:MM". Low speed will be enabled between them.
blindMode String null optional, change main slider action to orientation. By default, both closure and orientation will be set. When setting blindMode: true the blinds work in the following way: Opening the blinds or setting them to 100% will fully open them. Closing the blinds or setting them to 0% will fully close them. Setting the blinds to a value between 1% and 99% will first close the blinds and then adjust thier horizontal tilt in a way that 99% means fully horizonal = more light, and 1% means nearly closed = less light.
blindsOnRollerShutter Boolean false optional, when blinds are installed on roller shutter motors allow slats to stay horizontal (opened) at intermediate position
movementDuration Integer 0 optional, duration of a full shutter movement from 'open' to 'close' in seconds. Will be used to approximate shutter intermediate position. (0 = disable feature)
GarageDoorOpener parameters Type Default Note
cyclic Boolean false optional, restore closed state after cycleDuration seconds for stateless devices with cyclic behaviour
cycleDuration Integer false optional, cycle duration (in seconds) for cyclic mode (default: 5 sec)
reverse Boolean false optional, reverse up/down in case of bad mounting
pedestrianDuration Integer 0 optional, duration for pedestrian position for RTS gates
HeatingSystem parameters Type Default Note
derogationDuration Integer 1 optional, duration (in hours) for derogation orders
comfort Integer 19 optional, comfort temperature used as display for heaters controled by pilot wire
eco Integer 17 optional, comfort temperature used as display for heaters controled by pilot wire

Full configuration example:

{
	"bridge": {
		...
	},

	"description": "...",

	"accessories": [],

	"platforms":[
		{
			"platform": "Tahoma",
			"name": "My Tahoma Bridge",

			"user": "[email protected]",
			"password": "MyPassw0rd",
			"service": "tahoma",
			"exclude": ["hue", "rts", "Main door"],

			"devicesConfig": [
				{
					"key": "Alarm",
					"stayZones": "A,C"
				},
				{
					"key": "Bedroom blind",
					"blindMode": true
				},
				{
					"key": "GarageDoor",
					"reverse": true
				},
				{
					"key": "UpDownRollerShutter",
					"defaultPosition": 50
				}
			]
		}
	]
}

Contribute

You are welcome to contribute to this plugin development by opening an issue in case of bad behaviour or not implemented device.

Any support request must follow this process :

  1. Execute failling operations from official app then from Homekit
  2. Report your config to https://dev.duboc.pro/tahoma
  3. Browse or open issue with title corresponding to your device widget name (see picture below)
  4. Provide your bridge last 4 digits (number visible as SETUP-XXXX-XXXX-XXXX at step 2.) Widget

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.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap