Getting Started with Hardware System/Platform Bring Up Using Intel® System Studio 2018 for Linux* OS

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.

Intel® Debugger for Heterogeneous Compute

Remotely debugs parts of application code that get executed on an Intel® integrated GPU.

Connecting to Target

  1. Launch the Intel® System Studio IDE by running the script <install-dir>/iss_ide_eclipse-launcher.sh, where <install-dir> is the root directory of your Intel® System Studio installation. By default, <install-dir> is/opt/intel/system_studio_2018/.
  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 select the values of Target Type and Connection Method that match your setup.



     

  5. Press the green Connect button next to the target selection drop-down list.



     

  6. 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:

  • Capture logs broadcast by the Intel® Trace Hub
  • Filter and search the captured logs
  • Find sequences of events that follow your custom scenarios

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.

    Alternatively, run the script <install-dir>/system_debugger_<version>/system_debug/xdb.sh

  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

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.

Intel® System Debugger — System Debug documentation

The following documentation about the Intel® System Debugger — System Debug may be helpful:

Intel® System Debugger — System Trace documentation

The following documentation about the Intel® System Debugger — System Trace may be helpful:

Intel® Debugger for Heterogeneous Compute documentation

The following documentation about the Intel® Debugger for Heterogeneous Compute may be helpful:

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.

Legal Information

Intel, Intel Atom, Intel Core 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.

Copyright 2014-2018 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.

For more complete information about compiler optimizations, see our Optimization Notice.