Multigate. Datenkopplung mit ASCII-Protokoll. Einleitung. Funktionsprinzip. Multigate_ASCII_ _DE Technische Änderungen vorbehalten Seite 1 von 9

Transkript

1 Einleitung Für die SCADA-Anbindung der Wurm-Systemtechnik an ein zentrales Management (Leitstelle) ist eine definierte Schnittstelle für die Bereitstellung und Übergabe der gewünschten Datenpunkte notwendig. Das vorliegende Dokument beschreibt diese Schnittstelle für die, über eine XML-Datei definierten, Datenpunkte zur Übertragung in einem ASCII-Protokoll. Funktionsprinzip ASCII-Protokoll (Request) Multigate_ASCII_ _DE Technische Änderungen vorbehalten Seite 1 von 9

2 Inhaltsverzeichnis 1 Beschreibung Datenpunkte der Frigodata XP XML-Datei Das data - Element Das project - Element Das user - Element Das document - Element Übertragung der Datenpunkte Datagramm ReadSignal Datagramm WriteSignal Datagramm Response Fehlerkennungen Response Format der Werteausgaben Zeichenkette Natürliche Zahl, Bitwerte Analogsignale Uhrzeit Datum Zugriffschutz Beschreibung Datenpunkte der Frigodata XP XML-Datei Folgend wird der Aufbau der Frigodata XP XML-Datei zur Konfiguration des Datenaustausches mit einem Leitsystem beschrieben. Dateiname Der Dateiname besteht aus folgenden Elementen: DataExchange_xxxxxxxx.XML (wobei das xxxxxxxx die 8-stellige Projekt-ID ist) Aufbau XML-Datei Unter dem Hauptelement (Wurzelelement) configuration befinden sich 4 Unterelemente: - data : Enthält die eigentlichen Informationen über die zum Datenaustausch freigegebenen Signale - project : Beschreibt einige projektspezifische Informationen - user : Enthält Informationen zum Benutzer, welcher die Datei erstellt hat - document : Enthält Informationen zum Dokument selber Seite 2 von 9 Technische Änderungen vorbehalten Multigate_ASCII_ _DE

3 1.1 Das data - Element Das data -Element benennt das zum Datenaustausch freigegebene Signal. Folgende Elemente sind für ein Signal immer vorhanden: XML-Datei data element Beschreibung signal number Im signal number -Attribut jedes Signal-Elements befindet sich die Signalnummer, mit der die Leitstelle über den Frigodata XP-Webservice auf das Signal zugreifen kann. Hinweis! Das Attribut id dient internen Zwecken. Das Attribut cert dient für interne Zertifizierungs- Prüfungen. name context access r access rw typ CntrlNo maxlength 2 maxlength 4 Die Signalbezeichnung (z.b. Sollwert) Die nähere Signalbezeichnung (z.b. die Kühlstellenbezeichnung, die Regelkreisbezeichnung, eine erweiterte Sollwertbeschreibung) Die Zugriffsart r für readonly, Die Zugriffsart rw für readwrite Die Werteart, zurzeit definiert sind analog, string und field Eindeutige Gerätenummer (z.b. 1=HKS) Maximale Länge des Wertes 2 Byte (1 Modbus Register) Format integer Maximale Länge des Wertes 4 Byte (2 Modbus Register) Format float IEEE754 Multigate_ASCII_ _DE Technische Änderungen vorbehalten Seite 3 von 9

4 Abhängig vom typ (Werteart) folgen danach noch weitere Elemente: Typ Zuätzliche Elemente bei readonly -Signalen Zuätzliche Elemente bei readwrite -Signalen Bedeutung Analog - Min Minimalwert - Max Maximalwert - step Schrittweite - unit Phys. Einheit (z.b C ) Digital Field options (Aufzählung) options (Aufzählung) Definiert die Bedeutung der Feldwerte, z.b. 0: Aus 1: Ein Beispiel eines Analog-(readwrite) Wertes: Beispiel eines field (readonly) Wertes: Seite 4 von 9 Technische Änderungen vorbehalten Multigate_ASCII_ _DE

5 1.2 Das project - Element Definiert sind die folgenden Unterelemente: - id: Die eindeutige, max. 8-stellige, numerische Wurm-Projekt-ID - name: Der Projektname (max. 40 Zeichen) 1.3 Das user - Element Definiert ist hier das ident Element. 1.4 Das document - Element Das Element enthält 3 Sub-Elemente: - created : Erstellungsdatum des Dokumentes - lastchange : letzte Änderung - version : Dokument-Version 2 Übertragung der Datenpunkte Die Übertragung der Datenpunkte an eine Leitstelle ist über die Ethernet-Schnittstelle im Client/Server-Prinzip möglich. Bei der Übertragung werden 3 grundlegende Datagrammtypen verwendet: Datagramm Richtung Befehl (Ascii-Protokoll) ReadSignal Leitstelle->Multigate Request WriteSignal Leitstelle->Multigate Command Response Multigate->Leitstelle Response Eine eindeutige Zuordnung zwischen ReadSignal, WriteSignal und Response wird durch eine Request-ID ( ) sichergestellt, die vom Client (Leitstelle) vergeben wird. Der Server (Multigate) wiederholt die Request-ID bei dem entsprechenden Response. Der gewünschte Datenpunkt wird mit seiner Datenpunktnummer aus der XML-Datei angesprochen. <signal nummer= xxx (mit xxx = Datenpunktnummer) Multigate_ASCII_ _DE Technische Änderungen vorbehalten Seite 5 von 9

