Intel System Studio 2019 Get Started Guide

Get Started with Hardware System/Platform Bring Up Using Intel® System Studio 2019 for Windows* OS Host and Linux* OS Target

Explore the Debug Components

Component

Description

Intel® System Debugger — System Debug

Enables JTAG-based debugging of Intel® architecture-based system software and embedded applications.

Intel® System Debugger — System Trace

Allows you to access the Intel® Trace Hub, providing advanced SoC-wide instruction and data events tracing.

Note

You might not have all of the tools and libraries mentioned in this guide. To download additional Intel System Studio tools and libraries, visit the product page on the Intel Developer Zone.

Connecting to Target

  1. Launch the Intel® System Studio IDE by clicking Intel® System Studio in your Start menu. Alternatively, run the script <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:
    1. For Linux* OS target: C:\IntelSWTools\system_studio_2019\
    2. For Windows* OS target: C:\Program Files (x86)\IntelSWTools\
  2. Click the New Connection... drop-down list in the main toolbar of the Intel® System Studio IDE.



     

  3. In the Wizards list, select JTAG Connection for System Debug & Trace and click Next >.



     

  4. Name the connection by typing in the Connection Name input field, then click the Next > button.



  5. Select the values of Target Type and Connection Method that match your setup. Click the Next > button.



     

  6. Review the connection configuration details and click the Finish button to finalize the connection.
  7. Press the green Connect button next to the target selection drop-down list.



     

  8. After the connection has been established, the Disconnect button becomes active, and the word (Connected) appears in title bar of the Intel System Studio IDE and the Debug Targets Connection tab.



     

First Steps with Intel® System Debugger — System Trace

System Trace is a component of Intel® System Debugger. Among other features, System Trace enables you to:

Before you proceed, ensure that you followed the steps in section Connecting to Target.

Open the Trace Perspective

  1. Select Window > Perspective > Open Perspective > Other... to open the list of available perspectives.



     

  2. Select System Trace, then click OK.



     

  3. In the Welcome to System Trace dialog, select Help me setup a new project and click OK.
  4. Type the project name into the Project name field and click Next.
  5. Review the connection settings you set up earlier in the section Connecting to Target and click Next.
  6. Optionally, change the default name of the trace output file. Click Finish.

Start Live Tracing

  1. In the Trace Capture view, click the Begin capturing trace data from target button to start live tracing.



     

  2. Click the Stop capturing button to terminate the trace collection.
  3. Decoded trace output appears in the Message View window. Use the filter toolbar to select the columns of the trace output to display.

More Information

Refer to the following resources to get more information about System Trace:

In case you need additional assistance installing or running System Trace, please visit our Get Help page at http://software.intel.com/en-us/support for support options.

First Steps with Intel® System Debugger — System Debug

System Debug is a component of Intel® System Debugger. System Debug enables you to debug low-level systems software such as UEFI implementations and OS kernels.

Before you proceed, ensure that you followed the steps in section Connecting to Target.

Start Debugging Session

  1. Launch System Debug by clicking the Launch Intel System Debugger (Debug) button in the Intel® System Studio IDE.
  2. Click Yes in the New connection established dialog box.



     

Debug Your Target

By default, the debugger opens the Assembler and Console views.

In the Assembler view, you can set a breakpoint by double-clicking the blue bubble next to the desired memory address. You can control execution using the following toolbar buttons:

  • - run or continue
  • - suspend execution
  • - reset target
  • - step through the source code or assembly instructions

Load UEFI Symbols

To view the source code of your UEFI implementation (referred to as the debuggee) as you debug, click the LoadThis button in the toolbar of Intel System Debugger — System Debug. In case the location of the source code on your machine matches the location stored in the debug symbols of debuggee, the Source view loads automatically. Otherwise, verify that the Console view contains the following error message:

ERROR: Could not locate debug symbols for file <file>
INFO: compile time file location: <source_code_path>

Follow these steps to set up a mapping between <source_code_path> and the path to the source code on your machine:

  1. Copy <source_code_path> from the Console view.
  2. Select Options > Source Directories...
  3. In the Rules tab of the Source Directories dialog box, click the New... button.
  4. In the New Source Path Substitution Rule dialog box, paste <source_code_path> into the Replace input field.



     

  5. Paste the path to the source code on your system into the by input field and click OK. Click OK to save your changes in the Source Directories dialog box.
  6. Click the LoadThis button in the toolbar of the debugger.

More Information

Refer to the following resources to get more information about System Debug:

In case you need additional assistance installing or running System Debug, please visit our Get Help page at http://software.intel.com/en-us/support for support options.

Find More

Resource

Description

Intel® System Studio Code Samples and Tutorials

The sample code and tutorials available for download guide a new user through basic product features. Sample code illustrates common code inefficiencies and the corresponding tutorials show how the performance analysis products can be used to solve issues.

Additional Documentation

Use the online documentation for the latest content.

A downloadable ZIP file containing all Intel® System Studio documentation is available for offline use from https://software.intel.com/en-us/articles/download-documentation-intel-system-studio-current-previous.

Intel® System Studio Product Page

Visit this page for support and the latest online documentation.