Intel(R) Embedded Software Development Tool Suite 2.1
for Intel(R) Atom(TM) processor
Installation Guide

Document Number: 322069-003US

 

Contents

 

Introduction

This document explains how to install the Intel(R) Embedded Software Development Tool Suite 2.1  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. Each of the tool suite components has its own installation guide and its own release notes. Please follow them closely. 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 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

The different tools components included in this tool suite have different sets of host Linux* OS versions that they have been validated against. Please look at the individual component's installation guide and release notes after you unpacked the tool suite distribution using > tar -zxvf l_MID_DBG_p_2.1.xxx.tar.gz for details.

You can find individual installation guides at:

Furthermore you can find individual release notes after succesful installation at

The supported host OS information below is only providing a general overview and represents our actively validated platforms.

Additional Package Dependencies

The Intel(R) Application Software Development Tool Suite for Intel(R) Atom(TM) processor requires the installation of the compatibility libstdc++ package for the standard GCC 3.4 C++ libraries. For Ubuntu*  the libstdc++5 package in version 3.3.6-15 can be downloaded directly through the apt-get installer. On the original Fedora* installation media it is named compat-libstdc++-33-3.2.3-61.i386.rpm. (available also at http://rpmfind.net/linux/RPM/fedora/devel/i386/ ).  If you do not install this legacy compatibility package you may receive the following error message during installation:

-------------------------------------------
ERROR: Problem encountered executing chklic utility located here:
    /home/qa/l_MID_APPDBG_p_2.1.xxx/data/chklic.32
The chklic program /home/qa/l_MID_APPDBG_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.
-------------------------------------------

A successful install furthermore requires the following standard packages to be present: g++, gcc, libc6, libstdc++5, binutils

 

Security-enhanced Linux*

Security-enhanced Linux* settings (SELinux) are currently not supported by the Intel(R) VTune(TM) Performance Analyzer and need to be either disabled or set to permissive for a successful tool suite installation. If your Linux* distribution has SELinux enabled the following error message will be issued by the installer:

 

Target Software Requirements

The target platform should be based on one of the following environments:

For the Intel(R) VTune(TM) Performance Analyzer Sampling Collector you may want to additionally consult the Installation guide, which resides in the directory

after you unpacked it on the target with

> tar -xvzf vtune91u5_target.tar.gz

Hardware Requirements

Please see the validation and support overview matrix for the supported operating systems for your quick reference below:

 

Host-Target Platform Support Matrix

no not validated

*) partially validated

 

Table 1. Tool Suite components without direct target OS dependency

Host system     Compiler      Intel IPP
Fedora* 10 Z5xx, N270, CE3100, CE4100 Z5xx, N270, CE3100, CE4100
Fedora* 11 Z5xx, N270 Z5xx, N270
Asianux* 3 Z5xx, N270 Z5xx, N270

 

Table 2. Intel(R) VTune(TM) Performance Analyzer

Host /

Target

Moblin 

 

Midinux 2.0

 

CE FDK

 

Fedora* 10 Z5xx, N270 Z5xx, N270 CE3100, CE4100
Fedora* 11 Z5xx, N270 Z5xx, N270 CE3100*), CE4100*)
Asianux* 3 Z5xx, N270 Z5xx*), N270*) no

 

Table 3. Intel(R) Application Debugger

Host /

Target

Moblin 

 

Midinux 2.0 

 

CE FDK

 

Fedora* 10 Z5xx*), N270*) no CE3100, CE4100
Fedora* 11 Z5xx, N270 Z5xx CE3100*) , CE4100 *)
Asianux* 3 Z5xx, N270 Z5xx no

 

Table 4. Intel(R) JTAG  Debugger

Host /

Target

Z5xx 

 

CE3100 

 

 CE4100
Fedora* 10 yes yes yes 
Fedora* 11 yes  yes yes
Asianux* 3 yes  no no

 

Installing the Tool Suite

The default installation directories are:

for the VTune(TM) Performance Analyzer, Intel(R) Integrated Performance Primitives, Intel(R) C++ Compiler, Intel(R) Application Debugger and the Intel(R) JTAG Debugger respectively.

The tool suite is intended for Intel(R) Atom(TM) processor targeted cross-development. It is recommended to install the tool suite on your software development host system. It is further recommended to install selective components like the Intel(R) C++ Compiler, the Intel(R) IPP, the VTune(TM) Analyzer Sampling Collector (SEP) and the idbserver debug server in one of the following locations:

To understand the later two installation options and the integration of the Intel(R) Software Development Tool Suite for Intel(R) Atom(TM) processor with the Moblin build environment please refer to the Moblin* Integration Guide Moblin_Integration.htm.

 

For installation of the tool suite on the development host please follow the steps below:

  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 at https://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. The USB port configuration for the Intel(R) JTAG Debugger installation will however not be complete if current user install is selected. 
  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 accept to 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 will be prompted to choose one of several target processors. The debugger startup script install_dir/bin/xdb.sh automatically loads this processor. You can select a different target processor by starting the debugger using another startup script, called xdb_processor_name.sh, where processor_name is the name of the processor you want to use as the target. See install_dir/bin/ for the exact names of the different scripts. You can decide whether the default target processor supported by the Intel(R) JTAG Debugger shall be the Intel(R) Atom(TM) processor Z5xx, the Intel(R) Media processor CE3100 or the Intel(R) Atom(TM) processor CE4100. The Intel(R) Atom(TM) processor z5xx is the default selection.

 

  1. 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.  .

 

Installing the Intel VTune Performance Analyzer Sampling Collector on the target platform

  1. Please follow the instructions in ~/l_MID_DBG_p_2.1.xxx/INSTALL_VTUNE.txt closely.
  2. Copy the Intel(R) VTune(TM) Performance Analyzer Sampling Collector tool suite component located at ~/l_MID_DBG_p_2.1.xxx/rpm/vtune91u5_target.tar.gz onto the Mobile Internet Device.
  3. On the target Mobile Internet Device unpack the samplinc collector using the following command:

> tar -xvzf vtune91u5_target.tar.gz

  1. Run the install script ~/vtune91u5_target/install-vtune-sep.sh and follow the installation instructions outlined in  ~/vtune91u5_target/INSTALL.txt.

  2. The file vtune_user_guide.pdf, which  is located in ~/l_MID_DBG_p_2.1/, will give you detailed advice on how to use this utility.

Uninstalling the Tool Suite

To uninstall the entire tool suite change into the /opt/intel/atom directory and run the uninstall_atom.sh uninstall script. Individual tools components like the Intel(R) Application Debugger will additionally have an uninstall.sh script as part of their installation.

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) EmbeddedSW 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 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 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 APPLICATION 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.