QorIQ Configuration and Validation Suite …cache.freescale.com/files/soft_dev_tools/doc/user_guide/...Uninstalling QCS and DDR Validation ... 24 QorIQ Configuration and Validation

QorIQ Configuration and ValidationSuite Installation Guide

Document Number: QCVSINSTALLUGRev 4.1, 10/2014

QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014

2 Freescale Semiconductor, Inc.

Contents

Section number Title Page

Chapter 1Introduction

1.1 Utilization Scenarios.......................................................................................................................................................5

1.2 Installation Scenarios......................................................................................................................................................5

1.3 Prerequisites....................................................................................................................................................................6

1.3.1 Windows............................................................................................................................................................ 7

1.3.2 Linux.................................................................................................................................................................. 7

1.3.3 Target Operating Environments.........................................................................................................................8

1.4 Installation general considerations..................................................................................................................................8

1.5 Installation over CodeWarrior for Power Architectures.................................................................................................9

1.6 Installation over Eclipse..................................................................................................................................................10

1.7 Installation using all-in-one installer.............................................................................................................................. 13

1.8 Upgrading QCVS............................................................................................................................................................13

1.9 Uninstalling QCS and DDR Validation product.............................................................................................................13

1.10 Troubleshooting.............................................................................................................................................................. 17

1.10.1 I installed Eclipse but I can't run it.....................................................................................................................17

1.10.1.1 Static Installation of JRE....................................................................................................................18

1.10.2 I have successfully installed QorIQ Configuration and Validation Suite, but I see JRE compatibility

warning when Eclipse starts and QorIQ Configuration and Validation Suite does not work........................... 22

1.10.3 I installed QorIQ Configuration and Validation Suite into CodeWarrior for Power Architecture on

Windows 7/Windows Vista. The installation process finished without any errors. However, QorIQ

Configuration and Validation Suite does not work............................................................................................23

1.10.4 I tried to install QorIQ Configuration and Validation Suite into CodeWarrior for Power Architecture on

Windows 7/Windows Vista. The installation process stopped with the following error message.................... 24

1.10.5 I tried to install QorIQ Configuration and Validation Suite into CodeWarrior for Power Architecture on

Linux. I receive the following (or similar) error message during the installation............................................. 24


Freescale Semiconductor, Inc. 3



Chapter 1Introduction

This document describes how to install QorIQ Configuration and Validation Suite(QCVS) on the Eclipse environment.

The QCVS product is available as an update package for Eclipse IDE for C and C++developers 3.7, 4.2.x, Eclipse version of CodeWarrior for Power Architecture andCodeWarrior for ARMv7. This is a Java-based product intended to be used on both Linuxand Windows host systems.

NOTEA QCS installation cannot be upgraded to QCVS. You willencounter an error if it is attempted. Both QCS and DDRValidation Tool products must be uninstalled first in order toinstall QCVS. For details, see Uninstalling QCS and DDRValidation product for instructions on how to uninstall them.

1.1 Utilization Scenarios

QCVS can be used with:• CodeWarrior for Power Architectures product (10.2 or later) layout• CodeWarrior for ARM v7 product (10.0.2 or later). In this case explicit QCVS

installation is not required, since it comes bundled with the CodeWarrior product.• any Eclipse installation 3.7 and 4.2 (a stock installation from eclipse.org or a

commercial Eclipse-based product)

1.2 Installation Scenarios

QCVS can be installed:



• using an all-in-one installer that installs a stock version of Eclipse 4.2 with QCVSpre-installed. The installer is an executable file (for Windows and Linux), all isneeded is to execute it, select the install location and click Finish.

• as an add-on feature for CodeWarrior, stock Eclipse, or a commercial Eclipse-basedproduct.

QCVS can be installed from:• the Internet (only applicable when adding QCVS to a pre-existing Eclipse

installation/product)• installation packages are obtained from the Freescale website and stored on a local

disk

This product has been tested on the following host system platforms:

