CAN Nachrichten im ASCII Format mit Zeitstempel in einer Datei speichern.

Dieses Dokument beschreibt das Anwendungsscript "MC5 - CAN Nachrichten speichern".

Versionshistorie des Dokuments:

Weiterführende Dokumente sind:

Download Script: MC5-5.txt (1,3 kB) 
(right mouse-button and 'save under ..' to download)

Konfigurationsdatei: autorun.txt (1,3 kB) 
(right mouse-button and 'save under ..' to download)

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 CAN Schnittstelle anwendbar.

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

Erforderliche Firmware

Ein Firmware Version 4.78 oder höher ist erforderlich.

Siehe  hier für aktuelle Firmware Versionen.

Erforderliche PC Umgebung

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.

Zur Auswertung der Daten am PC kann z.B. Excel verwendet werden. Die meisten Software Pakete zur Datenanalyse verfügen über eine "CSV" Import und können demnach benutzt werden. Ein einfacher 'Notepad' Texteditor kann zur Visualisierung von kleinen Datenmengen auch verwendet werden.

Daten von einem oder zwei CAN Bussen loggen

Ist der Logger in Betrieb und eine Speicherkarte eingelegt, werden alle Nachrichten von einem oder zwei CAN Bussen auf die Speicherkarte geloggt. Siehe später im Dokument zur Einstellung der Anzahl der CAN Busse.

Die CAN Nachrichten werden im Text (ASCII) Format gespeichert. Die Paramter der CAN Nachricht werden durch ein "," getrennt. Die Spalten sind:

1. CAN Bus: "C1" bzw "C2" zu Kennzeichnung über welchen CAN Bus die Nachricht kam
2. Datum: Zeitstempel aktuelle Datum
3. Uhrzeit: Zeitstempel aktuelle Uhrzeit 
4. A/B: CAN Type A (11 Bit Identifier) oder Type B (29 Bit Identifier)
5. ID: Inhalt des ID Feld
6. RTR: Inhalt des RTR Bits
7. Länge Daten: Anzahl der Bytes im Payload Feld
8. Data: Payload - immer 8 Einträge durch Komma getrennt.

Jeden Tag wird eine neue Logdatei mit dem Namen yymmttxx.txt angelegt. Um Mitternacht wird jeweils eine neue Datei erzeugt. Über einen Parameter kann die Größe der Logdatei festgelegt werden. "xx" im Dateinamen ist eine fortlaufende Nummer - wenn die maximale Dateigröße erreicht ist, wird eine neue Datei mit xx+1 und dem Datum von heute angelegt.

In Excel importierte Daten

Lesen der Daten am PC oder MAC

Die Daten liegen als "CSV" Format vor. Dieses Text Format kann mit jedem Editor zum Lesen geöffnet werden. Zur Analyse und Auswertung können Programme wie Microsoft Excel, Math-Lab, Vector CANoe und Avisaro DIAG verwendet werden.

Excel: Der Import in Excel ist <hier> ausführlich beschrieben.

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 (CAN)

Wie die Datenschnittstelle konfiguriert wird, ist in der Bedienungsanleitung des jeweilgen Produktes beschrieben. Das Script funktioniert nur für CAN Daten. Typischerweise wird die Konfiguration entweder über eine Konfigurationsdatei ('autorun.txt') oder über die Webseite gemacht.

Option: CAN Filter Liste

Das Script kann eine Liste von CAN IDs speichern, die geloggt werden sollen. Die Liste wird im oberen Teil des Scripts hinter das Schlüsselwort "data" geschrieben. Die CAN IDs werden als dezimale Werte eingegeben und mit Komma getrennt. Soll keine Filterung stattfinden wird eine -2 eingetragen. Die Liste wird mit einer -1 abgeschlossen.

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

' ----------------
' List of CAN-IDs to be logged. All = -2. Last element of list = -1. Enter IDs as decimal values.

data -2 , -1

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

Beispiel zum Loggen nur der CAN ID 100 und 200:

' ----------------
' List of CAN-IDs to be logged. All = -2. Last element of list = -1. Enter IDs as decimal values.

data 100 , 200 , -1

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

Option: CAN Filter Bereich

Um einen Bereich (z.B. CAN ID 0 bis 100) zu definieren, wird der "CANFLT" Befehl in der autorun.txt (nicht über das Script!) verwendet. Eine Beschreibung des Befehls finden Sie  hier. Diese Methode ist vorzuziehen, wenn die relevanten CAN ID in einem Bereich liegen. Der Bereichsfilter selektiert schneller.

Option: Maximale Dateigröße

Damit Log-Dateien leichter kopiert und verschickt werden können, können diese in ihrer Größe begrenzt werden. Hat die Datei den eingestellten Schwellwert erreicht, wird eine neue Datei erzeugt. Die Dateigröße kann verändert werden:

Öffnen Sie dazu das Script in einem Editor und betrachten Sie oberen Zeilen:

' -------------------------
' max filesize in MByte

let size = 10

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

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

Option: 1 oder 2 CAN Ports

Avisaro bietet Logger mit einem oder mit zwei CAN Ports an. Mit dieser Option kann das Script auf die jeweilige Hardware angepasst werden. Insbesondere die rote und grüne LED unterscheiden sich.

Öffnen Sie dazu das Script in einem Editor und betrachten Sie oberen Zeilen:

' -------------------------
' One (=1) or two (=2) CAN Ports

let ports = 2

------------------------------------------------

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

Option: Konfiguration 2ter CAN Port

Wird der zweite CAN Port aktiviert, dann muss er im Script konfiguriert werden.

Öffnen Sie dazu das Script in einem Editor und betrachten Sie oberen Zeilen:

'-------------------------
' Define 2nd CAN Port

auxopen -8, 125000, 0, 536870910, 0, 0

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

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

Mit einem deutlich modifiziertem Script können Daten auch parallel geloggt und "live gestreamt" werden

Mögliche Anpassungen

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

• Aktives Abfragen eines Sensors: der Avisaro Logger kann Befehlssequenzen aussenden um eine angeschlossene Anlage abzufragen
• Formatierung der Spalten: Die Daten können als HEX Werte statt Dezimalwerte dargestellt werden, Spalten können hinzugefügt oder ausgelassen werden.