Bibliotheken für das WAGO-I/O-SYSTEM 750. Bausteinbeschreibungen zum Empfang von NMEA-0183 Datensätzen

Transkript

1 für das WAGO-I/O-SYSTEM 750 Bausteinbeschreibungen zum Empfang von NMEA-0183 Datensätzen Letzte Änderung:

2 2 Allgemeines Copyright 2007 by WAGO Kontakttechnik GmbH & Co. KG Alle Rechte vorbehalten. WAGO Kontakttechnik GmbH & Co. KG Hansastraße 27 D Minden Tel.: +49 (0) 571/ Fax: +49 (0) 571/ info@wago.com Web: Technischer Support Tel.: +49 (0) 571/ Fax: +49 (0) 571/ support@wago.com Es wurden alle erdenklichen Maßnahmen getroffen, um die Richtigkeit und Vollständigkeit der vorliegenden Dokumentation zu gewährleisten. Da sich Fehler, trotz aller Sorgfalt, nie vollständig vermeiden lassen, sind wir für Hinweise und Anregungen jederzeit dankbar. Wir weisen darauf hin, dass die im Dokument verwendeten Soft- und Hardwarebezeichnungen und Markennamen der jeweiligen Firmen im Allgemeinen einem Warenzeichenschutz, Markenschutz oder patentrechtlichem Schutz unterliegen.

3 Inhalt 3 WAGO-I/O-PRO CAA Bibliothek Inhalt Wichtige Erläuterungen 4 Urheberschutz... 4 Personalqualifikation... 4 Bestimmungsgemäßer Gebrauch... 4 Gültigkeitsbereich... 5 NMEA_02.lib 6 NMEA_RECEIVE... 6 NMEA_GET_FILTERED_MSG... 8 Datatype typnmea_sentence...10 typnmea_parameters...11 Enumerations enumnmea_error...12 enumnmea_sentence_type...13

4 4 Wichtige Erläuterungen Wichtige Erläuterungen Um dem Anwender eine schnelle Installation und Inbetriebnahme der beschriebenen Geräte zu gewährleisten, ist es notwendig, die nachfolgenden Hinweise und Erläuterungen sorgfältig zu lesen und zu beachten. Urheberschutz Dieses Dokument, einschließlich aller darin befindlichen Abbildungen, ist urheberrechtlich geschützt. Jede Weiterverwendung dieses Dokumentes, die von den urheberrechtlichen Bestimmungen abweicht, ist nicht gestattet. Die Reproduktion, Übersetzung in andere Sprachen, sowie die elektronische und fototechnische Archivierung und Veränderung bedarf der schriftlichen Genehmigung der WAGO Kontakttechnik GmbH & Co. KG, Minden. Zuwiderhandlungen ziehen einen Schadenersatzanspruch nach sich. Die WAGO Kontakttechnik GmbH & Co. KG behält sich Änderungen, die dem technischen Fortschritt dienen, vor. Alle Rechte für den Fall der Patenterteilung oder des Gebrauchmusterschutzes sind der WAGO Kontakttechnik GmbH & Co. KG vorbehalten. Fremdprodukte werden stets ohne Vermerk auf Patentrechte genannt. Die Existenz solcher Rechte ist daher nicht auszuschließen. Personalqualifikation Der in diesem Dokument beschriebene Produktgebrauch richtet sich ausschließlich an Fachkräfte mit einer Ausbildung in der SPS-Programmierung, Elektrofachkräfte oder von Elektrofachkräften unterwiesene Personen, die außerdem mit den geltenden Normen vertraut sind. Für Fehlhandlungen und Schäden, die an WAGO-Produkten und Fremdprodukten durch Missachtung der Informationen dieses Dokumentes entstehen, übernimmt die WAGO Kontakttechnik GmbH & Co. KG keine Haftung. Bestimmungsgemäßer Gebrauch Die Komponenten werden ab Werk für den jeweiligen Anwendungsfall mit einer festen Hard- und Softwarekonfiguration ausgeliefert. Änderungen sind nur im Rahmen der in dem Dokument aufgezeigten Möglichkeiten zulässig. Alle anderen Veränderungen an der Hard- oder Software, sowie der nicht bestimmungsgemäße Gebrauch der Komponenten, bewirken den Haftungsausschluss der WAGO Kontakttechnik GmbH & Co. KG. Wünsche an eine abgewandelte bzw. neue Hard- oder Softwarekonfiguration richten Sie bitte an WAGO Kontakttechnik GmbH & Co. KG.

5 Gültigkeitsbereich 5 Gültigkeitsbereich Dieser Anwendungshinweis basiert auf die genannte Hard- und Software der jeweiligen Hersteller sowie auf die zugehörige Dokumentation. Daher gilt dieser Anwendungshinweis nur für die beschriebene Installation. Neue Hard- und Softwareversionen erfordern eventuell eine geänderte Handhabung. Beachten Sie die ausführliche Beschreibung in den jeweiligen Handbüchern.