• Ubuntu 12.04 LTS (64-bit)• Ubuntu 13.10 (64-bit)• Ubuntu 14.04 LTS (64-bit)• Fedora 20 (64-bit)• OpenSUSE 13.1 (64-bit)• RedHat Enterprise Linux 5.4 (64-bit)• RedHat Enterprise Linux 5 (32-bit)• RedHat Enterprise Linux 6.5 (64-bit)• Windows XP Professional (32-bit)• Windows 7 Professional (32-bit)• Windows 7 Professional (64-bit)• Windows 8 (64-bit)

1.3 Prerequisites

It explains the prerequisites to install QCVS on the Eclipse environment. If you are usingan existing Eclipse environment, make sure that you have installed the supported versionof Eclipse. If you have not installed supported version of Eclipse yet, it is recommendedto download the supported version from the link below:

http://www.eclipse.org/downloads/packages/release/juno/sr2

The installation prerequisites are:• Java Runtime Environment (JRE) 1.6 or higher. If installing QCVS via the all-in-one

installer, or if using CodeWarrior, this is not a concern, as a suitable JRE is provided.• Read/write permissions to /home/<username> (Linux case) location or <USER_PROFILES_DIR>

\<username> (Windows case)

Prerequisites



https://www.freescale.com

http://www.eclipse.org/downloads/packages/release/juno/sr2

• If installing into an Eclispe based product other than CodeWarrior and stock Eclipse,the product’s Eclipse, if modified, must be compatible with the community versionof Eclipse. It must support any and all plugins that can be installed into a stockEclipse.

• If installing into CodeWarrior, current user must have root (Linux case) oradministrator (Windows case) permissions.

1.3.1 Windows

To install the product on the Windows host system, following is the prerequisite:• Eclipse stores your projects in a folder called workspace. This folder needs to be set

up in any folder that you can fully access. For example, C:\Profiles\<username>\workspace.

The product has been tested on:• Windows XP Professional (32-bit)• Windows 7 Professional (32/64-bit)• Windows 8 (64-bit)

To install the product into CodeWarrior, you require Administrator permissions for bothWindows Vista and Windows 7 platforms.

1.3.2 Linux

To install the product on Linux, following is the prerequisite:

Eclipse stores your project in a folder called workspace. For example, /home/<username>/ workspace. Make sure your workspace has read/write permissions set to beaccessible by Eclipse.

The product has been tested on:• Ubuntu 12.04 LTS (64-bit)• Ubuntu 13.10 (64-bit)• Ubuntu 14.04 LTS (64-bit)• Fedora 20 (64-bit)• OpenSUSE 13.1 (64-bit)• RedHat Enterprise Linux 5.4 (64-bit)• RedHat Enterprise Linux 5 (32-bit)• RedHat Enterprise Linux 6.5 (64-bit)

Chapter 1 Introduction



Administrator (root) permissions are required to install the product into CodeWarrior.

1.3.3 Target Operating Environments

The QCVS product can be installed into the following Eclipse environments:

• Eclipse 3.7 (Indigo) IDE for C/C++ Developers• Eclipse 4.2 (Juno) IDE for C/C++ Developers• CodeWarrior for Power Architectures 10.2 or newer• CodeWarrior for ARMv7

The product needs Java Runtime Environment (JRE) version 1.6 or higher to be used bythe hosting Eclipse environment.

If you are using some older version of JRE and do not want to update your system's JRE,you can install the version needed for QCVS statically so it will be used only by theEclipse environment where QCVS is installed. See Troubleshooting for details.

1.4 Installation general considerations

• The QCVS product is deployed as an Eclipse feature. Therefore, Eclipse (3.7 or 4.2)is a requirement for installing and using QCVS. The Eclipse can be a stock oneobtained from eclipse.org, or one in a commercial product (for example,CodeWarrior).

• The installation of QCVS relies on a Freescale Eclipse updater feature. This featureis not part of Eclipse stock distributions, but is bundled with CodeWarrior. For thisreason the installation of QCVS over an Eclipse other than CodeWarrior requires thatyou first install the Eclipse Updater feature (see installation steps for details). Thisfeature is distributed with QCVS.

• CodeWarrior for ARMv7 includes the QCVS product. Therefore, QCVS need not,and cannot, be explicitly installed into CodeWarrior for ARMv7. It can, however, beupdated to a newer version via Help > Check for Updates.

