Benutzerhandbuch Script "WD1"
Daten loggen und per FTP auf Server kopieren
Dieses Dokument beschreibt das Anwendungsscript "WD1 - Daten loggen und per FTP auf Server kopieren".
Versionshistorie des Dokuments:
| Datum | Änderungen |
| 29.10.2009 | Anwendung unterstützt nun zwei Schnittstellen gleichzeitig |
| 15.09.2009 | Erstellung / Übersetzung aus dem Englischen |
|
Aktueller Stand.
|
Weiterführende Dokumente sind:
Versionshistorie des Scripts:
| Scriptname | wd1-2.txt |
| Datum | 21.04.2010 |
| Firmware |
v4.78 oder höher
|
| Historie |
v1: Neue Dokumentation
v0: Erste Version
|
Systembeschreibung
Erforderliche Hardware
Es kommt ein Avisaro 2.0 Datenlogger mit WLAN oder LAN zum Einsatz. Die Avisaro 2.0 Box, Cube und Modul kann verwendet werden. Diese Anwendung ist zunächst für RS232 oder WLAN/LAN als Datenschnittstelle ausgelegt, kann aber leicht für die CAN Schnittstelle umgeändert werden.
Erforderliche Firmware
Ein Firmware Version 4.78 oder höher ist erforderlich.
Siehe
hier für aktuelle Firmware Versionen.
Erforderliche Systemumgebung
Es kann ein üblicher FTP Server im lokalen Netzwerk oder auch im Internet verwendet werden. Die Verbindung zum FTP Server wird über FTP im "passive Mode" gemacht - damit kann das Avisaro Modul auch von einem lokalen Netz aus einen Server im Internet erreichen.
Funktionsbeschreibung
Daten loggen
Ist der Logger in Betrieb und eine Speicherkarte eingelegt, werden alle Daten die über die RS232 Verbindugn kommen in eine Datei gespeichert. Die Daten werden dabei nicht verändert - es können Text- und Binärdaten gespeichert werden. Die Datenaufzeichnung startet nach dem Einschalten selbständig.
Übertragung zum FTP Server
Die Übertragung zum FTP Server erfolgt wenn eine Speicherkarte eingelegt ist und die Aufzeichnung aktiv ist. Wurde die Aufzeichnung mit der Taste unterbrochen, dann ist auch die Übertragung zum Server deaktiviert. Die Übertragung erfolgt alle 15 Sekunden (veränderbar).
Die lokal gespeicherten Daten werden auf dem FTP Server in eine Datei "logdata.txt" kopiert. Ist diese Datei vorhanden, dann werden die neuen Daten angehängt. Nach erfolgreicher Übertragung werden die lokal gespeicherten Daten gelöscht (veränderbar).
Start & Betrieb
Script aufspielen
Die Produkte "Box" und "Cube" werden mit einem vorinstalliertem Script ausgeliefert. Entnehmen Sie der Produktbeschreibung ob dieses Script bereits für Sie passend ist. In diesem Fall ist das Produkt sofort startklar.
Das Aufspielen eines neuen Scripts ist über die Konfigurations-Webseite, über die Datenschnittstelle oder über einen SD-Slot (falls vorhanden) möglich. Siehe
hier für Details.
Script in Betrieb nehmen
Vor dem Laden des Scripts müssen die Zugangsdaten des FTP Servers im Scriptfile eingetragen werden. Das Scriptfile kann mit jedem beliebigen Text Editor verändert werden. Siehe weiter unten zum Thema "Konfiguration".
Das Script muss dann geladen werden und die automatische Ausführung aktiviert werden.
Betrieb
Der Betrieb ist vollautomatisch. Eine Benutzeraktion ist nicht notwendig.
Konfiguration
Datenschnittstelle (RS232, I2C, SPI)
Wie die Datenschnittstelle konfiguriert wird, ist in der Bedienungsanleitung des jeweilgen Produktes beschrieben. Das Script funktioniert unabhängig von der eingestellten Baudrate etc. . Typischerweise wird die Konfiguration entweder über eine Konfigurationsdatei ('autorun.txt') oder über die Webseite gemacht.
FTP Server konfigurieren
Die Zugangsdaten zum FTP Server werden in das Script fest eingetragen. Hier ist ein Beispiel für den Zugriff auf einen Test-Account von Avisaro. Öffnen Sie dazu das Script in einem Editor und betrachten Sie oberen Zeilen:
' ------------------------------------------------
' Insert here FTP Server Information let ip$ = "www.avisaro.com" let port = 21 let usr$ = "p35753187-public" let pass$ = "avisaro!!" ' ------------------------------------------------
Ändern Sie die Zeilen "let ..." wie gewünscht.
Erklärung der Zeilen:
ip$ ist die Adresse des FTP Servers
port ist die Portnummer des FTP Servers, 21 ist standard
usr$ ist der Benutzername
pass$ ist das passende Passwort
Das Script läßt sich übrigens verschleiern - so ist ein Auslesen der Zugangsdaten nicht möglich bzw sehr erschwert. Kontaktieren Sie den Support von Avisaro für weitere Hinweise dazu.
Benutzerschnittstelle
Bedienelemente
Die Logger Box und Cube haben eine rote und eine grüne Leuchtdiode (LED) zur Anzeige von Betriebszuständen, sowie einen Taster zur Benutzereingabe.
Grüne LED:
Allgemeine Betriebsbereitschaft. Wärend der Übertragung zum FTP Server erlischt die grüne LED
Rote LED:
Die Aufzeichnung ist aktiv. Kommen Daten auf der RS232 Schnittstelle, dann blinkt die LED.
Taster:
Die Aufzeichnung wird beendet bis zum erneuten Drücken des Tasters oder bis zum Einstecken einer neuen SD Karte
Gegenstellen (PC, iPhone, Avisaro)
Windows PC: FTP Server
Als Gegenstelle zum Avisaro WLAN Device kann auf einem PC FTP Server installiert werden. Dazu gibt es einige frei verfügbare Server im Internet. Einer der bekanntesten ist der "FileZilla" Server. Dies ist ein leicht zu installierender FTP Server.
Mehr Informationen beim FileZilla Projekt: http://filezilla-project.org/
Handheld: iPhone, iPad
Für die Apple Produkte iPhone und iPad gibt es FTP Server als "App". Ein Beispiel ist das kostenpflichtige Programm "FTP to Go". Dies erlaubt den Upload von Date vom Avisaro Gerät auf das Pad. Bei dieser Anwendung muss die Option "Enable FTP Server" aktiviert werden und dann der Anleitung folgen.
(Diese Funktion ist 'experimental')
Avisaro WLAN Device
Als Gegenstelle kann ein anderes Avisaro WLAN / LAN Logger Device dienen. Bei diesem wird die Option "FTP Server" aktiviert. Bei eingelegter Speicherkarte kann dann eine Logdatei von einem Logger auf den anderen übertragen werden.
Optionen und Anpassungen
Anpassungen
Das Verhalten durch leicht anpassbare Scripte gesteuert. Diese können Sie selbst anpassen oder durch uns anpassen lassen. Veränderungen könnten sein:
- FTP Upload in Zeitabständen, zu einer Uhrzeit, Dateigröße oder externen Trigger
- FTP Übertragung wenn WLAN verfügbar ist (z.B. Fahrzeug auf Parkplatz)
- Daten beim Speichern formatieren: Zeitstempel, Datenfilter, ...
- Daten werden in immer neue Dateien gespeichert, bleiben lokal dauerhaft gespeichert, Ringspeicher, ...
- Dateinamen, Unterverzeichnisse, etc.. können angelegt werden
- Zusätzliche FTP commandos ("dir", ... mehr)
- Verschlüsselungen etc.