KNXeasy. KNXnet/IP made easy. Handbuch. KNXnet/IP - ASCII Protokoll Gateway

Transkript

1 KNXeasy KNXnet/IP - ASCII Protokoll Gateway KNXnet/IP made easy Handbuch

2 KNXeasy Handbuch - Dokumenthistorie Version Datum KNXeasy Manager Bemerkung Initialversion

3 Inhaltsverzeichnis Anwendung 4 Das KNXeasy Protokoll 5 ESF Daten aufbereiten 8 Konfiguration 10 Netzwerkparameter 10 Netzwerkschnittstelle 10 Weitere Einstellungen 11 KNXeasy Konfiguration 11 KNXeasy Gateway 12 ESF+ 13 KNXeasy to MySQL 13 System 15 KNXeasy Monitor 17 KNXeasy Funktion 19 KNXnet/IP zu KNXeasy 19 KNXeasy zu KNXnet/IP 19 Abfragen über KNXeasy 19 FAQ 21 Copyright 09/2007 b.a.b-technologie-gmbh Technische Änderungen vorbehalten 3 Dok. Rev. 04/2008

4 Anwendung Der KNXeasy wird über den LAN anschluss in das lokale Netzwerk eingebunden. Es übersetzt das binäre KNXnet/IP bidirektional in ein einfaches ASCII Protokoll. Intern wird eine Adress-Zustandstabelle geführt, die ein Abbild der EIB-Anlage darstellt. Ebenso können Daten zur späteren Auswertung in eine Datenbank gespeichert werden. Zum Konfigurieren des KNXeasy wird die Manager-Software benötigt. Spezifikationen Montage Hutschiene Abmessungen 8 TE Anschlüsse DC-IN (10-30 V), RJ-45(10 Mbit Ethernet) Nennstrom 70mA Max. Strom 180mA (Bootvorgang) 4 HANDBUCH KNXeasy

5 Das KNXeasy Protokoll Das KNXeasy Protokoll ist ein einfaches ISO kodiertes ASCII Protokoll. Kommandoaufbau Die einzelnen Parameter sind durch Leerzeichen getrennt und dürfen selbst keine Leerzeichen oder Tabs enthalten. A B D E F A: Ziel- / Quellbezeichner B: SystemID C: Kommando D: Gruppenadresse E: EIS-Typ F: Daten Ziel- / Quellbezeichner Bezeichnet das Ziel- oder Quellprotokoll. Wird ein Telegramm empfangen, so bezeichnet diese Angabe das Quellprotokoll, dessen Daten in das KNXeasy Protokoll übersetzt wurde. Wird ein Telegramm gesendet, so schickt der KNXeasy Daten in dem angegebenen Protokoll. Mögliche Werte: KNXnet/IP SystemID SystemID des KNXnet/IP Netzes. Über KNXnet/IP lassen sich Netze im Bereich von adressieren. Für andere Anwendungen sind Werte von denkbar. Kommando Die Aktion die ausgeführt werden soll oder ausgeführt wurde. Mögliche Werte: write Angegebenen Wert auf den Bus senden, bzw. Wert wurde auf dem Bus gesendet. read Wert einer Gruppenadresse abfragen. Wird anhand der internen Adresstabelle beantwortet. 5 Dok. Rev. 04/2008

6 status Antwort auf ein read Kommando. Besonderheit hier: nach der Gruppenadrese folgt eine Zeitangabe. Gruppenadresse Die Gruppenadresse kann entweder im zwei- oder dreistelligen Format angegeben werden. Dreistellig: Hautgruppe/Mittelgruppe/Untergruppe Zweistellig: Hauptgruppe/Untergruppe Anmerkung: Technisch werden die Gruppenadressen in einem 2-Byte Block gepackt. Dabei unterscheidet das hochwertigste Bit (a) die physikalische Adressierung von der Adressierung über Gruppenadressen. Die folgenden 4 Bit (b, Wertebereich 0-15) werden von der Hauptgruppe belegt. 3 Bit (c, Wertebereich 0-7) stehen für die Mittelgruppe zur Verfügung und 8 Bit (d, Wertebereich 0-255) für die Untergruppe. abbb bccc dddd dddd Im zweistelligen Format werden die Mittelgruppe und die Untergruppe zusammengefasst, sodass der Wertebereich von 0 bis 2047 reicht. Für die Hauptgruppe bleibt weiterhin die Beschränkung auf 0 bis 15. abbb bccc cccc cccc Für das einstellige Format werden die gesamten 2 Byte berücksichtigt (bis auf das hochwertigste Bit). Damit ergibt sich ein Wertebereich von Zeitangabe In der Antwort einer Statusabfrage wird eine Zeitangabe des letzten Telegramms gesendet. Format für die Zeitangabe: yyyy/mm/dd HH:MM:SS y = Jahr; m = Monat; d = Tag; H = Stunde; M = Minute; S = Sekunde EIS-Typ und Daten EIS_1 on off HANDBUCH KNXeasy

