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

Transkript

1 Anhang A - Weitere Bibliotheken WAGO-I/O-PRO 32 Bibliothek SMS_01.lib Die Library SMS_01.lib stellt dem Anwender die folgenden Funktionsbausteine zur Verfügung. Diese Bausteine unterstützen den SMS-Versand über ein Festnetzmodem. Prüfen Sie in jedem Fall ob Ihr SMS-Provider den Versand von Festnetz-SMS in Fremdnetze unterstützt. Inhalt SMS_01.lib 3 SMS_TAP... 3 SMS_UCP... 6 typtap_error (ENUM)... 9 typucp_operation_type (ENUM)... 9 typucp_error (ENUM)...10 WAGO-I/O-PRO 32 Version SMS_01.lib - 1

2 SMS_TAP 2 SMS_01.lib ml00300d WAGO-I/O-PRO 32

3 Anhang A - Weitere Bibliotheken SMS_01.lib SMS_TAP Kategorie: Kommunikationsbausteine Name: SMS_TAP Typ: Funktion Funktionsblock X Programm Name der Bibliothek: SMS_01.lib Verwendete Bibliotheken Serial_Interface_01.LIB MODEM_01.LIB SerComm.LIB STANDARD.LIB Anwendbar für: Programmierbare Koppler (nicht für /814/815/816) Eingangsparameter: Datentyp: Kommentar: bcom_port BYTE Nr. der verwendeten ser. Schnittstelle 1 -> interne Serviceschnittstelle 2 -> 1.gestecktes Modul x 3 -> 2.gestecktes Modul x u.s.w. cbbaudrate COM_BAUDRATE je nach benutzter Schnittstelle cpparity COM_PARITY je nach benutzter Schnittstelle csstopbits COM_STOPBITS je nach benutzter Schnittstelle cbsbytesize COM_BYTESIZE je nach benutzter Schnittstelle strmodem_int STRING Initialisierungsstring für das verwendete Modem. Dieser String wird beim Verbindungsaufbau als erstes an das Modem gesendet. Folgende Zeichen in diesem String haben eine Sonderbedeutung: strmodem_dial STRING Der Wählstring beinhaltet die Wählsequenz des Modems. Folgende Zeichen in diesem String haben eine Sonderbedeutung: WAGO-I/O-PRO 32 Version SMS_01.lib - 3

4 SMS_TAP strmodem_hang_up STRING Der Hang-Up-String beinhaltet die Sequenz die das Modem benötigt um die Verbindung zu trennen. Folgende Zeichen in diesem String haben eine Sonderbedeutung: strsmsc_no STRING Telefonnummer des SMSC strtarget_no STRING Telefonnummer des SMS-Empfängers strmsg STRING Text der Kurzmitteilung xstart BOOL mit einem TRUE an diesem Eingang wird die Übertragung der Mitteilung gestartet. ttime_out TIME Max. Zeit die auf einen Verbindungsaufbau gewartet wird. Ausgangsparameter: Datentyp: xready BOOL Ein TRUE an diesem Ausgang signalisiert das dieser Baustein seine Aktivitäten abgeschlossen hat und nun der Erfolg der letzten Aktivität über TAP_ERROR b.z.w. MODEM_ERROR abgefragt werden kann. xerror BOOL Ein TRUE an diesem Ausgang signalisiert das ein Fehler aufgetreten ist (siehe TAP_ERROR b.z.w. MODEM_ERROR). TAP_ERROR typtap_error Protokollfehlermeldung TAP_NO_ERROR := 0, TAP_PROTOCOL_ERROR := 1, TAP_SYNC_ERROR := 2, TAP_IDENTIFICATION_ERROR := 3, TAP_TIMEOUT_ERROR := 4, TAP_CHECKSUM_ERROR := 5, TAP_SYNTAX_ERROR := 6, TAP_SIO_TIMEOUT_ERROR := 7 MODEM_ERROR typmodem_error MODEM_NO_ERROR := 0, MODEM_CONNECT_ERROR := -1, MODEM_DISCONNECT_ERROR := -2, MODEM_INIT_ERROR := -3 MODEM_STATUS typmodem_status Meldet den Status der Modemverbindung. MODEM_DISCONNECT := 0, MODEM_INITIALIZE := 1, MODEM_IS_CONNECTING := 2, MODEM_CONNECTED := 3, MODEM_DATA_EXCHANGE := 4, MODEM_IS_DISCONNECTING := 5 4 SMS_01.lib ml00300d WAGO-I/O-PRO 32

5 Anhang A - Weitere Bibliotheken Graphische Darstellung Funktionsbeschreibung: Dieser Baustein ermöglicht den Versand einer SMS aus dem Festnetz mit dem Telocator Alphanumeric Protocol (TAP) über eine Modemverbindung. Das verwendete Short Message Service Center (SMSC) muß über einen Modemzugang mit dem TAP-Protokoll verfügen. Alle erforderlichen Schnittstellenaufrufe sind in diesem Baustein kapselt so das nur noch der Baustein SMS_TAP zyklisch aufgerufen werden muß. WAGO-I/O-PRO 32 Version SMS_01.lib - 5

6 SMS_UCP SMS_UCP Kategorie: Kommunikationsbausteine Name: SMS_UCP Typ: Funktion Funktionsblock X Programm Name der Bibliothek: SMS_01.lib Verwendete Bibliotheken Serial_Interface_01.LIB MODEM_01.LIB SerComm.LIB STANDARD.LIB Anwendbar für: Programmierbare Koppler (nicht für /814/815/816) Eingangsparameter: Datentyp: Kommentar: bcom_port BYTE Nr. der verwendeten ser. Schnittstelle 1 -> interne Serviceschnittstelle 2 -> 1.gestecktes Modul x 3 -> 2.gestecktes Modul x u.s.w. cbbaudrate COM_BAUDRATE je nach benutzter Schnittstelle cpparity COM_PARITY je nach benutzter Schnittstelle csstopbits COM_STOPBITS je nach benutzter Schnittstelle cbsbytesize COM_BYTESIZE je nach benutzter Schnittstelle strmodem_int STRING Initialisierungsstring für das verwendete Modem. Dieser String wird beim Verbindungsaufbau als erstes an das Modem gesendet. Folgende Zeichen in diesem String haben eine Sonderbedeutung: strmodem_dial STRING Der Wählstring beinhaltet die Wählsequenz des Modems. Folgende Zeichen in diesem String haben eine Sonderbedeutung: 6 SMS_01.lib ml00300d WAGO-I/O-PRO 32

7 Anhang A - Weitere Bibliotheken strmodem_hang_up STRING Der Hang-Up-String beinhaltet die Sequenz die das Modem benötigt um die Verbindung zu trennen. Folgende Zeichen in diesem String haben eine Sonderbedeutung: strsmsc_no STRING Telefonnummer des SMSC strtarget_no STRING Telefonnummer des SMS-Empfängers stroriginator_no STRING Telefonnummer des SMS-Absenders utoperation_type typucp_operation _TYPE Protokollübertragungstyp UCP_OT_CALL_INPUT := 1, UCP_OT_SMS_MESSAGE_TRANSFER := 30, UCP_OT_SUBMIT_SHORT_MESSAGE := 51 strmsg STRING Text der Kurzmitteilung xstart BOOL mit einem TRUE an diesem Eingang wird die Übertragung der Mitteilung gestartet. ttime_out TIME Max. Zeit die auf einen Verbindungsaufbau gewartet wird. Ausgangsparameter Datentyp: xready BOOL Ein TRUE an diesem Ausgang signalisiert das dieser Baustein seine Aktivitäten abgeschlossen hat und nun der Erfolg der letzten Aktivität über TAP_ERROR b.z.w. MODEM_ERROR abgefragt werden kann. xerror BOOL Ein TRUE an diesem Ausgang signalisiert das ein Fehler aufgetreten ist (siehe TAP_ERROR b.z.w. MODEM_ERROR). UCP_ERROR typucp_error Protokollfehlermeldung (siehe typucp_error) MODEM_ERROR typmodem_error MODEM_NO_ERROR := 0, MODEM_CONNECT_ERROR := -1, MODEM_DISCONNECT_ERROR := -2, MODEM_INIT_ERROR := -3 MODEM_STATUS typmodem_status Meldet den Status der Modemverbindung. MODEM_DISCONNECT := 0, MODEM_INITIALIZE := 1, MODEM_IS_CONNECTING := 2, MODEM_CONNECTED := 3, MODEM_DATA_EXCHANGE := 4, MODEM_IS_DISCONNECTING := 5 WAGO-I/O-PRO 32 Version SMS_01.lib - 7

8 SMS_UCP Graphische Darstellung Funktionsbeschreibung: Dieser Baustein ermöglicht den Versand einer SMS aus dem Festnetz mit dem Universal Computer Protocol (UCP) über eine Modemverbindung. Das verwendete Short Message Service Center (SMSC) muß über einen Modemzugang mit dem UCP-Protokoll verfügen. Es werden die Operationstypen 01; 30 und 51 lt. EMI-Spezifikation unterstützt. Alle erforderlichen Schnittstellenaufrufe sind in diesem Baustein kapselt so das nur noch der Baustein SMS_TAP zyklisch aufgerufen werden muß. 8 SMS_01.lib ml00300d WAGO-I/O-PRO 32

9 Anhang A - Weitere Bibliotheken typtap_error (ENUM) WAGO-I/O-PRO - Library Elemente Kategorie: Kommunikationsbausteine Name: typtap_error Typ: Datentyp Enumeration X Library Name: SMS_01.lib Deklaration : TYPE typtap_error : ( TAP_NO_ERROR := 0, TAP_PROTOCOL_ERROR := 1, TAP_SYNC_ERROR := 2, TAP_IDENTIFICATION_ERROR:= 3, TAP_TIMEOUT_ERROR := 4, TAP_CHECKSUM_ERROR := 5, TAP_SYNTAX_ERROR := 6, TAP_SIO_TIMEOUT_ERROR := 7); END_TYPE typucp_operation_type (ENUM) Kategorie: Name: typucp_operation_type Typ: Datentyp Enumeration X Bibliotheksname: SMS_01.lib Deklaration: TYPE typucp_operation_type : ( UCP_OT_CALL_INPUT := 1, UCP_OT_SMS_MESSAGE_TRANSFER := 30, UCP_OT_SUBMIT_SHORT_MESSAGE := 51); END_TYPE WAGO-I/O-PRO 32 Version SMS_01.lib - 9

10 typucp_error (ENUM) typucp_error (ENUM) WAGO-I/O-PRO - Library Elemente Kategorie: Kommunikationsbausteine Name: typucp_error Typ: Datentyp Enumeration X Library Name: SMS_01.lib Deklaration : TYPE typucp_error : ( UCP_NO_ERROR := 0, UCP_TIMEOUT_ERROR := -1, UCP_SIO_TIMEOUT_ERROR := -2, UCP_NOT_SUPPORTED_OT := -3, UCP_RESPONSE_CHECKSUM_ERROR := -4, (*--- SMSC EMI Specification Ver *) UCP_CHECKSUM_ERROR := 1, UCP_SYNTAX_ERROR := 2, UCP_OPERATION_NOT_SUPP := 3, UCP_OPERATION_NOT_ALLOWED := 4, UCP_CALL_BARRING_ACTIVE := 5, UCP_AdC_INVALID := 6, UCP_AUTHENTICATION_FAILURE := 7, UCP_LEGITIMISATION_FAILURE := 8, UCP_GA_NOT_VALID := 9, UCP_REPETITION_NOT_ALLOWED := 10, UCP_LEGITIMISATION_REPETITION_FAILURE := 11, UCP_PRIORITY_CALL_NOT_ALLOWED := 12, UCP_LEGITIMISATION_PRIORITY_FAILURE := 13, UCP_URGENT_MESSAGE_NOT_ALLOWED := 14, UCP_LEGITIMISATION_URGENT_MSG_FAILURE := 15, UCP_REVERSE_CHARGING_NOT_ALLOWED := 16, UCP_LEGITIMISATION_REV_CHARGING_FAILURE := 17, UCP_DEFERRED_DELIVERY_NOT_ALLOWED := 18, UCP_NEW_AC_NOT_VALID := 19, UCP_NEW_LEGITIMISATION_NOT_VALID := 20, UCP_STANDARD_TEXT_NOT_VALID := 21, UCP_TIME_PERIOD_NOT_VALID := 22, UCP_MESSAGE_TYPE_NOT_SUPPORTED := 23, UCP_MESSAGE_TOO_LONG := 24, UCP_REQUEST_STANDARD_TEXT_NOT_VALID := 25, UCP_MESSAGE_TYPE_NOT_VALID_FOR_PAGER := 26, UCP_MESSAGE_NOT_FOUND_IN_SMSC := 27, UCP_SUBSCRIBER_HANG_UP := 30, UCP_FAX_GROUP_NOT_SUPPORTED := 31, UCP_FAX_MSG_TYPE_NOT_SUPPORTED := 32, UCP_ADDRESS_ALREADY_IN_LIST := 33, UCP_ADDRESS_NOT_IN_LIST := 34, UCP_LIST_FULL_CANNOT_ADD_ADDRESS := 35, UCP_RPID_ALREADY_IN_USE := 36, UCP_DELIVERY_IN_PROGRESS := 37, UCP_MESSAGE_FORWARDED := 38 (*--- SMSC EMI Specification Ver *) ); END_TYPE 10 SMS_01.lib ml00300d WAGO-I/O-PRO 32