104 Chapter 4 Build System
Environment Variables of the Build System
As mentioned above, the OS build process is controlled through environment variables. An
OS design is defined by what environment variables it sets. Each OS design has an associ-
ated PBInitEnv.bat file that is called to configure the build environment for that OS design.
PBInitEnv.bat is called either when a new build window is opened through the Build Open
Release Directory in the Build Window menu item in Platform Builder, or when an OS build is
initiated through the Platform Builder UI. A sample PBInitEnv.bat file is as follows:
@echo off
REM Initial environment configuration
set _PB_INSTALL_ROOT=C:\PROGRA~1\MI0D56~1\6.00
set USING_PB_WORKSPACE_ENVIRONMENT=1
set _WINCEROOT=C:\WINCE600
set _FLATRELEASEDIR=C:\WINCE600\OSDesigns\CEBook\CEBook\RelDir\ _
DeviceEmulator_ARMV4I_Debug
set LOCALE=0409
set _PROJECTROOT=C:\WINCE600\OSDesigns\CEBook\CEBook\Wince600\DeviceEmulator_ARMV4I
REM Workspace and configuration variables
set PBWORKSPACE=C:\WINCE600\OSDesigns\CEBook\CEBook\CEBook.pbxml
set PBWORKSPACEROOT=C:\WINCE600\OSDesigns\CEBook\CEBook
set PBCONFIG=Device Emulator ARMV4I Debug
REM Call wince.bat
call C:\WINCE600\public\COMMON\OAK\MISC\wince.bat ARMV4I CEBook DeviceEmulator
REM Make sure all build options are turned off
set IMGNODEBUGGER=
REM Anchored features
set SYSGEN_WCETK=1
REM BSP features
REM Misc settings
set WINCEDEBUG=debug
set PATH=%PATH%;C:\WINDOWS\system32;C:\WINDOWS;C:\Program Files\ _
Microsoft Platform Builder\6.00\cepb\IdeVS
REM Configuration environment variables
REM Build options
set IMGEBOOT=1
REM Project settings
set _USER_SYSGEN_BAT_FILES=C:\WINCE600\OSDesigns\CEBook\CEBook _
\Wince600\DeviceEmulator_ARMV4I\OAK\MISC\CEBook.bat
REM Locale options
set IMGNOLOC=0
set IMGSTRICTLOC=0
As the code sample shows, PBInitEnv.bat calls Wince.bat. Wince.bat is where the majority of
environment variables are then set. Table 4–3 describes some of the more common environ-
ment variables.