Main Content

Using CAN Explorer for Data Reception and Visualization

This example shows how to use the graphical interface in CAN Explorer to receive and visualize CAN data. It uses MathWorks Virtual channels which are connected in a loopback configuration. CAN Explorer is configured to receive data using MathWorks Virtual 1 Channel 1. Pre-recorded data is provided in a MAT-file and replayed onto MathWorks Virtual 1 Channel 2 to emulate CAN traffic generated from connecting to an actual vehicle system.

Open the CAN Explorer

Open the CAN Explorer app using command canExplorer. Alternatively, you could find CAN Explorer in the MATLAB Apps tab.

Select the Device Channel

The Device List shows all the accessible CAN channels from devices connected to the system, and the current device channel in use is highlighted by a blue outline. Each time CAN Explorer is launched, the first device channel in the list is automatically selected by default. Select MathWorks Virtual 1 Channel 1 from the Device List if it is not selected by default.

Configure the Database Files

Add database files to CAN Explorer to decode incoming messages and signals.

  1. To open the Database Configuration dialog, select Databases in the toolstrip.

  2. Click Add to open the file selection dialog. Select the CANExplorerDatabase.dbc file provided with the example.

  3. Click OK to save the database configuration and close the dialog.

Configure the Channel Bus Speed

Configure the channel bus speed if the desired network speed differs from the default value.

  1. To open the Device Channel Configuration dialog, select Device Channel in the toolstrip.

  2. This example uses the default bus speed at 500000 bits per second. Confirm the current device channel configuration and click OK.

In the same dialog, you can configure message filters respectively for standard ID and extended ID to control which messages pass through the channel. By default, both filter options are set to allow all messages to pass, but you can also specify certain IDs to be allowed or blocked.

Configure the Signal Table

Add signals of interest to view on the Signal Table. In this example, you view all signals defined in the CANExplorerDatabase.dbc file.

  1. To open the Signal Table Configuration dialog, select Signals > Configure Signal Table in the toolstrip.

  2. Add signals from the Available Signals pane to the Configured Signals pane using the button. You can add individual signals, add all signals in a message by adding the message, or add all signals in a database by adding the database. For this example, select CANExplorerDatabase.dbc in the Available Signals pane and click to add all signals in the database to view.

  3. Click OK to save the signal table configuration and close the dialog.

If you provide a search text for signals or messages and click Find, the Available Signals pane is updated to display search results that are case-insensitive partial matches to the search text.

Configure the Signal Scopes

Add signals of interest to view on the Signal Scopes. CAN Explorer provides 3 scopes that can each be configured to visualize signals of selection. The number of scopes is fixed and cannot be customized. In this example, you view all signals from Message_A in the top signal scope, all signals from Message_B and Message_C in the middle signal scope, and all signals from Message_D in the bottom signal scope.

  1. To open the Top Signal Scope Configuration dialog, select Signals > Configure Top Signal Scope in the toolstrip.

  2. Select Message_A in the Available Signals pane and click to add all signals in this message to view on the top signal scope.

  3. Click OK to save the top signal scope configuration and close the dialog.

  4. Using a similar approach, add signals from Message_B and Message_C to view on the middle signal scope, and add signals from Message_D to view on the bottom signal scope.

Start Monitoring

Start monitoring in CAN Explorer before starting the replay to avoid losing any data. Click Start in the toolstrip.

Replay Pre-Recorded CAN Data

Data logged from a CAN network is provided in the file CANExplorerData.mat. The data is saved in timetable format and the time range spans about 60 seconds.

Replay the CAN data onto MathWorks Virtual 1 Channel 2 for CAN Explorer to receive on MathWorks Virtual 1 Channel 1 in the same MATLAB instance. To start the data replay, execute the script replayCANData.m. You can also execute the script sequentially multiple times to generate CAN data beyond 60 seconds for additional experiments.

Explore the Monitor and Display Options

While CAN Explorer continues to receive data, you can experiment with controls in the Monitor and Display sections of the toolstrip.

  1. Click Pause to temporarily suspend CAN Explorer from visually updating. While paused CAN Explorer continues accumulating and processing data in the background.

  2. Click Continue to resume the visual updates in CAN Explorer.

For further exploration:

  1. If you click Clear Data, all accumulated data is completely cleared from CAN Explorer.

  2. By default, the Message Table displays all CAN messages in chronological order. To view the latest instance of each unique message, toggle Unique Messages.

  3. By default, both the Message Table and the Signal Table display time since the start of monitoring. To view the delta time since the last message or signal in each table, toggle Delta Time.

Stop Monitoring

When you have completed your live acquisition activity, click Stop in the toolstrip to take the device channel offline.

Clean up for the Data Replay

Clean up by executing the script replayCANDataCleanup.m, which stops the MathWorks Virtual 1 Channel 2 used for replay and clears the unneeded variables.

Export Data for Additional Use

In the toolstrip, click the top half of the Export button to export the received data into the MATLAB workspace in a timetable format.

If you would like to retain the exported variable for future use:

  • To save the variable to a MAT-file, use the save function.

  • To save the variable to a BLF-file, use the blfwrite function.

The exported timetable of messages is also convertible into individual timetables of signal data. The canSignalTimetable function returns a structure with one field for each unique message in the timetable. Each field value is a timetable of all the signals defined in that message.