Configuration Files for Creating a Run-Time Image (Compact 2013)
3/26/2014
Windows Embedded Compact uses a number of configuration and batch files to create a run-time image. Some configuration files contain settings that are specific to your hardware platform. Other configuration files determine which of the platform-independent OS components to include in the run-time image. The build system uses these configuration files during the Build Step: Create Image process.
.Bib Files
Binary image builder (.bib) files define which modules and files to include in the run-time image. You use the MEMORY section of .bib files to select the address regions for your kernel and other OS image components, the regions for applications and RAM-based file systems, and reserved regions. For more information, see Binary Image Builder (.bib) File.
The following table provides examples of some typical names and uses of .bib files.
File name |
Description |
|---|---|
platform.bib |
Determines which device drivers and other hardware-specific modules are included in the run-time image |
config.bib |
Defines the memory layout and configuration options for the run-time image and reserves a section of shared memory for the boot arguments area |
boot.bib or eboot.bib |
Defines the memory layout and configuration options for the boot-loader image |
.Reg Files
Registry (.reg) files contain registry entries for the run-time image. The platform.reg file contains hardware registry settings for the Windows Embedded Compact powered device. Each device driver may also have a .reg file. The combination of all .reg files in the build process determines which device drivers load when the run-time image boots. For more information, see Build and Test Your Device Driver.
Module Inclusion
The build process uses configuration files and macros to determine which binaries and files to include in the run-time image. The following files specify the hardware-dependent modules and files, such as driver files, for the device:
- The platform.bib configuration file, which is located in %_WINCEROOT%\Platform\<BSP Name>\Files. There is one platform.bib file for each BSP. For a description of the layout of .bib files, see Binary Image Builder (.bib) File.
- The sources files, which are text files that tell the build process which files to compile from the source code. Each subproject usually has its own sources file. For more information, see Sources File.
Important
The sources file must include any modules or files specified by platform.bib. If any modules are left out of the sources file, the build system will not compile them, and those files will be missing from the final OS image.