SerComm.lib. Inhalt. WAGO-I/O-PRO 32 Bibliothek

Transkript

1 Anhang A Weitere Bibliotheken WAGO-I/O-PRO 32 Bibliothek Inhalt SERCOMM...2 SERCOMM_VERSION...7 COM_ACTION (Datentyp)...9 COM_BAUDRATE (Datentyp) COM_BYTESIZE (Datentyp)...12 COM_FLOW_CONTROL (Datentyp)...13 COM_PARITY (Datentyp)...14 COM_STOPBITS (Datentyp)...15 WAGO-I/O-PRO 32 Version A-1

2 SERCOMM SERCOMM Kategorie: Name: WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen SERCOMM Typ: Funktion Funktionsblock X Programm Name der Bibliothek: Anwendbar für: Alle Programmierbaren Feldbus-Controller ausser MODBUS Eingangsparameter: Datentyp: Kommentar: EN BOOL FB Ausführungssteuerung. Der Funktionsblock wird bei EN entlang einer steigenden Flanke ausgeführt. COMPORT BYTE Gibt den COM-Port an, auf dem in Abhängigkeit von 'FB_ACTION', eine der möglichen Operationen durchgeführt wird. BAUDRATE PARITY STOPBITS BYTESIZE FLOW_CONTROL FB_ACTION (ab Version 2.0, vorher 'ACTION') COM_ BAUDRATE COM_ PARITY COM_ STOPBITS COM_ BYTESIZE COM_FLOW_ CONTROL COM_ ACTION Gibt die Baudrate an, mit der Daten versendet oder empfangen werden sollen. Gibt an, ob, und wenn ja, welche Parität verwendet werden soll. Gibt an, wie viele Stopbits verwendet werden sollen. Gibt an, wie viele Bits ein Datenbyte repräsentieren. Gibt an, ob, und wenn ja, welche Art von Flusskontrolle verwendet werden soll. Gibt an, welche Art von Operation auf den eingestellten COM-Port durchgeführt werden soll. BYTES_TO_DO DWORD Gibt die Anzahl der Bytes an, die geschrieben oder gelesen werden sollen. IN_BUFFER DWORD Zeiger auf den Puffer, dessen Daten versendet werden sollen. OUT_BUFFER DWORD Zeiger auf den Puffer, der die empfangenen Daten aufnimmt.! A-2 Version WAGO-I/O-PRO 32

3 Anhang A Weitere Bibliotheken Ausgangsparameter: Datentyp: Kommentar: ENO BOOL Zeigt an, dass eine Operation auf den COM-Port vollständig ausgeführt oder mit einem Fehlercode abgebrochen wurde (TRUE). ERROR BOOL Zeigt an, dass während der durch 'FB_ACTION' spezifizierten Operation ein Fehler aufgetreten ist (TRUE). LAST_ERROR BYTE Wird durch 'ERROR' ein Fehler angezeigt, kann hier der entsprechende Fehlercode ausgelesen werden. BYTES_DONE DWORD Zeigt an, wie viele Bytes bei einer Schreiboperation bereits versendet wurden. Bei einer Leseoperation wird die Anzahl der gelesenen Bytes zurückgegeben. Interne Parameter: Datentyp: Kommentar: INTERNAL_USE_DO_ NOT_MODIFY Variablendeklarartion: ARRAY OF BYTE Internes Array. Dieses Array darf nicht vom Anwenderprogramm verändert werden (* Communication over a serial interface *) FUNCTION_BLOCK SERCOMM VAR_INPUT EN : BOOL; (* Initial = FALSE *) COMPORT : BYTE; (* Initial = COM1 *) BAUDRATE : COM_BAUDRATE; (* Initial = Baud *) PARITY : COM_PARITY; (* Initial = even parity *) STOPBITS : COM_STOPBITS; (* Initial = one stopbit *) BYTESIZE : COM_BYTESIZE; (* Initial = 8 Databits *) FLOW_CONTROL : COM_FLOW_CONTROL; (* Initial = No flow control *) FB_ACTION : COM_ACTION; (* Initial = Open *) BYTES_TO_DO : DWORD; (* Initial = 0 *) SEND_BUFFER : DWORD; (* Address of the send buffer *) RECEIVE_BUFFER : DWORD; (* Address of the receive buffer *) END_VAR VAR_OUTPUT ENO : BOOL; ERROR : BOOL; (* Indicates an error *) LAST_ERROR : BYTE; (* Error code *) BYTES_DONE : DWORD; (* Number of write/read bytes *) END_VAR VAR CONSTANT INTERNAL_USE_DO_NOT_MODIFY : ARRAY [0..133] OF BYTE; END_VAR! WAGO-I/O-PRO 32 Version A-3

