homebridge-syntex-knx
Advanced tools
A simple plugin to control KNX devices.
This plugin is made to cooperate with Homebridge: https://github.com/nfarina/homebridge
It connects to a KNX IP Gateway and offers some special tweaks.
Report us your IssuesJoin our Discord Server
sudo npm install -g homebridgesudo npm install -g homebridge-syntex-knxconfig.json file. See snippet below.sudo systemctl restart homebridge; sudo journalctl -fau homebridgeInfo: If the baseDirectory for the storage can't be created you have to do it by yourself and give it full write permissions!
sudo mkdir -p /var/homebridge/SynTex/ ( create the directory )sudo chmod -R 777 /var/homebridge/SynTex/ ( permissions for many processes )sudo chown -R homebridge /var/homebridge/SynTex/ ( permissions only for homebridge )"platforms": [
{
"platform": "SynTexKNX",
"baseDirectory": "/var/homebridge/SynTex",
"ip": "192.168.1.100",
"options": {
"port": 1714,
"language": "us",
"disablePreload": false
},
"log": {
"debug": false
},
"accessories": [
{
"id": "knx1",
"name": "Sensor Accessory",
"services": [
{
"address": {
"status": "1/0/0"
},
"type": "contact"
}
]
},
{
"id": "knx2",
"name": "Boolean Accessory",
"services": [
{
"address": {
"status": ["1/1/0", "1/1/1"],
"control": ["1/1/0", "1/1/1"]
},
"type": "switch"
}
]
},
{
"id": "knx3",
"name": "Dimmer Accessory",
"services": [
{
"address": {
"status": "1/1/2",
"control": "1/1/2"
},
"type": "dimmer"
}
]
},
{
"id": "knx4",
"name": "RGB Accessory",
"services": [
{
"address": {
"status": "1/1/3",
"control": "1/1/3"
},
"type": "rgb"
}
]
},
{
"id": "knx5",
"name": "Window Covering Accessory",
"services": [
{
"address": {
"status": "1/1/4",
"control": "1/1/4"
},
"delay": {
"up": 11000,
"down": 10000
},
"type": "blind",
"name": "Up / Down"
},
{
"address": {
"status": "1/1/5",
"control": "1/1/5"
},
"type": "switch",
"name": "Stop"
}
]
},
{
"id": "knx6",
"name": "Inverted Accessory",
"services": [
{
"datapoint": "1.001",
"address": {
"status": "1/0/0"
},
"type": "contact",
"inverted": true
}
]
},
{
"id": "knx7",
"name": "Multi Accessory",
"services": [
{
"address": {
"status": "1/0/0"
},
"type": "contact",
"name": "Contact"
},
{
"address": {
"status": "1/0/1"
},
"type": "humidity",
"name": "Humidity"
},
{
"address": {
"status": "1/0/2"
},
"type": "leak",
"name": "Leak"
},
{
"address": {
"status": "1/0/3"
},
"type": "light",
"name": "Light"
},
{
"address": {
"status": "1/0/4"
},
"type": "motion",
"name": "Motion"
},
{
"address": {
"status": "1/0/5"
},
"type": "occupancy",
"name": "Occupancy"
},
{
"address": {
"status": "1/0/6"
},
"type": "smoke",
"name": "Smoke"
},
{
"address": {
"status": "1/0/7"
},
"type": "temperature",
"name": "Temperature"
},
{
"address": {
"status": "1/1/1",
"control": "1/1/1"
},
"type": "led",
"name": "LED"
},
{
"address": {
"status": "1/1/1",
"control": "1/1/1"
},
"type": "outlet",
"name": "Outlet"
},
{
"address": {
"status": "1/1/1",
"control": "1/1/1"
},
"type": "switch",
"name": "Switch"
},
{
"address": {
"status": "1/1/2",
"control": "1/1/2"
},
"type": "dimmer",
"name": "Dimmer"
},
{
"address": {
"status": "1/1/3",
"control": "1/1/3"
},
"type": "rgb",
"name": "RGB"
},
{
"datapoint": "5.001",
"address": {
"status": "1/1/4",
"control": "1/1/4"
},
"delay": {
"up": 11000,
"down": 10000
},
"type": "blind",
"name": "Blind"
},
{
"datapoint": "1.001",
"address": {
"status": "1/1/1",
"control": "1/1/1"
},
"type": "switch",
"name": "Inverted Switch",
"inverted": true
}
]
}
]
}
]
platform is always SynTexKNXbaseDirectory The path where cache data is stored.ip The IP address of your KNX gateway.accessories For the accessory config.port To control your accessory over HTTP calls.language You can use your country initials if you want to change it ( Currently supported: us, en, de )disablePreload Disable reading device states after reboot ( prevents the bus from overflow )error, warn, info, read, update, success and debug ( for example debug: false )id, name and services ( required )id has to be either a physical group address or another random unique text ( no duplicates! )name could be anything.services The services of your accessory.name could be anything.type Define the service type ( blind, contact, dimmer, humidity, leak, led, light, motion, occupancy, outlet, rain, relais, rgb, smoke, switch, temperature )address can include your status and probably control group address from your knx system.datapoint ( KNX datapoint types )inverted ( inverts the state from false -> true / 0 -> 100 )delay for up and down ( to calibrate the time it takes to open / close the covering )Control and set up your devices by installing homebridge-syntex
This plugin is made for plugin management, automation system and device control.
Check out the GitHub page for more information:
https://github.com/SynTexDZN/homebridge-syntex
http:// Bridge IP /devices?id= Device ID &value= New ValueBridge IP and Device IDNew Value you can type this pattern:true / false ( dimmer, led, outlet, rgb, switch )10 / 12.4 ( blind )&brightness= New Brightness ( has to be a number )&hue= New Hue ( has to be a number )&saturation= New Saturation ( has to be a number )&type= SERVICETYPE&counter= SERVICENUMBERExample: http://homebridge.local:1714/devices?id=ABCDEF1234567890&type=dimmer&counter=0&value=true&brightness=100
( Updates the value and brightness of ABCDEF1234567890 to turned on, 100% brightness for example )
http:// Bridge IP /devices?id= Device IDBridge IP and Device ID&type= SERVICETYPE&counter= SERVICENUMBERExample: http://homebridge.local:1714/devices?id=ABCDEF1234567890
( Reads the state of ABCDEF1234567890 for example )
http:// Bridge IP /devices?id= Device ID &remove=CONFIRMBridge IP and Device ID&type= SERVICETYPE&counter= SERVICENUMBERExample: http://homebridge.local:1714/devices?id=ABCDEF1234567890&remove=CONFIRM
( Removes ABCDEF1234567890 from the Config and Home App )
To enable the automation module you have to create a file named automation.json in your baseDirectory >> automation or install the homebridge-syntex plugin to create them via UI ( only between SynTex plugins )
Example: For manual configuration update your automation.json file. See snippet below.
{
"automation": [
{
"id": 0,
"name": "Demo Automation",
"active": true,
"trigger": {
"logic": "AND",
"groups": [
{
"logic": "OR",
"blocks": [
{
"id": "multi2",
"name": "Multi Device",
"letters": "F0",
"plugin": "SynTexWebHooks",
"operation": "<",
"state": {
"value": 1000
}
},
{
"operation": "=",
"time": "16:00",
"options": {
"stateLock": true
}
}
]
},
{
"logic": "AND",
"blocks": [
{
"id": "multi1",
"name": "Multi Switch",
"letters": "41",
"plugin": "SynTexWebHooks",
"operation": "=",
"state": {
"value": false
},
"options": {
"stateLock": true
}
},
{
"operation": "=",
"days": [
1,
2,
3,
4,
5
]
}
]
}
]
},
"result": [
{
"id": "knx5",
"name": "Multi Accessory",
"letters": "80",
"plugin": "SynTexKNX",
"operation": "=",
"state": {
"value": true
}
},
{
"id": "extern1",
"name": "Extern Accessory",
"letters": "40",
"bridge": "192.168.1.100",
"plugin": "SynTexWebHooks",
"operation": "=",
"state": {
"value": false
},
"options": {
"stateLock": false
}
},
{
"operation": "=",
"delay": 1000
},
{
"url": "http://192.168.1.100:1714/devices?id=ABCDEF1234567890&value=true"
}
]
}
]
}
id A unique ID of your automation.name The name of the automation.active Enable / disable a single automation.trigger What triggers the automation?logic Define a logical operation for your groups ( AND, OR )groups Logical layer onelogic Define a logical operation for your blocks ( AND, OR )blocks Logical layer tworesult What happens when running an automation?options General automation optionstimeLock Set a timeout to prevent to many executions ( in milliseconds )id is the same like in your config file ( or in your log )name The name of the accessory.letters See letter configuration below.bridge IP of your other bridge ( optional )plugin Use the platform name of the plugin ( optional, see supported plugins below )operation Use the logical operands ( >, <, = )state The state of your accessory.value is used for the main characteristic.brightness can be used for dimmable / RGB lights.hue can be used for RGB lights.saturation can be used for RGB lights.operation Use the logical operands ( >, <, = )time Define a time point ( e.g. 16:00 )operation Use the logical operands ( = )days Set the weekdays ( from 0 to 6 )delay Set a timeout ( in milliseconds )url Fetch an URL.The letters are split into two parts ( characters )
1. Service Type
2. Duplicate Counter
Example: The first switch in your config has the letters 40, the second 41 and so on ..
homebridge-syntex-knx )homebridge-syntex-magichome )homebridge-syntex-tuya )homebridge-syntex-webhooks )FAQs
A KNX interface for an ip gateway
The npm package homebridge-syntex-knx receives a total of 44 weekly downloads. As such, homebridge-syntex-knx popularity was classified as not popular.
We found that homebridge-syntex-knx demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Fluent Assertions is facing backlash after dropping the Apache license for a commercial model, leaving users blindsided and questioning contributor rights.
Research
Security News
Socket researchers uncover the risks of a malicious Python package targeting Discord developers.
Security News
The UK is proposing a bold ban on ransomware payments by public entities to disrupt cybercrime, protect critical services, and lead global cybersecurity efforts.