WINCE BSB中不同后缀的文件讲解--.bib文件

1. .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复位向量地址的时候。

 

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%/RELEASE/INIT.EXE            NK    SH

    MYDLL.DLL        %_WINCEROOT%/RELEASE/MYDLL.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中。

 

（摘录：

config.bib:负责WinCE内存配置，WinCE image的大小以及内存的使用都在这里配置。
platform.bib:负责BSP的配置，一般是包含所要加载的BSP中的驱动及模块。
project.bib:负责WinCE工程的配置，该文件会在创建一个WinCE工程的时候自动生成，一般和该工程相关的配置，应该放在这里面。

）