How-To-Do. BASIC-Skript Beispiele

Transkript

1 How-To-Do BASIC-Skript Beispiele Inhaltsverzeichnis 1 Allgemeines Information Hinweis BASIC Scripting BASIC Skript Editor Skripte bearbeiten Beispiel Skripte Versand des aktuelles Wertes bei einem Ereignis Auswerten / Anzeigen der Feldstärke über eine Variable Internetzugang über eine Variable steuern Fallback für ADSL auf Mobilfunk Anzeigen ob eine VPN-Verbindung aufgebaut wurde Variable bitweise maskieren Variable umrechnen Revision History Änderungen September 15 Seite 1 von 10

2 1 Allgemeines 1.1 Information In diesem How-To-Do zeigen wir verschiedene Beispiele auf, welche Funktionen mit dem integrierten BASIC Editor zu realisieren sind. 1.2 Hinweis Dieses How-To-Do dient als Beispiel einer funktionierenden Anwendung. Eine Haftung ist für Sachund Rechtsmängel dieser Dokumentation, insbesondere für deren Richtigkeit, Fehlerfreiheit, Freiheit von Schutz- und Urheberrechten Dritter, Vollständigkeit und/oder Verwendbarkeit außer bei Vorsatz oder Arglist ausgeschlossen. 2 BASIC Scripting 2.1 BASIC Skript Editor Im TM-E & TM-H ist ein Skript Editor integriert, mit dem die schon sehr zahlreichen TM-E & TM-H - Funktionen nach eigenen Anforderungen und Bedürfnissen erweitert werden können. Die im TM-E & TM-H integrierte BASIC Sprache basiert auf BASIC, enthält aber noch einige TM-E & TM-H spezifische Befehle. Der Skript Editor ist in drei Funktionen unterteilt: Skripte bearbeiten : Hier wird der Code erstellt Skript Kontrolle : Hier werden zur Laufzeit Fehler oder Anwenderhinweise ausgegeben Start/Stop-Funktion : Hier wird die Skript Funktion gestartet & gestoppt 2.2 Skripte bearbeiten In diesem Menüpunkt werden die Skripte erstellt und bearbeitet. Der gesamte Code wird in Unterprogrammen (Sektionen) aufgebaut Init Section einmalige Ausführung beim Start der Module Cyclic Section zyklische Ausführung im RUN-Betrieb Sektionen Unterprogramme nach Bedarf Allgemeine Besonderheiten: Der Ablauf der einzelnen Sektionen erfolgt sequenziell (nacheinander) in einzelnen Schritten. September 15 Seite 2 von 10

3 Die Zykluszeit der Abarbeitung ist abhängig von dem Programmumfang. Besonderheit der Init Section: Es können ereignisorientierte Funktionen (ON ) gestartet werden, die nach Ablauf der Init Section im Hintergrund ständig überwacht werden. 3 Beispiel Skripte 3.1 Versand des aktuelles Wertes bei einem Ereignis Um eine zu versenden, wenn eine Variable den Zustand HIGH hat, wird dieses Skript verwendet. Dabei wird in der noch der aktuelle Wert einer Integer-Variable integriert. Wenn der Wert der Variable MyTag1 den Status von 0 nach 1 wechselt, wird eine mit dem aktuellen Wert der Variable MyTag2 versendet. 1. Erstellen Sie einen Tag für die Ereignissteuerung und nehmen folgende Einstellungen vor: Tag Name: MyTag1 Adresse: MyTag1 Typ: Digital 2. Erstellen Sie einen Tag für den Wertinhalt und nehmen folgende Einstellungen vor: Tag Name: MyTag2 Adresse: MyTag2 3. Kopieren Sie in die Init Section folgendes Skript: ONCHANGE "MyTag1", "goto _send" 4. Erstellen Sie danach eine neue Sektion namens " _Versand" und kopieren folgendes hinein: _Versand: a$ = "test@test.de" REM Hier den Betreff eintragen September 15 Seite 3 von 10