4 SERCOMM Grafische Darstellung: Zeitliches Verhalten:! A-4 Version WAGO-I/O-PRO 32

5 Anhang A Weitere Bibliotheken Funktionsbeschreibung: Mit diesem Funktionsblock können Daten über die Konfigurationsschnittstelle des Controllers und über gesteckte Schnittstellenklemmen vom Typ /651/653 versendet und empfangen werden. Die serielle Schnittstelle des Controllers wird mit COM 1 bezeichnet. Alle gesteckten Schnittstellenklemmen vom oben angegebenen Typ können in der Reihenfolge, in der sie gesteckt wurden, mit COM 2 bis COM 65 angesprochen werden. Jeder Instanz des Funktionsblockes 'SerComm' kann immer nur ein COM-Port zugeordnet werden. D.h., ein geöffneter COM-Port kann kein zweites Mal geöffnet werden. Weiterhin kann nur mit der Instanz des FB, mit der der COM-Port geöffnet wurde, eine Operation auf denselben durchgeführt werden. Es folgen nähere Beschreibungen der verschiedenen COM-Ports. COM 1: Die serielle Schnittstelle des Controllers ist voll-duplex fähig. Diese Schnittstelle unterstützt alle aufgeführten Kommunikationsparameter des FB. Lediglich die Flusskontrolle muss deaktiviert sein (NO_FLOW_CONTROL) und 'BYTESIZE' darf nur den Wert 'BS_8' annehmen. Während des Versendens von Daten werden die Daten blockweise aus den durch 'SEND_BUFFER' zugewiesenen Sendepuffer in einen internen Puffer der Firmware umkopiert. Während des Sendevorgangs sollte somit der Inhalt des Sendepuffers nicht verändert werden. Die Variable 'BYTES_DONE' wird mit dem Versenden eines Blocks aktualisiert. Sind alle Daten versendet, nimmt 'ENO' den Wert 'TRUE' an. Beim Empfang von Daten, werden diese in einen internen 128 Byte grossen Ringpuffer geschrieben. Beim Empfang weiterer Daten werden die Informationen im Ringpuffer überschrieben, wenn nicht bereits durch eine Read-Operation Daten aus dem Ringpuffer ausgelesen wurden. Lediglich beim Versenden von Daten ist es möglich, dass der Ausgang 'ENO' erst mehrere Zyklen später gesetzt wird und somit den Abschluss der Operation kennzeichnet. In diesem Fall ist es nicht erforderlich, den FB erneut aufzurufen, bis 'ENO' gesetzt wird. Wenn bei niedrigen Baudraten unmittelbar nach dem Versenden der Daten der COM-Port geschlossen wird, kann es vorkommen, dass das letzte Zeichen nicht mehr versendet wird. In diesem Fall sollte mehrere Zyklen gewartet werden, bis der COM-Port geschlossen wird. Wird der COM-Port 1 geöffnet, können Applikationen wie WAGO-I/O-PRO 32 oder WAGO-I/O-CHECK nicht mehr über die Konfigurationsschnittstelle mit dem Controller kommunizieren. Erst mit dem Schliessen des COM-Ports ist dieses wieder möglich. COM 2-65: Die unterstützten Kommunikationsparameter sind abhängig davon, durch welche Schnittstellenklemme dieser COM-Port repräsentiert wird. Einzelheiten sind den jeweiligen Datenblättern der Busklemmen zu entnehmen. Unterstützt eine Busklemme nicht das temporäre Einstellen von Kommunikationsparametern, so müssen die Kommunikationsparameter des FB mit denen der Busklemme übereinstimmen, ansonsten kann der COM-Port nicht geöffnet werden. Bei allen vier möglichen Operationen (OPEN, CLOSE, READ, WRITE) ist es möglich, dass der Ausgang 'ENO' erst mehrere Zyklen später gesetzt wird. In diesem Fall ist es erforderlich, den FB wiederholt aufzurufen, bis dieser Ausgang den Wert 'TRUE' annimmt. WAGO-I/O-PRO 32 Version A-5

