Installation of Wind River VxWorks tools


This article describes how to install the Wind River VxWorks-related tools on an IHA PC. The complete installation wil take 2-3 hours depending on the speed of your computer.

IMPORTANT: Follow this guide to the end - a lot of users forget to build the default components (see the end of this article) which will lead to errors when you try to build applications


This procedure describes how the installation of Wind River Tools should be made. The tools will be installed at C:\Windriver.

To install the tools, you must obtain the following:
  • Installation media set (CD-ROMs)
  • License File
  • License Administration Code (LAC)

from TFJ or from the IHA network drive K:\staff2stud\EIT-elektro og IKT\All Students\VxWorks.

"Installing"the license file

Copy the obtained license file to a new directory, C:\Windriver\license

Installation of Wind River Workbench 2.x

This procedure will perform a Wind River Workbench 2.x installation. This must be done before any other products are installed!
  1. Run the "WindRiver Workbench 2.x” CD, marked with “INSTALL FIRST”. For installation from network: Use files in the folder named "install first"
  2. Accept license agreement
  3. In Specify Installation Directory, Accept installation directory (C:\windriver)
  4. In End User Information, enter the License Authorization Code (LAC).
  5. In End User Information, enter remaining user information as shown below:
  1. In Computer Information, select DISK_SERIAL_NUMBER as Host ID
  2. In Select Information Type, select "I have the product installation file..." (option 3) . Specify the location of the WRSLicense.lic-file (C:\Windriver\License\wrslicense.lic)
  3. In Select Program Group, use defaults
  4. In Select Products Filter, use defaults
  5. The installation will now check the registry. Note: If the "Checking Registry..." info seems to hang, press the "X" in top right corner of the dialog, then select "No" to the cancellation confirmation. This seems to bring the installation out of the hanging...
  6. In Pre-Installation Summary, select "Next"
The installation will now proceed.

Installation of other products

Necessary Products

The “Developer Installation Media” hard-copy folder (or the network directory) contains a set of CDs. Necessary installations are:
  • VxWorks 6.3 and General Purpose Technologies, All Architectures
  • Wind River Compiler 5.4.0, All Architectures
  • Wind River GNU Compiler 3.4.4 for VxWorks 6.3, All Architectures
  • Board Support Packages for VxWorks 6.3 BSPs for Intel Architecture and SuperH
  • Wind River Platform Technologies For Automotive Devices, Consumer Devices,..., All Architectures

For installation from network: The above necessary installations are marked "cd2" thru "cd6"

To install the above, insert the applicable CD and follow the on-screen procedure. All selections should be left at default settings, as the settings are now taken from the information provided during the Workbench installation.

Other Products

Apart from the above, IHA has access to the following:
  • Board Support Packages for VxWorks 6.3 BSPs for MIPS
  • Board Support Packages for VxWorks 6.3 BSPs for ARM and XScale
  • Board Support Packages for VxWorks 6.3 BSPs for PowerPC

These are not part of a standard installation.

Compilation of default platform components

IHA has been equipped with a certain version of VxWorks that requires that the platform component source to be compiled before any build of boot loaders, kernel images etc. can take place.

Note: When you start Workbench for the first time to follow the steps below, a number of error messages will appear (it's mostly stuff about modules/packages that failed to install). Don't worry, be happy! It's quite normal and does not mean that something is wrong or that your installation of the VxWorks tools somehow failed.

Follow the procedure below to compile the platform component source (taken from "Wind River VxWorks Platforms, Getting Started, 3.3", section 3.2):

Step 1: Create a User-defined Project

  1. Open Workbench and select File > New > User-Defined Project
  2. From the Target Operating System list, select Wind River VxWorks 6.3, the click Next
  3. Provide a name for the project (it will be removed again later)
  4. Select Create Project at external location, and specify <installdir>/vxWorks-6.3 (or click browse and navigate to the directory), where <installdir> is usually c:\windriver. Then click Next
  5. Ensure that User-defined build is selected, then enter the following as your Build Command:
    • make CPU=PENTIUM TOOL=diab comp-kernel
  6. Under Make Rules for User-defined build, enter the following as your Clean Project Rule:
    • TARGET=rclean
  7. All other options can be left at the default state
  8. Click Finish

Step 2: Clean the Project

Right-click your project and select Clean Project. This step may take several minutes

Step 3: Build the Project

Right-click your project and select Build Project. If prompted to generate include paths, click "Ignore".

This step will take several minutes. When done, the default platform components will have been built once and for all and are ready for inclusion.

Step 4: Delete the Project

THIS IS IMPORTANT! You must now delete the project again. When you do so,

DO NOT DELETE THE CONTENTS OF installdir/vxWorks-6.3!

When prompted to confirm the deletion, make absolutely sure that the radio button "Do not delete contents" is set!