canSignalImport

Import CAN log file into decoded signal timetables

Syntax

sigtimetable = canSignalImport(file,vendor,database)

sigtimetable = canSignalImport(file,vendor,database,msgnames)

Description

sigtimetable = canSignalImport(file,vendor,database) imports a CAN message log file from the specified vendor directly into decoded signal value timetables using the provided database. The function returns a structure with a field for each unique message in the timetable. Each field value is a timetable of all the signals in all instances of that message. Use this form of syntax to convert an entire set of messages in a single function call.

sigtimetable = canSignalImport(file,vendor,database,msgnames) returns signal timetables for only the messages specified by msgnames, which can specify one or more message names. Use this syntax form to import signals from only a subset of messages.

Examples

Import Signals from Log for All Messages

Create signal timetables from all messages in a log file.

db = canDatabase('MyDatabase.dbc');
sigtimetable = canSignalImport('MsgLog.asc','Vector',db);

Import Signals from Log for Specified Messages

Create signal timetables from specified messages in a log file.

db = canDatabase('MyDatabase.dbc');
sigtimetable1 = canSignalImport('MsgLog.asc','Vector',db,'Message1');
sigtimetable2 = canSignalImport('MsgLog.asc','Vector',db,{'Message1','Message2'});

Input Arguments

file — CAN message log file

character vector | string

CAN message log file, specified as a character vector or string.

Example: 'MyDatabase.dbc'

Data Types: char | string

vendor — Vendor file format

'Kvaser' | 'Vector'

Vendor file format, specified as a character vector or string. The supported file formats are those defined by Vector and Kvaser.

Example: 'Vector'

Data Types: char | string

database — CAN database

database handle

CAN database, specified as a database handle.

msgnames — Message names

char | string | cell

Message names, specified as a character vector, string, or array.

Example: 'message1'

Data Types: char | string | cell

Output Arguments

sigtimetable — CAN signals

structure

CAN signals, returned as a structure. The structure field names correspond to the messages of the input, and each field value is a timetable of CAN signals.

Data Types: struct