Importing Trace Data Offline

You can import a trace data file offline from one project to another. Trace data can be imported into an existing project or a new project using the Import wizard. Importing a trace data file or raw trace in an existing project and existing launch config needs to be performed when you want to utilize that project's resources, that is the elf and the source mappings.

Before importing a raw trace into an existing project, replace the executable file (elf) of the existing project with the executable file of the project associated with the trace being imported. Make sure that you keep the original name of the executable file (of the existing project).

The executable is also required when you are importing raw trace data into a new project.

To import a trace data file offline to a new project:

  1. Select File > Import to open the Import wizard.
  2. Expand the Software Analysis node and select Trace.
    Figure 1. Select Page - Import Wizard
    Select Page - Import Wizard
  3. Click Next to display the Import Trace page of the Import wizard.
    Figure 2. Import Trace Page
    Import Trace Page
  4. Click Browse and locate the trace data file of the project that you want to import into your project. The trace data file is located in the .Analysis Data folder of the project in the workspace.
  5. Select the New project option to import trace data into a new project, which is created with a dedicated launch configuration. You can use this launch configuration to update the source path mappings in case sources have changed from the time of raw trace data collection.
    Note: If you select the Existing project option in the Import To group in Figure 2 and click Next, the Import Trace to Existing Project page appears. In this page, type or select the project in which you want to import the trace data. Type a new file name for the trace data file in the Enter new file name text box. This field is optional.
  6. Click Next to display the Import Trace Configuration page. This page allows you to specify the trace configuration details of the project to display imported trace data based on the executable file or launch configuration used during trace collection.
    Figure 3. Import Trace Configuration Page
    Import Trace Configuration Page
  7. Specify the target of your project in the System drop-down box.
  8. In the Source Code Correlation group, you can select any of the following options:
    • None if you do not want to correlate trace data with the source of your project, that is when the trace being imported is not program trace. The trace data will appear without displaying the source lines corresponding to the trace events.
    • Application if you want to correlate trace data with the source. Click Browse to locate the executable file (.abs/ .elf/ .afx) of the application used during trace collection.
    Note: In case you are importing trace into an existing project, you can select the Application option if the trace data you are importing was not collected with any of the project's executable (or it has changed in the meantime). The imported raw trace will be (re)decoded with the new executable. Click Browse to locate the executable file.
    Note: The Launch Configuration option is also displayed when you choose to import trace data into an existing project. Use this option when the raw trace was collected with one of the project's launch configuration. You will reuse the project's resources specified in the selected launch configuration (elf, source path mappings). Make sure that the elf did not change from the time when the imported raw trace was collected.
  9. Click Finish.

If you kept the View trace data on finish checkbox checked in the Figure 2, the imported trace data will automatically open in the Trace Data viewer of your project. If you uncheck this option, the imported data will be visible from the Software Analysis view. The imported trace data is saved in the .Analysis Data folder of your project also.

After importing trace data, the Decoding Trace dialog box appears displaying the progress of the trace to be decoded. If the trace data file to be imported is relatively small in size, the Decoding Trace dialog box disappears after a few seconds. However, when you import a heavy trace file (around 300 - 400 KB), the Decoding Trace dialog box displays the percentage of trace to be decoded.

Figure 4. Decoding Trace
Decoding Trace

If you do not want to see the complete contents of the trace file, you can cancel the trace in between by clicking Cancel . For example, if you cancel the trace decoding at 20%, only that much amount of trace will be displayed in the Trace Data viewer. After cancelling, you get a message box displaying that decoding is not finished and trace displayed will be incomplete. Click OK in the message box.