• Installing over the internet and from local packages are fundamentally the sameprocedure. The only difference is where the distribution files are located. Once youpoint Eclipse to this location, the installation steps are identical.

Installation general considerations



• The all-in-one installation is the easiest way to get QCVS. If you do not have anEclipse installation on your machine, or do but don’t need QCVS installed into it, it’srecommended you install QCVS using the all-in-one installer.

• QCS 3.0.x cannot be upgraded to QCVS.

Listed below are several methods that can be used to install QCVS. You can review theoptions below and pick the one that best matches your requirements.

• To install QCVS into an existing installation of CodeWarrior Development Studiofor Power Architecture, see Installation over CodeWarrior for Power Architecturestopic.

• To Install QCVS into an existing installation of Eclipse, see Installation over Eclipsetopic.

• To install a full working environment with QCVS over Eclipse 4.2, see Installationusing all-in-one installer topic.

1.5 Installation over CodeWarrior for Power ArchitecturesCodeWarrior for Power Architectures is a modified version of stock Eclipse and comeswith its own predefined update sites. An update site points to a web location containingupdates of new packages which can be installed over an existing CodeWarriorinstallation. QCVS product is one of the packages contained by such predefinedCodeWarrior for Power Architectures (10.2 or newer) update site.

• Start CodeWarrior for Power Architectures and select Help > Install New Softwareoption.

• Choose the predefined update site location.

Figure 1-1. Predefined update site link• Select QorIQ Configuration and Validation Suite from the available list. If QCVS

version is already installed, it will appear checked in the list.




• Click the Next button and then accept the license agreement and the Freescale digitalsignature.

• Click Finish. A message box will appear asking to restart the CodeWarrior.

1.6 Installation over EclipseTo install QCVS over Eclipse, perform these steps:

1. From the Eclipse main menu, select Help > Install New Software option.• If installing from a web location, type the URL depending on which Eclipse

stock you are installing over:

http://freescale/com/lgfiles/updates/Eclipse/QCVS

Installation over Eclipse



Figure 1-2. Enter URL for QCVS web installation• If installing from a disk location, choose the QCVS packages (.zip file) selecting

the Add > Archive >Open button as shown in figure below.




Figure 1-3. QVS packages installing from local disk2. Select Eclipse Freescale Solution Category from the available list. This will allow