6 6 NMEA_RECEIVE NMEA_02.lib Die Bibliothek "NMEA_02.lib" beinhaltet Funktionsbausteine zum Empfang von Datensätzen die dem Protokoll NMEA-0183 b.z.w. der IEC entsprechen. Weiterhin beinhaltet die Bibliothek einen Baustein zum ausfiltern bestimmter Nachrichten. NMEA_RECEIVE WAGO-I/O-PRO Elemente der Bibliothek Kategorie: Kommunikation Name: NMEA_RECEIVE Typ: Funktion Funktionsblock X Programm Name der Bibliothek: NMEA_02.lib Verwendete Standard.lib Serial_Interface_01.lib Sercomm.lib Anwendbar für: Programmierbare Feldbus-Controller (nicht für x ) (nicht für / xxx-xxx ) Ausgangsparameter: Datentyp: Kommentar: NewSentenceReceived BOOL Impuls für einen Zyklus wenn ein neuer gültiger Satz empfangen wurde. Sentence typnmea_sentence Struktur mit den Satz-Komponenten Error WORD Fehlermeldungen H-Byte -> NMEA-Protokollfehler L-Byte -> Sercomm-Fehler (siehe Doku Sercomm.lib) Ein-/Ausgangsparameter: Datentyp: Kommentar: SERIAL_COM_OBJECT SERIAL_COM_OBJECT Kommunikationsobjekt Kanal über den der Datenempfang erfolgt Der Prototyp dieses Objektes ist in der Serial_Interface_01.lib definiert.

7 NMEA_RECEIVE 7 Graphische Darstellung: Funktionsbeschreibung: Der Baustein NMEA_RECEIVE empfängt alle über das COM-Objekt eintreffenden Zeichen und prüft diese auf gültige NMEA-Datensätze. Weiterhin zerlegt dieser Baustein gültige NMEA-Datensätze in Einzelkomponenten und stellt diese strukturiert zur weiteren Verarbeitung am Ausgang Sentence zur Verfügung. Dieser Baustein muß zyklisch mindestens einmal je Zyklus aufgerufen werden. Beispielaufruf in ST : VAR (*--- Objekt zur seriellen Kommunikation *) SerialComObject : SERIAL_COM_OBJECT := ( COM_PORT_NR := 2, BAUDRATE := BAUD_4800, FLOW_CONTROL := NO_FLOW_CONTROL ); (* *) (*--- Empfänger für alle NMEA-Sentences *) myreceiver : NMEA_RECEIVE; (* *) mysentence : typnmea_sentence; END_VAR myreceiver( SERIAL_COM_OBJECT := SerialComObject, Sentence => mysentence );

8 8 NMEA_GET_FILTERED_MSG NMEA_GET_FILTERED_MSG WAGO-I/O-PRO Elemente der Bibliothek Kategorie: Kommunikation Name: NMEA_GET_FILTERED_MSG Typ: Funktion Funktionsblock X Programm Name der Bibliothek: NMEA_02.lib Verwendete Standard.lib Serial_Interface_01.lib Sercomm.lib Anwendbar für: Programmierbare Feldbus-Controller (nicht für x ) (nicht für / xxx-xxx ) Eingangsparameter: Datentyp: Kommentar: Sentence_Type enumnmea_sentence_ TYPE Filter : Über diesen Parameter kann ein Satztyp als Filter vorgegeben werden. Folgende Satztypen sind zulässig : NMEA_UNKNOWN_TYPE := 0 (* alle *) NMEA_PARAMETRIC_SENTENCE := 1 (* $ *) NMEA_ENCAPSULATION_SENTENCE := 2 (*! *) Talker_ID STRING(2) Filter : Über diesen Parameter kann eine Talker-ID als Filter vorgegeben werden. Wird dieser Parameter nicht oder mit einem Leerstring gesetzt, dann werden alle Talker (Sender) zugelassen. Formatter_ID STRING(3) Filter : Über diesen Parameter kann eine Formatter- ID als Filter vorgegeben werden. Wird dieser Parameter nicht oder mit einem Leerstring gesetzt, dann werden alle Formatter (Datensatzarten) zugelassen. Ausgangsparameter: Datentyp: Kommentar: NewSentenceReceived BOOL Impuls für einen Zyklus wenn ein neuer gültiger, gefilterter Satz empfangen wurde. Sentence typnmea_sentence Struktur mit den Satz-Komponenten Ein-/Ausgangsparameter: Datentyp: Kommentar: NMEA_Receiver NMEA_RECEIVE Kommunikationsobjekt Kanal über den der Datenempfang erfolgt (Instanz des Bausteins NMEA_RECEIVE)

9 NMEA_GET_FILTERED_MSG 9 Graphische Darstellung: Funktionsbeschreibung: Der Baustein NMEA_GET_FILTERED_MSG filtert aus den von dem Baustein NMEA_RECEIVE empfangenen, gültigen Sätzen die über die drei Eingangsfilter spezifizierten Sätze aus. Dieser Baustein kann mehrfach instanziiert werden und die Instanzen jeweils mit eigenen Filterparametern aufgerufen werden. Der Aufruf sollte im selben Zyklus wie der Aufruf des Bausteins NMEA_RECEIVE erfolgen.