4 b$ = "Test mit Variable" REM Inhalt der bestimmen c$ = "Aktueller Wert der Variable 2: " + STR$ MyTag2@ REM Versand der If (MyTag1@ = 1) THEN Sendmail a$, "", b$, c$ 3.2 Auswerten / Anzeigen der Feldstärke über eine Variable Im TM-E & TM-H kann die Feldstärke sowie der genutzte Dienst ausgewertet werden. Abhängig von diesen beiden Parametern kann festgestellt werden, ob ausreichend Empfang für den Betrieb im Mobilfunk vorhanden ist. Die beiden Parameter für Feldstärke und Dienst werden im 10 Sekundentakt ausgelesen und bewertet. In eine Variable wird dann eine 1 geschrieben, wenn der Empfang ausreichend ist. Dabei ist zu beachten, dass bei UMTS und HSxPA eine kleinere Feldstärke als bei GSM ausreicht! 1. Erstellen Sie bitte einen Tag für den Wertinhalt und nehmen folgende Einstellungen vor: Tag Name: MyTag2 Adresse: MyTag2 2. Erstellen Sie bitte einen Tag für die Feldstärke und nehmen folgende Einstellungen vor: Tag Name: GSM_Level Server Name: TM-H SYS Adresse: GSM_Level 2. Kopieren Sie in die Init Section folgendes Skript: TSET 1, 10 ONTIMER 1, "goto Level" 3. Erstellen Sie danach eine neue Sektion namens " GSM_Level" und kopieren folgendes hinein: GSM_Level: a$= "UMTS" b$= "HSPA" REM Aktuelle Netzversion laden SETSYS INF,"load" September 15 Seite 4 von 10

5 e$ = GETSYS INF,"GsmNetRegTxt" REM pruefen ob UMTS oder HSPA genutzt wird e% = 0 a% = INSTR 1, e$, a$ If (a% > 1) Then e% = 1 b% = INSTR 1, e$, b$ If (b% > 1) Then e% = 1 REM abhaengig vom Netz wird der GSM-Level gewaehlt MyTag2@=0 If (GSM_Level@ >=5 AND e% = 1) Then MyTag2@=1 If (GSM_Level@ >=18 AND e% = 0) Then MyTag2@=1 3.3 Internetzugang über eine Variable steuern Der WAN (Internet) Zugang von TM-E & TM-H kann über eine Variable gesteuert werden. Wenn der Wert der Variable MyTag1 den Status wechselt, wird bei Wert=1 der WAN-Zugang ein und bei Wert=0 ausgeschaltet. 1. Erstellen Sie bitte einen Tag für die Ereignissteuerung und nehmen folgende Einstellungen vor: Tag Name: MyTag1 Adresse: MyTag1 Typ: Digital 2. Kopieren Sie in die Init Section folgendes Skript: Onchange "MyTag1", "goto Process_Connect" 3. Erstellen Sie danach eine neue Sektion namens "Process_Connect" und kopieren folgendes hinein: Process_Connect: IF (MyTag1@=1) THEN Setsys COM,"load" Setsys COM,"WANPermCnx","1" Setsys COM,"WANCnx","2" Setsys COM,"save" ELSE Setsys COM,"load" September 15 Seite 5 von 10

