mtan93/homebridge
1
0
Fork 0
mirror of https://github.com/mtan93/homebridge.git synced 2026-04-17 06:13:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

Refactoring of reversely used group addresses

Browse Source 
The use of 0/1 for binary objects depends on installation, a contact
sensor can have contact=1 or open=1
The same applies to percentages:  a window can be 100% closed or 100%
open.

For a more general usage of reversed values, a suffix ("R") can now be
attached to all DPT1 and DPT5 group addresses.
Please see updated KNX.md for examples and details.

Note: outdated characteristic-workaround throw an exception at boot-up:
-  ContactSensorStateContact1
-  LockCurrentStateSecured0
-  LockTargetStateSecured0
Please see error message and KNX.md for reference.
This commit is contained in:
Snowdd1
2015-10-02 18:05:40 +02:00
parent fd72307384
commit 3031ba7e0f
4 changed files with 127 additions and 92 deletions
Download Patch File Download Diff File Expand all files Collapse all files

162
accessories/knxdevice.js
View File

@@ -14,6 +14,9 @@ New 2015-09-18:
New 2015-09-19: New 2015-09-19:
- GarageDoorOpener Service - GarageDoorOpener Service
- MotionSensor Service - MotionSensor Service
New 2015-10-02:
- Check for valid group addresses
- new "R" flag allowed for Boolean addresses: 1/2/3R is the boolean not(1/2/3), i.e. 0 and 1 switched on read and write
* *
*/ */
var Service = require("HAP-NodeJS").Service; var Service = require("HAP-NodeJS").Service;
@@ -24,6 +27,8 @@ var knxd_startMonitor = require('../platforms/KNX.js').startMonitor;
var milliTimeout = 300; // used to block responses while swiping var milliTimeout = 300; // used to block responses while swiping
var colorOn = "\x1b[30;47m";
var colorOff = "\x1b[0m";
function KNXDevice(log, config) { function KNXDevice(log, config) {
this.log = log; this.log = log;
@@ -115,6 +120,7 @@ KNXDevice.prototype = {
if (!groupAddress) { if (!groupAddress) {
return null; return null;
} }
this.log("[knxdevice:knxread] preparing knx request for "+groupAddress);
var knxdConnection = new knxd.Connection(); var knxdConnection = new knxd.Connection();
// this.log("DEBUG in knxread: created empty connection, trying to connect socket to "+this.knxd_ip+":"+this.knxd_port); // this.log("DEBUG in knxread: created empty connection, trying to connect socket to "+this.knxd_ip+":"+this.knxd_port);
knxdConnection.socketRemote({ host: this.knxd_ip, port: this.knxd_port }, function() { knxdConnection.socketRemote({ host: this.knxd_ip, port: this.knxd_port }, function() {
@@ -130,7 +136,7 @@ KNXDevice.prototype = {
if (err) { if (err) {
this.log("[ERROR] knxread:sendAPDU: " + err); this.log("[ERROR] knxread:sendAPDU: " + err);
} else { } else {
this.log("knx request sent for "+groupAddress); this.log("[knxdevice:knxread] knx request sent for "+groupAddress);
} }
}.bind(this)); }.bind(this));
} }
@@ -143,12 +149,12 @@ KNXDevice.prototype = {
// handle multiple addresses // handle multiple addresses
for (var i = 0; i < groupAddresses.length; i++) { for (var i = 0; i < groupAddresses.length; i++) {
if (groupAddresses[i]) { // do not bind empty addresses if (groupAddresses[i]) { // do not bind empty addresses
this.knxread (groupAddresses[i]); this.knxread (groupAddresses[i].match(/(\d*\/\d*\/\d*)/)[0]); // clean address
} }
} }
} else { } else {
// it's only one // it's only one
this.knxread (groupAddresses); this.knxread (groupAddresses.match(/(\d*\/\d*\/\d*)/)[0]); // regex for cleaning address
} }
}, },
@@ -158,38 +164,30 @@ KNXDevice.prototype = {
// boolean: get 0 or 1 from the bus, write boolean // boolean: get 0 or 1 from the bus, write boolean
knxregister_bool: function(addresses, characteristic) { knxregister_bool: function(addresses, characteristic) {
this.log("knx registering BOOLEAN " + addresses); this.log("knx registering BOOLEAN " + addresses);
knxd_registerGA(addresses, function(val, src, dest, type){ knxd_registerGA(addresses, function(val, src, dest, type, reverse){
this.log("[" +this.name + "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type + " for " + characteristic.displayName); this.log("[" +this.name + "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type + " for " + characteristic.displayName);
// iterate(characteristic); // iterate(characteristic);
characteristic.setValue(val ? 1 : 0, undefined, 'fromKNXBus');
}.bind(this)); characteristic.setValue(val ? (reverse ? 0:1) : (reverse ? 1:0), undefined, 'fromKNXBus');
},
knxregister_boolReverse: function(addresses, characteristic) {
this.log("knx registering BOOLEAN " + addresses);
knxd_registerGA(addresses, function(val, src, dest, type){
this.log("[" +this.name + "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type + " for " + characteristic.displayName);
// iterate(characteristic);
characteristic.setValue(val ? 0 : 1, undefined, 'fromKNXBus');
}.bind(this)); }.bind(this));
}, },
// knxregister_boolReverse: function(addresses, characteristic) {
// this.log("knx registering BOOLEAN REVERSE " + addresses);
// knxd_registerGA(addresses, function(val, src, dest, type, reverse){
// this.log("[" +this.name + "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type + " for " + characteristic.displayName);
//// iterate(characteristic);
// characteristic.setValue(val ? 0 : 1, undefined, 'fromKNXBus');
// }.bind(this));
// },
// percentage: get 0..255 from the bus, write 0..100 to characteristic // percentage: get 0..255 from the bus, write 0..100 to characteristic
knxregister_percent: function(addresses, characteristic) { knxregister_percent: function(addresses, characteristic) {
this.log("knx registering PERCENT " + addresses); this.log("knx registering PERCENT " + addresses);
knxd_registerGA(addresses, function(val, src, dest, type){ knxd_registerGA(addresses, function(val, src, dest, type, reverse){
this.log("[" +this.name + "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type+ " for " + characteristic.displayName); this.log("[" +this.name + "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type+ " for " + characteristic.displayName);
if (type !== "DPT5") { if (type !== "DPT5") {
this.log("[ERROR] Received value cannot be a percentage value"); this.log("[ERROR] Received value cannot be a percentage value");
} else { } else {
// if (!characteristic.timeout) { characteristic.setValue(Math.round(( reverse ? (255-val):val)/255*100), undefined, 'fromKNXBus');
// if (characteristic.timeout < Date.now()) {
characteristic.setValue(Math.round(val/255*100), undefined, 'fromKNXBus');
// } else {
// this.log("Blackout time");
// }
// } else {
// characteristic.setValue(Math.round(val/255*100), undefined, 'fromKNXBus');
// } // todo get the boolean logic right into one OR expresssion
} }
}.bind(this)); }.bind(this));
}, },
@@ -200,7 +198,7 @@ KNXDevice.prototype = {
var validValue = true; var validValue = true;
var hk_value = 0.0; var hk_value = 0.0;
this.log("["+ this.name +"]:[" + characteristic.displayName+ "]:knx registering FLOAT " + addresses); this.log("["+ this.name +"]:[" + characteristic.displayName+ "]:knx registering FLOAT " + addresses);
knxd_registerGA(addresses, function(val, src, dest, type){ knxd_registerGA(addresses, function(val, src, dest, type, reverse){
this.log("["+ this.name +"]:[" + characteristic.displayName+ "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type+ " for " + characteristic.displayName); this.log("["+ this.name +"]:[" + characteristic.displayName+ "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type+ " for " + characteristic.displayName);
// make hk_value compliant to properties // make hk_value compliant to properties
if (characteristic.props.minStep) { if (characteristic.props.minStep) {
@@ -227,10 +225,10 @@ KNXDevice.prototype = {
//integer //integer
knxregister_int: function(addresses, characteristic) { knxregister_int: function(addresses, characteristic) {
this.log("["+ this.name +"]:[" + characteristic.displayName+ "]:knx registering INT " + addresses); this.log("["+ this.name +"]:[" + characteristic.displayName+ "]:knx registering INT " + addresses);
knxd_registerGA(addresses, function(val, src, dest, type){ knxd_registerGA(addresses, function(val, src, dest, type, reverse){
this.log("["+ this.name +"]:[" + characteristic.displayName+ "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type+ " for " + characteristic.displayName); this.log("["+ this.name +"]:[" + characteristic.displayName+ "]: Received value from bus:"+val+ " for " +dest+ " from "+src+" of type "+type+ " for " + characteristic.displayName);
if (val>=(characteristic.props.minValue || 0) && val<=(characteristic.props.maxValue || 255)) { if (val>=(characteristic.props.minValue || 0) && val<=(characteristic.props.maxValue || 255)) {
characteristic.setValue(val, undefined, 'fromKNXBus'); characteristic.setValue(reverse ? (255-val):val, undefined, 'fromKNXBus');
} else { } else {
this.log("["+ this.name +"]:[" + characteristic.displayName+ "]: Value %s out of bounds %s...%s ",hk_value, (characteristic.props.minValue || 0), (characteristic.props.maxValue || 255)); this.log("["+ this.name +"]:[" + characteristic.displayName+ "]: Value %s out of bounds %s...%s ",hk_value, (characteristic.props.minValue || 0), (characteristic.props.maxValue || 255));
} }
@@ -294,39 +292,39 @@ KNXDevice.prototype = {
* }.bind(this)); * }.bind(this));
* *
*/ */
setBooleanState: function(value, callback, context, gaddress) { setBooleanState: function(value, callback, context, gaddress, reverseflag) {
if (context === 'fromKNXBus') { if (context === 'fromKNXBus') {
// this.log(gaddress + " event ping pong, exit!"); // this.log(gaddress + " event ping pong, exit!");
if (callback) { if (callback) {
callback(); callback();
} }
} else { } else {
var numericValue = 0; var numericValue = reverseflag ? 1:0;
if (value) { if (value) {
numericValue = 1; // need 0 or 1, not true or something numericValue = reverseflag ? 0:1; // need 0 or 1, not true or something
} }
this.log("["+ this.name +"]:Setting "+gaddress+" Boolean to %s", numericValue); this.log("["+ this.name +"]:Setting "+gaddress+" " + reverseflag ? " (reverse)":""+ " Boolean to %s", numericValue);
this.knxwrite(callback, gaddress,'DPT1',numericValue); this.knxwrite(callback, gaddress,'DPT1',numericValue);
} }
}, },
setBooleanReverseState: function(value, callback, context, gaddress) { // setBooleanReverseState: function(value, callback, context, gaddress) {
if (context === 'fromKNXBus') { // if (context === 'fromKNXBus') {
// this.log(gaddress + " event ping pong, exit!"); //// this.log(gaddress + " event ping pong, exit!");
if (callback) { // if (callback) {
callback(); // callback();
} // }
} else { // } else {
var numericValue = 0; // var numericValue = 0;
if (!value) { // if (!value) {
numericValue = 1; // need 0 or 1, not true or something // numericValue = 1; // need 0 or 1, not true or something
} // }
this.log("["+ this.name +"]:Setting "+gaddress+" Boolean to %s", numericValue); // this.log("["+ this.name +"]:Setting "+gaddress+" Boolean to %s", numericValue);
this.knxwrite(callback, gaddress,'DPT1',numericValue); // this.knxwrite(callback, gaddress,'DPT1',numericValue);
} // }
//
}, // },
setPercentage: function(value, callback, context, gaddress) { setPercentage: function(value, callback, context, gaddress, reverseflag) {
if (context === 'fromKNXBus') { if (context === 'fromKNXBus') {
// this.log(gaddress + "event ping pong, exit!"); // this.log(gaddress + "event ping pong, exit!");
if (callback) { if (callback) {
@@ -334,8 +332,11 @@ KNXDevice.prototype = {
} }
} else { } else {
var numericValue = 0; var numericValue = 0;
if (value) { value = ( value>=0 ? (value<=100 ? value:100):0 ); //ensure range 0..100
numericValue = Math.round(255*value/100); // convert 1..100 to 1..255 for KNX bus if (reverseflag) {
numericValue = 255 - Math.round(255*value/100); // convert 0..100 to 255..0 for KNX bus
} else {
numericValue = Math.round(255*value/100); // convert 0..100 to 0..255 for KNX bus
} }
this.log("["+ this.name +"]:Setting "+gaddress+" percentage to %s (%s)", value, numericValue); this.log("["+ this.name +"]:Setting "+gaddress+" percentage to %s (%s)", value, numericValue);
this.knxwrite(callback, gaddress,'DPT5',numericValue); this.knxwrite(callback, gaddress,'DPT5',numericValue);
@@ -350,7 +351,7 @@ KNXDevice.prototype = {
} else { } else {
var numericValue = 0; var numericValue = 0;
if (value && value>=0 && value<=255) { if (value && value>=0 && value<=255) {
numericValue = value; // assure 1..255 for KNX bus numericValue = value; // assure 0..255 for KNX bus
} }
this.log("["+ this.name +"]:Setting "+gaddress+" int to %s (%s)", value, numericValue); this.log("["+ this.name +"]:Setting "+gaddress+" int to %s (%s)", value, numericValue);
this.knxwrite(callback, gaddress,'DPT5',numericValue); this.knxwrite(callback, gaddress,'DPT5',numericValue);
@@ -411,27 +412,44 @@ KNXDevice.prototype = {
/** bindCharacteristic /** bindCharacteristic
* initializes callbacks for 'set' events (from HK) and for KNX bus reads (to HK) * initializes callbacks for 'set' events (from HK) and for KNX bus reads (to HK)
*/ */
bindCharacteristic: function(myService, characteristicType, valueType, config) { bindCharacteristic: function(myService, characteristicType, valueType, config, defaultValue) {
var myCharacteristic = myService.getCharacteristic(characteristicType); var myCharacteristic = myService.getCharacteristic(characteristicType);
var setGA = "";
var setReverse = false;
if (myCharacteristic === undefined) { if (myCharacteristic === undefined) {
throw new Error("unknown characteristics cannot be bound"); throw new Error("unknown characteristics cannot be bound");
} }
if (defaultValue) {
myCharacteristic.setValue(defaultValue);
}
if (config.Set) { if (config.Set) {
// can write // can write
// extract address and Reverse flag
setGA = config.Set.match(/\d*\/\d*\/\d*/);
if (setGA===null) {
this.log(colorOn + "["+ this.name +"]:["+myCharacteristic.displayName+"] Error in group adress: ["+ config.Set +"] "+colorOff);
throw new Error("EINVGROUPADRESS - Invalid group address given");
} else {
setGA=setGA[0]; // first element of returned array is the group address
}
setReverse = config.Set.match(/\d*\/\d*\/\d*(R)/) ? true:false;
switch (valueType) { switch (valueType) {
case "Bool": case "Bool":
myCharacteristic.on('set', function(value, callback, context) { myCharacteristic.on('set', function(value, callback, context) {
this.setBooleanState(value, callback, context, config.Set); this.setBooleanState(value, callback, context, setGA, setReverse); //NEW
}.bind(this));
break;
case "BoolReverse":
myCharacteristic.on('set', function(value, callback, context) {
this.setBooleanReverseState(value, callback, context, config.Set);
}.bind(this)); }.bind(this));
break; break;
// case "BoolReverse":
// this.log("["+ this.name +"]:["+myCharacteristic.displayName+"] \x1b[30;47m%s\x1b[0mWARNING in group adress: "+ config.Set +": Legacy BoolReverse used. Use " + config.Set +"R instead");
// myCharacteristic.on('set', function(value, callback, context) {
// this.setBooleanReverseState(value, callback, context, config.Set);
// }.bind(this));
// break;
case "Percent": case "Percent":
myCharacteristic.on('set', function(value, callback, context) { myCharacteristic.on('set', function(value, callback, context) {
this.setPercentage(value, callback, context, config.Set); this.setPercentage(value, callback, context, setGA, setReverse);
myCharacteristic.timeout = Date.now()+milliTimeout; myCharacteristic.timeout = Date.now()+milliTimeout;
}.bind(this)); }.bind(this));
break; break;
@@ -451,7 +469,7 @@ KNXDevice.prototype = {
}.bind(this)); }.bind(this));
break; break;
default: { default: {
this.log("[ERROR] unknown type passed"); this.log(colorOn + "[ERROR] unknown type passed: [" + valueType+"]"+ colorOff);
throw new Error("[ERROR] unknown type passed"); throw new Error("[ERROR] unknown type passed");
} }
} }
@@ -463,9 +481,9 @@ KNXDevice.prototype = {
case "Bool": case "Bool":
this.knxregister_bool([config.Set].concat(config.Listen || []), myCharacteristic); this.knxregister_bool([config.Set].concat(config.Listen || []), myCharacteristic);
break; break;
case "BoolReverse": // case "BoolReverse":
this.knxregister_boolReverse([config.Set].concat(config.Listen || []), myCharacteristic); // this.knxregister_boolReverse([config.Set].concat(config.Listen || []), myCharacteristic);
break; // break;
case "Percent": case "Percent":
this.knxregister_percent([config.Set].concat(config.Listen || []), myCharacteristic); this.knxregister_percent([config.Set].concat(config.Listen || []), myCharacteristic);
break; break;
@@ -479,8 +497,8 @@ KNXDevice.prototype = {
this.knxregister_HVAC([config.Set].concat(config.Listen || []), myCharacteristic); this.knxregister_HVAC([config.Set].concat(config.Listen || []), myCharacteristic);
break; break;
default: default:
this.log("[ERROR] unknown type passed: ["+valueType+"]"); this.log(colorOn+ "[ERROR] unknown type passed: ["+valueType+"]"+colorOff);
throw new Error("[ERROR] unknown type passed"); throw new Error("[ERROR] unknown type passed");
} }
this.log("["+ this.name +"]:["+myCharacteristic.displayName+"]: Issuing read requests on the KNX bus..."); this.log("["+ this.name +"]:["+myCharacteristic.displayName+"]: Issuing read requests on the KNX bus...");
this.knxreadarray([config.Set].concat(config.Listen || [])); this.knxreadarray([config.Set].concat(config.Listen || []));
@@ -515,8 +533,8 @@ KNXDevice.prototype = {
this.log("["+ this.name +"]:ContactSensor ContactSensorState characteristic enabled"); this.log("["+ this.name +"]:ContactSensor ContactSensorState characteristic enabled");
this.bindCharacteristic(myService, Characteristic.ContactSensorState, "Bool", config.ContactSensorState); this.bindCharacteristic(myService, Characteristic.ContactSensorState, "Bool", config.ContactSensorState);
} else if (config.ContactSensorStateContact1) { } else if (config.ContactSensorStateContact1) {
this.log("["+ this.name +"]:ContactSensor ContactSensorStateContact1 characteristic enabled"); this.log(colorOn+ "[ERROR] outdated type passed: [ContactSensorStateContact1]"+colorOff);
this.bindCharacteristic(myService, Characteristic.ContactSensorState, "BoolReverse", config.ContactSensorStateContact1); throw new Error("[ERROR] outdated type passed");
} }
//optionals //optionals
if (config.StatusActive) { if (config.StatusActive) {
@@ -670,16 +688,16 @@ KNXDevice.prototype = {
this.bindCharacteristic(myService, Characteristic.LockCurrentState, "Bool", config.LockCurrentState); this.bindCharacteristic(myService, Characteristic.LockCurrentState, "Bool", config.LockCurrentState);
} else if (config.LockCurrentStateSecured0) { } else if (config.LockCurrentStateSecured0) {
// for reverse contacts Secured = 0 // for reverse contacts Secured = 0
this.log("["+ this.name +"]:LockMechanism LockCurrentState characteristic enabled"); this.log(colorOn+ "[ERROR] outdated type passed: [LockCurrentStateSecured0]"+colorOff);
this.bindCharacteristic(myService, Characteristic.LockCurrentState, "BoolReverse", config.LockCurrentStateSecured0); throw new Error("[ERROR] outdated type passed");
} }
// LockTargetState // LockTargetState
if (config.LockTargetState) { if (config.LockTargetState) {
this.log("["+ this.name +"]:LockMechanism LockTargetState characteristic enabled"); this.log("["+ this.name +"]:LockMechanism LockTargetState characteristic enabled");
this.bindCharacteristic(myService, Characteristic.LockTargetState, "Bool", config.LockTargetState); this.bindCharacteristic(myService, Characteristic.LockTargetState, "Bool", config.LockTargetState);
} else if (config.LockTargetStateSecured0) { } else if (config.LockTargetStateSecured0) {
this.log("["+ this.name +"]:LockMechanism LockTargetState characteristic enabled"); this.log(colorOn+ "[ERROR] outdated type passed: [LockTargetStateSecured0]"+colorOff);
this.bindCharacteristic(myService, Characteristic.LockTargetState, "BoolReverse", config.LockTargetStateSecured0); throw new Error("[ERROR] outdated type passed");
} }
//iterate(myService); //iterate(myService);
@@ -887,7 +905,7 @@ KNXDevice.prototype = {
} }
if (config.PositionState) { if (config.PositionState) {
this.log("["+ this.name +"]:Window PositionState characteristic enabled"); this.log("["+ this.name +"]:Window PositionState characteristic enabled");
this.bindCharacteristic(myService, Characteristic.PositionState, "Float", config.PositionState); this.bindCharacteristic(myService, Characteristic.PositionState, "Int", config.PositionState);
} }
return myService; return myService;
}, },

10
platforms/KNX-sample-config.json
View File

@@ -61,13 +61,13 @@
"services": [ "services": [
{ {
"type": "LockMechanism", "type": "LockMechanism",
"description": "iOS8 Lock mechanism, Supports LockCurrentStateSecured0 OR LockCurrentState, LockTargetStateSecured0 OR LockTargetState, use depending if LOCKED is 0 or 1", "description": "iOS8 Lock mechanism, Supports LockCurrentState, LockTargetState, append R to the addresses if LOCKED is 1",
"name": "Office Window Lock", "name": "Office Window Lock",
"LockCurrentStateSecured0": { "LockCurrentState": {
"Listen": "5/3/15" "Listen": "5/3/15R"
}, },
"LockTargetStateSecured0": { "LockTargetState": {
"Listen": "5/3/15" "Listen": "5/3/16R"
} }
} }
] ]

17
platforms/KNX.js
View File

@@ -116,8 +116,8 @@ function groupsocketlisten(opts, callback) {
} }
var registerSingleGA = function registerSingleGA (groupAddress, callback) { var registerSingleGA = function registerSingleGA (groupAddress, callback, reverse) {
subscriptions.push({address: groupAddress, callback: callback }); subscriptions.push({address: groupAddress, callback: callback, reverse:reverse });
} }
/* /*
@@ -143,7 +143,7 @@ var startMonitor = function startMonitor(opts) { // using { host: name-ip, port
if (subscriptions[i].address === dest) { if (subscriptions[i].address === dest) {
// found one, notify // found one, notify
console.log('HIT: Write from '+src+' to '+dest+': '+val+' ['+type+']'); console.log('HIT: Write from '+src+' to '+dest+': '+val+' ['+type+']');
subscriptions[i].callback(val, src, dest, type); subscriptions[i].callback(val, src, dest, type, subscriptions[i].reverse);
} }
} }
}); });
@@ -156,7 +156,7 @@ var startMonitor = function startMonitor(opts) { // using { host: name-ip, port
if (subscriptions[i].address === dest) { if (subscriptions[i].address === dest) {
// found one, notify // found one, notify
// console.log('HIT: Response from '+src+' to '+dest+': '+val+' ['+type+']'); // console.log('HIT: Response from '+src+' to '+dest+': '+val+' ['+type+']');
subscriptions[i].callback(val, src, dest, type); subscriptions[i].callback(val, src, dest, type, subscriptions[i].reverse);
} }
} }
@@ -185,13 +185,16 @@ var registerGA = function (groupAddresses, callback) {
if (groupAddresses.constructor.toString().indexOf("Array") > -1) { if (groupAddresses.constructor.toString().indexOf("Array") > -1) {
// handle multiple addresses // handle multiple addresses
for (var i = 0; i < groupAddresses.length; i++) { for (var i = 0; i < groupAddresses.length; i++) {
if (groupAddresses[i]) { // do not bind empty addresses if (groupAddresses[i] && groupAddresses[i].match(/(\d*\/\d*\/\d*)/)) { // do not bind empty addresses or invalid addresses
registerSingleGA (groupAddresses[i], callback); // clean the addresses
registerSingleGA (groupAddresses[i].match(/(\d*\/\d*\/\d*)/)[0], callback,groupAddresses[i].match(/\d*\/\d*\/\d*(R)/) ? true:false );
} }
} }
} else { } else {
// it's only one // it's only one
registerSingleGA (groupAddresses, callback); if (groupAddresses.match(/(\d*\/\d*\/\d*)/)) {
registerSingleGA (groupAddresses.match(/(\d*\/\d*\/\d*)/)[0], callback, groupAddresses[i].match(/\d*\/\d*\/\d*(R)/) ? true:false);
}
} }
// console.log("listeners now: " + subscriptions.length); // console.log("listeners now: " + subscriptions.length);
}; };

30
platforms/KNX.md
View File

@@ -97,11 +97,25 @@ So the charcteristic section may look like:
```` ````
## reversal of values for characteristics
In general, all DPT1 types can be reversed. If you need a 1 for "contact" of a contact senser, you can append an "R" to the group address.
Likewise, all percentages of DPT5 can be reversed, if you need a 100% (=255) for window closed, append an "R" to the group address. Do not forget the listening addresses!
````json
{
"type": "ContactSensor",
"description": "Sample ContactSensor with 1 as contact (0 is Apple's default)",
"name": "WindowContact1",
"ContactSensorState": {
"Listen": [
"1/1/100R"
]
}
}
````
# Supported Services and their characteristics # Supported Services and their characteristics
## ContactSensor ## ContactSensor
- ContactSensorState: DPT 1.002, 0 as contact **OR** - ContactSensorState: DPT 1.002, 0 as contact
- ContactSensorStateContact1: DPT 1.002, 1 as contact - ~~ContactSensorStateContact1: DPT 1.002, 1 as contact~~
- StatusActive: DPT 1.011, 1 as true - StatusActive: DPT 1.011, 1 as true
- StatusFault: DPT 1.011, 1 as true - StatusFault: DPT 1.011, 1 as true
@@ -142,10 +156,10 @@ So the charcteristic section may look like:
- CurrentAmbientLightLevel: DPT 9.004, 0 to 100000 Lux - CurrentAmbientLightLevel: DPT 9.004, 0 to 100000 Lux
## LockMechanism (This is poorly mapped!) ## LockMechanism (This is poorly mapped!)
- LockCurrentState: DPT 1, 1 as secured **OR (but not both:)** - LockCurrentState: DPT 1, 1 as secured
- LockCurrentStateSecured0: DPT 1, 0 as secured - ~~LockCurrentStateSecured0: DPT 1, 0 as secured~~
- LockTargetState: DPT 1, 1 as secured **OR** - LockTargetState: DPT 1, 1 as secured
- LockTargetStateSecured0: DPT 1, 0 as secured - ~~LockTargetStateSecured0: DPT 1, 0 as secured~~
*ToDo here: correction of mappings, HomeKit reqires lock states UNSECURED=0, SECURED=1, JAMMED = 2, UNKNOWN=3* *ToDo here: correction of mappings, HomeKit reqires lock states UNSECURED=0, SECURED=1, JAMMED = 2, UNKNOWN=3*
@@ -181,7 +195,7 @@ So the charcteristic section may look like:
## WindowCovering ## WindowCovering
- CurrentPosition: DPT5 percentage - CurrentPosition: DPT5 percentage
- TargetPosition: DPT5 percentage - TargetPosition: DPT5 percentage
- PositionState: DPT5 value [listen only: 0 Closing, 1 Opening, 2 STopped] - PositionState: DPT5 value [listen only: 0 Closing, 1 Opening, 2 Stopped]
### not yet supported ### not yet supported
- HoldPosition - HoldPosition