7 EIS_2 on off 1 0 brightenx dimx (X = Dimmstufe) EIS_3 EIS_4 EIS_5 EIS_6 x% EIS_7 EIS_8 EIS_9 Tag: Mon Tue Wed Thu Fri Sat Sun Oder Mo Di Mi Do Fr Sa So Uhrzeit: Stunde:Minute:Sekunde Tag.Monat.Jahr x.y (z.b. 15.3; 2 Byte Fließkomma) up down EIS_10u x = on off disabled enabled x.y (z.b. 15.3; 4 Byte Fließkomma) EIS_10s x = EIS_11u x = EIS_11s x = EIS_12 EIS_13 Nicht Unterstützt! a z A Z EIS_14u x = EIS_14s X = EIS_15 EIS_UNDEF abcdefghijklmn (max 14 Zeichen) Kommt vom EIB ein Telegramm für eine Adresse, die nicht in der ESF+ Datei konfiguriert ist, gibt der KNXeasy diese Daten als HEX-Werte aus. Dabei hat jedes Datenbyte den Prefix 0x: KNXnet/IP 0 write 2/257 EIS_UNDEF 0x19 0x29 Beispiele: KNXnet/IP 0 write 3/1/4 EIS_1 off KNXnet/IP 0 write 3/2/4 EIS_15 Essen fertig KNXnet/IP 0 read 1/1 KNXnet/IP 0 status 1/1 2008/04/09 10:18:00 EIS_ Dok. Rev. 04/2008

8 ESF Daten aufbereiten Da die KNXnet/IP Telegramme keine Informationen über die Nutzdaten beinhalten, braucht der KNXeasy eine Tabelle, in der die Gruppenadressen mit den EIS-Typen verknüpft sind. Anhand dieser Tabelle weiß der KNXeasy, in welches Format die Telegramme für eine bestimmte Gruppenadresse umgerechnet werden müssen. Diese Tabelle wird in einer ESF+ Datei gespeichert. Über die EIB Programmier-Software ETS kann ein Projekt per OPC Export in eine ESF Datei exportiert werden. Darin sind alle vergebenen Gruppenadressen enthalten. Diese Datei lässt sich mit dem Manager unter dem Menupunkt File > Import importieren. Zu der ausgewählten Datei muss eine System-ID zur eindeutigen Identifizierung einer EIB-Anlage vergeben werden. Mit der Auswahl Merge with kann die ausgewählte Datei mit einer schon geöffneten ESF-Datei zusammengefügt werden. Sollte in der ETS nachträglich etwas an dem Projekt ändern, kann man über diese Option die Änderungen in einer vorhandenen ESF+ Datei einpflegen. Nach einem Klick auf Finish öffnet sich ein Editor (Simple Address Manager) mit einer Baumstruktur des EIB-Projekts. Wichtig ist die Spalte EIS. Hier müssen zu den entsprechenden Gruppenadressen die EIS-Typen konfiguriert werden. Die Änderung kann entweder über die Auswahlbox durch einen Klick in das entsprechende Feld oder durch ein Rechtsklick auf ein oder mehrere markierte Zeilen durchgeführt werden. Sind alle Datenpunkte konfiguriert, so lässt sich über die Export Funktion die 8 HANDBUCH KNXeasy

9 benötigte ESF+ Datei erstellen. Zusätzlich zu dem Export der ESF+ Datei sollte eine.sam Datei gepeichert werden. Mit dieser Datei lassen sich auch nachträglich noch Änderungen einpflegen. 9 Dok. Rev. 04/2008

10 Konfiguration Der KNXeasy wird über den Manager konfiguriert. Über den Menupunkt Configuration > KNXeasy öffnet sich der Verbindungsdialog. Im Auslieferungszustand ist die IP-Adresse und der SSH-Port 22. Wurden alle notwendigen Änderungen vorgenommen, so kann die Konfiguration über den Speicher-Button in der rechten oberen Ecke des Konfigurationseditors gespeichert werden. Netzwerkparameter Um den KNXeasy in ein Netzwerk einzubinden, ist es nötig, die Netzwerkparameter an die vorhandene Netzwerk-Infrastruktur anzupassen. Hier werden folgende Parameter vergeben: Netzwerkschnittstelle DHCP IP-Adresse 10 HANDBUCH KNXeasy Über das Dynamic Host Configuration Protocol (DHCP) werden über einen DHCP Server automatisch die Netzwerkparameter vergeben. Befindet sich im Netzwerk kein DHCP Server, darf diese Option nicht angewählt werden. Wird diese Option aktiviert, so entfällt die Konfiguration der folgenden Netzwerkparameter. Die gewünschte IP-Adresse unter der das Gerät erreichbar sein soll. (Standard ) Netzmaske Die gewünschte Subnetzmaske. (Standard )

11 Gateway Das Gateway welches vom KNXeasy für zum Beispiel Broadcasts oder Datenbankverbindungen genutzt werden soll. Das Gateway muss mit der aktuellen IP- und Subnetzmasken Konfiguration erreichbar sein. DNS-Server Es können drei DNS Server angegeben werden. Diese werden genutzt, wenn zum Beispiel für die Datenbankkonfiguration ein Hostname angegeben wird. Weitere Einstellungen SSH Port Der Port des internen SSH-Servers. Dieser ist für Konfigurationsund Wartungszwecke vorgesehen. KNXeasy Konfiguration Die Konfiguration der KNXeasy Funktionalität passiert in dieser Maske. 11 Dok. Rev. 04/2008

12 KNXeasy Gateway Loglevel Das Loglevel beschreibt die interne Aufzeichnungstiefe von System-Events. Diese Option ist nur für Wartungs- und Fehleranalysezwecke vorgesehen. Netzwerk-Schnittstelle Broadcast Adresse Broadcast Port 12 HANDBUCH KNXeasy Die intern zu nutzende Netzwerkschnittstelle. Diese Option kann nicht geändert werden. An diese Broadcast oder Unicast Adresse werden die KNXeasy Telegramme per UDP gesendet. Wird die IP-Adresse oder Subnetzmaske des KNXeasy geändert, so muss ggf. auch die Broadcast-Adresse angepasst werden. Dieser UDP Port wird für das KNXeasy Protokoll sowohl für die Empfangs- als auch Senderichtung genutzt. (Standard 4950) KNX Welten Der KNXeasy kann mehrere KNX-Welten verwalten. Jeder dieser Welten unterscheidet sich anhand der SystemID im KNXeasy Protokoll, und der Multicast-Adresse und Port für das KNXnet/IP Protokoll. Zusätzlich kann für jede KNX-Welt die Physikalische Adresse für die KNXnet/IP Telegramme konfiguriert werden, mit der der KNXeasy versendet. ESF+ Über diesen Abschnitt lässt sich eine ESF+ Datei in den KNXeasy laden, aus dem KNXeasy löschen oder zur Überprüfung auf den lokalen PC speichern. KNXeasy to MySQL Der KNXeasy bietet die Möglichkeit, alle Telegramme in einer MySQL Datenbank zur späteren Analyse und Auswertung zu speichern. Dieser MySQL Server kann sich sowohl im lokalen Netzwerk als auch im Internet (Gateway und DNS Einstellungen beachten) befinden. In der Datenbank werden die Klartext Daten der Telegramme gespeichert, wie sie auch über das KNXeasy Protokoll gesendet und empfangen werden. Zusätzlich zu diesen Daten wird sowohl die Zeit des Datenbankservers als auch des KNXeasy zu jedem Datensatz gespeichert. MySQL Aktivieren

