Benutzerhandbuch

Avisaro WLAN Logger Box mit CAN-Schnittstelle

für Produkte C23133, C26833

 

Dieses Dokument gibt einen Überblick über die Bedienung und Funktionen der Avisaro WLAN Logger. Wir empfehlen diese Online-Version zu benutzen, um immer die aktuellsten Informationen zu haben. Alternativ steht eine PDF Version zum Download bereit.

 

Datum	Änderungen
01.02.2010	Vollständige Überarbeitung

Zum Download der pdf-Version klicken Sie bitte hier:

Benutzerhandbuch Avisaro Datenlogger (DE, pdf 1 MB)

Der Avisaro WLAN Datenlogger  ist eine prozessorgesteuerte Einheit zum Mitschreiben und Übertragen von technischen Daten. Die Aufnahme der Daten erfolgt aktiv oder passiv über die Schnittstelle, um sie auf SD-Karte abzuspeichern. Die Informationen können gleichzeitig oder zeitversetzt per WLAN an ein Netzwerk übertragen werden. Die Anwendung wird über sogenannte Scripte gesteuert, die einmal geladen automatisch mit Betrieb des WLAN Loggers ausgeführt werden. Die Scripte regeln z.B.:

• das Verhalten bei Verbindungsaufnahme 
• wie und welche Daten gespeichert werden
• wann und welche Daten übertragen werden
• das Absenden von Kommandos oder Informationen über die Schnittstelle
• echte kleine Anwendungen sind möglich, wie z.B. ein Sensor wird aktiv ausgelesen oder beim Überschreiten von Schwellwerten wird eine Aktion ausgeführt

 

Scripte sind einfache in Basic geschriebene Programme, die entweder fertig für Standardanwendungen von der Avisaro Homepage geladen oder vom Anwender selber verändert bzw. neu geschrieben werden können. Eine Erläuterung finden Sie weiter unten in diesem Handbuch bzw. ausführlich in der Online-Dokumentation. Die WLAN Logger Box und der Cube sind serienmäßig bei Auslieferung bereits mit einem Script zur Abspeicherung von Daten versehen und betriebsbereit.

 

Zur Änderung der Konfiguration oder der Scripte verfügt der WLAN Logger über eine Web-Adminstrationsseite. Hierüber können einfach alle Einstellungen verändert werden. Außerdem ließt der WLAN Datenlogger bei beim Bootvorgang eine autorun.txt-Datei ein, sofern sich diese auf einer SD-Karte im Speicherslot befindet und nimmt darüber Befehle auf. Diese werden langfristig abgespeichert. Alternativ dazu können Steuerungs- und Konfigurationsbefehle über die Schnittstelle eingegeben werden, solange die Box kein Script ausführt.

 

Im Gegensatz zum PC benötigen Avisaro Devices fast keine Bootzeit. Im Automatikbetrieb wird das Script mit Stromzufuhr eigenständig gestartet und führt alle Abläufe voll automatisch aus.

 

Bedienelemente

Die Logger Box haben eine rote und eine grüne Leuchtdiode (LED) zur Anzeige von Betriebszuständen, sowie einen Taster zur Benutzereingabe.

Die Funktion der LEDs und des Taster wird durch das jeweils geladene Script bestimmt. Ist kein Script geladen oder ist die Ausführung des Scripts abgeschaltet, dann leuchtet auch keine LED auf. Eine passende Beschreibung finden Sie in der jeweiligen Dokumentation des Scriptes. Bei den meisten Scripten bedeutet die grüne LED - Gerät ist eingeschaltet und hat ausreichend Spannung und die rote LED - Logger bereit zum Aufzeichnen bzw. zeichnet auf.

Speicherkarten

Es können Speicherkarten vom Typ "SD" und "SDHC" verwendet werden. Die Logger sind für Karten bis 16 GByte getestet. Es können Karten von beliebigen Herstellern verwendet werden. Beachten Sie jedoch, dass die Qualität von 'Billigkarten' für industriellen Einsatz häufig nicht ausreicht. Bewährt haben sich Karten von SunDisk. Besondere "High-Speed" oder "Extreme" Karten funktionieren, haben jedoch keinen Vorteil im Avisaro Logger.

