WinCE BSP的BIB文件介绍

      在WinCE中使用的一个重要的文件就是BIB文件，全称Binary Image Builder File。在WinCE的编译过程中会用到BIB文件，应该是在最后的Makeimg阶段。所有的BIB文件会被合并成CE.bib文件，然后Romimage.exe会根据BIB文件中的描述来决定哪些文件最终被包含到WinCE image中。当然，BIB文件还决定了WinCE设备内存的分配，其中定义了WinCE image占用哪块内存，Framebuffer占用哪块内存等。

　　在BIB文件中分为4大项：MEMORY项，CONFIG项，MODULES项和FILES项。下面分别作个解释：

　　MEMORY：定义了内存分配的相关设置，一般在BSP中的config.bib文件中。

　　CONFIG：在最后的Makeimg阶段，为Romimage.exe提供一些生成WinCE image的配置属性。该项是可选的，一般也在BSP中的config.bib文件中定义。

　　MODULES：定义了一些会被打包到WinCE image中的模块或者文件，比如dll，exe等。这些文件会被Romimage.exe标记为加载到RAM中或者XIP。我们可以在这里添加自己的WinCE应用程序或者模块，但是不要添加Managed Binaries，一般指.NET的程序。

　　FILES：定义了一些操作系统会用到的其他的文件，比如字体文件，图片等。这些文件也会在WinCE运行的时候被加载到RAM中。

　　下面会详细介绍上面的4大项：

　　1.　　　 MEMORY项

　　一般都在config.bib文件中定义，开头会有MEMORY的字样。这里定义了为WinCE image以及其他模块预留的RAM，同时也定义了WinCE可以使用的RAM。具体格式如下：

　　MEMORY　　NAME　　Start Address　　　　Memory Size　　　　Type　

　　NAME：该内存区域的名字，必须是唯一的。

　　Start Address：该内存区域的起始地址，用十六进制表示。

　　Memory Size：该内存区域的大小，用十六进制表示。

　　Type：内存区域的类型。包涵的多种类型如下。 

 

类型值               描述

---

FIXUPVAR          用于在WinCE编译的Makeimg阶段，就初始化一个内核中的全局变量。

 
NANDIMAGE      当创建了一个使用BinFS的image的时候，NAND设备上的WinCE kernel重定向到RAM中的区域，当系  统访问该区域的时候，BinFS会负责访问Nand设备上相应的位置，并返回数据给系统，实际上就是在Nand设备上面实现了 XIP的功能。

 
RAM                  定义了被WinCE系统使用的RAM区域，这块内存必须是连续的，这里有一点要注意就是从硬件的角度来说，这块内存不能跨越两片SDRAM，也就是说整个区域空间必须在一片硬件SDRAM上。

RAMIMAGE        定义了一块内存区域用于加载WinCE image，实际上WinCE启动以后，image会被拷贝到这块内存区域上面运行。一个image只能有一个连续的RAMIMAGE区域。

RESERVED        这块内存区域会被预留出来，一般用于Frambuffer或者是DMA Buffer，或者是一块共享内存用于EBOOT传递参数给WinCE系统。

 
EXTENSION      定义了一块WinCE image中的区域作为ROMHDR extension的数据区域。

---

 

　　2．CONFIG项

　　一般在config.bib文件中定义，定义了一些额外的配置参数，其中一些对于WinCE image来说也很重要。具体格式如下；

　　CONFIG

　　ITEM=Parameter

ITEM                         描述

---

AUTOSIZE                 允许未被使用的WinCE image的RAM被用作WinCE系统的RAM。默认值为ON。

COMPRESSION          允许Romimage.exe压缩WinCE image中的可写入部分。默认值为ON。

 
BOOTJUMP                定义了跳转跳转页在RAMIMAGE空间的地址。而不是默认情况下的RAMIMAGE的首地址。默认值为NONE。

FSRAMPERCENT         定义了文件系统使用的内存的百分比。默认值为0x80808080。Byte 0：第一个2MB中，每1MB所包含的4KB的倍数。Byte 1：第二个2MB中，每1MB所包含的4KB的倍数。Byte 2：第三个2MB中，每1MB所包含的4KB的倍数。Byte 3：剩下的内存中，每1MB所包含的4KB的倍数。

 
KERNELFIXUPS          定义了Romimage.exe是否重新定向内核的可写入区域。默认值为ON，内核的可写入区域被重新定向到RAMIMAGE的起始位置。

 
OUTPUT                     定义了最终生成的image存放的路径。默认为%_FLATRELEASEDIR%。

 
PROFILE                    定义了是否在WinCE image中包含profiler的结构和符号。默认值为OFF。

 
RESETVECTOR           重新指定跳转页的位置，一般针对MIPS芯片从0x9FC00000开始引导的问题。

 
ROMFLAGS                 内核标记位，可以进行组合：0x01表示禁用按需分页。0x02表示禁用完全内核模式，完全内核模式表示所有的线程都运行在内核模式。0x10表示只信任ROM MODULES中的模块。0x20表示停止刷新TLB。0x40表示按照/base链接选项中的地址加载DLL。

 
ROMSTART               指WinCE image在内存中的起始地址。

 
ROMSIZE                 指WinCE image的大小。

 
ROMWIDTH             指数据总线的宽度。

 
ROMOFFSET            指定一个偏移量来修改.bin文件中的每一个记录的地址。一般用于ROM中的.bin文件加载到RAM来运行的情况，主要是表示存储.bin的位置和运行.bin的位置不一样。

 
SRE                        使Romimage.exe产生一个.sre文件。默认值为OFF。

 
X86BOOT                定义是否插入一条跳转指令，在x86复位向量地址的时候。

 

ITEM 描述 AUTOSIZE 允许未被使用的WinCE image的RAM被用作WinCE系统的RAM。默认值为ON。 COMPRESSION 允许Romimage.exe压缩WinCE image中的可写入部分。默认值为ON。 BOOTJUMP 定义了跳转跳转页在RAMIMAGE空间的地址。而不是默认情况下的RAMIMAGE的首地址。默认值为NONE。 FSRAMPERCENT 定义了文件系统使用的内存的百分比。默认值为0x80808080。Byte 0：第一个2MB中，每1MB所包含的4KB的倍数。Byte 1：第二个2MB中，每1MB所包含的4KB的倍数。Byte 2：第三个2MB中，每1MB所包含的4KB的倍数。Byte 3：剩下的内存中，每1MB所包含的4KB的倍数。 KERNELFIXUPS 定义了Romimage.exe是否重新定向内核的可写入区域。默认值为ON，内核的可写入区域被重新定向到RAMIMAGE的起始位置。 OUTPUT 定义了最终生成的image存放的路径。默认为%_FLATRELEASEDIR%。 PROFILE 定义了是否在WinCE image中包含profiler的结构和符号。默认值为OFF。 RESETVECTOR 重新指定跳转页的位置，一般针对MIPS芯片从0x9FC00000开始引导的问题。 ROMFLAGS 内核标记位，可以进行组合：0x01表示禁用按需分页。0x02表示禁用完全内核模式，完全内核模式表示所有的线程都运行在内核模式。0x10表示只信任ROM MODULES中的模块。0x20表示停止刷新TLB。0x40表示按照/base链接选项中的地址加载DLL。 ROMSTART 指WinCE image在内存中的起始地址。 ROMSIZE 指WinCE image的大小。 ROMWIDTH 指数据总线的宽度。 ROMOFFSET 指定一个偏移量来修改.bin文件中的每一个记录的地址。一般用于ROM中的.bin文件加载到RAM来运行的情况，主要是表示存储.bin的位置和运行.bin的位置不一样。 SRE 使Romimage.exe产生一个.sre文件。默认值为OFF。 X86BOOT 定义是否插入一条跳转指令，在x86复位向量地址的时候。

　　3．MODULES项和FILES项

　　该项列出了所有被包含在WinCE image中的模块以及文件，以及这些模块和文件以什么方式被加载到内存中。具体格式如下：

　　MODULES　　Name　　Path　　　　　　Memory　　　　　　Type　

　　Name：模块的名字，比如一个dll或者exe文件的文件名。

　　Path：路径，一般都是WinCE的工程的Release目录。

　　Memory：指定该模块被放在哪个区域，一般都是NK区域。

　　Type：定义了文件的类型。具体如下：

类型	描述
S	系统文件。
H	隐藏文件。
R	只压缩模块的资源部分。
C	压缩模块的所有部分。
D	禁止调试。
N	模块是不可信任的。
P	告诉Romimage.exe不需要检查CPU的类型。
K	告诉Romimage.exe必需固定该模块的内核地址。有该标记的模块只能被LoadKernelLibrary函数加载。
X	告诉Romimage.exe对该模块签名。
M	运行时加载整个模块，不要按需分页。
L	告诉Romimage.exe不要分离ROM DLL。

　　一般FILES项的Type只支持S，H，N，D几个类型，而MODULES项的Type是都支持的。

　　举个例子吧：

　　INIT.EXE　　　　　　%_WINCEROOT%RELEASEINIT.EXE　　　　　　NK　　SH

　　MYDLL.DLL　　　　%_WINCEROOT%RELEASEMYDLL.DLL　　　NK　　SHC

　　对于BIB文件来说同样支持“条件编译”，我们可以通过设置环境变量来选择性地将某些模块打包到WinCE image中。一般在BSP中，对于一些驱动模块的环境变量我们IF来进行条件判断。而对于WinCE的系统模块来说，一般都是SYSGEN变量，应该使用@CESYSGEN IF来判断。

　　我们在BSP的开发中最常见的主要就是eboot.bib，config.bib，platform.bib和project.bib。下面简单介绍一下：

　　project.bib：该文件主要自创建的WinCE工程中所需的一些文件。

　　platform.bib：该文件包含了和硬件平台相关的文件，主要以驱动程序为主。

　　config.bib：该文件描述了WinCE系统的内存的配置。

　　eboot.bib：该文件描述了WinCE的eboot的内存的配置。

　　还有其他的一些bib文件，在WinCE系统编译后都会背拷贝到工程的release目录下面。比如common.bib，ie.bib等。这些文件列出了WinCE的组件相关的文件，根据用户订制的系统，会被选择性的打包到WinCE image中。