QorIQ Configuration and Validation Suite Installation Guide
Document Number: QCVSINSTALLUG Rev 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 1 Introduction 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
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 3 QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 4 Freescale Semiconductor, Inc. Chapter 1 Introduction
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 and CodeWarrior for ARMv7. This is a Java-based product intended to be used on both Linux and Windows host systems. NOTE A QCS installation cannot be upgraded to QCVS. You will encounter an error if it is attempted. Both QCS and DDR Validation Tool products must be uninstalled first in order to install QCVS. For details, see Uninstalling QCS and DDR Validation 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:
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 5 Prerequisites • using an all-in-one installer that installs a stock version of Eclipse 4.2 with QCVS pre-installed. The installer is an executable file (for Windows and Linux), all is needed is to execute it, select the install location and click Finish. • as an add-on feature for CodeWarrior, stock Eclipse, or a commercial Eclipse-based product. 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 using an existing Eclipse environment, make sure that you have installed the supported version of Eclipse. If you have not installed supported version of Eclipse yet, it is recommended to 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/
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 6 Freescale Semiconductor, Inc. Chapter 1 Introduction • 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 version of Eclipse. It must support any and all plugins that can be installed into a stock Eclipse. • If installing into CodeWarrior, current user must have root (Linux case) or administrator (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\
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/
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 7 Installation general considerations 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 by the 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 the Eclipse 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 one obtained from eclipse.org, or one in a commercial product (for example, CodeWarrior). • The installation of QCVS relies on a Freescale Eclipse updater feature. This feature is not part of Eclipse stock distributions, but is bundled with CodeWarrior. For this reason the installation of QCVS over an Eclipse other than CodeWarrior requires that you first install the Eclipse Updater feature (see installation steps for details). This feature 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, be updated to a newer version via Help > Check for Updates. • Installing over the internet and from local packages are fundamentally the same procedure. The only difference is where the distribution files are located. Once you point Eclipse to this location, the installation steps are identical.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 8 Freescale Semiconductor, Inc. Chapter 1 Introduction • The all-in-one installation is the easiest way to get QCVS. If you do not have an Eclipse installation on your machine, or do but don’t need QCVS installed into it, it’s recommended 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 the options below and pick the one that best matches your requirements. • To install QCVS into an existing installation of CodeWarrior Development Studio for Power Architecture, see Installation over CodeWarrior for Power Architectures topic. • To Install QCVS into an existing installation of Eclipse, see Installation over Eclipse topic. • To install a full working environment with QCVS over Eclipse 4.2, see Installation using all-in-one installer topic.
1.5 Installation over CodeWarrior for Power Architectures CodeWarrior for Power Architectures is a modified version of stock Eclipse and comes with its own predefined update sites. An update site points to a web location containing updates of new packages which can be installed over an existing CodeWarrior installation. QCVS product is one of the packages contained by such predefined CodeWarrior for Power Architectures (10.2 or newer) update site. • Start CodeWarrior for Power Architectures and select Help > Install New Software option. • 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.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 9 Installation over Eclipse • Click the Next button and then accept the license agreement and the Freescale digital signature. • Click Finish. A message box will appear asking to restart the CodeWarrior.
1.6 Installation over Eclipse To 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
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 10 Freescale Semiconductor, Inc. Chapter 1 Introduction
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.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 11 Installation over Eclipse
Figure 1-3. QVS packages installing from local disk 2. 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
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 12 Freescale Semiconductor, Inc. Chapter 1 Introduction 3. Select QorIQ Configuration and Validation Suite from the available list. This will install the QCVS product.
Figure 1-5. Installation of QCVS package 4. 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 installer You 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/qcvs 2. 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 QCVS QCVS can be upgraded to a newer version in future using Help > Check for Updates in the Eclipse menu bar. NOTE Because QCVS is bundled with CodeWarrior for ARM v7, upgrading CodeWarrior may upgrade the version of QCVS in the product. However, QCVS can be independently upgraded as needed.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 13 Uninstalling QCS and DDR Validation product 1.9 Uninstalling QCS and DDR Validation product To 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 menu 2. The Available Software page appears. Click on the link What is already installed.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 14 Freescale Semiconductor, Inc. Chapter 1 Introduction
Figure 1-7. Available Software page 3. The Installed Software page appears. You can select the DDR Validation and QorIQ Configuration Suite from the list and click Uninstall.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 15 Uninstalling QCS and DDR Validation product
Figure 1-8. Installed Software page 4. The Uninstall Details page appears. Click Finish to complete the uinstallation.
Figure 1-9. Uninstall Details page
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 16 Freescale Semiconductor, Inc. Chapter 1 Introduction 5. A message box will appear asking to restart the application for the changes to take effect. Click Restart Now.
Figure 1-10. Software Updates
1.10 Troubleshooting
This section describes how to resolve the issues that appear during the QorIQ Configuration and Validation Suite installation. While installing QorIQ Configuration and 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 have JRE 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 by the hosting Eclipse environment. To install appropriate version of JRE into your system: For Windows users:
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 17 Troubleshooting 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 Screen 3. 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 static installation to be used by a specific application only using the steps in the topic Static Installation of JRE.
1.10.1.1 Static Installation of JRE
1. Run the downloaded *.exe with parameter STATIC=1
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 18 Freescale Semiconductor, Inc. Chapter 1 Introduction
Figure 1-13. Static Installation 2. 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 the Java 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.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 19 Troubleshooting
Figure 1-15. Java SE Download for Linux 3. 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.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 20 Freescale Semiconductor, Inc. Chapter 1 Introduction
Figure 1-16. Extracting JRE Archived File 5. Rename the jre1.7.0 folder to jre.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 21 Troubleshooting
Figure 1-17. Renaming JRE Folder
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 If you receive the following warning message after you installed QorIQ Configuration and Validation Suite and restarted Eclipse, it means your Eclipse environment does not use the required JRE version.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 22 Freescale Semiconductor, Inc. Chapter 1 Introduction
Figure 1-18. Wrong Java Version Message It is recommended to update your system JRE. If you do not want to upgrade your system JRE, you can install the required version of JRE statically for the Eclipse environment only where QorIQ Configuration and Validation Suite should be installed. To install the JRE statically, follow the steps described in the Static Installation of JRE.
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. If you receive the following (or similar) error message after the QorIQ Configuration Suite installation while creating a new project, it means you did not use Administrator permissions during installation. This particular error occurs when you have CodeWarrior installed in the "Program Files" folder on Windows 7 or Vista.
Generator: INTERNAL ERROR: at line : Error in including "
INTERNAL ERROR: at line
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 23 Troubleshooting c. Enter administrator login ID and password in the administrator login dialog. If the administrator login dialog does not appear, quit CodeWarrior, log off from Windows 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 Suite into CodeWarrior for Power Architecture on Windows 7/ Windows Vista. The installation process stopped with the following 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
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.
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 and Validation Suite Installation Guide, Rev. 4.1, 10/2014 24 Freescale Semiconductor, Inc. Chapter 1 Introduction As per CodeWarrior updates installation rule, the administrator permissions must be used when you install QorIQ Configuration and Validation Suite into CodeWarrior. This particular error occurs when you have CodeWarrior installed in some root location like /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.
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 Freescale Semiconductor, Inc. 25 Troubleshooting
QorIQ Configuration and Validation Suite Installation Guide, Rev. 4.1, 10/2014 26 Freescale Semiconductor, Inc. How to Reach Us: Information in this document is provided solely to enable system and software implementers to use Freescale products. There are no express Home Page: or implied copyright licenses granted hereunder to design or fabricate freescale.com any integrated circuits based on the information in this document. Web Support: Freescale reserves the right to make changes without further notice to freescale.com/support any products herein. Freescale makes no warranty, representation, or guarantee regarding the suitability of its products for any particular purpose, nor does Freescale assume any liability arising out of the application or use of any 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 sheets and/or specifications can and do vary in different applications, and actual performance may vary over time. All operating parameters, including “typicals,” must be validated for each customer application by customer's technical experts. Freescale does not convey any license under its patent rights nor the rights of others. Freescale sells products pursuant to standard terms and conditions of sale, which can be found at the following address: freescale.com/SalesTermsandConditions. Freescale, the Freescale logo, CodeWarrior, Processor Expert, and QorIQ are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. All other product or service names are the property of their respective owners. © 2011–2014 Freescale Semiconductor, Inc.
Document Number QCVSINSTALLUG Revision 4.1, 10/2014