IPC_Serial_Interface_01.lib

Transkript

1 Anhang A - Weitere Bibliotheken WAGO-I/O-PRO CAA Bibliothek Die Bibliothek stellt dem Anwender den Funktionsbaustein SERIAL_INTERFACE speziell zur Verwendung auf dem WAGO-IPC zur Verfügung. Der Baustein erlaubt die transparente Datenübertragung beliebiger Frames ohne eine zusätzliche Protokollschicht einzuführen. Inhalt 3 SERIAL_INTERFACE...3 SET_SERIAL_MODUL...6 typring_buffer (Datentyp)...7 COM_BAUDRATE (Datentyp)...8 COM_BYTESIZE (Datentyp)...9 COM_FLOW_CONTROL (Datentyp)...10 COM_PARITY (Datentyp)...11 COM_STOPBITS (Datentyp)...12 WAGO-I/O-PRO CAA Version

2 SERIAL_INTERFACE 2 ml00701d WAGO-I/O-PRO CAA

3 Anhang A - Weitere Bibliotheken SERIAL_INTERFACE Kommunikationsbausteine SERIAL_INTERFACE Typ: Funktion Funktionsblock X Programm Name der Bibliothek: Verwendete Bibliotheken SysLibCom.Lib; KbusLib.lib; Standard.lib Anwendbar für: IPC Eingangsparameter: Datentyp: Kommentar: xopen_com_port BOOL True öffnet die Schnittstelle bcom_port_nr BYTE Portnummer bei interner Schnittstelle. Bei externer Schnittstelle ist dieser Eingang mit der Funktion SET_SERIAL_MODUL zu beschalten. cbbaudrate cbsbytesize cpparity csstopbits cfflow_control COM_ BAUDRATE COM_ BYTESIZE COM_ PARITY COM_ STOPBITS COM_ FLOW_CONTROL BAUD_4800 := 480, BAUD_9600 := 960, BAUD_19200 := 1920, BAUD_38400 := 3840, BAUD_57600 := 5760 (unterstützte Werte) (wird nur bei internem Port unterstützt) Wird z.zt. ignoriert (ist immer 8) PARITY_NO:=0, PARITY_ODD:=1, PARITY_EVEN:=2, (wird nur bei internem Port unterstützt) STOPBITS_1 := 0, STOPBITS_1_5 := 1, STOPBITS_2 := 2, (wird nur bei internem Port unterstützt) Wird z.zt. ignoriert ibytes_to_send INT Anzahl der zu sendenden Bytes ptsend_buffer POINTER Zeiger auf den Sendebuffer TO BYTE WAGO-I/O-PRO CAA Version

4 SERIAL_INTERFACE Ein-/Ausgangsparam.: Datentyp: Kommentar: xstart_send BOOL Aktiviert die Übertragung der mit ibytes_to_send angegebenen Anzahl von Bytes. Nach der Übertragung wird das Signal zurückgesetzt. utreceive_ BUFFER xinit typring_ BUFFER BOOL TYPE typring_buffer : STRUCT Index : INT; Data : ARRAY[0..RING_BUFFER_SIZE] OF BYTE; END_STRUCT Ausgangsparameter: Datentyp: Kommentar: berror BYTE 0x00: Kein Fehler 0x09: Parameter vom COM-Port nicht unterstützt. 0xFF: unzulässige Datenbreite des ext. Moduls Grafische Darstellung: 4 ml00701d WAGO-I/O-PRO CAA

5 Anhang A - Weitere Bibliotheken Funktionsbeschreibung: Der Baustein sollte in jedem Zykus aufgrufen werden, da pro Zyklus maximal 5 Byte an Daten übertragen werden. Bei Verwendung der internen Schnittstelle (COM 1) können die Übertragungsparameter geändert werden. Bei extern gesteckten Schnittstellenmodulen werden die eingestellten Parameter ignoriert. Es wird die transparente Datenübertragung beliebiger Frames unterstützt. Der Funktionbaustein stellt keine Protokollschicht zur Verfügung. Bei Verwendung der internen Schnittstelle ist der Eingang bcom_port_nr mit 1 zu beschalten. Bei externen Modulen ist dieser Eingang mit der Funktion SET_SERIAL_MODUL zu beschalten. Daten senden: Dem Funktionsbaustein ist die Adresse der zu übertragenden Daten ptsend_buffer und die Anzahl in Bytes ibytes_to_send zu übergeben. Anschließend wird mit xstart_send die Übertragung angestoßen. Sind alle Daten übertragen nimmt der Baustein das Signal xstat_send zurück. Daten empfangen: Dem Funktionsbaustein wird mit utreceivebuffer die Adresse eines Speicherbereiches zur Aufnahme der empfangenen Daten übergeben. Ein empfangenes Zeichen wird im utreceivebuffer.data (einem Array of Byte) an die Stelle des aktuellen utreceivebuffer.index geschrieben. Anschließend wird ReceiveBuffer.Index um eins erhöht. WAGO-I/O-PRO CAA Version

6 SET_SERIAL_MODUL SET_SERIAL_MODUL Kommunikationsbausteine SET_SERIAL_MODUL Typ: Funktion X Funktionsblock Programm Name der Bibliothek: Verwendete Bibliotheken Standard.lib Anwendbar für: IPC Eingangsparameter: Datentyp: Kommentar: ptindata POINTER TO BYTE Anfangsadresse des Schnittstellenmoduls im PAE ptoutdata POINTER TO BYTE Anfangsadresse des Schnittstellenmoduls im PAE bmodulwidth BYTE Modulbreite im Prozessabbild in Byte (normalerweise 4 oder 6 ) Interface SERIAL_INTERFACE Kommunikationsobjekt (Instanzname von SERIAL_INTERFACE) Rückgabewert: Datentyp: Kommentar: SET_SERIAL_MODUL BYTE Interne Kennung Grafische Darstellung: Funktionsbeschreibung: Bei der Verwendung eines seriellen Schnittstellenmoduls x muss diese Funktion dem Eingang bcom_port_nr des Bausteines SERIAL_INTERFACE vorgeschaltet werden. Da ein Modul x am IPC nicht über die Portnummer angesprochen werden kann erweitert dieser Baustein den Eingang Portnummer um für die Kommunikation erforderliche Informationen. 6 ml00701d WAGO-I/O-PRO CAA

