Intel® Application Debugger 2.0  for Intel(R) Atom(TM) processor
Installation Guide

Document Number: 322070-004US

 

Contents

Introduction

Additional Legal Notices

System Requirements

Installing the Debugger

Uninstalling the Debugger

First Steps

Applying the Kernel Patch

Obtaining Technical Support

Disclaimer and Legal Information

 

Introduction

This document explains how to install and configure for use the Intel(R) Application Debugger 2.0  for Intel(R) Atom(TM) processor product. Installation is a multi-step process. Please read this document in its entirety before beginning and follow the steps in sequence. For information about the product contents, including new and changed features, please refer to the separate Release Notes.

 

Additional Legal Notices

This product includes software developed at:

The Apache Software Foundation (http://www.apache.org/).

Portions of this software were originally based on the following:
- software copyright (c) 1999, IBM Corporation., http://www.ibm.com.
- software copyright (c) 1999, Sun Microsystems., http://www.sun.com.
- the W3C consortium (http://www.w3c.org) ,
- the SAX project (http://www.saxproject.org)
- voluntary contributions made by Paul Eng on behalf of the
Apache Software Foundation that were originally developed at iClick, Inc.,
software copyright (c) 1999.

This product includes updcrc macro,
Satchell Evaluations and Chuck Forsberg.
Copyright (C) 1986 Stephen Satchell.

This product includes software developed by the MX4J project
(http://mx4j.sourceforge.net).

This product includes ICU 1.8.1 and later.
Copyright (c) 1995-2006 International Business Machines Corporation and others.

Portions copyright (c) 1997-2008 Cypress Semiconductor Corporation.
All rights reserved.

This product includes XORP.
Copyright (c) 2001-2004 International Computer Science Institute

This product includes software licensed from Macraigor Systems, LLC.
Copyright (c) 2004-2009, Macraigor Systems LLC. All rights reserved.

This product includes software from the book
"Linux Device Drivers" by Alessandro Rubini and Jonathan Corbet,
published by O'Reilly & Associates.

This product includes hashtab.c.
Bob Jenkins, 1996.

 

System Requirements

Host Software Requirements

-------------------------------------------
ERROR: Problem encountered executing chklic utility located here:
    /home/qa/l_MID_DBG_p_2.1.xxx/data/chklic.32
The chklic program /home/qa/l_MID_DBG_p_2.1.xxx/data/chklic.32 requires these libraries:
      linux-gate.so.1 => 
      libpthread.so.0 => /lib/libpthread.so.0
      libm.so.6 => /lib/libm.so.6
      libstdc++.so.5 => not found
      libgcc_s.so.1 => /lib/libgcc_s.so.1
      libc.so.6 => /lib/libc.so.6
      libdl.so.2 => /lib/libdl.so.2
      /lib/ld-linux.so.2
You need to install libstdc++5 library to continue the installation.
It requires superuser or "root" privileges.
Exiting installation program.
-------------------------------------------

Target Software Requirements

One of the following environments:

Hardware Requirements

 

Installing the Debugger

The default installation directory is:

/opt/intel/atom/idb/2.0.xxx

This debugger can coexist with the Intel(R) Debugger IDB that is part of the Intel(R) C++ Compiler installation and targets native Embedded debugging with the installation path

/opt/intel/Compiler/idb/11.1.xxx 

It can also coexist with the Intel(R) JTAG Debugger for Intel(R) Atom(TM) processor with installation path

/opt/intel/atom/xdb/2.1.xxx

Perform the following steps to install the debugger.

  1. Unpack the tool suite package in a directory to which you have write access.
    > tar -zxvf l_MID_DBG_p_2.1.xxx.tar.gz
  2. If you do not have a license file, please note the product serial number. You will need it to complete the installation process. Otherwise copy the license file you may have received via email from the Intel(R) Software Development Products Registration Center to /opt/intel/licenses/.  
  3. It is recommended to register your product at https://registrationcenter.intel.com . If you purchased support for this product you will need to register to take full advantage of Intel Premier Support athttps://premier.intel.com .

  4. Change into the directory the tar file was extracted to ../l_MID_DBG_p_2.1.xxx

  5. Run the installation script

    Execute the install script in the directory where the tar file was extracted.
    >./install.sh

  6. If you are not logged in as root, you will be asked if you want to install as root, install as root using sudo, or install without root privileges. Installing as root (using sudo if you have that privilege) is recommended, as that will update the system RPM database. Use the install as current user option if you want to install to a private area.
  7. In the next step you will be informed about the Intel(R) Embedded Software Development Tool Suite for Intel(R) Atom(TM) processor components and the installation flow. Press the Enter key to continue
  8. Afterwards you will be asked to read the end-user license agreement for the tool suite. Press the Enter key to continue with reading the license agreement. Once done type acceptto continue with the installation.
  9. When asked whether you would like to activate and install your product select one of th eoptions provided depending on whether you have a license file available or not. If there is already a valid license file available and installed on your system, the installation routine will recommend to simply use the existing license file. If you do not have access to the internet at the time of installation select the alternative activation option.
  10. You can choose between a typical install, which installs all tool suite components or a custome install, which permits the selection of individual tool suite components.

Step no: 4 of 7 | Installation Type
--------------------------------------------------------------------------------
Congratulations! Your software has been activated. Please continue the
installation by choosing Typical Install (default installation options) or
Custom Install to change the default installation options.
--------------------------------------------------------------------------------
1. Typical Install (Recommended) [default]
2. Custom Install (For Advanced Users)

h. Help
b. Back to the previous menu
q. Quit
--------------------------------------------------------------------------------
Please type a selection or press "Enter" to accept default choice [1]:
 

  1. If you choose the recommended typical install you can decide to add a kernel patch for Intel(R) Embedded Debugger instruction trace awareness.
  2. After reviewing the installation options

Step no: 4 of 7 | Configuration - Intel(R) VTune(TM) Performance Analyzer
-------------------------------------------------------------------------------
- Select '1' to use current settings.
- Select options 2-6 to change the installation settings.
-------------------------------------------------------------------------------

1. Finish configuration

2. VTune analyzer group         [ use group 'vtune' ]
3. Driver kit options...        [ auto ]
4. Eclipse options...           [ install ]
5. Advanced options...          [ installation type: 'full install' ]

h. Help
b. Back to the previous menu
q. Quit
-------------------------------------------------------------------------------
Please type a selection or press "Enter" to accept default choice [1]:

 

you can finalize the configuration and commence with the tool suite component installation itself.

  1. The installation will be finalized and you will be informed when the installation has been completed succesfully.  

Uninstalling the Debugger

To uninstall the Intel(R) Application Debugger, simply change into the /opt/intel/atom/idb/2.0.xxx/bin directory and run the uninstall.sh script.

First Steps

Enabling the Intel Debugger Remote Server

Before you can start the debugger, you need to first start the Intel Debugger Remote Server on the target system. The remote server, idbserver_LINUX32, is installed with the debugger installation on the host system.

To enable the Intel(R) Debugger Remote Server:

  1. Copy the Intel(R) Debugger Remote Server from the host system to the shared drive. Open a shell and use the following command:

    cp install_dir/atom/idb/2.0.xxx/server/idbserver_LINUX32 /mnt/shared/

    Notice that the path includes the full version number including update number.

  2. Start the remote server from a shell. Use the following command:

    /mnt/shared/idbserver_LINUX32

Leave this shell open while the remote server is running.

Starting the Debugger

To start the debugger, enter the following command in a shell on the host, separate from the remote server shell:

install_dir/atom/idb/2.0.xxx/bin/idb.sh

The debugger is now running.

 

Connecting to a Remote Debugging Target

Before you can open an Embedded to debug, you must connect to the system on which it is running, the target.

To connect to the target:

  1. Get the IP address of the target by using the ifconfig command on the target system. Against eth0 look for an inet entry, such as 10.100.15.78. Note this address to use it as the IP address.
  2. Select File > Connect....
    The Open Connections dialog box opens.
  3. Enter the IP address of the target from step 1.
  4. Enter the port number of the target. The target shell displays the port number when you start the Intel(R) Debugger Remote Server.
  5. Click OK.

The host connects to the target system. The Intel(R) Debugger remote server command shell on the target indicates that it is connected.

The debugger is now ready to be used and to be attached to a debuggee process. Please refer to the Getting Started document at /opt/intel/atom/documentation/idb/Getting_Started.html for more details.

 

Applying the Kernel Patch to Enable Thread-Specific Execution Trace

If you selected to install the kernel patch for Linux* OS thread-aware execution trace visibility you will find it located in the installation directory /opt/intel/atom/idb/2.0.xxx/kernel-patches/trace/ after the installation is complete.

  1. Download and install the kernel sources
  2. Chdir to the top level kernel source directory
  3. Apply the patch using

    patch < patch-kernel-<version>-idb

    In the current release there are two patch files available to choose from.

    The files "patch-kernel-2.6.22-idb.dpatch" and "patch-kernel-2.6.24-idb.dpatch " are generic versions of this kernel patch, which should be applicable as is for most 2.6.2x kernel version based Linux distributions.

  4. Rebuild the kernel and copy and install it on the target device.
     

Technical Support

For general support information please visit Intel's Software Developer Support homepage.

To submit issues related to this product please visit the Intel Premier Support webpage and submit issues under the product  Intel(R) Embedded SW Dev Tools Atom.

For information on how to register for and purchase support for the Intel(R) Embedded Software Development Tool Suite for Intel(R) Atom(TM) processor please visit the Intel(R) Software Development Products webpage.

Additional support for this product is available at the Intel(R) Software Development Tool Suites for Intel(R) Atom(TM) processor forum which is a sub-forum of the Intel(R) Software Network Community Forums for issue discussion and community support.

 

Disclaimer and Legal Information

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.
UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY Embedded IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR.
Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information.
The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.
Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.
Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or by visiting Intel's Web Site.

Intel processor numbers are not a measure of performance. processor numbers differentiate features within each processor family, not across different processor families. See http://www.intel.com/products/processor_number for details.

BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino Atom, Centrino Atom Inside, Centrino Inside, Centrino logo, Core Inside, FlashFile, i960, InstantIP, Intel, Intel logo, Intel386, Intel486, IntelDX2, IntelDX4, IntelSX2, Intel Atom, Intel Atom Inside, Intel Core, Intel Inside, Intel Inside logo, Intel. Leap ahead., Intel. Leap ahead. logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel StrataFlash, Intel Viiv, Intel vPro, Intel XScale, Itanium, Itanium Inside, MCS, MMX, Oplus, OverDrive, PDCharm, Pentium, Pentium Inside, skoool, Sound Mark, The Journey Inside, Viiv Inside, vPro Inside, VTune, Xeon, and Xeon Inside are trademarks of Intel Corporation in the U.S. and other countries.

* Other names and brands may be claimed as the property of others.

Copyright © 2007-2009, Intel Corporation. All rights reserved.