6 SERCOMM Im Gegensatz zu 'COM1', wird bei 'COM2 65' intern für jede Action (OPEN, CLOSE, READ, WRITE) eine seperate Zustandsmaschine abgearbeitet. Für eine Zustandsänderung ist es teilweise erforderlich, dass ein SPS-Zyklus vergangen ist. Jede Instanz des FB darf daher pro Action nur einmal pro Zyklus aufgerufen werden! Nach dem Abschluss einer Operation (ENO = TRUE) werden die internen Zustandsmaschinen erst wieder nach dem Erkennen einer negativen Flanke an dem Eingang 'EN' abgearbeitet. Mit einer erfolgreichen 'CLOSE'- Operation auf den COM-Port werden die internen Zustände zurückgesetzt, so dass eine nicht abgeschlossene Operation (ENO = FALSE) abgebrochen werden kann. Beim wiederholten Aufruf des FB zum Ausführen einer Operation, dürfen bis auf 'ACTION' und 'COMPORT' alle Kommunikationsparameter verändert werden. Für das Versenden von Daten gilt analog zu COM 1, dass der Inhalt des Sendepuffers während des Sendens nicht verändert werden sollte. Befinden sich mehr Bytes im Eingangspuffer der Klemme als Datenbytes gelesen werden sollen, wird (maximal) das nächste ganzzahlige Vielfache der Datenbreite im PA der Klemme, an Bytes zurückgegeben. Dieses muss bei der Dimensionierung des Eingangspuffers berücksichtigt werden. Wird durch zwei Instanzen gleichzeitig versucht einen COM-Port zu öffnen, kann es zu Konflikten kommen, so dass eine der beiden Operationen mit einer Fehlermeldung abgebrochen wird. Fehlercodes: 0x00: Kein Fehler. 0x01: Diese Library wird von der Firmware nicht unterstützt. 0x02: COM-Port ausserhalb des gültiges Bereichs. 0x03: Dieser Funktionsblock-Instanz ist noch kein COM-Port zugeordnet worden. 0x04: Dieser Funktionsblock-Instanz ist bereits ein anderer COM-Port zugeordnet. 0x05: COM-Port ist bereits geöffnet. 0x06: COM-Port ist bereits geschlossen. 0x07: COM-Port ist nicht geöffnet. 0x08: Eine Schreiboperation ist noch aktiv (COM1). 0x09: Diese Übergabeparameter werden vom COM-Port nicht unterstützt. 0x0A: Die aktuellen Einstellungen der Busklemme konnten nicht gelesen werden. 0x0B: Diese Library-Version unterstützt noch nicht das temporäre Einstellen von Kommunikationsparametern. 0x0C: Busklemme konnte nicht initialisiert werden. 0x0D: Fehler beim Schreiben der Daten in den FIFO-Speicher der Busklemme. 0x0E: Inhalt des FIFO-Speichers wurde nicht versendet (kontinuierliches Senden). 0x0F: Interner Fehler A-6 Version WAGO-I/O-PRO 32

7 SERCOMM_VERSION Kategorie: Name: Anhang A Weitere Bibliotheken WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen SERCOMM_VERSION Typ: Funktion X Funktionsblock Programm Name der Bibliothek: Anwendbar für: Alle Programmierbaren Feldbus-Controller ausser MODBUS Eingangsparameter: Datentyp: Kommentar: EN BOOL Eine positive Flanke an diesem Eingang aktiviert diese Funktion. Rückgabewert: Datentyp: Kommentar: SERCOMM_VERSION WORD Version der Bibliothek Variablendeklaration: FUNCTION SERCOMM_VERSION : WORD VAR_INPUT EN: BOOL; END_VAR Grafische Darstellung: Zeitliches Verhalten:! WAGO-I/O-PRO 32 Version A-7

