ewon Technical Note Nr. 008 Version 1.2

Transkript

1 ewon Technical Note Nr. 008 Version 1.2 SMS Funktionen mit ewon Übersicht 1. Thema 2. Benötigte Komponenten 3. ewon Konfiguration 3.1 ewon IP Adresse einstellen 3.2 ewon Webseite 4. Modemkonfiguration 4.1 Hinweis zur Verwendung des GSM/GPRS Modems 4.2 Pin Code Konfiguration 4.3 Eingehende PPP Verbindung 4.4 Ausgehende PPP Verbindung 4.5 Internetverbindung 5. E Mail Konfiguration 5.1 SMTP Service einstellen 6. TAG Konfiguration 6.1 Tag erstellen 6.2 Alarm per SMS einstellen 7. ewon Skript konfigurieren 7.1 Beispiel 1: Reboot des ewon Gerätes 7.2 Beispiel 2: Alarm quittieren 7.3 Beispiel 3: Anforderung eines Reports per 8. Beispiele testen 8.1 Reboot des ewon Gerätes 8.2 Alarm quittieren 8.3 Report versenden 9. Kontaktdaten /SI Seite 1 von 17

2 1. Thema In dieser Technical Note wird erklärt, wie Sie Ihr ewon Gerät, per SMS fernwarten können. Ihr ewon besitzt ein eingebautes GSM Modem und kann mit diesem SMS empfangen. Es wird Ihnen erklärt wie Sie sich mit geringem Aufwand diese Funktion zu Nutze machen, um verschiedene Aktionen auf dem ewon Gerät ausführen zu können. Gegebenenfalls können einige Einstellungen, wie IP Adresse, Subnetzmaske, Projektnamen, usw., von der gezeigten Anleitung abweichen. 2. Benötigte Komponenten: Wir werden in dieser Technical Notes nicht auf jeden Programmierbefehl eingehen können, den wir verwenden. Legen Sie sich bitte dazu das ewon Programmierhandbuch bereit, damit Sie bei Interesse nachlesen können für was, welcher Befehl zu benutzen ist. Als Hardware benötigen Sie mindestens ein ewon2001/gsm/gprs (Art.Nr.: WEW21205) und eine GSM Antenne (Art.Nr.: WEW40902). 3. ewon Konfiguration: 3.1 ewon IP Adresse einstellen Standardmäßig wird Ihr ewon Gerät mit der IP Adresse und der Subnetzmaske ausgeliefert. Im Folgenden sehen Sie, wie Sie die IP Adresse Ihres ewon Gerätes ändern. Öffnen Sie hierzu bitte das Tool ebuddy. Folgendes Fenster wird sich nun öffnen: Seite 2 von 17

3 Klicken Sie nun auf den Punkt Ändern der IP Adresse, woraufhin sich das folgende Fenster öffnet: Nun müssen Sie Ihr angeschlossenes ewon Suchen... Nachdem Sie nun Ihr ewon Gerät ausgewählt haben, klicken Sie bitte auf OK. Nun wird Ihnen noch einmal die Seriennummer Ihres Gerätes angezeigt. Seite 3 von 17

4 Im nächsten Fenster wird die, von Ihnen gewünschte IP Adresse, vergeben. Klicken Sie zum Fortsetzen auf Weiter. Sie sehen einen Fortschrittsbalken. ewon ändert nun die IP Adresse und startet dann selbstständig neu. Ist der Vorgang abgeschlossen, erscheint noch ein Bestätigungsfenster. Die Änderung der IP Adresse ist nun abgeschlossen. 3.2 ewon Webseite Da Sie nun eine Änderung der IP Adresse des ewon Gerätes vorgenommen haben, sollte nun geprüft werden, ob Sie Zugriff zu dessen Webinterface haben. Öffnen Sie hierzu einen Browser und tragen als Adresse die IP Adresse Ihres ewon Gerätes ein. Seite 4 von 17

5 Sie werden nun aufgefordert, einen Benutzername und Passwort zur Authentifizierung einzugeben. Standardmäßig ist der Benutzername und das Passwort adm. Nach einer erfolgreichen Anmeldung sehen Sie nun das Webinterface von ewon. 4. Modemkonfiguration 4.1 Hinweis zur Verwendung des GSM/GPRS Modems.1 Siemens MC35 GSM Modemkonfiguration: Wird das ewon neugestartet, kann es bis zu 2 Minuten dauern, bis das GSM/GPRS Modem im ewon gebootet und initialisiert wurde. In dieser Zeit ist natürlich keine Kommunikation über das Modem möglich. 4.2 PIN Code Konfiguration Um Kommunikation zu dem Mobilfunknetz aufnehmen zu können, muss ein PIN Code eingetragen werden. Zum Eintragen des PIN Codes begeben Sie sich bitte in das Konfigurationsmenü des Modems. Dieses finden Sie unter: Konfiguration > Systemeinstellungen > Kommunikation > Schnittstellen > Modem Nach dem Sie Ihren PIN Code eingestellt haben, starten Sie das ewon Gerät neu, damit eben dieser PIN Code übernommen wird. 2 Arten von Meldungen können nun auftreten: - Richtige Ausführung: Signal Stärke, die Netzbeschreibung und der Name Ihres Mobilfunkanbieters - Falsche Ausführung: Fehlergrund wird angezeigt Seite 5 von 17

6 Folgende Fehler könnten auftreten: Meldung SIM card error! PIN code error! In Progress Grund Die SIM Karte wurde nicht oder noch nicht in der ewon gefunden Sie haben den falschen PIN Code eingegeben Das Modem befindet sich noch im Startmodus. Warten Sie einen kleinen Moment Signalstärke (Signal level) Die Signalstärke wird jede Minute aktualisiert, sprich: Sie müssen die Seite aktualisieren um eine Veränderung des Wertes zu erkennen (es sollte ein wert zwischen 0 und 99 sein). Für eine sichere Kommunikationsverbindung sollte der Wert über 17 liegen. Ein Wert von 25 bedeutet eine gute Verbindung, ein Wert über 30 eine sehr gute Verbindung. Heimnetz (Home network) alias Roaming Wenn ewon in einem Land eingesetzt wird, aus dem auch die SIM Karte stammt, bekommen Sie bei einer Verbindung home network angezeigt. Verwenden Sie ewon in einem anderen Land, bekommen Sie Roaming angezeigt. Dies geht allerdings auch nur dann, wenn auf Ihrer SIM Karte der Roaming Service aktiviert ist (dies ist nicht mit jedem Mobilfunkanbieter möglich). Wenn alles richtig eingerichtet ist und funktioniert sieht die Modemkonfiguration wie folgt aus: 4.3 Eingehende PPP Verbindung Gehen Sie nun zu Konfiguration > Systemeinstellungen > Kommunikation > Netzwerkverbindungen > Modem. Die Eingehende PPP Verbindung ist bereits aktiviert und kann bei den Default Einstellungen belassen werden. 4.4 Ausgehende PPP Verbindung Die Ausgehende PPP Verbindung muss aktiviert werden: Seite 6 von 17

7 Danach klicken Sie auf Server 1 und tragen Ihre Verbindungsdaten ein. Hier tragen Sie die Verbindungsdaten (Einwahldaten) Ihres Internet Service Providers (z.b. T Online) ein. Zum Schluss klicken Sie auf Aktualisieren. 4.5 Internetverbindung Konfiguration > Systemeinstellungen > Kommunikation > Netzwerk Konfiguration > Internet Verbindung Im Feld Netzwerk Verbindung muss der Punkt Modem Verbindung ausgewählt werden. Seite 7 von 17

8 5. E Mail Konfiguration 5.1 SMTP Service einrichten SMTP Server Adresse: SMTP Server Port: Adresse Von : Benutzername: Passwort: Server Adresse ihres E Mail Anbieters (Postausgang) Standard 25, er muss nur in sehr seltenen Fällen geändert werden Ihre E Mail Adresse Ihr E Mail Benutzername. In den meisten Fällen ist er gleich der E Mail Adresse Ihr E Mail Passwort 6. TAG konfiguration In diesem Abschnitt wird Ihnen erklärt, wie Sie einen Beispiel Tag einrichten um die SMS Funktionen testen zu können 6.1 Tag erstellen Gehen Sie zu Konfiguration > Tag Einstellungen. Standardmäßig sind keine Tag s in dem ewon Gerät eingerichtet. Zur Erstellung des Tags klicken Sie auf die entsprechende Schaltfläche: Erstellen eines neuen Tags Es öffnet sich ein neues Fenster. Seite 8 von 17

9 In diesem Fenster sind fast alle Felder leer. Es müssen folgende Einstellungen vorgenommen werden: Identifikation / IO Server Einstellung Tag Name: Seite: Tag Beschreibung: Server Name: Topic Name: Adresse: Typ: Alarm1 Standard kann leer bleiben MEM kann leer bleiben kann leer bleiben digital Alarm Einstellungen Alarm aktivieren Digitaler Alarmwert: Haken setzen Muss auf 1 gesetzt werden Der Rest der Einstellungen kann so belassen werden Fertig ausgefüllt sieht das ganze folgendermaßen aus: Seite 9 von 17

10 Zur Bestätigung der Einstellungen und zum Hinzufügen der Alarmmeldungen aktivieren Sie bitte den Haken bei Benachrichtigung erstellen und klicken Sie auf Hinzufügen/Aktualisieren. Es öffnet sich ein neues Fenster. Siehe Kapitel Alarm per SMS einstellen In diesem Fenster können Sie nun einstellen wie Sie bei einem Alarm benachrichtigt werden möchten. Wir wählen die Funktion SMS über. Dort nehmen wir folgende Änderungen vor: SMS über ALM: SMS Empfänger: SMS Betreff: Haken setzen Ihre Handynummer,gsm,0 Den Alarmnamen, den Fehler den der Alarm auslöst und der Code mit dem der Alarm quittiert werden soll (siehe Kapitel 7.2). Zum Bestätigen klicken Sie bitte auf Aktualisieren. Seite 10 von 17

11 7. ewon Skript konfigurieren Da Sie Ihre ewon dazu bewegen möchten, sobald sie eine SMS empfängt eine Aktionen auszuführen, müssen verschieden Einstellungen im Skript der ewon vorgenommen werden. Im Skript werden Programmabläufe und Operationen programmiert, die nicht per Auswahlfenster oder Menüpunkt einzustellen sind. Im Folgenden werden die vorzunehmenden ewon Skript Einstellungen anhand von 3 Beispielen erklärt. Gehen Sie zu Konfiguration > Skript Einstellungen. Danach baut sich das unten abgebildete Bild auf. Standardmäßig sind noch keine Skripte erstellt, außer Init Section und Cyclic Section. Diese sind aber leer und es stehen keine Anweisungen darin. Für die Nutzung der SMS Dienste müssen zuerst einmal verschiedene Skripte erstellt werden. Dazu klicken Sie im Feld Skript Sektionen auf Neue Sektion und erstellen 2 Skripte. Wir nennen sie hier Sms und restart Füllen Sie nur den Skript Namen aus und klicken sie anschließend auf Aktualisieren. Nach erfolgreichem einrichten der Skripte sieht die Skript Liste folgendermaßen aus: In den folgenden Kapiteln wird nun der Quellcode gezeigt, mit dem Sie die Skripte füllen können. Seite 11 von 17

12 7.1 Beispiel 1: Reboot des ewon Gerätes In diesem Beispiel wird gezeigt, wie Sie das ewon Skript bearbeiten müssen, damit Sie per SMS einen Reboot Ihrer ewon veranlassen können. Zum Bearbeiten des Skriptes Sms wählen Sie es per Mausklick aus und gehen anschließend auf Bearbeiten. Es erscheint ein neues Fenster. Sie müssen nun folgenden Programmablauf im rechten Fenster eintragen: Sms: a%=getsys Prg,"SmsRead" If(a%<>0) Then s%=s%+1 PRINT "SMS Nr: ";s% f$=getsys Prg,"smsfrom" Print"From:";f$ Print Getsys Prg,"smsdate" a$=getsys Prg,"smsmsg" Print "Message: ";a$ b$=f$+",gsm,0" If(a$="Reboot") THEN c$="received message: "+a$ d$="reboot wird in 1 min gestartet" Sendsms b$,d$ ONTIMER 1, "goto restart" Else e$="falscher Befehl" Sendsms b$,e$ Endif Goto Sms Endif End Dies ist der Verweis zum restart Skript. Um das Skript zu aktivieren müssen Sie es mit Aktualisieren bestätigen. Wichtig: Das Skript muss auf RUN (momentan gestoppt) stehen. Ansonsten bringt die ewon eine Fehlermeldung und bittet Sie das Skript zu stoppen bevor es die Änderungen übernimmt. Seite 12 von 17

13 Nun füllen Sie noch das restart Skript. Gehen Sie dazu genauso vor wie beim Sms Skript, nur das Sie folgendes als Programmcode eingeben: restart: REBOOT Bestätigen Sie Ihre Eingabe wieder mit Klick auf Aktualisieren. Auch hier ist es wichtig, dass der Skript Modus auf RUN(momentan gestoppt) steht. Damit die ewon überhaupt weiß, dass sie auf das Sms Skript zugreifen soll, muss die Init Sektion noch abgeändert werden. Klicken Sie hierfür in der Auswahlliste der Skripte auf Init Sektion und dann auf Bearbeiten Folgende Einträge sind vorzunehmen: ONSMS Goto Sms TSET 1,60 ONSMS ist der Befehl zum starten der SMS Überwachung. TSET 1,60 ist ein Timer Befehl. Es wird der Timer 1 gestartet, der nach 60 Sekunden aktiv wird und dann das gewünschte Skript ausführt. Im Sms Skript steht dann der Befehl ONTIMER 1, Goto restart. Dieser Befehl greift auf den Timer 1 zu und führt nach 60 Sekunden Goto restart aus. D.H es dauert nach Eingang der Sms 60 Sekunden bis die ewon neu startet. Bestätigen Sie Ihre Einträge durch Klick auf Aktualisieren Gehen Sie nun zum Feld RUN(momentan gestoppt) und starten Sie die Skript Verarbeitung Ihrer ewon. Nun sind alle Einstellungen vorgenommen um das Beispiel zu testen. Siehe dazu Kapitel 8 Beispiele testen! Seite 13 von 17

14 7.2 Beispiel 2: Alarm quittieren In Kapitel 6 haben wir Ihnen gezeigt wie Sie einen Alarm Tag einrichten. Als SMS Betreff haben wir eingegeben Alarm 1. Fehler XY. Bitte bestätigen mit A1 Nun beschäftigen wir uns damit wie der Alarm mit A1 bestätit werden kann. Dazu gehen wir auch wieder in Konfiguration > Skripteinstellungen. In Kapitel 7.1 haben Sie bereits das Skript Sms erstellt. Dieses werden wir wieder verwenden, es aber abändern. Das Skript restart können Sie mit einem Klick auf Löschen entfernen. Folgenden Programmcode sollten Sie nun in Sms übertragen: Sms: a%=getsys Prg,"SmsRead" If(a%<>0) Then s%=s%+1 PRINT "SMS Nr: ";s% f$=getsys Prg,"smsfrom" Print"From:";f$ Print Getsys Prg,"smsdate" a$=getsys Prg,"smsmsg" Print "Message: ";a$ b$=f$+",gsm,0" If(a$="A1") THEN c$="received message: "+a$ d$="alarm 1 wurde quittiert" Sendsms b$,d$ ALMACK Alarm1, Else e$="falscher Befehl" Sendsms b$,e$ Endif Goto Sms Endif End Wir haben die Änderungen im Skript rot markiert. Bestätigen Sie ihre Eingabe wieder mit Aktualisieren. Da Sie im Kapitel 7.1 die Init Sektion bereits geändert haben und das auszuführende Skript nach wie vor Sms lautet müssen dort keine Änderungen vorgenommen werden. Seite 14 von 17

15 Wir werden das Beispiel in Kapitel 8.2 testen. 7.3 Beispiel 3: Anforderung eines Reports per In diesem Kapitel werden wir Ihnen zeigen, wie Sie sich per SMS einen Auszug Ihrer Event Datei als zukommen lassen. Damit können Sie überall und zu jeder Zeit sehen ob irgendwelche Fehler vorhanden sind oder wer sich in letzter Zeit Ein bzw. Ausgeloggt hat. Dazu gehen wir auch wieder in Konfiguration > Skripteinstellungen. In Kapitel 7.1 haben Sie bereits das Skript Sms erstellt. Dieses werden wir auch hier wieder verwenden, es aber abändern. Das Skript restart können Sie mit einem Klick auf Löschen entfernen. Folgenden Programmcode sollten Sie nun in Sms übertragen: Sms: a%=getsys Prg,"SmsRead" If(a%<>0) Then s%=s%+1 PRINT "SMS Nr: ";s% f$=getsys Prg,"smsfrom" Print"From:";f$ Print Getsys Prg,"smsdate" a$=getsys Prg,"smsmsg" Print "Message: ";a$ b$=f$+",gsm,0" If(a$="Report") THEN c$="received message: "+a$ d$="report wird an ihre Adresse gesendet" Sendsms b$,d$ Sendmail ", Event-Mail, &[$dtev $fth $st_d1] Else e$="falscher Befehl" Sendsms b$,e$ Endif Goto Sms Endif End Wir haben die Änderungen im Skript rot markiert. Bestätigen Sie ihre Eingabe wieder mit Aktualisieren. Da Sie im Kapitel 7.1 die Init Sektion bereits geändert haben und das auszuführende Skript nach wie vor Sms lautet müssen dort keine Änderungen vorgenommen werden. Seite 15 von 17

16 Wir werden das Beispiel in Kapitel 8.3 testen. 8. Beispiele testen Um die Beispiele testen zu können, muss sichergestellt sein das unter Konfiguration > Skript Einstellungen der Modus STOP (momentan gestartet) aktiv ist. 8.1 Reboot des ewon Gerätes Um die Rebootfunktion zu testen schicken Sie eine SMS an die Nummer ihrer GSM Karte die Sie ins ewon eingebaut haben. Diese SMS sollte folgenden Inhalt haben: Reboot Nun dauert es einen Moment. Sie bekommen einen Bestätigungs Sms mit folgendem Inhalt: Der Reboot wird in 1 Minute ausgeführt. Wie Sie leicht an den Kontrolllampen des ewon kontrollieren können, findet dieser Reboot wirklich nach ca. 1 min. statt. Der Test war erfolgreich. 8.2 Alarm quittieren Um die Alarm Quittierungs Funktion testen zu können müssen Sie zuerst einen Alarm auslösen. Gehen Sie dazu ins Hauptmenü der ewon. Unter Ansicht I/O sehen Sie Ihren eingerichteten TAG Alarm1. Um nun einen Alarm auszulösen gehen Sie auf das Feld Neuer Wert wählen die 1 aus und klicken auf Aktualisierung. Vor dem Tag Namen in diesem Fall Alarm1 erscheint eine gelbe Glocke und im Feld Wert steht nun eine 1: Setzen sie den Wert anschließend wieder auf 0 und aktualisieren Sie ihn. Wie Sie sehen bleibt das Alarmsignal bestehen und im Feld Wert steht wieder eine 0. In der Zwischenzeit haben Sie bereits eine Sms auf ihr Handy bekommen. (Die Nummer haben wir in Kapitel 6.2 eingestellt) Diese wird ungefähr so lauten: Alarm 1. Fehler XY. Bitte bestätigen mit A1,... Antworten Sie auf die SMS indem Sie A1 zurücksenden. In Ihrer ewon unter Ansicht I/O verschwindet die gelbe Glocke vor dem TAG. Sie haben den Alarm quittiert. Zur Bestätigung erhalten Sie eine SMS mit dem Inhalt: Seite 16 von 17

17 Alarm 1 quittiert. Sollte alles funktioniert haben war der Test erfolgreich. 8.3 Report versenden Um die Reportfunktion zu testen schicken Sie eine SMS an die Nummer Ihrer GSM Karte die sie ins ewon eingebaut haben. Diese SMS sollte folgenden Inhalt haben: Report Nun dauert es einen Moment. Sie bekommen einen Bestätigungs Sms mit folgendem Inhalt: Report wird an ihre Adresse gesendet. Nun können Sie Ihre E Mails kontrollieren. Nach ca. 5 min bekommen Sie eine E Mail mit Absenderadresse der ewon (Kapitel 5). Diese enthält eine Event.htm. Nach öffnen des Anhangs sehen Sie die Event Liste der ewon des letzten Tages. Der Test war erfolgreich. 9. Kontaktdaten Für weitere Fragen stehe ich Ihnen gerne zur Verfügung. Support und technische Beratung für Webserver / Gateway ewon Sascha Isinger Tel: +49 (0) 67 22/ Tel: +49 (0) 67 22/ si@wachendorff.de Mehr Details und Informationen über ewon bekommen Sie unter oder unter online.de. Seite 17 von 17