Share via

Build Step: Build Platform\Common (Compact 7)

  • Article

3/12/2014

After the Sysgen OS step, the build process gets substantially simpler. The %_WINCEROOT%\Platform\Common build step runs build.exe in the %_WINCEROOT%\Platform\Common directory. The resulting libraries and .dll files are output to the following two directories, respectively:

  • $(_SG_OUTPUT_ROOT)\Platcomm\$(_TGTPLAT)\Lib\$(_TGTCPU)\$(_WINCEDEBUG) - library files
  • $(_SG_OUTPUT_ROOT)\Platcomm\$(_TGTPLAT)\Target\$(_TGTCPU)\$(_WINCEDEBUG) - .dll files

Note

Some directories in %_WINCEROOT%\Platform\Common are CPU-specific, and their dirs files contain a special directive that indicates that the files in the directory will be compiled only if a particular architecture is selected during the call to wince.bat. For example, the files in the directory that include the DIRS_ARM directive are compiled only if the ARM CPU architecture is selected.

%_WINCEROOT%\Platform\Common directories may depend on libraries from the Sysgen OS step, and may rely on certain MODULES and COMPONENTS being present. For example, you cannot build a Bluetooth driver in %_WINCEROOT%\Platform\Common if you did not build Bluetooth functionality into the OS during the Sysgen OS step. To suppress the making of directories whose prerequisites are missing, filtering is done on dirs files based on ceconfig.h. Below is a more complex dirs example (%_WINCEROOT%\Platform\Common\Src\Soc\Omap35xx_tps659xx_ti_v1\Omap\Tps659xx). The conditional statement capability that it uses is explained in Cesysgen Conditional Statements.

DIRS= \
# \@CESYSGEN IF CE_MODULES_DEVICE    
    twl \
    gpio \
# \@CESYSGEN IF GWES_KBDUI
    keypad \
# \@CESYSGEN ENDIF GWES_KBDUI
    wave \
# \@CESYSGEN ENDIF CE_MODULES_DEVICE

After the Build %_WINCEROOT%\Platform\Common step is completed, the $(SG_OUTPUT_ROOT) directory contains all of the %_WINCEROOT%\Platform\Common files that you need for the later build steps. It does not need to be run again unless the %_WINCEROOT%\Platform\Common files change.

See Also

Concepts

Build from the Top Down
Build Step: Build Platform\$(_TGTPLAT)