Die Karten werden eingesteckt bis ein Einrasten zu spüren ist. Zum Herausnehmen werden die Karten leicht hereingedrückt und werden dann durch eine Feder herausgedrückt. In den meisten Anwendungen können die Karten ohne Schaden einfach entnommen werden. Manche Anwendungen verlangen jedoch, dass zuvor der Taster gedrückt wird.

Inbetriebnahme

Zur Inbetriebnahme werden die Datenlogger über die jeweilige Schnittstelle mit der Datenquelle verbunden und mit Strom versorgt (Spannung: 6 V - 32 V). Damit ist der Datenlogger zur passiven Datenaufnahme einsatzbereit. Die gründe Leuchtdiode an der Gehäusevorderseite leuchtet auf. Für eine aktive Datenabfrage muss vorher ein entsprechendes Script geladen werden.

 

Für Ihren gezielten Einsatz in der gewünschen Funktion können typischerweise ggfs. folgende Einstellungen  angepasst werden:

• Anwendungsskript: Für jeden Datenlogger ist das Datenloggen (Script MR1 - für RS232-Schnittstelle oder MC5 - für CAN-Schnittstelle) vorinstalliert. Wenn Sie eines der anderen Skripte verwenden möchten, müssen die dieses installieren. Siehe dazu Punkt 6-Scripte
• Baudrate / Format der Datenschnittstelle: Die Änderung der Einstellung erfolgt über eine autorun.txt-Datei auf der SD-Karte oder über die Schnittstelle. Siehe dazu Punkt 8-Konfiguration

Zu beachten ist folgendes:

• Versorgungsspannung muss im erlaubten Bereich liegen
• Die Box darf nicht der Feuchtigkeit ausgesetzt werden
• Der Avisaro Datenlogger verträgt Temperaturen zwischen -30 und + 85 C
• Bei längerer, intensiver Sonneneinstrahlung kann sich das Gehäuse der Box leicht verfärben

 

Schieben Sie eine SD-Karte in den Kartenslot an der Vorderseite bis zur Einrastung ein. Damit ist der Datenlogger empfangsbereit. In dem Standardscript wartet der Datenlogger auf die Übertragung aus der Datenquelle. In Punkt 6 bzw. 7 finden Sie Erläuterungen wie Sie ein anderes Script laden bzw. selber schreiben können.

Wartung

Die Avisaro Datenlogger sind für wartungsarmen Betrieb ausgelegt. 

Lagerung

Die Box verfügen über einen Pufferakku damit die interne Echtzeituhr und Datum erhalten bleiben auch wenn der Logger nicht im Betrieb ist. Dieser Pufferakku hält ca. einen Monat.  Bei längerer Lagerung muss die Uhrzeit neu gestellt werden und der Datenlogger über 48 h mit Spannung versorgt werden damit der Pufferakku wieder voll geladen wird.

Reinigung

In staubiger Umgebung kann der SD Kartenslot verschmutzen. Eine Reinigung ist mit Druckluft möglich. Geignet ist z.B. "Druckluft" Dose von Contact Chemie. Verwenden Sie auf keinen Fall ölhaltige Druckluft aus Druckluftsystemen.

Echtzeituhr

Die Avisaro Box und der Avisaro Cube verfügen über eine gepufferte Echtzeituhr. Datum und Uhrzeit werden so z.B. für Dateinamen, Zeitstempel und andere Funktionen richtig verwendet. Über das Script oder Kommando kann auf die aktuelle Zeit zugegriffen werden. 

Die Echtzeituhr wird intern durch einen Akku gespeist. Dieser Akku hält ca. 1 Monate ohne externe Versorgung. Liegt eine Versorungsspannung an der Box an, wird der Akku innerhalb von 48 h wieder geladen.

Die Uhr ist im Auslieferungszustand gestellt (Zeitzone: Berlin). Die Uhr kann über die Konfiguration (siehe Punkt 8) geändert werden. Die Ganggenauigkeit beträgt ein paar Minuten pro Jahr. Sommer / Winterzeit Umstellung wird nicht unterstützt.

 

WLAN

Dieses Avisaro Device ist mit einer WLAN-Funktion ausgestattet.

 

Die Parameter für die WLAN-Schnittstelle sind die Folgenden.

 