6 Setsys COM,"WANPermCnx","0" Setsys COM,"WANCnx","0" Setsys COM,"save" Setsys PRG,"PPPIP", 0 Endif Hinweis: Der Parameter WANCnx ist abhängig von der Anzahl der Modems / Schnittstellen im TM-H: 0 = Kein Internet Zugang 1 = TM-E-Geräte: Modem TM-H-Geräte: Modem 2 = TM-H-Geräte Ethernet-WAN 3.4 Fallback für ADSL auf Mobilfunk In einigen TM-H Geräten ist außer dem WAN-Anschluss auch noch ein Mobilfunkmodem zur redundanten Verbindung eingebaut. Sollte der DSL-Anschluss nicht verfügbar sein, kann das TM- H automatisch auf Mobilfunk umschalten. Um zu prüfen, ob die WAN-Verbindung aktiv ist, wird die VPN-IP-Adresse ausgelesen. Ist diese gleich , ist keine Verbindung aktiv. Diese Prüfung findet alle 900 Sekunden (15 Minuten) statt. Wenn die Fallback-Funktion aktiv ist, wird nach 7200 Sekunden (2 Stunden) wieder auf WAN zurückgeschaltet. 1. Kopieren Sie in die Init Section folgendes Skript: Tset 1,900 Ontimer 1,"goto TestVPN" Tset 2,0 Ontimer 2,"goto ReturnToWAN" 2. Erstellen Sie danach eine neue Sektion namens "Fallback" und kopieren folgendes hinein: TestVPN: Setsys INF,"load" a$ = Getsys INF,"VPNIP" If (a$=" ") THEN Tset 1,0 Tset 2,7200 Setsys COM,"load" Setsys COM,"WanCnx",1 September 15 Seite 6 von 10

7 Setsys COM,"save" Print "MODEM aktiv" Endif End ReturnToWAN: Setsys COM,"load" Setsys COM,"WanCnx",2 Setsys COM,"save" Tset 1,900 Tset 2,0 Print "Ethernet WAN aktiv" 3.5 Anzeigen ob eine VPN-Verbindung aufgebaut wurde Wenn eine VPN-Verbindung aufgebaut wurde, kann diese ausgewertet werden. Wenn der Status der VPN-Verbindung sich ändert, wird bei aufgebautem VPN eine 1 in eine Variable geschrieben, ansonsten eine Erstellen Sie bitte einen Tag für den Wertinhalt und nehmen folgende Einstellungen vor: Tag Name: MyTag1 Adresse: MyTag1 2. Kopieren Sie in die Init Section folgendes Skript: ONVPN "Goto VPN" 3. Erstellen Sie danach eine neue Sektion namens " VPN_Action" und kopieren folgendes hinein: VPN_Action: a%=getsys PRG,"EVTINFO" If (a%=1) Then MyTag1@=1 REM VPN ist aufgebaut Else MyTag1@=0 REM VPN ist abgebaut Endif September 15 Seite 7 von 10

8 3.6 Variable bitweise maskieren Um aus einer vorhandenen analogen Variable ein Bit zu selektieren, und dieses auf eine Bitvariable umzulegen, kann dieses Skript genutzt werden. Aus der Variable MyTag2 wird das dritte Bit extrahiert und der Wert in die Bitvariable MyTag1 gespeichert. 1. Erstellen Sie bitte einen Tag für den Wertinhalt und nehmen folgende Einstellungen vor: Tag Name: MyTag1 Adresse: MyTag1 Typ: Digital 2. Erstellen Sie bitte einen Tag für den Wertinhalt und nehmen folgende Einstellungen vor: Tag Name: MyTag2 Adresse: MyTag2 3. Kopieren Sie in die Cyclic Section folgendes Skript: = 3.7 Variable umrechnen Um zwei Variablen miteinander umzurechnen kann dieses Skript genutzt werden. Die Summe aus den beiden Variablen MyTag2 und MyTag3 wird in MyTag1 als Ergebnis gespeichert. 1. Erstellen Sie bitte einen Tag für das Ergebnis und nehmen folgende Einstellungen vor: Tag Name: MyTag1 Adresse: MyTag1 September 15 Seite 8 von 10

9 2. Erstellen Sie bitte einen Tag für den Wert 1 und nehmen folgende Einstellungen vor: Tag Name: MyTag2 Adresse: MyTag2 3. Erstellen Sie bitte einen Tag für den Wert 2 und nehmen folgende Einstellungen vor: Tag Name: MyTag3 Adresse: MyTag3 4. Kopieren Sie in die Cyclic Section folgendes Skript: MyTag1@ = MyTag2@ + MyTag3@ September 15 Seite 9 von 10

10 4 Revision History 4.1 Änderungen DATUM ÄNDERUNGEN BEARBEITER Erstellung Dokument Andreas Hoehn September 15 Seite 10 von 10