6 2.1 Datagramm ReadSignal Die Übertragungsrichtung ist von der Leitstelle zum Multigate und dient zur Abfrage des Inhaltes eines Datenpunktes: request/<requestid>:<liste>;<datenpunktnr>;<zugriffskennung><cr><lf> (Beispiel ) RequestID = 123 Liste = 1 (zurzeit immer auf 1) Datenpunkt = 11 Zugriffskennung = WURM0410@ Datagramm WriteSignal Die Übertragungsrichtung ist von der Leitstelle zum Multigate und schreibt neue Daten in den Datenpunkt: command/<requestid>:<liste>;<datenpunktnr>;<zugriffskennung>#<wert><cr><lf> (Beispiel command/41235:1;87;wurm0410@223#234 ) RequestID = Liste = 1 (zurzeit immer auf 1) Datenpunkt = 87 Zugriffskennung = WURM0410@223 Wert = Datagramm Response Die Ausgabe des gewünschten Datenpunktes erfolgt mittels folgendem Response-Telegramm: response/<requestid>:<liste>;<datenpunktnr>#<wert><cr><lf> (Beispiel response/123:1;11#kühlstelle MoPro ) RequestID = 123 Liste = 1 (zurzeit immer auf 1) Datenpunkt = 11 Wert = Kühlstelle MoPro Hinweis! Ist ein Fehler bei der Bearbeitung aufgetreten, wird ein entsprechender Response mit einem Fehlercode vom Multigate ausgesendet: response/<requestid>:error#<fehlerkennung><cr><lf> (Beispiel response/123:error#noo Eine Auflistung der Fehlerkennungen finden Sie auf der Seite 7 im Kapitel 3 Fehlerkennungen Reponse. Seite 6 von 9 Technische Änderungen vorbehalten Multigate_ASCII_ _DE

7 3 Fehlerkennungen Response Eine Fehlerkennung setzt sich aus 3 Buchstaben zusammen. Im folgenden eine Tabelle mit den Fehlerkennungen und ihrer Bedeutung: Fehlerkennung Bedeutung fli Fehler Listen-Nummer Gültiger Wertebereich 1 10 nli Liste im Multigate nicht vorhanden fdp Fehler in Datenpunkt-Nummer Gültiger Wertebereich ndp Werteart des Datenpunktes nicht ermittelbar. (Fehler im Datenpunkt in der Datenpunkt-Austauschliste) fke Fehler in der Zugriffskennung pnv Protokoll Syntax-Fehler (Datagramm WriteSignal/ReadSignal beinhaltet unbekanntes Token) nre Keine Rückmeldung vom Regelgerät (Timeout) (Regelgerät nicht vorhanden oder auf Datenstörung) noo Rückmeldung vom Regelgerät Datenpunkt nicht ermittelbar (Objektnummer unbekannt) nso Datenpunkt darf nur gelesen werden. frq Fehler in der Request-ID (Gültiger Wertebereich ) fmi Neuer Sollwert ist kleiner MIN (Vorgegeben in der XML-Datei) fma Neuer Sollwert ist größer MAX (vorgegeben in der XML-Datei) fwe Fehler im Wert (z.b. Monat = 0 im Datum) fwr Kommunikationsfehler auf CAN-Bus beim Schreiben eines Datagramm WriteSignals fty Die Installation hat sich geändert und der aktuelle Gerätetyp entspricht nicht mehr dem Datentyp in der Bereitstellungsliste Multigate_ASCII_ _DE Technische Änderungen vorbehalten Seite 7 von 9

8 4 Format der Werteausgaben Alle Wertausgaben werden mit einem Response-Telegramm ausgegeben und durch ein <cr><lf> abgeschlossen. 4.1 Zeichenkette Eine Zeichenkette wird im Ascii-Format ausgegeben. response/123:1;11#dies ist ein Beispieltext<cr><lf> 4.2 Natürliche Zahl, Bitwerte Natürliche Zahlen oder Bitwerte werden ohne Vorzeichen oder sonstige Formathilfen ausgeben. response/123:1;11#n<cr><lf> (mit n =0,1,2.) response/123:1;11#---<cr><lf> (Wert ungültig) 4.3 Analogsignale Ein Analogsignal setzt sich aus dem Vorzeichen + oder - und dem eigentlichen Wert mit Nachkommastellen hinter,. response/123:1;11#+12,6 <cr><lf> (Wert = +12,6) response/123:1;11#----- <cr><lf> (Wert ungültig) 4.4 Uhrzeit Die Uhrzeit wird in Stunden und Minuten ausgegeben. Als Trennzeichen wird ein Doppelpunkt ( : ) verwendet. response/123:1;11#09:22<cr><lf> 4.5 Datum Das Datum wird in der Reihenfolge Tag, Monat und Jahr ausgegeben. Als Trennzeichen wird ein Punkt (. ) verwendet. response/123:1;11# <cr><lf> Seite 8 von 9 Technische Änderungen vorbehalten Multigate_ASCII_ _DE

9 5 Zugriffschutz Multigate Um missbräuchliche Datenzugriffe zu verhindern, wird beim Lesen und Schreiben von Werten eine Zugriffskennung benötigt. Diese setzt sich zusammen aus einer User-Identifikation und einem Kontrollbyte (Aufbau Zugriffskennung: Die folgende Useridentifikation ist einmalig aus dem User- Element der zugehörigen XML-Datei zu entnehmen. Des Weiteren ist für jeden Datenpunkt das zugehörige Kontrollbyte in der XML-Datei im data-element definiert. id= a-b-c-d-e-xxx (mit xxx = Kontrollbyte) Hinweis! Stimmt die User-ID oder das Kontrollbyte nicht mit den im Multigate hinterlegten Daten überein, schickt das Multigate eine negative Quittung (Response). Multigate_ASCII_ _DE Technische Änderungen vorbehalten Seite 9 von 9