File Logger Init

Block to initialize the File Logger module

Description

The 'File Logger Init' block instructs the code generator to enable support for the File Logger module. This module allows the logging of Simulink signals (at a fixed time interval) into a file that is written to the SD-card.

All signals in the ASCII log-file are separated by a semicolon. This data format allows the log-files to be opened by any tool that can read CSV files, such as Microsoft Excel.

Remarks

Parameters
Filename
Name of the log-file, including file extension. It will be written to the root directory on the SD-card.
Add auto-incrementing number to filename
If enabled, then a 3-digit sequence number will be added to the log-file and automatically increment it between software program starts. So if the filename is specified as 'mylog.txt', then the first time the software program is started, the log-file will be called 'mylog001.txt', the next time the software program is started, it will be called 'mylog002.txt', etc.
First line in log-file
Specify the first line for the log-file. Typically, this line contains the column headers for the logged data signals. Note that the File Logger module automatically adds the timestamp in the first column. The next columns contain the data signals.
Logging interval (ms)
This detemins the delta time as which the data signals are sampled and written to the log-file. Specify the time in milliseconds. Note that a short logging interval will increase the CPU load. It is recommended to specify a value >= 5ms.
Maximum signals to log
Specify the maximum number of signals you intend to log. This determines the number of columns in the log-file in addition to the timestamp column.
Use dot-character as decimal seperator (comma otherwise)
After sampling data signals, the signal valus are converted to a string in order to be able to write them to the log-file. This configurable instructs the File Logger module to use either a '.'-character or ','-character as a decimal separator.
Automatically start logging
Select if logging should automatically start after initialization. If not then a trigger input will appear that can be used to trigger the logging start.

Examples

Given is the following configuration:

Filename: 'mylog.txt'
Add auto-incrementing number to filename: Yes
First line in log-file: 'time;counter1;counter2'
Logging interval (ms): 100
Maximum signals to log: 2
Use dot-character as decimal seperator (comma otherwise): No

After running the software program, the log-file 'mylog001.txt' will appear on the SD-card with the following contents:

time;counter1;counter2
0,100;1;100
0,200;2;101
0,300;3;102
0,400;4;103
0,500;5;104
0,600;6;105
0,700;7;106
0,800;8;107
0,900;9;108
1,000;10;109
1,100;11;110
....etc....