Typ: 802.11 b/g

Sicherheit: WEP + WPA

Reichweite: ca. 300m (Outdoor)

 

SSID: avisaro

Channel: 11

Mode: adhoc

Encryption: none

 

Zur Konfiguration: Öffnen Sie eine Browser und geben Sie die IP 192.168.0.74 ein. Dann loggen Sie sich mit Benutzernamen und Passwort ein. Wenn Sie es noch nicht geändert haben, sind es der Benutzername: 'admin' und das Initialpasswort: '1234'. Zu Ihrem Schutz sollten Sie es aber umgehend ändern und sich gut merken. Achtung: Es gibt keine Hintertür bei verlorenen Passwörtern. Dann müssen Sie sich direkt an Avisaro wenden.

Elektrische Eigenschaften

Die Versorgungsspannung hat einen Bereich von 6 V - 32 V.

Fällt die Spannung unter 5 V ist eine sichere Funktion nicht gewährleistet. Die Box macht bei Unterspannung automatisch einen Neustart ("Bown-Out"). Bei Spannungen über 32 V kann der Logger dauerhaft beschädigt werden.

Der Eingang für die Versorgungsspannung ist mit einem Verpolungsschutz versehen - wird Masse und VCC versehentlich vertauscht nimmt der Logger keinen Schaden, funktioniert aber auch nicht.

Der Logger verfügt intern über eine Schmelzsicherung die bei einer Stromaufnahme von 1 A auslöst. Die Sicherung kann nur von Avisaro oder einem Fachbetrieb gewechselt werden. Meistens ist eine defekt Sicherung ein Zeichen für andere Defekte.

Die Stromaufnahme beträgt ca. 1.0 W.

Mechanische Daten:

Abmessungen: 51 x 72 x 24 mm
Gewicht: 110 g
Schutzklasse: keine

Temperatur: -30°C bis 85°C, sofern der Hersteller der verwendeten SD-Karte keine einschränkende Vorgabe macht.

 

WLAN Netzwerke

Es werden WLAN Netzwerke mit zentralem Access Punkt ("Infrastruktur") und mit direkter Kommunikation ("Adhoc") unterstützt. Diese grundsätzlichen Netzwerk Topologien werden durch besondere Funktionen erweitert:

1.) Infrastruktur Netzwerk mit Access Punkt:

Großflächige WLAN Netzwerke werden mit mehreren Access Punkten aufgespannt. Avisaro WLAN Geräte können sich - wie üblich - mit dem "nächstbesten" Zugangspunkt verbinden. Es kann aber auch ganz gezielt festgelegt werden, mit welchem AP sich das Avisaro Device verbinden soll ( Details).

2.) Adhoc Netzwerk:

Bei einem Adhoc Netzwerk bestimmt das Modul, dass am ersten eingeschaltet wird, bestimmte Netzwerkparameter. Bei größeren Distanzen, sich bewegenden, oder vielen Teilnehmern kann das jedoch dazu führen, dass ein Adhoc Netzwerk in zwei getrennte Netzwerk zerfällt. Avisaro WLAN Devices verfügen über einen besonderen Modus, der dies verhindert ( Details).

Zuverlässigkeit:

MTBF: 4500000 h
SD Slot: 10000 Zyklen (Insert/Extract)
Vibration: 6g, 20-2000 Hz

 

 

Die Box wird mit verschiedenen Anschlusstypen ausgeliefert. Es kommen entweder eine D-Sub Buchse für Daten und ein Hohlstecker für Spannungsversorgung, eine bzw zwei WAGO Steckkontakte oder eine RJ45 für das Ethernet zum Einsatz.

 

Die Steckerbelegung ist wie folgt:

Standard SubD-9 connector (male)

Barrel connector

The barrel connector is layouted as follows. Supply voltage is 6 - 32 V. '

Diameter of the connector is 2.1mm.

Outside : Ground

WAGO Connector

 

Standardeinstellung der Schnittstelle (CAN)

Die Standardparameter der CAN Schnittstelle sind wie folgt:

Baudrate: 125 kbits/s

CAN ID: 49 (hex, für Avisaro Kommandos/Meldungen)

Filter: offen (alle CAN Nachrichten werden gespeichert / gesendet)

 

