Get Started with the Intel® System Bring Up Toolkit for Linux*

ID 766453
Date 12/06/2021
Public

Intel® System Debugger

Speed up system bring-up and validation of system hardware and software using in-depth debug and trace of BIOS/UEFI, firmware, device drivers, operating system kernels, and more.

Connecting to Target

To start using the Intel® System Debugger, physically connect a cable to the target device (follow instructions for your cable and/or target device) and follow these steps to launch the debugger:

  1. Launch the Intel® System Debugger IDE: click Intel® System Debugger in your Start menu or run the script <install-dir>\iss_ide_eclipse-launcher.bat, where <install-dir> is the installation location of Intel® System Debugger (by default, C:\IntelSWTools\system_debugger\<version>-nda)

    Double click the Intel System Debugger icon on the desktop or run the script <install-dir>/iss_ide_eclipse-launcher.sh, where <install-dir> is the installation location of Intel® System Debugger (by default, /opt/intel/system_debugger/<version>-nda)

    where <install-dir> is the root directory of your Intel System Debugger installation.
  2. Click the New Connection drop-down list in the main toolbar of the Intel® System Studio IDE.
  3. Select Connect and detect target to allow the Target Connection Assistant to automatically identify and configure your target.

  4. If your target was not detected correctly, you can set it up manually. For instructions, refer to the wizard help (see the button at the bottom-left).
  5. When the target is successfully detected, verify the connection configuration details in the final wizard dialog. For instructions on configuring the connection components, refer to the Target Connection Assistant User Guide available from the Eclipse* Help.

    To change the probe used for connection, click Select on the right and choose an alternative connection method.

    If you want to connect to the target right away, check the Connect to target on finish box.

  6. Click Finish.
  7. After the connection has been established, the green Connect button next to the target selection drop-down list becomes inactive and the red Disconnect button becomes active.

    The word (Connected) appears in title bar of the Debug Targets Connection tab.

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 the Connecting to Target section and you opened the Debug perspective. Otherwise, select Window > Perspective > Open Perspective > Debug.

For instructions on common debug use cases and additional configurations, refer to the Intel® System Debugger documentation.

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 the Connecting to Target section.

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.

For instructions on common trace use cases and additional configurations, refer to the Intel® System Debugger documentation