Ethernet Binär. Protokoll

Transkript

1 Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Pro tokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Pro tokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Pro tokoll Protokoll Pro tokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Pro tokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Pro tokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Pro tokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protkoll Protokoll Protokoll Protok oll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Pro tokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Protokoll Ethernet Binär PSG Plastic Service GmbH Pirnaer Str Mannheim Deutschland Tel Fax info@psg-online.de 10/2013

2

3 PSG Plastic Service GmbH 1 Protokoll Ethernet Binär PCU/MCU Inhaltsverzeichnis 1 Darstellungskonventionen Verwendete Datentypen Allgemeine Spezifikation Adressberechnung Für Zonen Für Systemparameter Dateninhalt des TCP/IP Telegramms Telegrammstruktur bei den Befehlen 0x0000, 0x0001, 0x0003, 0x0004, 0x000D, 0x000E Telegrammstruktur bei den Befehlen 0x000A Berechnung der Prüfsumme Befehl 0x0000 Verbindung herstellen Befehl 0x0001 Softwareversion auslesen Befehl 0x0003 Lese Bytes Befehl 0x0004 Schreibe Bytes Befehl 0x000D Lese Bytes von mehreren Zonen Befehl 0x000E Schreibe Bytes von mehreren Zonen Befehl 0x000A CAN-Befehl senden Anhang Versionshistorie... 14

4 2 Kapitel 1 Darstellungskonventionen 1 Darstellungskonventionen In diesem Handbuch finden sich Symbole und Konventionen, die Ihnen zur schnelleren Orientierung dienen. Achtung Hinweis Beispiel Verweis FAQ Gleichungen Mit diesem Symbol werden Hinweise und Informationen angezeigt, die entscheidend für den Betrieb des Gerätes sind. Bei Nichtbefolgen oder ungenauem Befolgen kann es zu Schäden am Gerät oder zu Personenschäden kommen. Das Symbol weist auf zusätzliche Informationen und Erklärungen hin, die zum besseren Verständnis dienen. Bei dem Symbol wird eine Funktion anhand eines Beispiels erläutert. Bei diesem Symbol wird auf Informationen in einem anderen Dokument verwiesen. Hier werden FAQ (frequently asked questions) beantwortet. Berechnungsvorschriften und Berechnungsbeispiele werden so dargestellt. 1.1 Verwendete Datentypen Größe (Bit) Bezeichnung 8 Byte 16 Word 32 Long

5 PSG Plastic Service GmbH 3 Protokoll Ethernet Binär PCU/MCU 2 Allgemeine Spezifikation Das Ethernet Binär Protokoll basiert auf einer TCP/IP Verbindung. Zunächst wird eine Socketverbindung zur IP-Adresse der PCU/MCU auf den Port 5000 hergestellt. Danach muss über den Befehl CMD_CONNECT (siehe Kapitel 2.4) die Verbindung aktiviert werden. Anschließend können alle beschriebenen Befehle ausgeführt werden. 2.1 Adressberechnung Die in den Befehlen anzugebenden Adressen sind grundsätzlich Absolutadressen. Der Offset innerhalb der Regelzonen kann der Dokumentation zu Regler spezifischen Parameter- und Objektlisten für Protokoll PSGII entnommen werden Für Zonen Sollen Daten von Regelzonen gelesen werden, so berechnen sich die Absolutadressen folgendermaßen: Absolutadresse = 0xC Regelzone( ) * 0x800 + Offset; Für Systemparameter Sollen Daten von Systemparametern gelesen werden, so berechnen sich die Absolutadressen folgendermaßen: Absolutadresse = 0xA Offset;

