Getting Started Guide

  • XX.XX
  • 02/07/2020
  • Public Content

Get Started with the Intel® System Debugger - System Trace
for Windows* OS Host

The System Trace feature of the Intel® System Debugger provides an
Intel® System Studio IDE
plug-in which adds the capability to access the Intel® Trace Hub providing advanced SoC-wide instruction and data events tracing through its trace viewer.
Intel® System Debugger - System Trace is available as part of the following products:
  • Intel® System Studio
  • Intel® oneAPI IoT Toolkit (Beta)
  • Intel® System Bring-up Toolkit (Beta)
In case you need assistance installing or running this product, please visit our Get Help page at http://software.intel.com/en-us/support for support options.
For discussions, user-to-user help and general debugging information, please also join our online community at http://software.intel.com/en-us/forums/debug-solutions .
Python* 3 is used by default.

Prerequisites

For system requirements, see the Intel® System Debugger - System Trace User Guide and the Release Notes .

Installation

For details of the installation process, see the Intel® System Debugger - System Trace User Guide .

Starting the System Trace

If you have an existing workspace containing an old System Trace project, this project is probably not compatible with the newly-installed System Trace anymore.
Whenever you install a newer version of
Intel® System Studio or
Intel® System Debugger including the System Trace, create a new Eclipse* IDE workspace or at least a new System Trace project.
  1. Launch the Intel® System Debugger the following way:
    • As the Intel® System Studio component
      Launch the Intel® System Studio IDE by running
      <
      install-dir
      >
      \iss_ide_eclipse-launcher.bat
      , where
      <
      install-dir
      >
      is the root directory of your Intel® System Studio installation. By default,
      <
      install-dir
      >
      is
      :
      • For Linux* OS target:
        C:\IntelSWTools\system_studio_<
        version
        >\
      • For Windows* OS target:
        C:\Program Files (x86)\IntelSWTools\
    • As a component of Intel® oneAPI Toolkits (Beta)
      Launch the Intel® System Debugger by running
      <
      install-dir
      >/system_debugger/<
      version
      >
      \isd_eclipse-launcher.bat
      , where
      <
      install-dir
      >
      is the root directory of your Intel® oneAPI toolkit installation. By default,
      <
      install-dir
      >
      is
      C:\Program Files (x86)\inteloneapi
      .
  2. To open the System Trace plugin, go to
    Window
    Open Perspective
    Other
    .
  3. Choose
    System Trace
    as the perspective. The System Trace default window is displayed. The first time you launch, the System Trace will show a welcome dialog, which guides you through the first steps.
Options available in the
Welcome to System Trace
dialog box:
Help me setup a new project
This option will guide you through the process of creating a trace project.
Import a project
This option will open the Intel® System Debugger import dialog to import existing trace projects.

Importing an Existing Trace Capture Archive/Trace Capture File (Bin-file)

To import an existing trace capture archive file, such as one of the examples which can be found in
<
install-dir
>\system_debugger\<
version
>\system_trace\examples\input
, you need to import that file into your trace viewer.
To import a sample System Validation Events (SVEN) trace included in a Trace Capture Archive or in a plain bin-file:
  1. Launch the
    Intel® System Debugger
    .
  2. Switch to the Trace perspective.
  3. Go to
    File
    Import ...
    .
  4. Browse to
    System Trace
    Trace Capture
    .
  5. Click
    Next
    .
  6. Select the Trace Capture Archive by clicking
    Browse…
    .
    Locate
    sven_stp_data.tracecptentry
    in the directory
    <
    install-dir
    >\system_debugger\<
    version
    >\system_trace\examples\input
    .
    If you want to import a bin file, select the
    *.*
    file filter on the bottom right corner of the file browse dialog.
  7. Select the trace project you want to import the data from. If you do not have a project, type in a name for your new project and select
    Create trace project
    .
  8. Click
    Finish
    to import the trace capture archive.
  9. In the
    Project Explorer
    expand the capture node. You should see a
    sven_stp_data.tracecpt
    entry.
  10. Right-click the
    sven_stp_data.tracecpt
    entry and select
    Decode
    .
The sample trace is displayed in the trace viewer.
For more information about how to use the System Trace, see Intel® System Debugger - System Trace User Guide

Training and Documentation

Document
Description
This document provides information about how to install and start the System Trace on Eclipse*.
Documentation for the command line interface to Intel® System Debugger - System Trace.
Release Notes for the Intel® System Debugger and its components.
Intel® System Studio product page. See this page for support and online documentation.
Intel® oneAPI (Beta) product page. See this page for support and documentation for various toolkits.

Notices and Disclaimers

No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.
Intel technologies' features and benefits depend on system configuration and may require enabled hardware, software or service activation. Performance varies depending on system configuration. No product or component can be absolutely secure. Check with your system manufacturer or retailer or learn more at [intel.com].
Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.
This document contains information on products, services and/or processes in development. All information provided here is subject to change without notice. Contact your Intel representative to obtain the latest forecast, schedule, specifications and roadmaps.
The products and services described may contain defects or errors which may cause deviations from published specifications. Current characterized errata are available on request.
Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.
*Other names and brands may be claimed as the property of others.
Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.
© Intel Corporation.
This software and the related documents are Intel copyrighted materials, and your use of them is governed by the express license under which they were provided to you (
License
). Unless the License provides otherwise, you may not use, modify, copy, publish, distribute, disclose or transmit this software or the related documents without Intel's prior written permission.
This software and the related documents are provided as is, with no express or implied warranties, other than those that are expressly stated in the License.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804