updating the Eclipse stock updater (see general considerations #2).

Figure 1-4. Upgrading Eclipse stock updater

Installation over Eclipse



3. Select QorIQ Configuration and Validation Suite from the available list. This willinstall the QCVS product.

Figure 1-5. Installation of QCVS package4. Click Next and then accept the license agreement and the Freescale digital signature.5. Click Finish. A message box will appear asking to restart the CodeWarrior.

1.7 Installation using all-in-one installerYou can use all-in-one installer to install QCVS over an Eclipse 4.2 stock.

1. Download all-in-one installer from http://www.freescale.com/qcvs2. Run the installer.3. The QorIQ Configuration and Validation Suite Setup Wizard window will be

displayed.4. Follow the instructions in the wizard to complete the installation.

1.8 Upgrading QCVSQCVS can be upgraded to a newer version in future using Help > Check for Updates inthe Eclipse menu bar.

NOTEBecause QCVS is bundled with CodeWarrior for ARM v7,upgrading CodeWarrior may upgrade the version of QCVS inthe product. However, QCVS can be independently upgraded asneeded.




http://www.freescale.com/qcvs

1.9 Uninstalling QCS and DDR Validation productTo uninstall QCS and DDR validation tool, perform these steps:

1. Click Help menu of the IDE to select Install New Software option as shown below.

Figure 1-6. Help menu2. The Available Software page appears. Click on the link What is already installed.

Uninstalling QCS and DDR Validation product



Figure 1-7. Available Software page3. The Installed Software page appears. You can select the DDR Validation and

QorIQ Configuration Suite from the list and click Uninstall.




Figure 1-8. Installed Software page4. The Uninstall Details page appears. Click Finish to complete the uinstallation.

Figure 1-9. Uninstall Details page

Uninstalling QCS and DDR Validation product



5. A message box will appear asking to restart the application for the changes to takeeffect. Click Restart Now.

Figure 1-10. Software Updates

1.10 Troubleshooting

This section describes how to resolve the issues that appear during the QorIQConfiguration and Validation Suite installation. While installing QorIQ Configurationand Validation Suite, you might encounter the following problems.

1.10.1 I installed Eclipse but I can't run it

If you receive the following message while launching Eclipse, it means you do not haveJRE installed in your system. Eclipse is a Java-based application and need JRE to be run.

Figure 1-11. No JRE Installed Message

QorIQ Configuration and Validation Suite needs JRE version 1.6 or higher to be used bythe hosting Eclipse environment. To install appropriate version of JRE into your system:

For Windows users:




1. Navigate to the Java SE download section of Oracle website http://www.oracle.com/technetwork/java/javase/downloads/

2. Accept the licence agreement and download the JRE installer.

Figure 1-12. Java SE Download Screen3. If you want to install JRE to be default for all applications in your system, just run

the downloaded *.exe file.4. If you do not want to affect your system's Java installation, for example, if you want

to use specific JRE versions for some specific application, you can create a staticinstallation to be used by a specific application only using the steps in the topic StaticInstallation of JRE.

1.10.1.1 Static Installation of JRE

1. Run the downloaded *.exe with parameter STATIC=1

Troubleshooting



http://www.oracle.com/technetwork/java/javase/downloads/


Figure 1-13. Static Installation2. Change the target path to a desired location, for example, use Eclipse\jre path for an

installation of JRE into a particular Eclipse installation.

Figure 1-14. Changing Target Path

For Linux users, JRE is installed by a Linux packaging system:

1. If you want to use some specific version of JRE for some application, navigate to theJava SE download section of Oracle website: http://www.oracle.com/technetwork/java/javase/downloads/.

2. Accept the licence agreement and download g-zipped version of the JRE installer.64-bit JRE is of no use for QCVS.






Figure 1-15. Java SE Download for Linux3. Unpack the archived file using the graphical archiver or using the tar -vxzf

jre*.tar.gz command.4. Copy the extracted folder and paste it into your Eclipse directory.

Troubleshooting



Figure 1-16. Extracting JRE Archived File5. Rename the jre1.7.0 folder to jre.




Figure 1-17. Renaming JRE Folder

1.10.2 I have successfully installed QorIQ Configuration andValidation Suite, but I see JRE compatibility warning whenEclipse starts and QorIQ Configuration and ValidationSuite does not work

If you receive the following warning message after you installed QorIQ Configurationand Validation Suite and restarted Eclipse, it means your Eclipse environment does notuse the required JRE version.

Troubleshooting



Figure 1-18. Wrong Java Version Message

It is recommended to update your system JRE. If you do not want to upgrade your systemJRE, you can install the required version of JRE statically for the Eclipse environmentonly where QorIQ Configuration and Validation Suite should be installed. To install theJRE statically, follow the steps described in the Static Installation of JRE.

1.10.3 I installed QorIQ Configuration and Validation Suite intoCodeWarrior for Power Architecture on Windows 7/Windows Vista. The installation process finished withoutany errors. However, QorIQ Configuration and ValidationSuite does not work.

If you receive the following (or similar) error message after the QorIQ ConfigurationSuite installation while creating a new project, it means you did not use Administratorpermissions during installation. This particular error occurs when you have CodeWarriorinstalled in the "Program Files" folder on Windows 7 or Vista.

Generator: INTERNAL ERROR: at line : Error in including "<component>.drv" (file: Drivers

\<component>.src)

and/or

INTERNAL ERROR: at line <line number>: %launchExt failed with the following error:

LaunchExtObject.LoadLibrary: not possible to load requested library...

Perform the following steps:1. Uninstall QorIQ Configuration and Validation Suite.2. Run CodeWarrior with Administrator permissions and install QorIQ Configuration

and Validation Suite using the following steps:a. Go to Windows Explorer and navigate to the <CodeWarrior Installation folder>

\eclipse folder.b. Right-click cwide.exe and select the Run as administrator option.




c. Enter administrator login ID and password in the administrator login dialog. Ifthe administrator login dialog does not appear, quit CodeWarrior, log off fromWindows and log in as administrator.

d. Install QorIQ Configuration and Validation Suite.e. Do not restart CodeWarrior after the installation, quit it, and run it again with

your own credentials.

1.10.4 I tried to install QorIQ Configuration and Validation Suiteinto CodeWarrior for Power Architecture on Windows 7/Windows Vista. The installation process stopped with thefollowing error message.

An error occurred while installing the items session context was:(profile=PlatformProfile,

phase=org.eclipse.equinox.internal.p2.engine.phases.Install, operand=null -->

[R]com.freescale.processorexpert.feature.qcs_root <QorIQ Configuration Suite version>,

action=com.freescale.updater.customactions.actions.FreescaleInstall). Target: Path <Path>

could not be created.

As per CodeWarrior updates installation rule, the Administrator permissions must beused when you install QorIQ Configuration and Validation Suite into CodeWarrior. Thisparticular error occurs when you have CodeWarrior installed in an administrator location,for example, the Program Files folder on Windows 7 or Windows Vista. Perform thefollowing steps to troubleshoot this problem:

1. Log off from Windows2. Log in to Windows as administrator.3. Install QorIQ Configuration and Validation Suite.4. Do not restart CodeWarrior after installation, quit it, log off from Windows, and log

in to Windows using your original credentials.

1.10.5 I tried to install QorIQ Configuration and Validation Suiteinto CodeWarrior for Power Architecture on Linux. Ireceive the following (or similar) error message during theinstallation.

An error occurred while installing the items session context was:(profile=PlatformProfile,

phase=org.eclipse.equinox.internal.p2.engine.phases.Install, operand=null -->

[R]com.freescale.processorexpert.feature.qcs_root <QorIQ Configuration Suite version>,

action=com.freescale.updater.customactions.actions.FreescaleInstall). Target: Path <Path>

could not be created.

Troubleshooting



As per CodeWarrior updates installation rule, the administrator permissions must be usedwhen you install QorIQ Configuration and Validation Suite into CodeWarrior. Thisparticular error occurs when you have CodeWarrior installed in some root locationlike /usr/lib/... on Linux. Perform the following steps to troubleshoot this problem:

1. Run CodeWarrior with administrator (root) permissions (sudo ./cwide).2. Install QorIQ Configuration and Validation Suite.3. Do not restart CodeWarrior after installation, quit it, and run it again using your own

credentials.




Troubleshooting



How to Reach Us:

Home Page:freescale.com

Web Support:freescale.com/support

Information in this document is provided solely to enable system andsoftware implementers to use Freescale products. There are no expressor implied copyright licenses granted hereunder to design or fabricateany integrated circuits based on the information in this document.Freescale reserves the right to make changes without further notice toany products herein.

Freescale makes no warranty, representation, or guarantee regardingthe suitability of its products for any particular purpose, nor doesFreescale assume any liability arising out of the application or use ofany product or circuit, and specifically disclaims any and all liability,including without limitation consequential or incidental damages.“Typical” parameters that may be provided in Freescale data sheetsand/or specifications can and do vary in different applications, andactual performance may vary over time. All operating parameters,including “typicals,” must be validated for each customer application bycustomer's technical experts. Freescale does not convey any licenseunder its patent rights nor the rights of others. Freescale sells productspursuant to standard terms and conditions of sale, which can be foundat the following address: freescale.com/SalesTermsandConditions.

Freescale, the Freescale logo, CodeWarrior, Processor Expert, andQorIQ are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat.& Tm. Off. All other product or service names are the property of theirrespective owners.

© 2011–2014 Freescale Semiconductor, Inc.

Document Number QCVSINSTALLUGRevision 4.1, 10/2014

http://www.freescale.com

http://www.freescale.com/support

http://freescale.com/SalesTermsandConditions

Documents

QorIQ Configuration and Validation Suite …cache.freescale.com/files/soft_dev_tools/doc/user_guide/...Uninstalling QCS and DDR Validation ... 24 QorIQ Configuration and Validation