Log file
This section documents the log file format.
An example log file is given below for reference.
# Logger type: CL2000
# HW rev: 6.xx
# FW rev: 5.31
# Logger ID: OPEL
# Session No.: 70
# Split No.: 1
# Time: 20170101T022232
# Value separator: ";"
# Time format: 4
# Time separator: ""
# Time separator ms: ""
# Date separator: ""
# Time and date separator: "T"
# Bit-rate: 500000
# Silent mode: false
# Cyclic mode: false
Timestamp;Type;ID;Data
01T022231683;8;7df;02010d5555555555
01T022231688;0;7e8;03410d00aaaaaaaa
01T022231693;8;7df;02010c5555555555
01T022231701;0;7e8;04410c0000aaaaaa
01T022231783;8;7df;02010d5555555555
01T022231788;0;7e8;03410d00aaaaaaaa
01T022231793;8;7df;02010c5555555555
01T022231801;0;7e8;04410c0000aaaaaa
File format
Log files are written in a CSV-like format using the reduced ASCII character set. The log files can be opened directly in most simple text editors. Log entries are formatted according to the settings in the configuration file (see Log and Data fields) and terminated by a single “line feed” character.
The configuration of the log file format is written to each log file header (e.g. the timestamp format used, the separators used, etc.).
Note
Note that some text editors do not recognise a single “line feed” character as a new line.
File name
The log file names are built using a unique sequential 7 digit number. Each time a new log file is created, the log file name number is increased by one. The log file extension is *.txt, e.g. 0000001.txt.
Note
Note that the log name number is not reset on a power-cycle.
Header
The log file header is added to all log files. The header contains information needed to identify and interpret the log file. Log file header lines start with # to indicate that these are not data records.
Below the log header entries are described:
Logger type: The device type (CL2000)HW rev: The hardware revisionFW rev: The firmware revisionLogger ID: The logger identification string (see here)Session No.: The session sequential number (see Session No.)Split No.: The log file split number (see Split No.)Time: The log file start time with fixed formatYYYYMMDDThhmmss(see here)Value separator: The value separator used in the log file (see here)Time format: The time stamp format used in the log file (see here)Time separator: The timestamp time separator (see here)Time separator ms: The timestamp ms separator (see here)Date separator: The timestamp date separator (see here)Time and date separator: The timestamp time to date separator (see here)Bit-rate: The manually set or auto detected CAN-bus bit rate (see here)Silent mode: The state of silent mode (see here)Cyclic mode: The state of cyclic mode (see here)
Log file numbering
Session No.
Each logging session is given a unique number. Each time the logger powers up, the session number is increased by one. The session number can be used to group multiple log files from the same logging session (see here)
Note
Note that the session number is not reset on a power-cycle
Split No.
The split number is reset each time the logger powers up. The purpose of the Split No. is to ensure an unambiguous order of log files within the same logging session (log files with the same Session No.)
The log file split behaviour can be configured in Log.
Data fields
A column header is included before the first data record. This provides the names of each column and specifies the value separator used.
The interpretation of the columns are:
Timestamp: Timestamp in ms (1ms resolution)Type: Message type indicator.0: Received standard ID message1: Received extended ID message8: Transmitted standard ID message9: Transmitted extended ID message
ID: CAN-bus message identifier (in HEX)Length: The length in bytes of the CAN-message data field (in decimal)Data: CAN-bus message data bytes[1] (0-8) (in HEX)