Target.FileLog

Target Computer file logger

Since R2020b

Description

A Target.FileLog object represents the file logger that runs on a Speedgoat^® target computer and provides access to methods and properties related to the file logger.

The object provides access to methods and properties that:

• Enable and disable the file logger.

• Import file log data.

• Check for available file log data.

• Discard unwanted file log data.

Function names are case-sensitive. Type the entire name. Property names are not case-sensitive. You do not need to type the entire name if the characters you type are unique for the property.

Creation

A Target.FileLog object is created when you create a Target object by using the slrealtime command. After you create and connect to the Target object, you can access the Target.FileLog object. This example creates and connects to Target object tg, and then starts the file logger on the target computer.

tg = slrealtime('TargetPC1');
connect(tg);
enable(tg.FileLog);

Properties

Importing — File log import status

0 (not importing) (default) | 1 (importing)

The Importing property indicates whether the file logger is importing a file log. When FileLogger is enabled, the file logger imports file log data at the end of simulation runs. You can disable the import by setting the Disable automatic import of file logs option for the real-time application. For more information, see the start function.

Note

The Importing property will be removed in a future release.

Example: 0

LoggingService — File logging service status

STARTING (default) | RUNNING | STOPPING | STOPPED | ERROR

The LoggingService property indicates the file logging service status.

Example: 100

DataAvailable — File log data available status

0 (no data available) (default) | 1 (data available)

The DataAvailable property indicates whether file log data is available for import.

Example: 0

Object Functions

discard	Delete file log data from target computer
list	Get information about available file logs of signal data
import	Import file log data from target computer
openImportDialog	Get information about available file logs of signal data

Examples

Disable File Log

The disable function disables file logging.

Create a Target object and connect to the target computer. Creating a Target object creates a child Target.FileLog object. Connecting to the target computer provides access to the Target.FileLog object. Disable file logging.

tg = slrealtime('TargetPC1');
connect(tg);
disable(tg.FileLog);

Version History

Introduced in R2020b

R2022b: Removed Importing property

The Importing property of the Target.FileLog object is removed. An error appears when you use this property.

R2021b: Synchronous Processing for File Log Import

The operation of the Target.FileLog object has changed. Now, the file log import process is synchronous in MATLAB, which means that while data import is occurring, the MATLAB status is busy. The abort function has been removed. The ImportProgress property has been removed.