As with the installation process itself, the steps required to set up your environment depend on your host operating system.
The graphical installer for Sourcery CodeBench Lite does this setup for you, however it may not take effect until you next log in.
In order to use the Sourcery CodeBench tools from the command line, you
should add them to your PATH.
In the instructions that follow, replace
installdir with the full pathname
of your Sourcery CodeBench Lite installation directory,
including the drive letter.
To set the PATH on a Microsoft Windows Vista system,
use the following command in a cmd.exe
shell:
> setx PATH "%PATH%;installdir\bin"
To set the PATH on a system running Microsoft Windows 7,
from the desktop bring up the Start menu and
right click on Computer.
Select Properties and click on
Advanced system settings.
Go to the Advanced tab,
then click on the Environment Variables button.
Select the PATH variable and click
Edit.
Add the string ;
to the end, and click installdir\binOK.
To set the PATH on older versions of Microsoft
Windows, from the desktop
bring up the Start menu and
right click on My Computer.
Select Properties,
go to the Advanced tab,
then click on the Environment Variables button.
Select the PATH variable and click the
Edit.
Add the string
;
to the end, and click installdir\binOK.
You can verify that your PATH is set up correctly
by starting a new cmd.exe shell and running:
> arm-none-eabi-gcc -v
Verify that the last line of the output contains:
Sourcery CodeBench Lite 2012.09-63.
Sourcery CodeBench Lite does not require Cygwin or any other UNIX emulation environment. You can use Sourcery CodeBench directly from the Windows command shell. You can also use Sourcery CodeBench from within the Cygwin environment, if you prefer.
The Cygwin emulation environment translates Windows path names
into UNIX path names. For example, the Cygwin path
/home/user/hello.c corresponds to the
Windows path c:\cygwin\home\user\hello.c.
Because Sourcery CodeBench is not a Cygwin application, it does not, by
default, recognize Cygwin paths.
If you are using Sourcery CodeBench from Cygwin, you should set the
CYGPATH environment variable. If this environment
variable is set, Sourcery CodeBench Lite automatically translates Cygwin path
names into Windows path names. To set this environment
variable, type the following command in a Cygwin shell:
> export CYGPATH=cygpath
To resolve Cygwin path names, Sourcery CodeBench relies on the
cygpath utility provided with Cygwin. You
must provide Sourcery CodeBench with the full path to
cygpath if cygpath is not
in your PATH. For example:
> export CYGPATH=c:/cygwin/bin/cygpath
directs Sourcery CodeBench Lite to use c:/cygwin/bin/cygpath
as the path conversion utility. The value of
CYGPATH must be an ordinary Windows path, not
a Cygwin path.
The graphical installer for Sourcery CodeBench Lite does this setup for you, however it may not take effect until you next log in.
Before using Sourcery CodeBench Lite you should add it to your
PATH. The command you must use varies with the
particular command shell that you are using. If you are using the
C Shell (csh or tcsh), use
the command:
> setenv PATH installdir/bin:$PATH
If you are using Bourne Shell (sh), the Korn
Shell (ksh), or another shell, use:
> PATH=installdir/bin:$PATH
> export PATH
If you are not sure which shell you are using, try both commands.
In both cases, replace installdir with
the full pathname of your Sourcery CodeBench Lite installation directory.
You may also wish to set the MANPATH environment
variable so that you can access the Sourcery CodeBench manual pages, which
provide additional information about using Sourcery CodeBench. To set the
MANPATH environment variable, follow the same steps
shown above, replacing PATH with
MANPATH, and bin with
share/doc/arm-arm-none-eabi/man.
You can test that your PATH is set up correctly by
running the following command:
> arm-none-eabi-gcc -v
Verify that the last line of the output contains:
Sourcery CodeBench Lite 2012.09-63.