====== KNXd  ======


Version History...

[[https://github.com/Woersty/LoxBerry-Plugin-KNXd/commits/master|Änderungshistorie]]


\\


----

===== Aufgabe des Plugins =====

  * Das KNXd Plugin von [[https://loxwiki.atlassian.net/wiki/people/6166fe40d9820f00703083d9?ref=confluence|Christian Wörstenfeld]] bietet die Möglichkeit, über ein KNX-IP-Gateway direkt mit dem KNX/EIB-Bus zu kommunizieren.\\
Als Gateway kann hierbei auch der Miniserver dienen.
  * Weiterhin bietet das Plugin die Möglichkeit, jede Minute die aktuelle LoxBerry Systemzeit auf den Bus zu senden.
  * Ein weiteres Leistungsmerkmal des Plugins ist, dass es eine Liste von Gruppenadressen sequentiell (mit 250 ms Pause) abfragen kann.\\
Die Abfrage erfolgt über einen Aufruf der Plugin-Webseite mit dem Parameter [[http://dein-loxberry/plugins/knxd/?mode=gad_query|''%%http://dein-loxberry/plugins/knxd/?mode=gad_query%%'']]\\
Die ermöglicht den Aufruf über einen simplen Trigger via 'Virtueller Ausgang' z.B. nach einem Loxone Miniserver Neustart.

===== Konfigurationsoptionen =====

{{plugins:knxd:1269957970.png?h=400}}

Wenn man im ETS Monitor sehen möchte, dass die Pakete vom KNXd Plugin kommen, kann man mit der Option ''%%--client-addrs=1.1.251:1%%'' die Quelladresse der Pakete festlegen:

{{plugins:knxd:1269957972.png?h=142}}

Dann noch das Gerät mit dieser Adresse anlegen und entspreched benennen:

Das Gerät an 1.1.250 stellt bei mir die Kommunikation her, die Pakete vom LoxBerry KNXd werden von 1.1.251 gesendet.

{{plugins:knxd:1269957971.png?h=109}}

  * ''%%KNXD_OPTS%%''''%%=%%''Diese Option enthält die Kommandozeilenparameter für den KNXd-Daemon. //Standardwert: ''%%-b ipt:KNXGW.woersty.com --eibaddr=1.1.250 --client-addrs=1.1.251:1%%''\\
''%%KNXGW.woersty.com ist durch die IP Adresse oder den Namen des KNX/EIB IP Interfaces zu ersetzen!%%''\\
//
  * ''%%KNXD_GAD_DAT_TIM_USE_CB=%%''Diese Option legt fest, ob das Plugin minütlich das Datum und die Zeit auf den Bus sendet. //Mögliche Werte:// ''%%1, 0%%''
  * ''%%KNXD_GAD_DAT=%%''Diese Option enthält die KNX Gruppenadresse für das Datum im Format ''%%15/7/255%%'' 
  * ''%%KNXD_GAD_TIM=%%''Diese Option enthält die KNX Gruppenadresse für die Uhrzeit im Format ''%%15/7/255%%''
  * ''%%KNXD_GAD_QUERY_USE_CB=%%''Diese Option legt fest, ob das Plugin beim Aufruf von''%% ?mode=gad_query%%'' die Gruppenadressen aus der Liste abfragen soll. //Mögliche Werte:// 1''%%, 0%%''
  * ''%%KNXD_GAD_QUERY=%%''Diese Option enthält die KNX Gruppenadressenliste im Format ''%%1/1/1~2/2/2~3/4/5%%''
  * //Diese Optionen werden automatisch vom Webinterface gesetzt.//

===== Download =====

  * Das Plugin wurde auf LoxBerry 1.x umgestellt. Die alte Version für LoxBerry 0.2.x ist hier erhältlich: [[https://github.com/Woersty/LoxBerry-Plugin-KNXd/archive/v1.7.zip|v1.7]] 
  * Ab Version v2018.3.12 funktioniert das Plugin nur noch am LoxBerry 1.0.3 oder neuer. Download [[https://github.com/Woersty/LoxBerry-Plugin-KNXd/archive/v2018.3.12.zip|hier]] und bietet eine Auto-Update Funktion.
  * Ab Version 2020.3.2 lässt sich das Plugin nur noch am LoxBerry 1.5.0 oder neuer installieren. Download [[https://github.com/Woersty/LoxBerry-Plugin-KNXd/archive/2020.3.2.zip|hier]] oder per Auto-Update Funktion.
  * Der Sourcecode ist auf GitHub verfügbar: https://github.com/Woersty/LoxBerry-Plugin-KNXd/

===== Installation =====

<HTML><ul></HTML>
<HTML><li></HTML><HTML><p></HTML>Das Plugin wird über die LoxBerry-Pluginverwaltung installiert: ''%%https://github.com/Woersty/LoxBerry-Plugin-KNXd/archive/2021.04.18.zip%%''<HTML></p></HTML>

<HTML><p></HTML>Der Installationsfortschritt kann über den Button **Anzeigen** im Logging Bereich auf der Plugin-Adminseite verfolgt werden.<HTML></p></HTML>

<HTML></li></HTML><HTML></ul></HTML>

===== Funktion des Plugins =====

Das Plugin benutzt den [[https://github.com/knxd/knxd|KNXd]] um dem LoxBerry den Zugriff auf den KNX Bus zu ermöglichen.

Außerdem verwendet es das angepasste [[http://www.hoerndlein.de/cms/index.php/eib|eibtime.pl Script von Thomas Hoerndlein]]

Eine weitere Funktion ist die sequentielle Abfrage von einer KNX-Gruppenadressen-Liste, gestartet durch einen beliebigen Trigger über einen //[[http://www.loxone.com/dede/service/dokumentation/loxone-config/peripherie/virtuelle-e-a.html#VO|Virtuellen Ausgang]]// 

<HTML><ul></HTML>
<HTML><li></HTML><HTML><ul></HTML>
<HTML><li></HTML>Bis Version 2020.3.2 kann nur **''%%http://%%''''%%KNXd:loxberry@%%''''%%<loxberry-hostname-oder-IP-Adresse:Port>/plugins/knxd/?mode=gad_query%%''** aufgerufen werden<HTML></li></HTML>
<HTML><li></HTML>Ab Version 2020.3.2 kann der Aufruf auch via **''%%http://<loxberry-hostname-oder-IP-Adresse:Port>/plugins/knxd/?mode=gad_query%%''''%%&user=KNXd&pass=loxberry%%''''%% %%''**erfolgen<HTML></li></HTML>
<HTML><li></HTML>Der LoxBerry fragt dann alle 250 ms eine Gruppenadresse ab. Der Miniserver erhält dann ggf. die Antwort auf dem Bus, falls ein Gerät antwortet..\\

<HTML><ol></HTML>
<HTML><li></HTML>Die Gruppen-Adressen müssen das 3-stellige Format haben: **''%%xx/x/xxx%%''**.<HTML></li></HTML><HTML></ol></HTML>
<HTML></li></HTML><HTML></ul></HTML>
<HTML></li></HTML><HTML></ul></HTML>

===== Status des KNXd =====

Der KNXd Status wird auf der Plugin-Admin-Seite dargestellt.

{{plugins:knxd:1209205544.jpg?h=78}}

Die Aktualisierung erfolgt alle 10 Sekunden.

Es gibt 4 Zustände:

  - ''%%Grau%%'' - Status unbekannt
  - ''%%Gelb%%'' - KNXd Control Server läuft aber, KNXd Status gestoppt 
  - ''%%Rot %%'' - KNXd Control Server nicht erreichbar, KNXd Status nicht prüfbar
  - ''%%Grün%%'' - KNXd und Control Server laufen - alles ok!

===== Fehler melden / Fehlersuche / Troubleshooting =====

Ab Version 1.7 kann zu Testzwecken mit dieser Adresse 10 Sekunden auf dem Bus mitgelesen werden:

<HTML><ul></HTML>
<HTML><li></HTML><HTML><ul></HTML>
<HTML><li></HTML>**''%%http://<loxberry-hostname-oder-IP-Adresse:Port>/plugins/knxd/?mode=read_bus%%''**<HTML></li></HTML><HTML></ul></HTML>
<HTML></li></HTML><HTML></ul></HTML>

Das Plugin hat eine Logdatei. 


Fehlerberichte bitte direkt im [[https://github.com/Woersty/LoxBerry-Plugin-KNXd/issues|Repository auf GitHub]] melden.


\\


Das Plugin überträgt die Authentifizierungsdaten in leserlicher Form im Netzwerk. Wer Zugriff auf das Netzwerk hat, könnte die Daten möglicherweise mitlesen.


\\


Der Miniserver lässt immer nur eine Verbindung zum KNX Gateway zu. Greift KNXd bereits auf dieses zu kann der EIB nicht mehr per ETS über den Miniserver programmiert werden!


\\


Ab Version v2018.3.12 kann der KNXd im [[https://github.com/Woersty/LoxBerry-Plugin-RPi-Monitor|RPi-Monitor]] überwacht werden. Das RPi-Monitor Plugin muß aber mindestens Version v2018.3.12 haben.


\\