node-red-contrib-knx-ultimate 3.1.6 → 3.1.7

package/.github/ISSUE_TEMPLATE/README.md

@@ -0,0 +1,2 @@
+# ISSUE\_TEMPLATE
+

package/.github/README.md

@@ -0,0 +1,2 @@
+# .github
+

package/CHANGELOG.md

@@ -6,6 +6,9 @@
 
 # CHANGELOG
 
+**Version 3.1.7** - August 2024<br/>
+- KNX Node: KNX Function: async/await caused some race condition issues, so the code is now sync.<br/>
+
 **Version 3.1.6** - August 2024<br/>
 - KNX Node: KNX Function: added "self", "toggle" and "setGAValue" function. See the help.<br/>
 - KNX Node: KNX Function: the code runs now in async/await mode.<br/>

package/docs/README.md

@@ -0,0 +1,15 @@
+# Home
+
+![Logo](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/logo-big.png)
+
+Control your KNX intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.
+
+> \[!TIP] I'm putting many effort, money and free time to this node, so please consider [making a little donation](https://www.paypal.me/techtoday) if you're using KNX-Ultimate. Thanks!
+
+#### WORKING WITH THE ETS CSV FILE
+
+Instead of create a knx device node for each Group Address to control, you can import your ETS csv group addresses file. Thanks to that, the knx device node where you selected **Listen to all Group Addresses**, becomes an universal input/output node, aware of all Datapoints, Group Addresses and Device's name (ex: Living Room Lamp). Just send the payload to the knx-ultimate node, and it'll encode it with the right datapoint and send it to the bus. Likewise, when the knx-ultimate node receives a telegram from the bus, it outputs a right decoded payload using the datapoint specified in the ETS file.
+
+> You can work with a mix of knx-ultimate nodes, some with **Listen to all Group Addresses** checked and some not. You are absolutely free! See this youtube video,
+
+[![](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/yt.png)](https://youtu.be/egRbR\_KwP9I)

package/docs/SUMMARY.md

@@ -0,0 +1,45 @@
+# Table of contents
+
+* [Home](README.md)
+  * [Changelog](home/changelog.md)
+  * [FAQ AND TROUBLESHOOT](home/5.-faq-troubleshoot.md)
+  * [Security Policy](home/security.md)
+  * [Node self protection](home/protections.md)
+* [ KNX NODES](other-knx-nodes/README.md)
+  * [KNX Gateway configuration](other-knx-nodes/1.-gateway-configuration.md)
+  * [KNX Device Node configuration](other-knx-nodes/2.-node-configuration.md)
+  * [Load Control configuration](other-knx-nodes/loadcontrol-configuration.md)
+  * [Scene Controller configuration](other-knx-nodes/scenecontroller-configuration.md)
+  * [WatchDog configuration](other-knx-nodes/7.-watchdog-configuration.md)
+  * [ETS Logger configuration](other-knx-nodes/logger-configuration.md)
+  * [Global Context configuration](other-knx-nodes/globalvariable.md)
+  * [Alerter configuration](other-knx-nodes/alerter-configuration.md)
+  * [Viewer configuration](other-knx-nodes/knxultimateviewer.md)
+* [PHILIPS HUE NODES](hue-bridge-configuration/README.md)
+  * [HUE Light](hue-bridge-configuration/hue-light.md)
+* [SAMPLES](samples/README.md)
+  * [DATE / TIME TO THE KNX BUS](samples/date-time-to-the-knx-bus.md)
+  * [Datapoint 2](samples/datapoint-2.md)
+  * [Datapoint 22](samples/datapoint-22.md)
+  * [Datapoint 222](samples/datapoint-222.md)
+  * [Datapoint 213](samples/datapoint-213.md)
+  * [Datapoint 237](samples/datapoint-237.md)
+  * [RGBW, Datapoint 251.600](samples/rgbw-datapoint-251.600.md)
+  * [RGB color, Datpoint 232.600](samples/rgb-color-datpoint-232.600.md)
+  * [SCENE CONTROLLER NODE SAMPLES](samples/scene-controller-node-samples.md)
+  * [Alexa](samples/alexa.md)
+  * [POE On/Off](samples/poe-on-off.md)
+  * [WATCHDOG NODE](samples/watchdog-node.md)
+  * [VIRTUAL DEVICE](samples/virtual-device.md)
+  * [LOAD CONTROL SAMPLE](samples/load-control-sample.md)
+  * [Google Assistant](samples/google-assistant.md)
+  * [Switching a lamp](samples/switching-a-lamp.md)
+  * [Dimming a lamp](samples/dimming-a-lamp.md)
+  * [Homekit with Siri](samples/homekit-with-siri.md)
+  * [Read Request to the KNX BUS](samples/read-request-to-the-knx-bus.md)
+  * [ALERTER NODE SAMPLE](samples/alerter-node-sample.md)
+  * [PROGRAMMATICALLY CHANGE THE NODE CONFIG](samples/programmatically-change-the-node-config.md)
+  * [Global Context Node Sample](samples/global-context-node-sample.md)
+  * [Scene actuator controller](samples/scene-actuator-controller.md)
+  * [Subtype Value Sample](samples/subtype-value-sample.md)
+  * [ETS Logger sample](samples/logger-sample.md)

package/docs/home/5.-faq-troubleshoot.md

@@ -0,0 +1,170 @@
+# FAQ AND TROUBLESHOOT
+
+_First of all, thank you to use one of my node-red nodes! I worked a lot on this node and i hope you'll enjoy my efforts in offering my work to all users._\
+_If you're here, you may have some issues. I'm sorry about that._\
+_**Don't worry and relax**, we'll find what your problem is, because the **knx-ultimate node WORKS**, it has about thousand installations around the world and i have it installed as well for my home. So please follow the FAQ and if you "i'm still having problem", contact me._
+
+<details>
+
+<summary>THE NODE DOESN'T WORK</summary>
+
+**Follow this checklist**
+
+* Do you have created the [Gateway configuration node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/1.-Gateway-configuration) with the IP and Port pointing to your KNX/IP Router/Interface?
+* If you've a KNX/IP **Router**, you need to put in the **Host** field, the multicast KNX IP address **224.0.23.12** and port **3671**
+* If you've a KNX/IP **Interface**, you need to put in the **Host** field, the Interface's IP address, for example **192.168.1.22** and port **3671**
+* If you have **two or more Ehternet interfaces** (like Raspberry PI), either specify the Ethernet interface to use in the [Gateway configuration node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/1.-Gateway-configuration), or totally disable the WIFI interface. Remember to **restart node-red**!
+* Use only certified pure KNX/IP Router (preferable) or pure KNX/IP Interfaces. Do not use "all in one" devices, or proxies, or devices that, besides other functions, do KNX/IP routing as well. A stable connection between **LAN and KNX is the most important thing**, and it need to work. Spend money on that and you'll setup and forget it.
+* If you have **an IP interface** try to disable the ACK by selecting _Suppress ACK request_ in the [Gateway configuration node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/1.-Gateway-configuration).
+* Follow the **I CAN ONLY RECEIVE TELEGRAMS, NOT SEND - OR VICE VERSA** checklist
+* If you're running Node-Red in a container, **delay the start of node-red after the container boots up**. Some users report that the Ethernet card is still DOWN when node-red starts. You can try it by manually stop node-red, disabling auto start of noder-red at boot, reboot the container, wait 2-3 minutes and manually start node-red. If KNX-Ultimate works, the issue is that.
+
+</details>
+
+<details>
+
+<summary>AFTER SOME TIME THE NODE STOPS WORKING</summary>
+
+**Follow this checklist**
+
+* Read the **THE NODE DOESN'T WORK** faq.
+* Check and eventually **disable** DDOS protection or UDP flood protection on your switches/routers. This as general rule. UDP KNX packets can be blocked otherwise.
+* Try to directly connect your KNX/IP Router/Interface and your node-red PC.
+* If you've a cheap KNX/IP Interface, specially if is an "all in onde" device, it can hangs. Go buy a real KNX/IP Router.
+* If you use an KNX/IP Interface, be sure that you haven't reached the maximum connection limit (see your KNX/IP Interface's user manual). **KNX/IP Routers** are preferable instead, they doesn't have connection limits.
+
+</details>
+
+<details>
+
+<summary>KNXD CONFIGURATION</summary>
+
+**Follow this checklist**
+
+* If you're running **knxd** on the same machine of node-red, please use 127.0.0.1 as interface address, otherwise knxd will have problems.
+* If you're using **knxd**, please check the filtering tables and change the KNX config-node's physycal address accordingly.
+* Enable the **Echo sent message to all node with same Group Address** in the gateway config-node, under advanded options.
+
+</details>
+
+<details>
+
+<summary>I SEE THE TELEGRAM IN ETS, BUT MY ACTUATOR WON'T REACT</summary>
+
+**Follow this checklist**
+
+You may have other Node-Red KNX Plug-ins installed.
+
+* Remove all KNX Plugin from node-red Palette. Leave only knx-ultimate. Remember to remove the config nodes as well, they are hidden.
+* If you have **an IP interface** try to disable the ACK by selecting _Suppress ACK request_ in the [Gateway configuration node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/1.-Gateway-configuration).
+
+</details>
+
+<details>
+
+<summary>I CAN ONLY RECEIVE TELEGRAMS, NOT SEND - OR VICE VERSA</summary>
+
+**Follow this checklist**
+
+Your KNX/IP Router/Interface may have filtering active.
+
+* Check in ETS if the router has filtering enabled. If yes, either allow **forwarding** in all configuration pages of your KNX Router, or change the physical address of the knx-ultimate config node according to your router's filter tables.
+* If you're using **knxd**, please check the filtering tables and change the KNX config node physycal address accordingly.
+
+</details>
+
+<details>
+
+<summary>WRONG VALUES FROM THE NODE</summary>
+
+**Follow this checklist**
+
+* Make sure to use the right datapoint. For example, for temperature, use 9.001
+* When possible, import the ETS csv file in the Gateway configuration node. You'lll have always the right Datapoints!
+* Make sure not to have two or more knx-ultimate nodes, having **same Group Address** but **different Datapoint**.
+
+</details>
+
+<details>
+
+<summary>IF I SEND A MESSAGE TO A NODE FROM NODE-RED, OTHER NODES IN THE FLOWS HAVING THE SAME GROUP ADDRESS, DOESN'T RECEIVE/DON'T REACT TO THIS MESSAGE</summary>
+
+**This happens if you use a tunneling/unicast connection, like KNX/IP Interfaces or knxd does.**
+
+* Enable the **Echo sent message to all node with same Group Address** in the gateway config-node, under advanded options.
+
+</details>
+
+<details>
+
+<summary>DOES IT WORK WITH SECURE KNX ROUTER/INTERFACES?</summary>
+
+**Follow this checklist**
+
+Secure IP Router/Interfaces doesn't work if set to secure. It works, instead, if you allow unsecure connections to you router.
+
+* Make sure to disable the secure routing or to allow unsecure connections.
+* If you feel that you can be hacked, you can use a second ethernet card, straight connecting node-red machine to your KNX Router/Inteface with a dedicated LAN cable. In the knx-ultimate config node **Bind to local interface** option, you can then set this interface to be the default KNX/IP interface.
+* Secure connection will be implemented one day.
+
+</details>
+
+<details>
+
+<summary>FLOOD PROTECTION KICKS IN. WHAT THE HELL IS THAT?</summary>
+
+**Follow this checklist**
+
+Flood protection avoids your node-red UI to become unresponsive, due to a too high amount of messages sent to te input pin of the node in a specified time frame of 1 second.\
+The max number of msg you can send to a node is 120 each second. If you need to send a lot of msg to the node, please consider a "delay" node, to delay each message a bit.\
+[See here](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Protections)
+
+* Review your flow. Send less messages to the node or use a **delay** node.
+* Use RBE filter, to discard messages having the payload equal to the current node's payload.
+
+</details>
+
+<details>
+
+<summary>I'VE IMPORTED ETS FILE BUT THERE ARE WARNINGS ABOUT DATAPOINTS</summary>
+
+**Follow this checklist**
+
+In a ETS installation, setting Datapoints is mandatory, at least for professional one.\
+With Datapoints, all youd visualization and control devices know how to handle the telegram and how to perform a right decondinf of values.\
+You'll see that ALL devices, control software, visualization systems and all the entire KNX world need Datapoints, so why not to thanks knx-ultimate, to force you to finally fix your ETS installation, that wait so long to be fixed? :-)\
+
+
+* Put an headphone on your head, with good music, open ETS and start adding datapoints.
+* Or... import ETS file by selecting the option "if Group Address has no Datapoint", to "Import with a fake 1.001 datapoint (Not recommended)", or to skip affected datapoint.
+* Remember to set the FULL datapoint (main type + subtype), otherwise the importer will set a default .001 subtype. Please see this image ![Subtype pic](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/subtype.png)
+
+</details>
+
+<details>
+
+<summary>CIRCULAR REFERENCE PROTECTION KICKS IN. WHAT THE HELL IS THAT?</summary>
+
+**Follow this checklist**
+
+Circular reference protection avoids your node-red UI to become unresponsive and your KNX installation to be flooded, by disabling two nodes with same Group Address link toghether.\
+For example, if you link the **output** pin of a node having Group Address 0/1/1, to the **input** ping of another node having the same Group Address 0/1/1, the protection will kicks in.\
+[See here](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Protections)
+
+* Review your flow. Detach the two identical nodes or out something inbetween, acting as "moderator".
+* Use RBE filter, to discard messages having the payload equal to the current node's payload.
+
+</details>
+
+<details>
+
+<summary>I'M STILL HAVING PROBLEM</summary>
+
+**Use one of the channels below to reach me (i ever prefer gitHub)**
+
+* Open an issue on [Github](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues). Whenever you open an issue, i receive an email and i can sort it out immediately.
+* Send me a PM on [Knx-User-Forum](https://knx-user-forum.de). I'm here as TheMax74. Mein Deutsch ist nicht so gut, daher bitte auf Englisch schreiben!
+
+</details>
+
+Now that your issue has been resolved, you can [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday)

package/docs/home/changelog.md

@@ -0,0 +1,7 @@
+---
+description: In the link below, you'll find the changelog.
+---
+
+# Changelog
+
+[https://github.com/Supergiovane/node-red-contrib-knx-ultimate/blob/master/CHANGELOG.md](../../CHANGELOG.md)

package/docs/home/protections.md

@@ -0,0 +1,46 @@
+# Node self protection
+
+KNX-Ultimate has two types of internal protection, to protect your KNX Bus from being flooded and your Node-RED GUI from being unresponsive, if you make some mistake in your flows.\
+Let's have **some fun** with these protections!\
+
+
+## FLOOD PROTECTION
+
+Flood protection avoids your node-red UI to become unresponsive, due to a too high amount of messages sent to te input pin of the node in a specified time frame of 1 second.\
+The max number of msg you can send to a node is 120 each second. If you need to send a lot of msg to the node, please consider a "delay" node, to delay each message a bit.\
+
+
+![](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/floodprotection.png)\
+
+
+**Copy this code and paste it into your flow**
+
+```javascript
+
+[{"id":"f91f45d.66cd538","type":"comment","z":"3e6a6a12ba5593cb","name":"Flood protection sample. Click Flood!","info":"","x":270,"y":140,"wires":[]},{"id":"d37f901.ab92c7","type":"comment","z":"3e6a6a12ba5593cb","name":"How to avoid Flood protection by inserting rate control node. Click Flood!","info":"","x":380,"y":300,"wires":[]},{"id":"c2fcf850cd98f5ea","type":"group","z":"3e6a6a12ba5593cb","name":"","style":{"fill":"#ffbfbf","label":true},"nodes":["c190dcf9.50bd4","5cf9789e.f8a6e8","477e25ad.e2efa4"],"x":114,"y":159,"w":612,"h":82},{"id":"c190dcf9.50bd4","type":"inject","z":"3e6a6a12ba5593cb","g":"c2fcf850cd98f5ea","name":"Flood!","props":[{"p":"payload"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"false","payloadType":"bool","x":210,"y":200,"wires":[["5cf9789e.f8a6e8"]]},{"id":"5cf9789e.f8a6e8","type":"function","z":"3e6a6a12ba5593cb","g":"c2fcf850cd98f5ea","name":"Send 300 telegrams at once","func":"for (var i = 0; i < 300; i++) { \n  node.send({payload:false});\n}","outputs":1,"noerr":0,"initialize":"","finalize":"","libs":[],"x":410,"y":200,"wires":[["477e25ad.e2efa4"]]},{"id":"477e25ad.e2efa4","type":"knxUltimate","z":"3e6a6a12ba5593cb","g":"c2fcf850cd98f5ea","server":"64df43b53180c04b","topic":"0/1/1","outputtopic":"","dpt":"1.001","initialread":false,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Garage Light","outputtype":"write","outputRBE":false,"inputRBE":false,"formatmultiplyvalue":"1","formatnegativevalue":"leave","formatdecimalsvalue":"999","passthrough":"no","x":630,"y":200,"wires":[[]]},{"id":"64df43b53180c04b","type":"knxUltimate-config","host":"224.0.23.12","port":"3671","physAddr":"15.15.22","hostProtocol":"Multicast","suppressACKRequest":false,"csv":"\"Group name\"\t\"Address\"\t\"Central\"\t\"Unfiltered\"\t\"Description\"\t\"DatapointType\"\t\"Security\"\n\"Attuatori luci\"\t\"0/-/-\"\t\"\"\t\"\"\t\"\"\t\"\"\t\"Auto\"\n\"Luci primo piano\"\t\"0/0/-\"\t\"\"\t\"\"\t\"\"\t\"\"\t\"Auto\"\n\"Luce camera da letto\"\t\"0/0/1\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-8\"\t\"Auto\"\n\"Luce loggia camera da letto\"\t\"0/0/2\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce camera armadi\"\t\"0/0/3\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce bagno grande (switch)\"\t\"0/0/4\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce loggia bagno grande\"\t\"0/0/5\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio bagno grande (switch)\"\t\"0/0/6\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce lavanderia\"\t\"0/0/7\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio lavanderia (switch)\"\t\"0/0/8\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce studio\"\t\"0/0/9\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Plafoniera soggiorno (switch)\"\t\"0/0/10\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique soggiorno (switch)\"\t\"0/0/11\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce loggia soggiorno cucina\"\t\"0/0/12\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce cucina\"\t\"0/0/13\"\t\"\"\t\"\"\t\"\"\t\"DPT-1\"\t\"Auto\"\n\"Pensili cucina\"\t\"0/0/14\"\t\"\"\t\"\"\t\"\"\t\"DPT-1\"\t\"Auto\"\n\"Luce corridoio\"\t\"0/0/15\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"LED scala\"\t\"0/0/16\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique soggiorno brightness value\"\t\"0/0/17\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce specchio bagno grande(dim)\"\t\"0/0/18\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Plafoniera soggiorno brightness value\"\t\"0/0/19\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce specchio lavanderia (dim)\"\t\"0/0/20\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"LED cambiacolori RGB scala\"\t\"0/0/21\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio bagno grande brightness value\"\t\"0/0/22\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Plafoniera soggiorno (dim)\"\t\"0/0/23\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Applique soggiorno (dim)\"\t\"0/0/24\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Luce specchio lavanderia brightness value\"\t\"0/0/25\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Plafoniera soggiorno switch Stato\"\t\"0/0/26\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique soggiorno switch Stato\"\t\"0/0/27\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce camera armadi Stato\"\t\"0/0/28\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce bagno grande (switch) Stato\"\t\"0/0/29\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio bagno grande Stato\"\t\"0/0/30\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce specchio lavanderia Stato\"\t\"0/0/31\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce lavanderia Stato\"\t\"0/0/32\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Plafoniera soggiorno (colore)\"\t\"0/0/33\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Plafoniera soggiorno brightness value Stato\"\t\"0/0/34\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Applique soggiorno brightness value Stato\"\t\"0/0/35\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce bagno grande (brightness value)\"\t\"0/0/36\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce bagno grande (brightness value) Stato\"\t\"0/0/37\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce bagno grande (dim)\"\t\"0/0/38\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Luce bagno grande (color)\"\t\"0/0/39\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Luce bagno grande (color) Stato\"\t\"0/0/40\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Applique soggiorno (color)\"\t\"0/0/41\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Applique soggiorno (color) Stato\"\t\"0/0/42\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Luce bagno grande scena cambio colori (ON/OFF)\"\t\"0/0/43\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luci piano terra\"\t\"0/1/-\"\t\"\"\t\"\"\t\"Luci piano terra\"\t\"\"\t\"Auto\"\n\"Luce corridoio e scala\"\t\"0/1/0\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce tavolo taverna\"\t\"0/1/1\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique taverna\"\t\"0/1/2\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce cameretta\"\t\"0/1/3\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce bagno piano terra\"\t\"0/1/4\"\t\"\"\t\"\"\t\"Bagno piano terra Luce\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce timer garage (ON)\"\t\"0/1/5\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luci marciapiedi giardino\"\t\"0/1/6\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Fari allarme giardino\"\t\"0/1/7\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Controsoffitto taverna (switch)\"\t\"0/1/8\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Controsoffitto taverna (dim)\"\t\"0/1/9\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Controsoffitto scena cambio colori taverna (ON/OFF)\"\t\"0/1/10\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"IR Luci taverna (ON/OFF)\"\t\"0/1/11\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"","KNXEthInterface":"Auto","KNXEthInterfaceManuallyInput":"","statusDisplayLastUpdate":true,"statusDisplayDeviceNameWhenALL":true,"statusDisplayDataPoint":false,"stopETSImportIfNoDatapoint":"stop","loglevel":"debug","name":"KNX Gateway 224.0.23.12","localEchoInTunneling":true,"delaybetweentelegrams":"50","delaybetweentelegramsfurtherdelayREAD":"1","ignoreTelegramsWithRepeatedFlag":false,"keyringFileXML":"","autoReconnect":"yes"},{"id":"31dd699c74532e18","type":"group","z":"3e6a6a12ba5593cb","name":"","style":{"fill":"#e3f3d3","label":true},"nodes":["7fe40a28.710acc","6be47a90.25445c","2f6d18b7.00ee1","904f53e5.a02f1"],"x":114,"y":319,"w":752,"h":82},{"id":"7fe40a28.710acc","type":"inject","z":"3e6a6a12ba5593cb","g":"31dd699c74532e18","name":"Flood!","props":[{"p":"payload"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"false","payloadType":"bool","x":210,"y":360,"wires":[["6be47a90.25445c"]]},{"id":"6be47a90.25445c","type":"function","z":"3e6a6a12ba5593cb","g":"31dd699c74532e18","name":"Send 300 telegrams at once","func":"for (var i = 0; i < 300; i++) { \n  node.send({payload:false});\n}","outputs":1,"noerr":0,"initialize":"","finalize":"","libs":[],"x":410,"y":360,"wires":[["904f53e5.a02f1"]]},{"id":"2f6d18b7.00ee1","type":"knxUltimate","z":"3e6a6a12ba5593cb","g":"31dd699c74532e18","server":"64df43b53180c04b","topic":"0/1/2","outputtopic":"","dpt":"1.001","initialread":false,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Entrance Light","outputtype":"write","outputRBE":false,"inputRBE":false,"formatmultiplyvalue":"1","formatnegativevalue":"leave","formatdecimalsvalue":"999","passthrough":"no","x":760,"y":360,"wires":[[]]},{"id":"904f53e5.a02f1","type":"delay","z":"3e6a6a12ba5593cb","g":"31dd699c74532e18","name":"Rate","pauseType":"rate","timeout":"5","timeoutUnits":"milliseconds","rate":"10","nbRateUnits":"1","rateUnits":"second","randomFirst":"1","randomLast":"5","randomUnits":"seconds","drop":false,"outputs":1,"x":610,"y":360,"wires":[["2f6d18b7.00ee1"]]}]
+
+```
+
+\
+
+
+## CIRCULAR REFERENCE PROTECTION
+
+Circular reference protection avoids your node-red UI to become unresponsive and your KNX installation to be flooded, by disabling two nodes with same Group Address link toghether.\
+For example, if you link the **output** pin of a node having Group Address 0/1/1, to the **input** ping of another node having the same Group Address 0/1/1, the protection will kicks in.\
+
+
+![](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/circularreferenceprotection.png)\
+
+
+**Copy this code and paste it into your flow**
+
+```javascript
+
+[{"id":"40a2def50bbedd29","type":"comment","z":"bde887538cf27686","name":"AVOID circular reference error by enabling the \"rbe\" output filter. Press Nuke!","info":"","x":350,"y":280,"wires":[]},{"id":"e3d2eae710199011","type":"comment","z":"bde887538cf27686","name":"TOTALLY DISABLE the circular reference protection by deleting the msg.knx.destination property.","info":"","x":410,"y":440,"wires":[]},{"id":"24a9630758a10955","type":"comment","z":"bde887538cf27686","name":"Circular reference in action. Press Nuke!","info":"","x":230,"y":120,"wires":[],"icon":"node-red/alert.svg"},{"id":"3080af98055a1e80","type":"group","z":"bde887538cf27686","name":"","style":{"fill":"#ffbfbf","label":true},"nodes":["98a01d3c5fef2aca","de469c89030c1b57","050e8dad9f27fb9d"],"x":74,"y":139,"w":592,"h":82},{"id":"98a01d3c5fef2aca","type":"knxUltimate","z":"bde887538cf27686","g":"3080af98055a1e80","server":"64df43b53180c04b","topic":"0/1/1","outputtopic":"","dpt":"1.001","initialread":0,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Table light","outputtype":"write","outputRBE":false,"inputRBE":false,"formatmultiplyvalue":1,"formatnegativevalue":"leave","formatdecimalsvalue":999,"passthrough":"no","x":320,"y":180,"wires":[["de469c89030c1b57"]]},{"id":"de469c89030c1b57","type":"knxUltimate","z":"bde887538cf27686","g":"3080af98055a1e80","server":"64df43b53180c04b","topic":"0/1/1","outputtopic":"","dpt":"1.001","initialread":0,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Table light","outputtype":"write","outputRBE":false,"inputRBE":false,"formatmultiplyvalue":1,"formatnegativevalue":"leave","formatdecimalsvalue":999,"passthrough":"no","x":580,"y":180,"wires":[[]]},{"id":"050e8dad9f27fb9d","type":"inject","z":"bde887538cf27686","g":"3080af98055a1e80","name":"Nuke!","props":[{"p":"payload"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"true","payloadType":"bool","x":170,"y":180,"wires":[["98a01d3c5fef2aca"]]},{"id":"64df43b53180c04b","type":"knxUltimate-config","host":"224.0.23.12","port":"3671","physAddr":"15.15.22","hostProtocol":"Multicast","suppressACKRequest":false,"csv":"\"Group name\"\t\"Address\"\t\"Central\"\t\"Unfiltered\"\t\"Description\"\t\"DatapointType\"\t\"Security\"\n\"Attuatori luci\"\t\"0/-/-\"\t\"\"\t\"\"\t\"\"\t\"\"\t\"Auto\"\n\"Luci primo piano\"\t\"0/0/-\"\t\"\"\t\"\"\t\"\"\t\"\"\t\"Auto\"\n\"Luce camera da letto\"\t\"0/0/1\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-8\"\t\"Auto\"\n\"Luce loggia camera da letto\"\t\"0/0/2\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce camera armadi\"\t\"0/0/3\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce bagno grande (switch)\"\t\"0/0/4\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce loggia bagno grande\"\t\"0/0/5\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio bagno grande (switch)\"\t\"0/0/6\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce lavanderia\"\t\"0/0/7\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio lavanderia (switch)\"\t\"0/0/8\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce studio\"\t\"0/0/9\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Plafoniera soggiorno (switch)\"\t\"0/0/10\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique soggiorno (switch)\"\t\"0/0/11\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce loggia soggiorno cucina\"\t\"0/0/12\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce cucina\"\t\"0/0/13\"\t\"\"\t\"\"\t\"\"\t\"DPT-1\"\t\"Auto\"\n\"Pensili cucina\"\t\"0/0/14\"\t\"\"\t\"\"\t\"\"\t\"DPT-1\"\t\"Auto\"\n\"Luce corridoio\"\t\"0/0/15\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"LED scala\"\t\"0/0/16\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique soggiorno brightness value\"\t\"0/0/17\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce specchio bagno grande(dim)\"\t\"0/0/18\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Plafoniera soggiorno brightness value\"\t\"0/0/19\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce specchio lavanderia (dim)\"\t\"0/0/20\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"LED cambiacolori RGB scala\"\t\"0/0/21\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio bagno grande brightness value\"\t\"0/0/22\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Plafoniera soggiorno (dim)\"\t\"0/0/23\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Applique soggiorno (dim)\"\t\"0/0/24\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Luce specchio lavanderia brightness value\"\t\"0/0/25\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Plafoniera soggiorno switch Stato\"\t\"0/0/26\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique soggiorno switch Stato\"\t\"0/0/27\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce camera armadi Stato\"\t\"0/0/28\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce bagno grande (switch) Stato\"\t\"0/0/29\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce specchio bagno grande Stato\"\t\"0/0/30\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce specchio lavanderia Stato\"\t\"0/0/31\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce lavanderia Stato\"\t\"0/0/32\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Plafoniera soggiorno (colore)\"\t\"0/0/33\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Plafoniera soggiorno brightness value Stato\"\t\"0/0/34\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Applique soggiorno brightness value Stato\"\t\"0/0/35\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce bagno grande (brightness value)\"\t\"0/0/36\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce bagno grande (brightness value) Stato\"\t\"0/0/37\"\t\"\"\t\"\"\t\"\"\t\"DPST-5-1\"\t\"Auto\"\n\"Luce bagno grande (dim)\"\t\"0/0/38\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Luce bagno grande (color)\"\t\"0/0/39\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Luce bagno grande (color) Stato\"\t\"0/0/40\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Applique soggiorno (color)\"\t\"0/0/41\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Applique soggiorno (color) Stato\"\t\"0/0/42\"\t\"\"\t\"\"\t\"\"\t\"DPST-232-600\"\t\"Auto\"\n\"Luce bagno grande scena cambio colori (ON/OFF)\"\t\"0/0/43\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luci piano terra\"\t\"0/1/-\"\t\"\"\t\"\"\t\"Luci piano terra\"\t\"\"\t\"Auto\"\n\"Luce corridoio e scala\"\t\"0/1/0\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce tavolo taverna\"\t\"0/1/1\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Applique taverna\"\t\"0/1/2\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce cameretta\"\t\"0/1/3\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce bagno piano terra\"\t\"0/1/4\"\t\"\"\t\"\"\t\"Bagno piano terra Luce\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luce timer garage (ON)\"\t\"0/1/5\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Luci marciapiedi giardino\"\t\"0/1/6\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Fari allarme giardino\"\t\"0/1/7\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Controsoffitto taverna (switch)\"\t\"0/1/8\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"Controsoffitto taverna (dim)\"\t\"0/1/9\"\t\"\"\t\"\"\t\"\"\t\"DPST-3-7\"\t\"Auto\"\n\"Controsoffitto scena cambio colori taverna (ON/OFF)\"\t\"0/1/10\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"\n\"IR Luci taverna (ON/OFF)\"\t\"0/1/11\"\t\"\"\t\"\"\t\"\"\t\"DPST-1-1\"\t\"Auto\"","KNXEthInterface":"Auto","KNXEthInterfaceManuallyInput":"","statusDisplayLastUpdate":true,"statusDisplayDeviceNameWhenALL":true,"statusDisplayDataPoint":false,"stopETSImportIfNoDatapoint":"stop","loglevel":"debug","name":"KNX Gateway 224.0.23.12","localEchoInTunneling":true,"delaybetweentelegrams":"50","delaybetweentelegramsfurtherdelayREAD":"1","ignoreTelegramsWithRepeatedFlag":false,"keyringFileXML":"","autoReconnect":"yes"},{"id":"6e422304896ccc5f","type":"group","z":"bde887538cf27686","name":"","style":{"fill":"#e3f3d3","label":true},"nodes":["0b9bab778f3b15f3","380b7b3249b49c1d","0d717072e99434ae"],"x":74,"y":299,"w":632,"h":82},{"id":"0b9bab778f3b15f3","type":"knxUltimate","z":"bde887538cf27686","g":"6e422304896ccc5f","server":"64df43b53180c04b","topic":"0/1/1","outputtopic":"","dpt":"1.001","initialread":0,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Table light","outputtype":"write","outputRBE":false,"inputRBE":false,"formatmultiplyvalue":1,"formatnegativevalue":"leave","formatdecimalsvalue":999,"passthrough":"no","x":320,"y":340,"wires":[["380b7b3249b49c1d"]]},{"id":"380b7b3249b49c1d","type":"knxUltimate","z":"bde887538cf27686","g":"6e422304896ccc5f","server":"64df43b53180c04b","topic":"0/1/1","outputtopic":"","dpt":"1.001","initialread":0,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Table light","outputtype":"write","outputRBE":true,"inputRBE":false,"formatmultiplyvalue":1,"formatnegativevalue":"leave","formatdecimalsvalue":999,"passthrough":"no","x":600,"y":340,"wires":[[]]},{"id":"0d717072e99434ae","type":"inject","z":"bde887538cf27686","g":"6e422304896ccc5f","name":"Nuke!","props":[{"p":"payload"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"true","payloadType":"bool","x":170,"y":340,"wires":[["0b9bab778f3b15f3"]]},{"id":"20ce8ce8686e8354","type":"group","z":"bde887538cf27686","name":"","style":{"fill":"#ffffbf","label":true},"nodes":["bcd4f654095901c0","b8fdb7228b50ab57","52f169de1714bb44","bf6565d5a68a8d9d"],"x":74,"y":459,"w":732,"h":82},{"id":"bcd4f654095901c0","type":"knxUltimate","z":"bde887538cf27686","g":"20ce8ce8686e8354","server":"64df43b53180c04b","topic":"0/1/2","outputtopic":"","dpt":"1.001","initialread":0,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Bed Led","outputtype":"write","outputRBE":false,"inputRBE":false,"formatmultiplyvalue":1,"formatnegativevalue":"leave","formatdecimalsvalue":999,"passthrough":"no","x":320,"y":500,"wires":[["bf6565d5a68a8d9d"]]},{"id":"b8fdb7228b50ab57","type":"knxUltimate","z":"bde887538cf27686","g":"20ce8ce8686e8354","server":"64df43b53180c04b","topic":"0/1/2","outputtopic":"","dpt":"1.001","initialread":0,"notifyreadrequest":false,"notifyresponse":false,"notifywrite":true,"notifyreadrequestalsorespondtobus":false,"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized":"0","listenallga":false,"name":"Bed Led","outputtype":"write","outputRBE":false,"inputRBE":false,"formatmultiplyvalue":1,"formatnegativevalue":"leave","formatdecimalsvalue":999,"passthrough":"no","x":720,"y":500,"wires":[[]]},{"id":"52f169de1714bb44","type":"inject","z":"bde887538cf27686","g":"20ce8ce8686e8354","name":"Nuke!","props":[{"p":"payload"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"true","payloadType":"bool","x":170,"y":500,"wires":[["bcd4f654095901c0"]]},{"id":"bf6565d5a68a8d9d","type":"change","z":"bde887538cf27686","g":"20ce8ce8686e8354","name":"","rules":[{"t":"delete","p":"knx.destination","pt":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":520,"y":500,"wires":[["b8fdb7228b50ab57"]]}]
+
+```
+
+\
+\
+\

package/docs/home/security.md

@@ -0,0 +1,34 @@
+---
+cover: >-
+  https://images.unsplash.com/photo-1493129922668-fcb1a8514643?crop=entropy&cs=srgb&fm=jpg&ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHw4fHxsb2NrfGVufDB8fHx8MTcyNDQwODE2Mnww&ixlib=rb-4.0.3&q=85
+coverY: 0
+---
+
+# Security Policy
+
+Home automation is not a joke. Please consider all dangers involving the use of this repository to control your home or building. A single light that remains ON while you're not at home, for example, **can become a serious danger of fire**.\
+All unattended devices put your building at risk.\
+Not to mention if, for your fault or for a BUG in the knx-ultimate repository, a garage doors closes while a child is sitting inbetween. The **building security** must be your primary concern.\
+Please use knx-ultimate (but it's generally the same for ALL repositories) only to control actuators that have been secured by other certified means.\
+For the example above, the garage door must be secured by a **CERTIFIED mechanical or electronical system**, preventing damages to people, animals or things. The developer of knx-ultimate repository and all developers involved in this project, are not responsible in any way for any damage, as stated in the MIT License you can find [here](../../LICENSE/).\
+
+
+## Home automation rules
+
+In my experience, i developed some **best practices** to secure my home from fire, damages and risks for third persons.\
+Some interesting things are below, for you. Hope you appreciate that.\
+
+
+* Install one or more main power switches, that cut off the power in your whole house while you're away, leaving powered only the minimal number of necessary devices (like refirgerator, alarm panel, internet router and so on). If you need some automation while youre away, you can temporarly switch on the main power switch and regain full access. This is worthful to avoid possible hacking of your home by someone having access, for example, to an improperly secured, always powered IOT device.
+* Install a redundant internet router using another wan line, for example an LTE connection. In case you lost one wan, you have another one to rely to.
+* Find a way to **enter** in your home, even in case of power outages (for example, a phisycal mechanichal key somewhere in the garden).
+* Find a way to **exit** your home, even in case of power outages (for example, a phisycal mechanichal key somewhere near your main door).
+* Find a way to **escape** from your home in case of bulgary or fire alarm (for example, by means of an extensible ladder from a balcony).
+* Use only professional and certified bulgary/fire security system and command it by KNX. Be aware, the KNX part of your security system, becomes a backdoor for possible problems. Never ever allow the KNX node to disarm your security system without a password. If you use a touchscreen, avoid **single button disarm** capability. Create buttons simulating a security panel **keypad** pression instead.
+* Install a **medical emergency** KNX pushbutton and put it, for example, near your bed. In case of emergency, automatically notify your family or someone that can help you, turn on all significant lights, create a **visible entrance pattern** for paramedics, unlock doors and the pathway to allow them to reach you even in case you become inconscious. Repeat an audio message to help **paramedics equipe**, using for example you Sonos speakers, stating **how to find you** in your home, **who parents to call**, what pre-existing **diseases** do you have. You can even use Alexa, Siri or Google Home to trigger this KNX pushbutton (see in the example section of the wiki), in case you've a stroke and you can't move.
+* Install a **panic** KNX pushbutton
+* Take this into consideration: never enter your home in case of someone forces and threats you to do that, expecially if your family is inside. Once you're inside, **the offender can do whatever he wants** and no one outside can care about you. Install a **panic** button somewhere near your external doors and garages.
+* If you've installed external perimeter sensors, light up hour home by means of at least 4 (one for each angle of your home) powerful LEDs projector as soon as someone enters the perimeter at dusk or night.
+* Do an announcement via alarm keypads as soon as someone opens a window, external door or blind, even if you're at home.
+
+## REMEMBER: YOU ARE THE ONLY RESPONSIBLE OF THE SECURITY OF YOUR PROPERTY. FOLLOW THE LAW, CONSIDER THIS KNX-ULTIMATE NODE ONLY AS AUTOMATION HELP, RELY ONLY ON CERTIFIED AND MECHANICALLY OR ELECTRONICALLY SECURED AUTOMATION DEVICES. THINK ABOUT YOUR SAFETY. THINK THAT SOMETHING CAN GO WRONG OR FAIL, SO HAVE A BACKUP AND, FOR HEALT AND SAFETY RISKS, HAVE DOUBLE SECURITY BACKUP. ONLY THEN, YOU CAN ENJOY YOUR LIFE WITH THE HELP AND FUN OF HOME AUTOMATION!

package/docs/hue-bridge-configuration/README.md

@@ -0,0 +1,25 @@
+# PHILIPS HUE NODES
+
+\
+
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/huehub.jpg" alt="" width="40%">
+
+</div>
+
+The HUE nodeset has been integrated to allow anyone to link KNX and HUE in a simpler manner as possible.
+
+The HUE nodeset is using the V2 clip API version.
+
+In this page, you can learn how to link the things toghether. First of all, you need to have a Bridge V2 (square bridge). Then you can add it to the HUE node. The process is very straightforward.
+
+Just set the Bridge's IP and click **CONNECT** button.
+
+| Property | Description                                     |
+| -------- | ----------------------------------------------- |
+| IP       | Put here the bridge's IP (the IP must be fixed) |
+| Name     | The bridge's name                               |
+
+![image.png](../../img/hude-config.png)