13 Hostname / IP Mit dieser Option lässt sich die MySQL Schnittstelle aktivieren oder deaktivieren. Ist die Datenbank für einen längeren Zeitraum nicht vorhanden, so empfiehlt es sicht, diese Option zu deaktivieren. Die IP-Adresse oder Hostname des MySQL Servers. Wird ein Hostname eingegeben, so muss der konfigurierte DNS-Server unter Netzwerk Parameter erreichbar sein. Database Benutzer Passwort Tabelle Der Name der Datenbank innerhalb des MySQL Servers. Der Benutzername für den Zugriff auf die Datenbank. Das Passwort für den angegebenen Benutzer. Der Name der Tabelle zur Speicherung der KNXeasy Daten. Die Create-Anweisung für eine Tabelle knxeasy in der Datenbank babtec : CREATE TABLE `babtec`.`knxeasy` ( ìd` int(11) NOT NULL auto_increment, `source_protocol` varchar(20) NOT NULL, `sernr` varchar(12) NOT NULL, `timestamp` varchar(50) NOT NULL, `source` varchar(10) default NULL, `dest` varchar(10) default NULL, èistype` varchar(10) default NULL, `data` varchar(50) default NULL, `sysid` varchar(10) default NULL, `pid` varchar(10) NOT NULL, `db_time` timestamp NOT NULL default CURRENT_TIMESTAMP, PRIMARY KEY (ìd`) ) ENGINE=MyISAM AUTO_INCREMENT=865 DEFAULT CHARSET=latin1; 13 Dok. Rev. 04/2008

14 Die Tabelle kann zum Beispiel über den MySQL Client oder phpmyadmin erstellt werden hat folgenden Aufbau: id source_protocol sernr timestamp source dest eistype data sysid pid db_time int(11) NOT NULL auto_increment Primärschlüssel, eindeutige ID des Datensatzes varchar(20) NOT NULL Quellprotokoll. KNXnet/IP KNXeasy varchar(12) NOT NULL Die Seriennummer des KNXeasy varchar(50) NOT NULL Interne KNXeasy Zeit varchar(10) default NULL Physikalische Quelladresse varchar(10) default NULL Ziel-Gruppenadresse varchar(10) default NULL EIS-Typ: EIS_UNDEF EIS_1 EIS_2 varchar(50) default NULL Die umgerechneten Klartextdaten varchar(10) default NULL Verwendete SystemID varchar(10) NOT NULL Interne ProzessID des KNXeasy für Wartungszwecke timestamp NOT NULL default CURRENT_TIMESTAMP Die Zeit des Datenbankrechners 14 HANDBUCH KNXeasy

15 System Über die Systeminformationen lässt sich die Systemzeit verändern. Diese ist notwendig, um für die interne Adresszustandstabelle, sowie die Datenbankverbindung die korrekten Zeitstempel mitführen zu können. Über die Aktualisieren -Funktion wird die Zeit aus dem KNXeasy ausgelesen. In dem Textfeld kann eine manuell eine neue Zeit eingetragen, oder per Lokale Zeit die Systemzeit des Clientrechners übernommen werden. Wird die Zeit übermittelt, so übernimmt der KNXeasy diese umgehend. Über den Abschnitt System-Funktionen kann in dem KNXeasy ein Warm- oder Kaltstart ausgeführt werden. Per Warmstart wird nur der interne Software- Prozess neu gestartet, bei einem Kaltstart erfolgt ein kompletter Reboot des Gerätes. Stehen neue Firmware-Versionen bereit, so lässt sich der KNXeasy über die Firmware-Update Funktion auf den neusten Softwarestand bringen. 15 Dok. Rev. 04/2008

16 KNXeasy Monitor In dem Manager gibt es den KNXeasy Monitor. Darüber lassen sich aktuelle Telegramme aufzeichnen, Telegramme senden und Statusabfragen ausführen. Über den Menupunkt Window > Show View > Monitor > KNXeasy Monitor lässt sich das entsprechende Fenster öffnen. Um über den KNXeasy Monitor Telegramme senden zu können, muss eine UDP Broadcast oder Unicast Adresse angegeben werden. Mit der voreingestellten Adresse wird in alle erreichbaren Netze verschickt. Somit sollte jeder KNXeasy diese Pakete mitbekommen, wenn kein Router zwischen dem PC und dem KNXeasy UDP Pakete blockt. Der KNXeasy versendet und empfängt Telegramme über das KNXeasy Protokoll über den Port Mit der Funktion Aktivieren wird die Aufzeichnung gestartet. In dem Aufzeichnungsfenster werden die Daten des KNXeasy Protokolls ausgegeben. Jedes Telegramm wird mit der lokalen PC-Zeit ausgegeben. Diese ausgegebene Zeit gehört nicht zum KNXeasy Protokoll. Über die Kommandoeingabe können Telegramme versendet werden. Die Daten 16 HANDBUCH KNXeasy

17 können entweder manuell eingegeben, oder über die Eingabemaske generiert werden. 17 Dok. Rev. 04/2008

18 KNXeasy Funktion Der KNXeasy übersetzt bidirektional das KNXnet/IP und KNXeasy Protokoll. KNXnet/IP zu KNXeasy Empfängt der KNXeasy ein Telegramm per KNXnet/IP, wird in den ESF+ Daten nach der Gruppenadresse gesucht. Anhand des Konfigurierten EIS-Typ werden die Nutzdaten umgerechnet. Ebenso wird die Gruppenadresse in die zwei oder dreistellige Darstellung umgerechnet. Die Daten werden im KNXeasy Format als write -Kommando an die konfigurierte UDP Broadcast oder Unicast Adresse gesendet. Die Clients wissen somit, dass entweder auf dem EIB oder durch einen anderen Client ein Telegramm ausgelöst wurde. Ebenso wird dieses KNXeasy Telegramm in die interne Adresszustandstabelle und die MySQL Datenbank (falls vorhanden) geschrieben. KNXeasy zu KNXnet/IP Wird von einem Client aus ein KNXeasy Telegramm (write) geschickt, so wird es zunächst auf Konformität zu dem KNXeasy Protokoll überprüft. Ist es per Unicast an die IP-Adresse des KNXeasy gesendet worden, so wird es für alle anderen Clients an die konfigurierte UDP Broadcast Adresse gesendet. Ebenso wird es in die Adresszustandstabelle und in die Datenbank eingetragen. Anhand des angegebenen EIS-Typ wird der Wert umgerechnet und per KNXnet/IP an die angegebene EIB-Welt, die durch die SystemID identifiziert wird, gesendet. Abfragen über KNXeasy Statusabfragen (read) können nur anhand der internen Adresszustandstabelle beantwortet werden. Wird der KNXeasy frisch mit einer vorhandene EIB-Anlage verbunden, so dauert es eine Weile bis alle Adressen ein mal gesendet und somit eingepflegt wurden. Die Antwort auf eine Statusabfrage (status) wird per UDP Unicast nur an den Client gesendet, der diese Adresse abgefragt hat. 18 HANDBUCH KNXeasy

19 FAQ F: Wie finde ich den KNXeasy, wenn ich die IP-Adresse nicht mehr kenne? A: In dem Manager gibt es unter Window > Show View > Other > Device Overview eine Möglichkeit den KNXeasy zu finden. Bedingung dafür ist, dass er sich im gleichen Netzwerk befindet, oder alle Router zwischen dem PC und dem KNXeasy den Multicast Port 1735 für die Multicast- Adresse weiterleiten. In der Spalte Adresse steht der Hostname bzw. die IP-Adresse des Gerätes. F: Ich sehe keine Daten in dem KNXeasy Monitor? A: Überprüfen Sie ob in der KNXeasy Konfiguration die Broadcast Adresse richtig eingestellt ist. Wenn Sie eine Broadcastadresse ausserhalb des eingestellten Subnetzes eingestellt haben, muss das Gateway entsprechend konfiguriert und erreichbar sein. Ebenso muss das Gateway UDP Pakete über den Port 1735 weiterleiten. F: Warum werden meine KNXeasy Kommandos nicht auf den EIB gesendet? A: Überprüfen Sie, ob der KNXeasy über die angegebene Broadcastadresse erreichbar ist. Überprüfen Sie auch die Filterregeln in Ihren KNXnet/IP Gateways. 19 Dok. Rev. 04/2008

20 b.a.b-technologie gmbh Heinrich-Hertz-Straße Unna Tel Fax info@bab-tec.de Internet: