Read and Interpret MODULES and FILES Entries (Compact 2013)
3/26/2014
Each entry listed under the MODULES and FILES section of the ce.bib file specifies the file name, full path, target memory, and type flags for each file you want to include in the ROM image. The Memory column always contains “NK”, which instructs the build system to include the file in nk.bin.
Note
The individual binary image builder (.bib) files can contain path variables, such as %_FLATRELEASEDIR%. The build system resolves these path variables before it writes the entry in the ce.bib file.
Type Option Flags
The Type column specifies options for storing the file in the ROM image or on the target device. The following table describes some commonly used flags.
Flag |
Description |
|---|---|
C |
Compressed module |
H |
Hidden file |
R |
Compressed resource of a DLL or EXE |
S |
System file |
U |
Uncompressed module |
Z |
Fix up like nk.exe |
Important
By default, FILES are compressed and MODULES are uncompressed.
MODULES Section Entry
The following code shows an example entry for an executable file (“module”), in this case the kernel (nk.exe). The Path column shows that the build system will include the file from the flat release directory. The Type column indicates that this file is a system (‘S’) hidden (‘H’) file that is fixed up like nk.exe.
Note
The file nk.exe is in the MODULES section and does not have the ‘C’ flag set, so it is not compressed.
MODULES
; Name Path Memory Type
; -------------- --------------------------------------------- -----------
kitl.dll C:\WINCE800\OSDesigns\RelDir\VirtualPC_x86_Release\kitl.dll NK SHZ
FILES Section Entry
The following code shows an example entry for a non-executable file, in this case the TrueType font file tahoma.ttf. The Path column shows that the build system will include the file from the public directory. The Type column indicates that this file is a system (‘S’) hidden (‘H’), uncompressed (‘U’) file.
FILES
; Name Path Memory Type
; -------------- --------------------------------------------- -----------
tahoma.ttf C:\WINCE800\public\common\oak\files\tahoma.ttf NK SHU
...
Note
The file tahoma.ttf is in the FILES section but has the ‘U’ flag set, so it is not compressed. Files that the system accesses often are usually not compressed in order to avoid the overhead of multiple decompression actions each time the file is accessed.