Suite Switcher 4.0 (c) ARM Ltd 2003-2008.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-




Introduction
-=-=-=-=-=-=-


RealView Development Suite (RVDS) provides RealView Compilation Tools (RVCT),
RealView Debugger (RVD), Instruction Set Simulation Model (ISSM) and RealView
Instruction Set Simulator (RVISS) ARMulators, as well as either Eclipse or
CodeWarrior.


ARM Developer Suite (ADS) provides CodeWarrior, AXD and earlier generations
of compilation tools and ARMulator.


Although most users will install only one set of development tools, in some
circumstances you may wish to have both ADS and/or multiple versions of
RVDS (e.g. RVDS 3.0 and RVDS 3.1) installed at the same time.


For example:
- You may wish to use the ADS compilation tools for building
  your application code, but RVD and RVISS ARMulator for
  debugging.
- You may wish to use the RVCT tools for building your
  application code, but AXD for debugging.
- You may wish to compare code-generation improvements between two versions
  of RVDS and it is convenient to have them both installed at the same time.


This utility allows you to easily configure your PC for any of
the above three examples and will carry out all necessary setup of
environment variables.


Notes
1) This utility only switches between compilers and ARMulators.
   If both developer suites are installed, then AXD and RVD
   should both be accessible regardless of any settings made
   using Suite Switcher.


2) The CodeWarrior application provided as part of ADS cannot be
   used with the RVDS 2.0 or 2.1 compilers. If you are using RVDS 2.2 it
   will include a newer version of CodeWarrior that works with RVCT 2.2.
   You can use the mcp2make utility available from the Technical
   Support area of www.arm.com to convert CodeWarrior projects to
   makefiles. When you activate a suite which includes CodeWarrior
   (e.g. ADS 1.2, RVDS 2.2) it will also activate the correct version of
   CodeWarrior and change any relevant file associations to open with
   that version of CodeWarrior (i.e. .c files open with CodeWarrior).


3) RVDS 2.1 also includes AXD 1.3, in addition to AXD 1.2 which
   included with ADS 1.2.1. Only one version of AXD may be
   registered to operate at a time. You must choose which version
   of AXD to register. Suite Switcher allows you to choose the
   version of AXD to register. This mainly applies to running AXD
   from the Start menu. It is possible run the unregistered AXD
   from the command line. If AXD 1.2 is registered and RVDS is
   active, and you type 'axd' from the command-line, you will
   start AXD 1.3 (because it is on the search path) which is
   not the registered version of AXD.




Installing Suite Switcher
-=-=-=-=-=-=-=-=-=-=-=-=-


You must use a login with administrator privileges to install Suite Switcher.


If you are using a previous version of Suite Switcher you must uninstall it
before installing this version of Suite Switcher. To uninstall an earlier
version of Suite Switcher use the Add or Remove Programs control panel.




Using Suite Switcher
-=-=-=-=-=-=-=-=-=-=-


It is recommended that you quit AXD, RVD, CodeWarrior, etc. before using
SuiteSwitcher to activate another suite/debugger.


Starting Suite Switcher presents the user with a simple dialog
box with two groups of radio buttons - one labeled "Suite" to
choose which developer suite to enable (e.g. ADS 1.2.1, RVDS 2.1)
and another group labeled "AXD" to choose which version of AXD to
register for operation. The selected radio buttons indicate
which developer suite is currently active or which version of
AXD is registered. There is also a small text field below the
radio buttons describing the currently active developer suite and
registered version of AXD.


If no radio button is selected for the Suite group, then no
developer suite is fully active, which can lead to unpredictable
behaviour. In normal usage of the tools, this will happen after
installing or uninstalling a second developer suite (as some
environment variables will be set for RVDS and other environment
variables set for ADS). Selecting one of the radio buttons will
then fully enable one developer suite and disable the other.


The change takes place immediately, so there is no need to exit
Suite Switcher or restart your machine. However, any open DOS
windows will not be notified of the change. You will need to
open a new DOS window to execute any newly activated suite-
related tools (e.g. armcc) from the command line.


Suite Switcher will also set an environment variable called
ARM_CURRENT_SUITE which indicates the name of the most recently activated
developer suite. For exmaple, if you last activated RVDS 2.1:


    ARM_CURRENT_SUITE = RVDS 2.1 [Build 69]


This can be useful for setting the title of an open DOS window using the
command:


   C:\>title %ARM_CURRENT_SUITE%




Supported Suites
-=-=-=-=-=-=-=-=-


Suite Switcher supports the following developer suites:


* ADS 1.0.1 - ADS 1.2.1
* RVCT for BREW 1.2 - 3.0
* RVDS 2.0 - RVDS 4.0 Pro
* RVDK for ARM7 Processor Family (Chinese edition)
* RVDK for Oki
* RVDK for Philips
* RVDK for Philips Nexperia Sy.Sol
* RVDK for STMicroelectronics




What does Suite Switcher actually do?
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-


Suite Switcher carries out two types of changes to the system in
order to switch between the ADS and RVDS compilers/ARMulator.


First, it modifies the system path to contain the path to the tools for the
active suite and it removes all other development suites from the path.
This primarily affects which version of the compiler is found if executed
from the command line.


Additionally, it restores the environment variables for the
active suite to their default values. In particular, the ADS
ARMulator and the RVDS ARMulator both use the same environment
variables: ARMCONF and ARMDLL. Suite Switcher ensures that
ARMCONF and ARMDLL are set correctly for the active developer
suite.


AXD contains a number of OCX controls which must be registered
with the operating system. When you select a version of AXD to
register, Suite Switcher runs a batch file to register the OCX
controls for that version of AXD.