Daten von einer RS232 Schnittstelle in eine Datei loggen

Dieses Dokument beschreibt das Anwendungsscript "MR1 - Daten in Datei loggen".

Versionshistorie des Dokuments:

Weiterführende Dokumente sind:

Versionshistorie des Scripts: 

Erforderliche Hardware

Es kommt ein Avisaro 2.0 Datenlogger zum Einsatz. Die Avisaro 2.0 Box, Cube und Modul kann verwendet werden. Diese Anwendung ist für Logger mit RS232, I2C (Client) oder SPI (Client) anwendbar.

Eine WLAN oder LAN Schnittstelle ist nicht erforderlich, bringt aber zusätzlichen Nutzen.

Erforderliche Firmware

Ein Firmware Version 4.41 oder höher ist erforderlich.

Siehe  hier für aktuelle Firmware Versionen.

Erforderliche Systemumgebung

Zum Loggen von Daten ist eine Speicherkarte notwendig. Zum Auslesen der Daten an einem PC ist jedes Kartenlesegerät geeignet. Viele Notebooks haben diesen bereits fest eingebaut. Über sogenannten "All-in-One" Reader läßt sich diese leicht an jedem PC oder MAC nachrüsten.

Daten loggen

Ist der Logger in Betrieb und eine Speicherkarte eingelegt, werden alle Daten die über die Schnittstelle (RS232, I2C oder SPI) an den Logger gesendet werden 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.

Es werden keine Zeitstempel etc. hinzugefügt. Diese oder ähnliche Formatierungen können aber leicht hinzugefügt werden.

Es werden alle Daten in einer Datei mit dem Namen "log-1.txt" bzw "log-2.txt" abgelegt. Ist diese Datei vorhanden, so werden neue Daten angehängt. Hat die Datei ihre maximale Größe erreicht (2GB), dann stoppt die Aufzeichnung.

Lesen der Daten an einem PC oder MAC

Zum Lesen der Daten wird die Speicherkarte entnommen und in den SD Kartenleser des PC gesteckt. Die Datei "logdata.txt" kann dort mit einem geeigneten Programm geöffnet werden. Welches Programm geeignet ist, hängt von der Art der geloggten Daten ab. Sind Text (ASCII) Daten aufgezeichnet worden - z.B. die Ausgaben einer Waage - dann kann die Datei durch doppelklick im "Editor" angesehen werden. Wurden Daten im binärformat gespeichert, so können die Daten mit einem HEX-Editor gesichtet werden.

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.

Zum Aufspielen eines neuen Scripts gehen Sie wie folgt vor:

1. Laden Sie Script Datei und die 'autorun.txt' Datei von der Webseite herunter
2. Kopieren Sie die Dateien auf eine Speicherkarte
3. Legen Sie die Speicherkarte in das Avisaro Produkte und schalten die Versorgungsspannung ein
4. Warten Sie kurz (5 Sekunden)
5. Schalten Sie die Versorgungsspannung aus und entnehmen die Speicherkarte
6. Löschen Sie die beiden Dateien wieder von der Speicherkarte

Alternative kann das Aufspielen eines Scripts über SD Karte (Details), Webseite (Details) oder die Datenschnittstelle (Details) erfolgen. 

System in Betrieb nehmen

Die Inbetriebnahme des Produktes ist in der jeweiligen Produkt - Dokumentation beschrieben. In der Regel muss lediglich das Datenkabel und Stromkabel eingesteckt werden. Ggf. die Schnittstelle (Baudrate, ...) und wenn vorhanden, das WLAN/LAN Interface konfigurieren. Das Script startet nach dem Einschalten automatisch.

Betrieb

Das System arbeitet komplett selbständig. Es ist keine fortlaufende Bedienung durch den Benutzer notwendig.

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.

Option: "Alles in eine Datei" oder "jeden Tag eine neue Datei"

Das Script kann so konfiguriert werden, dass entweder alle Daten in eine Datei geschrieben werden, oder jeden Tag eine neue Datei erzeugt wird. 

1. Alles in eine Datei: Auf der SD Karte wird eine Datei mit dem Namen "log-1.txt" erzeugt. In diese Datei werden alle Daten geschrieben. Sind beide RS232 Schnittstellen aktiviert, dann wird eine zweite Datei mit "log-2.txt" angelegt.
2. Jeden Tag eine neue Datei: Es wird ein Ordner Namens "logs" auf der SD Karte erzeugt. In diesen Ordner werden Dateien mit dem Namen "yymmtt-1.txt" erzeugt und dort die Daten gespeichert. Jeweils um Mitternacht wird automatisch eine neue Datei erzeugt. Sind beide RS232 Schnittstelle aktiviert, dann wird eine weitere Datei mit dem Namen "yymmtt-2.txt" erzeugt. Der Grund für den Ordner "logs" ist, dass so beliebig viele Dateien gespeichert werden können - im Wurzelverzeichnis wären nur 250 Dateien erlaubt.

Diese Option kann im Script geändert werden. Öffnen Sie dazu das Script in einem Editor und betrachten Sie oberen Zeilen:

' ------------------------------------------------
' Every Day a new File (1= yes, 0 = no) ?

let new_file = 1

' ------------------------------------------------

Ändern Sie die Zeile "let ..." wie gewünscht.

Option: 1 oder 2 serielle Schnittstellen

Das Script kann so konfiguriert werden, dass entweder eine oder zwei serielle Schnittstellen unterstützt werden. Es wird pro serielle Schnittstelle eine Datei mit jeweils "*-1.txt" oder "*-2.txt" erzeugt. 

Diese Option kann im Script geändert werden. Öffnen Sie dazu das Script in einem Editor und betrachten Sie oberen Zeilen:

' ------------------------------------------------
' One or two RS232 Ports (1, 2) ?

let ports = 1

' ------------------------------------------------

Ändern Sie die Zeile "let ..." wie gewünscht.

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:

Dauerlicht: Logger hat Betriebsspannung

Rote LED:

Logger ist bereit zum Aufzeichnen von Daten. Eintreffende Daten werden durch ein Blinken angezeigt.

Taster:

Die Aufzeichnung wird gestoppt (rote LED aus) bzw wieder gestartet (rote LED an)

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. Besondere "High-Speed" oder "Extreme" Karten haben bei den Avisaro Produkten keinen Vorteil.

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.

WLAN / LAN Option

Verfügt das Avisaro Produkt über einen WLAN oder LAN Anschluss, dann können die geloggten Daten per FTP angerufen werden. Dazu kann der normale 'Explorer' verwendet werden oder auch ein spezieller FTP Client ( Details). 

Mögliche Anpassungen

Das Verhalten des Scripts kann leicht verändert werden. Möglich Anpassungen sind z.B.:

• Aufspalten der Logdatei: Statt einer Datei wird täglich mit einer neuen Datei begonnen (beim MR3 (Ringspeicher) wird dies bereits gemacht)
• Aktives Abfragen eines Sensors: der Avisaro Logger kann Befehlssequenzen aussenden um eine angeschlossene Anlage abzufragen
• Daten quittieren: Empfangene Daten können dem System durch eine Kennung quittiert werden
• Keine Startmeldung: Die Startmeldung (Versionsnummer) des Avisaro Loggers kann abgeschaltet werden. Manche Anlagen 'verwirt' ein solche Meldung, für den Benutzer ist diese jedoch eine gute Kontrollnachricht.