8 SERCOMM_VERSION Funktionsbeschreibung: Die Funktion SERCOMM_VERSION gibt die aktuelle Versionsnummer der Bibliothek zurück. Diese Funktion kann während der Programmentwicklung zur Information eingesetzt werden. Ferner können zur Laufzeit Versionskonflikte vermieden werden. Version Beschreibung 1.0 Erste Version. Das temporäre Einstellen von COM-Parametern wird noch nicht unterstützt. 2.0 Die Instanzvariable 'ACTION' des Funktionsblockes 'SERCOMM' wurde in 'FB_ACTION' umbenannt. Ab der WAGO-I/O-PRO 32-Version 2.2 muss die in der Version 2.0 oder höher verwendet werden. 2.1 Bei einer Operation auf COM1 wird jetzt im Fehlerfall der entsprechende Fehlercode zurückgegeben. Fehlerbehebung bezüglich der Klemmen die kontinuierliches Senden unterstützen. 3.0 Der Funktionsblock "SERCOMM" arbeitet jetzt flankengesteuert. 3.1 Bei den Kommunikationsparametern besteht die Möglichkeit den Default-Wert der Klemme zu verwenden. 3.2 Bei einer Schreiboperation wird im Fehlerfall die korrekte Anzahl der verwendeten Daten angezeigt. 4.0 Bei parametrierbaren Klemmen werden mit dem Öffnen des COM-Ports die Kommunikationsparameter fest eingestellt und mit dem Schliessen des COM-Ports wieder zurückgesetzt. 4.1 Das gleichzeitige Öffnen mehrerer Schnittstellen kann nicht mehr zu internen Ressourcen-Konflikten führen und ist somit problemlos möglich. 4.2 Das Versenden von Null Bytes über COM1 ist jetzt möglich. Bei geöffneten COM-Port (2-65) kann der Anwender jetzt nicht mehr versehentlich durch externe Tools die Klemmenparameter verstellen. 5.0 Kompatibel mit der WAGO-I/O-PRO 32 Version 2.2 SR5. Die Benutzung zusammen mit Onlinechange ist möglich. 5.1 Bei parametrierbaren Klemmen kommt es nicht mehr vor, dass mit dem Öffnen und Schliessen der Schnittstelle erneut Daten aus dem Sendepuffer versendet werden. A-8 Version WAGO-I/O-PRO 32

9 COM_ACTION (Datentyp) Kategorie: Name: Typ: Name der Bibliothek: Anwendbar für: Anhang A Weitere Bibliotheken WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_ACTION Datentyp X SERCOMM Elemente: Wert: Kommentar: OPEN 0 COM-Port wird geöffnet. CLOSE 1 COM-Port wird geschlossen. READ 2 Leseoperation auf einen COM-Port. WRITE 3 Schreiboperation auf einen COM-Port. Variablendeklaration: TYPE COM_ACTION : ( OPEN := 0, CLOSE := 1, READ := 2, WRITE := 3 ); END_TYPE Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und beschreibt, welche Operation auf einen COM-Port durchgeführt wird. WAGO-I/O-PRO 32 Version A-9

10 COM_BAUDRATE (Datentyp) Kategorie: Name: Typ: Name der Bibliothek: Anwendbar für: COM_BAUDRATE (Datentyp) WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_BAUDRATE Datentyp X SERCOMM Elemente: Wert: Kommentar: BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUD_ bit/s BAUDRATE_ TERMINAL_DEFAULT 16#FFFF Default-Wert der Klemme! A-10 Version WAGO-I/O-PRO 32