6 4 Kapitel 2 Allgemeine Spezifikation 2.2 Dateninhalt des TCP/IP Telegramms Telegrammstruktur bei den Befehlen 0x0000, 0x0001, 0x0003, 0x0004, 0x000D, 0x000E typedef struct { word HEAD // Telegrammkennung // Bei Anfrage an PCU/MCU: 0xA5EF byte RESERVE // Immer auf 0 setzen word BEFEHL // Befehl byte RESERVE // Immer auf 0 setzen long ADDRESS // Zugriffsadresse byte RESERVE // Immer auf 0 setzen word LEN // Befehlslänge // Anzahl Datenbytes in BUFF Byte Prüfsumme word ANZ // Anzahl zu lesender / schreibender Daten // (pro Zone bei Zonenbefehlen) byte BUFF[1020] // Datenbytes + 1 Byte Prüfsumme nach letzten Daten } tx; Im TCP/IP Telegramm wird folgende Datenstruktur von der PCU/MCU gesendet (Antwort): typedef struct { word HEAD // Telegrammkennung // Antwort von PCU/MCU: 0x4143 byte RESERVE // Immer auf 0 setzen word STATUS // Status der Antwort byte RESERVE // Immer auf 0 setzen long ADDRESS // Zugriffsadresse byte RESERVE // Immer auf 0 setzen word LEN // Befehlslänge // Anzahl Datenbytes in BUFF Byte Prüfsumme word ANZ // Anzahl Nutzdaten gesamt byte BUFF[1020] // Datenbytes + 1 Byte Prüfsumme nach letzten Daten } rx;

7 PSG Plastic Service GmbH 5 Protokoll Ethernet Binär PCU/MCU Telegrammstruktur bei den Befehlen 0x000A typedef struct { word HEAD // Telegrammkennung // Bei Anfrage an PCU/MCU: 0xA5FE byte RESERVE // Immer auf 0 setzen word BEFEHL // Befehl byte LEN // Befehlslänge // Anzahl Datenbytes in BUFF Byte Prüfsumme word TXNode // Sende-ID word RXNode // Empfangs-ID byte ANZ // Anzahl Datenbytes byte BUFF[1024] // CAN-Telegramm + BCC } tx_can; Im TCP/IP Telegramm wird folgende Datenstruktur von der PCU/MCU gesendet (Antwort): typedef struct { word HEAD // Telegrammkennung // Antwort von PCU/MCU: 0x4142 byte RESERVE // Immer auf 0 setzen word STATUS // Status der Antwort byte LEN // Befehlslänge // Anzahl Datenbytes in BUFF Byte Prüfsumme word TXNode // Sende-Node-ID word RXNode // Empfangs-Node-ID byte ANZ // Anzahl Datenbytes byte BUFF[1024] // CAN-Telegramm + BCC } rx_can;

8 6 Kapitel 2 Allgemeine Spezifikation 2.3 Berechnung der Prüfsumme Die Prüfsumme wird folgendermaßen berechnet: // Pruefsumme berechnen byte ps=0; byte* Ptr; // Pointer auf Send-/Empfangsstruktur setzen Ptr = &tx; for (cnt=0; cnt< tx.len-1; cnt++) { ps += Ptr[cnt]; } // Pruefsumme in Sendestring eintragen Ptr[tx.LEN-1] = 0-ps;

9 PSG Plastic Service GmbH 7 Protokoll Ethernet Binär PCU/MCU 2.4 Befehl 0x0000 Verbindung herstellen Anfrage an PCU/MCU tx.head = 0xA5EF; Telegrammkennung tx.befehl = 0x0000; Befehl tx.address = 0x5555AAAA; Zugriffsadresse tx.len = 0x0010; Befehlslänge tx.anz = 0x0000; Anzahl zu lesender / schreibender Daten tx.buff[0] = 0x5B; Datenbytes + 1 Byte Prüfsumme nach letzten Daten Antwort von PCU/MCU rx.head = 0x4143; rx.status = 0x0000; rx.address = 0; rx.len = 19; rx.anz = 3; rx.buff[0] = OK ; rx.buff[3] = Prüfsumme;

10 8 Kapitel 2 Allgemeine Spezifikation 2.5 Befehl 0x0001 Softwareversion auslesen Anfrage an PCU/MCU tx.head = 0xA5EF; Telegrammkennung tx.befehl = 0x0001; Befehl tx.address = 0x ; Zugriffsadresse tx.len = 0x0010; Befehlslänge tx.anz = 0x0000; Anzahl zu lesender / schreibender Daten tx.buff[0] = 0x5A; Datenbytes + 1 Byte Prüfsumme nach letzten Daten Antwort von PCU/MCU rx.head = 0x4143; rx.status = 0x0000; rx.len = 29; rx.anz = 13; rx.buff[0] = Versionsnummer; rx.buff[13] = Prüfsumme;

11 PSG Plastic Service GmbH 9 Protokoll Ethernet Binär PCU/MCU 2.6 Befehl 0x0003 Lese Bytes Anfrage an PCU/MCU tx.head = 0xA5EF; tx.befehl = 0x0003; tx.address = Adresse von der gelesen wird; tx.len = 16; tx.anz = Anzahl zu lesender Bytes; tx.buff[0] = Prüfsumme; Antwort von PCU/MCU rx.head = 0x4143; rx.status = 0x0000; rx.address = 0; rx.len = 16 + Anzahl gelesener Bytes; rx.anz = Anzahl gelesener Bytes; rx.buff[0] = Daten; rx.buff[anzahl gelesener Bytes] = Prüfsumme;

12 10 Kapitel 2 Allgemeine Spezifikation 2.7 Befehl 0x0004 Schreibe Bytes Anfrage an PCU/MCU tx.head = 0xA5EF; tx.befehl = 0x0004; tx.address = Adresse, auf die geschrieben wird; tx.len = 16 + Anzahl zu schreibender Bytes; tx.anz = Anzahl zu schreibender Bytes; tx.buff[0] = Daten; tx.buff[anzah l zu schreibender Bytes] = Prüfsumme; Antwort von PCU/MCU rx.head = 0x4143; rx.status = 0x0000; rx.address = 0; rx.len = 19; rx.anz = 3; rx.buff[0] = OK ; rx.buff[3] = Prüfsumme;

13 PSG Plastic Service GmbH 11 Protokoll Ethernet Binär PCU/MCU 2.8 Befehl 0x000D Lese Bytes von mehreren Zonen Anfrage an PCU/MCU Beispiel Zonenparameter Sollwerte und Istwerte lesen (für 80 Zonen ab erster Zone) tx.head = 0xA5EF; Telegrammkennung tx.befehl = 0x000D; Befehl tx.address = 0x000C0000; Adresse von der gelesen wird (Adresse ergibt sich aus der ersten zu lesenden Zone); tx.len = 0x0011; Befehlslänge; tx.anz = 0x0004 Anzahl zu lesender Bytes pro Zone; tx.buff[0] = 0x50; Anzahl Zonen; tx.buff[1] = 0xEC; Prüfsumme; Antwort von PCU/MCU rx.head = 0x4143; rx.status = 0x0000; rx.address = 0; rx.len = 17 + Anzahl gelesener Bytes gesamt; rx.anz = Anzahl gelesener Bytes gesamt; rx.buff[0] = Anzahl Zonen; rx.buff[1] = Daten (Daten Zone 1, Daten Zone 2, ) rx.buff[anzahl gelesener Bytes gesamt + 1] = Prüfsumme;

14 12 Kapitel 2 Allgemeine Spezifikation 2.9 Befehl 0x000E Schreibe Bytes von mehreren Zonen Anfrage an PCU/MCU tx.head = 0xA5EF; tx.befehl = 0x000E; tx.address = Adresse auf die geschrieben wird (Adresse ergibt sich aus der ersten zu schreibenden Zone); tx.len = 17 + Anzahl zu schreibender Bytes gesamt; tx.anz = Anzahl zu schreibender Bytes gesamt; tx.buff[0] = Anzahl Zonen; tx.buff[1] = Daten (Daten Zone 1, Daten Zone 2, ); rx.buff[anzahl gelesener Bytes gesamt + 1] Prüfsumme; Antwort von PCU/MCU rx.head = 0x4143; rx.status = 0x0000; rx.address = 0; rx.len = 19; rx.anz = 3; rx.buff[0] = OK ; rx.buff[3] = Prüfsumme;

15 PSG Plastic Service GmbH 13 Protokoll Ethernet Binär PCU/MCU 2.10 Befehl 0x000A CAN-Befehl senden Anfrage an PCU/MCU (Telegrammstruktur siehe 2.2.2) tx_can.head = 0xA5FE; tx_can.befehl = 0x000A; tx_can.txnode = Sende-ID; tx_can.rxnode = Empfangs-ID; tx_can.len = 12 + Anzahl Datenbytes; tx_can.anz = Anzahl Datenbytes; tx_can.buff[0] = Datenbytes (Datenbyte [0], Datenbyte [1],..) ; tx_can.buff[anzahl Datenbytes] = Prüfsumme; Antwort von PCU/MCU (Telegrammstruktur siehe 2.2.2) rx_can.head = 0x4142; rx_can.status = 0x0000; rx_can.txnode = Sende-ID; rx_can.rxnode = Empfangs-ID; rx_can.len = 20; rx_can.anz = 8; rx_can.buff[0] = Datenbytes [0] ; rx_can.buff[1] = Datenbytes [1] ; rx_can.buff[2] = Datenbytes [2] ; rx_can.buff[3] = Datenbytes [3] ; rx_can.buff[4] = Datenbytes [4] ; rx_can.buff[5] = Datenbytes [5] ; rx_can.buff[6] = Datenbytes [6] ; rx_can.buff[7] = Datenbytes [7] ; rx_can.buff[8] = Prüfsumme;

16 14 Kapitel 3 Anhang 3 Anhang 3.1 Versionshistorie Version Datum Änderung Bezeichnung unsigned int durch word ersetzt. Prüfsummenberechnung korrigiert. Bezeichnung der Variablen vereinheitlicht Verwendete Datentypen ergänzt; Befehl 0x0000, 0x0001 Prüfsumme ergänzt; Befehl 0x000D Beispiel; Adressberechnung Systemparameter, Schreibbefehle, CAN-Befehl ergänzt Tippfehlerkorrekturen Erstveröffentlichung PSG Plastic Service GmbH Pirnaer Straße Mannheim Deutschland Tel Fax ww.psg-online.de info@psg-online.de