7 Anhang A - Weitere Bibliotheken typring_buffer (Datentyp) typring_buffer Typ: Datentyp X Enumeration Name der Bibliothek: Struktur: Element: Datentyp: Beschreibung: Index INT Aktuelle Position im Array Data ARRAY[0.. RING_BUFFER_SIZE] OF BYTE Byte Array für Nutzdaten Deklaration: TYPE typring_buffer : STRUCT Index : INT; Data : ARRAY[0.. RING_BUFFER_SIZE] OF BYTE; END_STRUCT Beschreibung: WAGO-I/O-PRO CAA Version

8 COM_BAUDRATE (Datentyp) COM_BAUDRATE (Datentyp) Typ: Name der Bibliothek: Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_BAUDRATE Datentyp X 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 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 ); Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und beschreibt, mit wie viel Bits pro Sekunde Daten versendet bzw. empfangen werden. Achtung Baudraten werden nur bie Verwendung der internen Schnittstelle unterstützt. Von der internen Schnittstelle werden nicht alle Baudraten unterstützt (siehe Baustein SERIAL_INTERFACE). 8 ml00701d WAGO-I/O-PRO CAA

9 Anhang A - Weitere Bibliotheken COM_BYTESIZE (Datentyp) Typ: Name der Bibliothek: Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_BYTESIZE Datentyp X Elemente: Wert: Kommentar: BS_7 7 7 Datenbits pro Byte BS_8 8 8 Datenbits pro Byte BYTESIZE_TERMINAL_ DEFAULT 16#FFFF Default-Wert der Klemme Variablendeklaration: TYPE COM_BYTESIZE : ( BS_7 :=7, BS_8 :=8, BYTESIZE_TERMINAL_DEFAULT : =16#FFFF ); Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und beschreibt, durch wie viele Bits ein Datenbyte repräsentiert wird. Achtung Dieser Datentyp ist aus kompatibilitätsgründen zu anderen WAGO-Bausteinen erforderlich. Es werden auf dem IPC nur 8 Datenbit unterstützt. WAGO-I/O-PRO CAA Version

10 COM_FLOW_CONTROL (Datentyp) COM_FLOW_CONTROL (Datentyp) Typ: Name der Bibliothek: Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_FLOW_CONTROL Datentyp X Elemente: Wert: Kommentar: NO_FLOW_CONTROL 0 Keine Flusskontrolle XON_XOFF 1 Software-Flusskontrolle RTS_CTS 2 Hardware Handshake FULLDUPLEX 3 Datenübertragung Vollduplex HALFDUPLEX 4 Datenübertragung Vollduplex FLOW_CONTROL_ TERMINAL_DEFAULT 16#FFFF Default-Wert der Klemme Variablendeklaration: TYPE COM_FLOW_CONTROL : ( NO_FLOW_CONTROL :=0, XON_XOFF :=1, RTS_CTS :=2, FULLDUPLEX:=3, HALFDUPLEX:=4, FLOW_CONTROL_TERMINAL_DEFAULT :=16#FFFF ); Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und beschreibt, ob, und wenn ja, welche Art von Flusskontrolle unterstützt wird. Achtung Dieser Datentyp ist aus kompatibilitätsgründen zu anderen WAGO-Bausteinen erforderlich. Werte werden auf dem IPC nicht unterstützt 10 ml00701d WAGO-I/O-PRO CAA

11 Anhang A - Weitere Bibliotheken COM_PARITY (Datentyp) Typ: Name der Bibliothek: Kommunikation über die Konfigurationsschnittstelle des Controllers oder über serielle Schnittstellenklemmen COM_PARITY Datentyp X 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 16#FFFF Default-Wert der Klemme Variablendeklaration: TYPE COM_PARITY : ( PARITY_NO:=0, PARITY_ODD:=1, PARITY_EVEN:=2, PARITY_TERMINAL_DEFAULT:=16#FFFF ); Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und gibt an, ob ein Paritätsbit eingefügt wird. WAGO-I/O-PRO CAA Version

12 COM_STOPBITS (Datentyp) COM_STOPBITS (Datentyp) Typ: Name der Bibliothek: Kommunikation über die Konfigurationsschnittstelle des Controllers oder seriellen Schnittstellenklemmen COM_STOPBITS Datentyp X Elemente: Wert: Kommentar: STOPBITS_1 0 1 Stopbit pro Datenbyte STOPBITS_1_5 1 1,5 Stopbits pro Datenbyte STOPBITS_2 2 2 Stopbits pro Datenbyte STOPBITS_TERMINAL_ DEFAULT 16#FFFF Default-Wert der Klemme Variablendeklaration: TYPE COM_STOPBITS : ( STOPBITS_1 := 0, STOPBITS_1_5 := 1, STOPBITS_2 := 2, STOPBITS_TERMINAL_DEFAULT:=16#FFFF ); Datentypbeschreibung: Dieser Datentyp ist eine Enumeration und gibt an, wie viele Stopbits nach jedem Datenbyte eingefügt werden. 12 ml00701d WAGO-I/O-PRO CAA