11 Anhang A Weitere Bibliotheken Variablendeklaration: TYPE COM_BAUDRATE : ( BAUD_110 := 11, BAUD_300 := 30, BAUD_600 := 60, BAUD_1200 := 120, BAUD_2400 := 240, BAUD_4800 := 480, BAUD_9600 := 960, BAUD_12000 := 1200, BAUD_14400 := 1440, BAUD_19200 := 1920, BAUD_28800 := 2880, BAUD_38400 := 3840, BAUD_57600 := 5760, BAUD_62500 := 6250, BAUDRATE_TERMINAL_DEFAULT := 16#FFFF ); END_TYPE Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und beschreibt, mit wie viel Bits pro Sekunde Daten versendet bzw. empfangen werden. WAGO-I/O-PRO 32 Version A-11

12 COM_BYTESIZE (Datentyp) Kategorie: Name: Typ: Name der Bibliothek: Anwendbar für: COM_BYTESIZE (Datentyp) WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_BYTESIZE Datentyp X SERCOMM Elemente: Wert: Kommentar: BS_7 7 7 Datenbits pro Byte BS_8 8 8 Datenbits pro Byte BYTESIZE_ TERMINAL_DEFAULT Variablendeklaration: 16#FFFF Default-Wert der Klemme TYPE COM_BYTESIZE : ( BS_7 :=7, BS_8 :=8, BYTESIZE_TERMINAL_DEFAULT : =16#FFFF ); END_TYPE Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und beschreibt, durch wie viele Bits ein Datenbyte repräsentiert wird. A-12 Version WAGO-I/O-PRO 32

13 Anhang A Weitere Bibliotheken COM_FLOW_CONTROL (Datentyp) Kategorie: Name: Typ: Name der Bibliothek: Anwendbar für: WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_FLOW_CONTROL Datentyp X SERCOMM Elemente: Wert: Kommentar: NO_FLOW_CONTROL 0 Keine Flusskontrolle XON_XOFF 1 Software-Flusskontrolle RTS_CTS 2 Hardware Handshake FULLDUPLEX 3 RS485 HALFDUPLEX 4 RS485 FLOW_CONTROL_ TERMINAL_DEFAULT Variablendeklaration: 16#FFFF Default-Wert der Klemme TYPE COM_FLOW_CONTROL : ( NO_FLOW_CONTROL :=0, XON_XOFF :=1, RTS_CTS :=2, FULLDUPLEX := 3, HALFDUPLEX := 4, FLOW_CONTROL_TERMINAL_DEFAULT :=16#FFFF ); END_TYPE Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und beschreibt, ob, und wenn ja, welche Art von Flusskontrolle unterstützt wird. WAGO-I/O-PRO 32 Version A-13

14 COM_PARITY (Datentyp) Kategorie: Name: Typ: Name der Bibliothek: Anwendbar für: COM_PARITY (Datentyp) WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_PARITY Datentyp X SERCOMM Elemente: Wert: Kommentar: PARITY_NO 0 Kein Paritätsbit PARITY_ODD 1 Paritätsbit wird bei einer geraden Anzahl von Bits im Datenbyte gesetzt. PARITY_EVEN 2 Paritätsbit wird bei einer ungeraden Anzahl von Bits im Datenbyte gesetzt. PARITY_ TERMINAL_DEFAULT Variablendeklaration: 16#FFFF Default-Wert der Klemme TYPE COM_PARITY : ( PARITY_NO:=0, PARITY_ODD:=1, PARITY_EVEN:=2, PARITY_TERMINAL_DEFAULT:=16#FFFF ); END_TYPE Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und gibt an, ob ein Paritätsbit eingefügt wird. A-14 Version WAGO-I/O-PRO 32

15 COM_STOPBITS (Datentyp) Kategorie: Name: Typ: Name der Bibliothek: Anwendbar für: Anhang A Weitere Bibliotheken WAGO-I/O-PRO 32 Elemente der Bibliothek Kommunikation über die Konfigurationsschnittstelle des Controllers oder seriellen Schnittstellenklemmen COM_STOPBITS Datentyp X SERCOMM Elemente: Wert: Kommentar: STOPBITS_1 1 1 Stopbit pro Datenbyte STOPBITS_2 2 2 Stopbits pro Datenbyte STOPBITS_ TERMINAL_DEFAULT Variablendeklaration: 16#FFFF Default-Wert der Klemme TYPE COM_STOPBITS : ( STOPBITS_1:=1, STOPBITS_2:=2, STOPBITS_TERMINAL_DEFAULT:=16#FFFF ); END_TYPE Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und gibt an, wie viele Stopbits nach jedem Datenbyte eingefügt werden. WAGO-I/O-PRO 32 Version A-15

16 A-16 Version WAGO-I/O-PRO 32