Konfiguration der Schnittstelle über WEB-Administratorseite

Am einfachsten stellen Sie die Schnittstelle bei allen WLAN/LAN-fähigen Avisaro Devices mittels der Administratorseite um. Folgen Sie diesen Schritten:

 

1. Öffnen Sie den Browser, wählen Sie die IP Ihres Avisaro Devices an und loggen Sie sich ein.

2. Gehen Sie unter Data Interface in dem Menü auf Ihre Schnittstelle.

3. Passen Sie die Parameter an die Bedürfnisse der Umgebung an. Schließen Sie mit 'submit' wieder ab.

4. Rebooten Sie das Device entweder durch Stromunterbrechung oder unter Generals der Button 'Reboot'

 

Konfiguration der Schnittstelle per Konfigurations-Datei auf SD-Karte (autorun.txt)

Zur einfachen Konfiguration werden alle Einstellungen in eine gewöhnliche Textdatei mit dem Namen "autorun.txt" geschrieben.

Beispiel zur Konfiguration der CAN-Schnittstelle

prot can
CAN 125000 1fe 0 2ff 1
load mc5-4.txt
run auto

Beachte: Wichtig ist, dass die letzte Zeile mit Betätigung der 'Enter'-Taste abgeschlossen wird. Dieses Beispiel setzt die Datenschnittstelle auf CAN fest und stellt die Schnittstellenparameter ein.

Details:

prot: wählt die Schnittstelle aus ( Details)

can: legt die Parameter der Schnittstelle fest ( Details)

load: läd ein Script ( Details)

run: konfiguriert, wann wie das Script gestartet werden soll ( Details)

 

In diesem Beispiel wird das Script 'mc5-4.txt' geladen (dieses muss sich ebenfalls auf der SD Karte befinden). Abschließend wird das Script auf 'automatisches Ausführen nach dem Start' gestellt.

 

Fast alle Einstellungen werden intern im Flash gespeichert - die Autorun.txt muss also nur einmal ausgeführt werden und kann dann vom Datenträger gelöscht werden. So funktioniert es:

1. autorun.txt Datei erzeugen und auf Speicherkarte speichern
2. Avisaro Logger ausschalten und Speicherkarte einlegen
3. Avisaro Logger einschalten und ca. 10 Sekunden warten. In dieser Zeit werden die Befehle in der autorun.txt Datei abgearbeitet
4. Avisaro Logger ausschalten und autorun.txt von Datenträger löschen
5. Nach einem Neustart ist die Einstellung aktiv

 

Konfiguration der Schnittstelle über die Schnittstelle selber

Diese Methode setzt einen sendefähige Verbindung über die bisherige Konfiguration der Schnittstelle und noch kein aktives Script voraus. Dieses Vorgehen ist nur in Ausnahmefällen, z.B. dem automatisierten Einstellen des Device ratsam.

Sie können dann dem Device in einer Folge von Befehlen Anweisungen zur Einstellung der Schnittstelle geben.

 

Beispiel:

PROT CAN

CAN 500000 49 0 49 0

 

Die Umstellung wird erst nach einem Reboot aktiv.

Sie können im gleichen Vorgang auch das Script laden. Beschreibung siehe unter Scripting.

 

Die eigentliche Funktion - das Aufzeichnen von Daten - wird durch Anwendungsscripte definiert.

Die Anwendungsprogramme oder Scripte sind kleine Programme, geschrieben in der Programmiersprache BASIC. Durch diese Scripte wird das Verhalten der Logger festgelegt - also wie die Daten formatiert werden, ob Zeitstempel gesetzt werden und so weiter.

Die Avisaro Logger Box und Logger Cube werden mit einem vorinstallierten Scripts ausgeliefert. In dem Fall des Avisaro Datenloggers mit CAN-Schnittstelle ist es das Script MC5: Loggen von Daten in eine CSV-Datei in ASCII mit Zeitstempel. Diese kann durch ein anderes bereits durch Avisaro verfügbares Script oder durch eigene programmierte Scripts ersetzt werden.

Es gibt eine Reihe von fertigen Scripten, die auf der Avisaro Homepage veröffentlicht sind und zum Download bereitstehen. Damit können Sie die Funktionsweise Ihres Avisaro Device selber verändern. Für dieses Produkt gibt es zur Zeit folgende Scripts: 

 

MC5: CAN (ASCII + Zeit)

Dieses Script speichert CAN Nachrichten mit Zeitstempel in eine Datei.  mehr

MC6: Vector CANalyzer

Dieses Script speichert CAN Nachrichten passend zur Weiterverarbeitung in CANalyzer von Vector 
 mehr

MR 51: RS485 Bus loggen

Dieses Script speichert Nachrichten von bis zu zwei RS485 Schnittstellen in je eine Datei auf SD-Karte  mehr

Laden von Scripten

Die "Box" und "Cube" Logger werden mit einem vorinstallierten Script ausgeliefert. Dies kann direkt so verwendet werden, oder durch ein anderes ersetzt werden. Zum Laden eines neuen Scriptes stehen mehrere Möglichkeiten zur Verfügung:

- Über eine 'autorun.txt' Datei auf der SD-Karte

- Über die Datenschnittstelle bei deaktiviertem Script

- bei Datenlogger mit Netzwerkschnittstelle: zusätzlich über die Webseite

 

1.) Laden eines Scripts von der SD-Karte (mit der Autorun.txt Datei)

 

Befindet sich eine Datei mit dem Namen autorun.txt beim Einschalten des Loggers auf der Speicherkarte, dann werden alle Kommandos in dieser Datei ausgeführt. Eine Übersicht aller Befehle finden Sie online im Avisaro Wiki ( hier).

 

Laden Sie das neue Script von der Avisaro Webpage herunter und speichern Sie es auf die SD-Karte. Das Script hat das Format .txt.

 

Zum Laden eines neuen Scriptes in den Avisaro müssen Sie mit einem einfachen Text-Editor eine Datei mit dem Namen autorun.txt anlegen. Dazu schreiben Sie in die Datei den Befehl "load <dateiname>"  ( details) und drücken dann die Enter-Taste. Achten Sie darauf, dass der Dateiname und Endung exakt identisch ist mit dem Namen unter dem das Script auf der SD-Karte gespeichert ist. 

Mit einem in der nächsten Zeile folgenden Befehl "run" wird das Script sofort einmalig ausgeführt. Mit dem Befehl "run auto" startet das Script ab der nächsten Stromunterbrechung jedesmal automatisch (zu empfehlen) bei jeder Nutzung des Loggers. Sie können auch beide run-Befehle nach einander verwenden.

Drücken Sie nach jeder Befehlszeile (auch nach der letzten!) die Enter-Taste.

 

Speichern Sie die Datei unter autorun.txt ebenfalls (zusammen mit dem Script) auf die SD-Karte. Beispiel für den Inhalt der autorun.txt:

load wr1-7.txt
run auto
run

Hinweis: Die Dateinamen bestehen aus höchstens höchstens 8 Zeichen und maximal 3 Zeichen Endung. Jede Zeile (auch die letzte) muß mit Drücken der 'Enter'-Taste abgeschlossen werden.

 

Schieben Sie die SD-Karte mit den beiden Dateien in den Logger. Beim Einschalten wird das Script geladen und dauerhaft im Flash gespeichert. D.h. die Dateien können danach wieder von der Speicherkarte gelöscht werden und brauchen nicht jedes Mal mitgegeben zu werden.

 

Nun sind das Script und der Startbefehl geladen. Bei ausschliesslicher Verwendung des Befehles 'run' müssen Sie von nun an den Avisaro Logger eingeschaltet lassen, das Script wird unmittelbar ausgeführt. Bei alleiniger Verwendung von 'run auto' ist es notwendig noch einmal den Avisaro aus und wieder anzuschalten, damit das Script tatsächlich gestartet wird.

 

 

2.) Laden von Scripten über die Datenschnittstelle / Kommandoschnittstelle

 

Über die RS232 oder CAN Schnittstelle kann ebenfalls ein Script geladen werden. Ist bereits ein Script aktiv, dann muss dieses zunächst beendet werden, da sonst die Kommando-Schnittstelle nicht aktiv ist (alle Eingaben würden vom Script verarbeitet und nicht als Befehl interpretiert).

 

Das laufende Script beenden Sie mittels einer 'autorun.txt' auf der SD-Karte. Dazu schalten Sie den Strom aus und legen eine SD-Karte mit einer autorun.txt ein, die Sie mit einem einfachen Text-Editor schreiben können.

Der Inhalt der autorun.txt lautet:

run manual

Hinweis: Die Zeile muß mit drücken der 'Enter'-Taste abgeschlossen werden.

 

Anschliessend schalten Sie den Strom ein, damit die Datei geladen wird. Sie können dann die SD-Karte wieder entnehmen. Jetzt müssen Sie zum Neustart einmal den Strom aus und wieder einschalten. Damit startet der Datenlogger ohne ein Script auszuführen (die LEDs leuchten nun nicht mehr).

Nun können Sie über die Schnittstelle Befehle an den Datenlogger senden. Die Befehle sind identisch zu denen, die im oberen Abschnitt in der autorun.txt verwendet wurden.

   

3.) Laden von Scripten über die Webpage per WLAN/LAN

 

Öffnen Sie eine Browser und geben Sie die IP 192.168.0.74 ein. Dann loggen Sie sich mit Benutzernamen und Passwort ein. Wenn Sie es noch nicht geändert haben, sind es der Benutzername: 'admin' und das Initialpasswort: '1234'. Zu Ihrem Schutz sollten Sie es aber umgehend ändern und sich gut merken. Achtung: Es gibt keine Hintertür bei verlorenen Passwörtern. Dann müssen Sie sich direkt an Avisaro wenden. Über den Menuepunkt 'Setting Script' können Sie das Script ändern:

 

Upload new script:

Wählen Sie die Script-Datei aus und klicken Sie auf 'send file'

Run script on start-up:

No: Script startet nicht automatisch, wenn das Device angeschaltet wird.

Asynchronous: Script startet automatisch, wenn das Device angeschaltet wird.
Exclusive: Script startet ausschliesslich - nur für Experten.

Currently running

Markiert: Script läuft.

Nicht markiert: Script läuft nicht. 

Um das Script manuell zu starten oder stoppen, markieren oder löschen Sie entsprechend das Kontrollkästchen und klicken dann auf das 'submit'-Feld. Hinweis: Betätigen Sie anschliessend den 'Refresh'-Button um sicher zu gehen, dass die Änderung durchgeführt wurde.

3 x 2 Tabelle

Diese Tabelle kann für eigene geschriebene Scripte verwendet werden, um Daten anzuzeigen oder abzufragen. Für Hinweise zur Ansteuerung dieser Tabelle siehen Sie den Abschnitt 'Scripting' auf der Avisaro Webseite.

 

Grundsätzliches

Scripte sind in der Programmiersprache BASIC geschrieben. Die Scripte sind einfache Text-Dateien, die mit jedem Editor betrachtet und geändert werden können. Das fertige Script wird dann einmal in den Avisaro geladen und bleibt dort gespeichert - auch wenn der Strom ausgeschaltet wird. Typischerweise ist der Avisaro so konfiguriert, dass das Script beim Power-Up automatisch ausgeführt wird (mit dem oben genannten Befehl "run auto"). So lassen sich alle Abläufe voll automatisieren.  

Scripte schreiben / Weiterführende Dokumentation

Ein komplettes Script mit dokumentiertem Source Code ist in der Anleitung zum Script "MR3" zu finden ( Details).

 

Weitere Anleitungen und die Auflistung aller Befehle finden Sie auf der Webpage unter Menu-Punkt 'Wiki'( Details).

 

Für den Betrieb an einer programmierbaren Einheit ("Mikrocontroller" oder "SPS") stehen leistungsfähige Befehle zur Verfügung. Damit kann ein externer Mikrocontroller über einen einfachen, aber mächtigen Befehlssatz das Avisaro Produkt steuern: Dateien öffnen, Daten lesen und schreiben, TCP/IP Verbindungen bedienen, etc. Zur Nutzung der Kommando-Schnittstelle darf kein Script ausgeführt werden.

 

Die API-Programmierschnittstelle setzt entsprechendes Grundlagenwissen voraus. Eine ausführliche Beschreibung der Befehle finden Sie im Avisaro Wiki ( Details).