Benutzerhandbuch

Avisaro Datenlogger Box mit CAN-Schnittstelle

für Produkte M23133, M26833, M2C933

 

Dieses Dokument gibt einen Überblick über die Bedienung und ausgewählte Funktionen der Avisaro Datenlogger. Es bezieht sich ausschliesslich auf die genannten Produkttypen. Es gilt in der jeweils bei Produktauslieferung bzw. Update gültigen Fassung. Irrtümer und Änderungen bleiben vorbehalten.

 

 

Datum	Änderungen
15.08.2010	Umfangreiche Überarbeitung des Handbuches ohne Produktänderung

 

Das Handbuch umfasst die allgemeinen Informationen. Weiterführende Erklärungen über die allgemeine Handhabung hinaus sowie Erläuterung zur eigenen Script-Programmierung finden Sie in unserer Online-Dokumentation auf der Avisaro Internet-Seite.

 

Zum Download des Handbuches als pdf-Version klicken Sie bitte hier. Die pdf-Version kann einen älteren Stand wiedergeben.

Benutzerhandbuch Avisaro Datenlogger (DE, pdf   0,1 MB)

 

Der Avisaro Datenlogger ist eine prozessorgesteuerte Einheit zum Speichern von technischen Daten. Die Aufnahme der Daten erfolgt aktiv oder passiv über die Schnittstelle, um sie auf SD-Karte abzuspeichern. Die Anwendung wird über sogenannte Scripte gesteuert, die einmal geladen automatisch mit Betrieb des Datenloggers ausgeführt werden. Die Scripte regeln z.B.:

• das Verhalten bei Verbindungsaufnahme 
• wie und welche Daten gespeichert 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 Datenlogger 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 ließt der 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.

 

Anschluss

Zur Inbetriebnahme wird das Device über den jeweiligen Anschluss auf der Rückseite entsprechend der Anschlussspezifikation mit der Datenquelle verbunden und mit Strom versorgt (Spannung: 6 V - 32 V). Beachten Sie unbedingt die Anschlussbelegung in Kapitel 4. 

 

Damit ist das Device zur passiven Datenaufnahme einsatzbereit. Die gründe Leuchtdiode an der Gehäusevorderseite leuchtet auf.

Bedienelemente

Die Logger Box hat 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 Beschreibung der Belegung von LED und Taste finden Sie in der Dokumentation des jeweiligen Scriptes. Bei den meisten Scripten bedeutet die grüne LED - Gerät ist eingeschaltet und hat ausreichend Spannung. Die rote LED signalisiert - 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 drücken Sie die Karten leicht herein. Eine Feder schiebt sie dann heraus. In den meisten Anwendungen können die Karten ohne Schaden einfach entnommen werden. Manche Scripte verlangen jedoch, dass zuvor der Taster gedrückt wird. Einen entsprechenden Hinweis finden Sie in der Anleitung des geladenen Scriptes.

Einstellungen

 

Der Datenlogger ist mit einem Standardscript versehen und die Schnittstelle befindet sich in der Grundeinstellung gemäß Abschnitt 5. Soweit Ihre Anschlussumgebung dieser entspricht werden alle einkommenden Daten auf SD-Karte gespeichert.

 

Für Ihren gezielten Einsatz in der gewünschten Funktion sollten gegebenfalls folgende Einstellungen  angepasst werden:

• Baudrate / Format der Datenschnittstelle: In Abhängigkeit Ihrer Umgebung muss evtl. die Schnittstellenparameter angepasst werden. Siehe dazu Punkt 5-Konfiguration.
• Anwendungsskript: Für jeden Datenlogger ist das Datenloggen (Script MR1 - für RS232-Schnittstelle oder MC5 - für CAN-Schnittstelle) vorinstalliert. Wenn Sie ein anderes Skript verwenden möchten, installieren Sie diese, wie in Punkt 6-Scripte beschrieben.
• Sondereinstellungen: Über die Command-Befehle können unabhängig vom Script grundlegende Einstellungen vorgenommen werden. Die sich daraus ergebenen Möglichkeiten sind unter Wiki-FAQ auf der Internet-Seite von Avisaro beschrieben. 

Alle Einstellungen können bei diesem Gerät über eine Datei namens 'autorun.txt' auf der SD-Karte vorgenommen werden. Beim Bootvorgang wird diese Datei gelesen und ausgeführt. Sie braucht nur einmal eingelesen zu werden und kann anschliessend wieder von der SD-Karte gelöscht werden. Bei Geräten mit LAN bzw. WLAN Zugang lassen sich alle Einstellungen über eine Adminstatoren-Seite vornehmen. (siehe entsprechender Abschnitt)

 

 

Schieben Sie eine SD-Karte in den Kartenslot bis zur Einrastung ein. Damit ist der Datenlogger empfangsbereit und zeichnet all Daten gemäß Script auf.

 

LAN (nur ausgewählte Geräte)

Devices mit LAN Anschluss verfügen über eine Online-Administratoren-Seite, die über die LAN Schnittstelle erreicht werden kann. Auf dieser Seite können menü-geführt einfach alle Einstellungen des Gerätes vorgenommen sowie neue Scripte geladen werden. Dazu gehen Sie wie folgt vor:

 

Stellen Sie eine LAN Verbindung mit dem Computer her.

Öffnen Sie eine Browser und geben Sie die IP 192.168.0.75 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. Die meisten Boxen können Sie alternativ wieder in den Ursprungszustand zurücksetzen.

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.

 

Elektrische Eigenschaften

Die Versorgungsspannung hat einen Bereich von 6 V - 32 V. Fällt die Spannung unter 6 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 ab einer Stromaufnahme von 1 A auslöst. Die Sicherung kann nur von Avisaro oder einem Fachbetrieb gewechselt werden. In der Regel ist eine defekte Sicherung ein Zeichen für einen anderen grundsätzlicheren Defekt in der Stromversorgung.

Die Stromaufnahme beträgt ca. 0.5 W für Datenlogger und ca. 1 W für Geräte mit integriertem WLAN.

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.

 

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

 

Für die Logger Box mit WAGO Ausgang ist eine Adapter auf D-Sub-Stecker als Zubehör verfügbar.

 

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 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 oder Abfragen 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, die Abfrage von Daten, bedingte Steuerung etc.

Die Avisaro Logger Box und Logger Cube werden mit einem vorinstallierten Scripts ausgeliefert. In diesem 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 Loggers selber verändern. Für dieses Produkt gibt es zur Zeit folgende fertige Scripte: 

 

MC5: CAN (ASCII + Zeit)

Dieses Script speichert CAN Nachrichten mit Zeitstempel in eine Datei.   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.

   

 

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).