=================

*** The adapter is only compatible with Node 4.x and higher!! ***

en: This adapter allows importing of knxproj Files from ETS. It generates the translation between KNX- groupaddresses and ioBroker and put the devices into rooms (esp. for MobileUI).

It connects to standard KNX/LAN Gateways.

Befor beginning: Every DPT of com.Objects should be set in your ETS project. Every device should be sortet into your facility structure.

After installing this adapter, open the adapter configuration. Fill in:

<IP of your KNX/Lan GW> with ipv4 format

this is normally port 3671

fill in free phys. address corresponding to your KNX-architecture

here you can upload your ETS Export in "knxproj" format.

After successful import a message shows how much objects where recognized.

Hit "save & close" and the adapter should start. While starting the adapter reads all groupAdresses with read-Flag. This could take a while and can produce a high load on your KNX-bus. But the values in your visare updatet after start.

Here is under knx.0 the group adress tree like in your ETS project.

If you have a Buildingstructure in your ETS with the corresponding devices, it will be shown here. Under "members" are the names of groupaddresses listet from the devices with send-Flag in this Group.

#Usage If the adapter startet successfully your datapoints will be available for everything you like to do. Try out "mobileUI".

At the moment are DPT1 - DPT20 with subtypes and DPT238 available. But not all are validated.

• many Datapointtypes are missing ( takes time to implement )
• does not work with babtec (means it does not work with babtec as KNX/LAN gateway)

Dabei werden den Gruppenaddressreferenz (im folgenden GAR) ID's der jeweilige DPT der KOR zugeordnet, wenn er vorhanden ist. Ausserdem bekommt der erste Eintrag die Attribute write=yes und read=no. Alle darauf folgenden GAR ID's bekommen nur den DPT zugeordnet

Hier wird die GAS anhand der GAR ID's erzeugt und ebenfalls die DPT's zugeordnet, falls dies unter 1) noch nicht geschehen ist.

In dem ETS Export sind die Schalt- und Statusadressen nicht hinterlegt. Somit führe ich eine Ähnlichkeitsprüfung aller Gruppenadressnamen durch mit der Auswertung auf status und state. Wird ein Pärchen gefunden, dessen Ähnlichkeit mehr als 70% beträgt, dann wird angenommen, das die GA1 die Schaltadresse und GA2 die Statusadresse ist. Dabei erhält GA1 das write=true und read=false und GA2 das write=false und read=true. Ausserdem werden die DPT abgeglichen aus der jeweilig korrespondierenden GA. Aus diesem Grund ist es schwierig, Pärchen zu finden, wenn die Gruppenadressbeschriftungen nicht konsistent sind.

Ein DPP wird erzeugt, wenn die GA, GAR und der DPT valid sind. Mit diesen DPP arbeitet der Adapter. Fehlen also die DPT's in einer GA, weil sie auf keiner der o. A. Wege gefunden werden konnte, so wird für diese GA kein DPP erzeugt und ist im Weiteren nicht nutzbar.

Im Idealfall werden somit für einen Schaltkanal 2 DPP erzeugt. Das erste ist das Schalten. In diesem ist die GAR ID des Status DPP hinterlegt. Das zweite ist dann das Status DPP ohne weitere Refenrenz.

Alle mit dem Lesen-Flag markieren DPP werden beim Start abgefragt. Dies verursacht u.U. eine höhere Buslast und dauert einen Moment. Im Anschluss sind aber alle aktuellen Werte verfügbar.

1. saubere ETS Programmierung und saubere ETS Programmierung und saubere ETS Programmierung

• zuweisen der DPT's !!
• einheitliche Beschriftung der GA-Namen (z.B "EG Wohnen Decke Licht schalten" und "EG Wohnen Decke Licht schalten status" )
• Vermeidung von Sonderzeichen (kann zu Problemen bei der Erzeugung der GAS führen)

2. Prüfen ob das KNX/LAN GW erreichbar ist. Wenn es das nicht ist, versucht der Adapter sich kontinuierlich zu verbinden.

3. Physikalische Adresse richtig wählen ( wichtig beim Einsatz von Linienkopplern )

4. Der Port der LAN Schnittstelle ist i.d.R. 3671

• added act channel update of corresponding state
• fix bug in state-vis update
• optimized knxproj upload

• implemented device-config parsing from knxproj
• better choice of state/val of DP objects

• fixed DPT1 switch problem

• (chefkoch009) more DPT's are supported
• faster Startup
• implemented generation of room list with device dependicies

• (chefkoch009) added necessary dependicies

• (chefkoch009) Support standard KNX/LAN Gateways.

• (chefkoch009) Support of project export

• (chefkoch009) redesign

(vegetto) include vis widget

• (bluefox) fix errors with grunt

• (bluefox) initial release

The CC-NC-BY License (CC-NC-BY)

Copyright (c) 2016 K.Ringmann [email protected]

THE WORK IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.

BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.

Read full license text in LICENSE