10 10 Datatype Datatype typnmea_sentence WAGO-I/O-PRO Elemente der Bibliothek Kategorie: Name: typnmea_sentence Typ: Datentyp X Enumeration Name der Bibliothek: NMEA_02.lib Struktur: Element: Datentyp: Beschreibung: SentenceType enumnmea_sentence_type NMEA_UNKNOWN_TYPE := 0 NMEA_PARAMETRIC_SENTENCE := 1 NMEA_ENCAPSULATION_SENTENCE := 2 Talker_ID STRING(2) Sender-Kennung Formatter_ID STRING(3) Satz-Kennung Parameter typnmea_parameters Parameterstruktur Deklaration: TYPE typnmea_sentence : STRUCT SentenceType : enumnmea_sentence_type; Talker_ID : STRING(2); Formatter_ID : STRING(3); Parameter : typnmea_parameters; END_STRUCT END_TYPE Beschreibung: Diese Struktur bildet einen NMEA-Datensatz ab

11 Datatype 11 typnmea_parameters WAGO-I/O-PRO Elemente der Bibliothek Kategorie: Name: typnmea_parameters Typ: Datentyp X Enumeration Name der Bibliothek: NMEA_02.lib Struktur: Element: Datentyp: Beschreibung: Count BYTE Anzahl der gültigen Parameter im Value-Feld Value ARRAY[1..NMEA_MAX_VALUES_ PER_SENTENCE] OF STRING Werte der Parameter Deklaration: TYPE typnmea_parameters : STRUCT Count : BYTE; (* quantity of values *) Value : ARRAY[1..NMEA_MAX_VALUES_PER_SENTENCE] OF STRING; END_STRUCT END_TYPE Beschreibung: Diese Struktur bildet die Parameter eines NMEA-Datensatzes ab

12 12 Enumerations Enumerations enumnmea_error WAGO-I/O-PRO Elemente der Bibliothek Kategorie: Name: enumnmea_error Typ: Datentyp Enumeration X Name der Bibliothek: NMEA_02.lib Elemente: Wert: Kommentar: NMEA_NO_ERROR 16#0000 NMEA_CRC_ERROR 16#0100 Berechneter CRC ist ungleich dem empfangenen CRC NMEA_MISSING_CRC 16#0200 Endezeichen empfangen bevor ein CRC empfangen wurde NMEA_INVALID_CHAR 16#0300 ein nicht erwartetes Zeichen empfangen NMEA_SECOND_STARTCHAR 16#0400 Zweites Startzeichen ($ /!) im Frame empfangen NMEA_SECOND_CRC_DELIM 16#0500 Zweite CRC-Kennung (*) empfangen NMEA_CRC_DELIM_TO_EARLY 16#0600 CRC-Kennung bevor Adressfeld komplett NMEA_FIELD_DELIM_TO_EARLY 16#0700 Feldtrenner (,) bevor Adressfeld komplett NMEA_HEX_DELIM_TO_EARLY 16#0800 HEX-Kennung (^) bevor Adressfeld komplett NMEA_TO_MANY_PARAMETERS 16#0900 Anzahl der Parameter kann nicht von dem Array im typparameters aufgenummen werden. Array zu klein. Neudefinition der globalen Konstanten NMEA_MAX_VALUES_PER_SENTENCE Deklaration: TYPE enumnmea_error : ( NMEA_NO_ERROR := 0, NMEA_CRC_ERROR := 16#0100, NMEA_MISSING_CRC := 16#0200, NMEA_INVALID_CHAR := 16#0300, NMEA_SECOND_STARTCHAR := 16#0400, NMEA_SECOND_CRC_DELIM := 16#0500, NMEA_CRC_DELIM_TO_EARLY := 16#0600, NMEA_FIELD_DELIM_TO_EARLY := 16#0700, NMEA_HEX_DELIM_TO_EARLY := 16#0800, NMEA_TO_MANY_PARAMETERS := 16#0900 ); END_TYPE

13 Enumerations 13 enumnmea_sentence_type WAGO-I/O-PRO Elemente der Bibliothek Kategorie: Name: enumnmea_sentence_type Typ: Datentyp Enumeration X Name der Bibliothek: NMEA_02.lib Elemente: Wert: Kommentar: NMEA_UNKNOWN_TYPE 0 Nicht spezifizierter / unbekannter Typ NMEA_PARAMETRIC_TYPE 1 Parameter-Satz NMEA_ENCAPSULATION_TYPE 2 Gekapselter Satz Deklaration: TYPE enumnmea_sentence_type :( NMEA_UNKNOWN_TYPE := 0, NMEA_PARAMETRIC_SENTENCE := 1, NMEA_ENCAPSULATION_SENTENCE := 2 ); END_TYPE

14 WAGO Kontakttechnik GmbH & Co. KG Postfach 2880 D Minden Hansastraße 27 D Minden Telefon: 05 71/ Telefax: 05 71/ info@wago.com Internet: