WINCE BIB文件相关资料

更新时间：2024-06-21 19:29:01 阅读量：综合文库文档下载

说明：文章内容仅供预览，部分内容可能不全。下载后的文档，内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的，是否完整无缺。

wince推荐度：
相关推荐

在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中。

CEC文件详解

经过以前的学习，我们已经掌握了生成CE的过程及编译的几个阶段，这次我们再来了解一下Platform Builder中为我们提供的组件包的管理方式以及如何管理自己的组件。

在Platform Builder（以下简称PB）中的右侧有一个\窗口，其中列出了所有可供

使用的组件，我们可以看到其内容是非常之多的，现在的疑问就产生了，PB是如何管理这些组的呢？如果我有一个新设备的驱动组件要如何才能放到这个组件包窗口中呢？如果我开发了一个设备驱动以供其他人使用那我要如何才能发布我的驱动呢？下面，我们就来解决这些问题。

在PB中，这些组件的管理都是能过一种组件文件(.cec文件)来实现的。在CE4中，系统自带的CEC文件都位于PB的安装文件夹下的CEC文件夹，我们可以在那里很容易的找到它们，但是在CE5中，它的位置变了，你可以在:

WINCE500/PUBLIC/COMMON/OAK/CATALOG/CEC下找到他们。如果你开发了OAL，设备驱动或其他组件，你就可以能过CEC文件来把它们加入到PB中。通过在PB环境中导入CEC文件，其他的平台开发人员就可以使用这些组件了。CEC文件是用来描述组件信息的文本文件，它包括了一些块的列表，主要包括以下四种信息块： --CECInfo块，

用来描述此CEC文件的信息，每个CEC文件只能含有一个此信息块，从中你可以看到该CEC的名称、GUID、版本、供应商和简要描述。 --ComponentType块

它描述了最高级别的组件类型，在一个CEC文件中可以有多个此信息块，它通过Group,RequiredCEModules,ExcludeWhenSet,MaxResolvedImplsAllowed等条目来描述此组件所在的组，需要的CE组件，排除的组件及允许在一个CE平台中存在的数量等信息。 --Implementation块

用来描述此组件在编译时需要的各种信息，每个CEC文件中也可以有多个此信息块，它是 ComponentType块的一部分，其中的

BSPPlatformDir,Children,OptionalChildren,DefaultDrivers,ExcludeWhenSet,FeatureVariable,ImplSize等条目的具体含义可以在PB的帮助文档中找到，在此不一一细述。 --BuildMethod块描述了编译的方法，也是ComponentType块的一部分，为了加深对上一次编译阶段的理解，我们详细说一下此块中Step和Action两个条目。

Step用来说明编译此组件将要在哪一步中进行，对照上一次的内容，它的取值为：CESYSGEN,BSP,BUILDREL,MAKEIMG。所以如果你自己开发了OAL或驱动之类的组件，你就需要自己决定让PB在什么阶段来编译它，就要在CEC中通过Step来描述。其实在具体的编译过程中，上述的每一阶段又有PRE和POST两个子阶段，也就是说对于每个阶段其实都有三步，即

PRECESYSGEN,CESYSGEN,POSTCESYSGEN,PREBSP,BSP,POSTBSP…… 一般不用具体到这样详细的程度。

Action则描述了组件编译的行为，有效的行为与编译阶段的对应关系如下表所示： Action CESYSGEN BSP BUILDREL MAKEIMG #BUILD(DIR,...) No Yes No No

#BUILD(SOURCES) No Yes No No #BUILD(MAK,...) No Yes No No #CUSTOM(...,...) No Yes Yes No #COPY(...,...) Yes No Yes No #ENV(...,...) No Yes No Yes #SRCCODE(...) No No No No 这些Action的意义如下： --#BUILD（）：使用DIRS文件或SOURCES文件或MAKE文件来调用build.exe，在完全

编译平台的时候被使用； --#CUSTOM（）：在编译的时候运行批处理文件或可执行文件； --#COPY（）：从一个位置复制文件到另一个位置； --#ENV（）：设置环境变量； --#SRCCODE（）：指定了包含源程序文件的文件夹，只在编译所选组件时应用。

对于以上每个条目的具体用法可以参阅PB的帮助文档。为了获得感性认识，我们最好用记事本打开几个CEC文件来看一下。比如打开serial.cec看看串口驱动组件的实现方法等。以上我们了解了CEC文件，我们再来解决后面的问题，即假设我从别的供应商处拿到了一个设备的驱动程序，它带了CEC文件，那么我要如何把这个组件加入到PB的组件包中呢？这个问题其实很简单，只要在PB的File菜单下使用\命令即可。在这个弹出的对话框中的内容和使用方法就不用我说了吧。

再来解决下一个问题，我要如何为我开发的组件编写CEC文件呢？这个也好办，在Tools菜单下使用\Editor\命令即可，如果不会写，可以先打开一个现有的CEC文件看看是如何组织的，然后再仿照它来写自己的就可以了，别忘了写完后要保存哦，同时也要注意GUID的问题。

此次内容的最后，我们再来看一下BSP。什么是BSP呢，其实就是为某一种开发板实现了设备驱动的软件包，它包含了源程序文件，二进制文件等，还有OAL适配层，Bootloader 和其他有关的配置文件。比如CE5的评估版就带了x86的BSP,AMD的BSP和Emulator的BSP。

通常对BSP的操作都在BSP向导中进行，它位于Platform菜单中，利用它可以新建自己的BSP，复制现存的BSP，修改现存的BSP或创建全局的驱动程序。如果你准备好了BSP所需要的那些东西就可以用它来生成你的BSP了，它会选择必须的CE内核组件。

WinCE BSP中的DAT 文件介绍

DAT 文件用于在WinCE启动的时候，定义文件系统的结构，也就是定义有哪些文件夹，哪些文件在什么位置等。每次冷启动的时候，Filesys模块会根据.dat文件中的内容来创建目录以及目录下的文件。

在BSP 中我们可以找到platform.dat。在创建一个WinCE 的工程以后，可以在工程目录下面找到project.dat。可以在这两个.dat文件中定义我们所需的根目录以及相应的子目录和文件，当然Windows文件夹及其包含的子文件夹除外。用户可以通过定义快捷方式的方法来引用Windows目录下的文件。

关于DAT 文件的具体格式，来举个例子： root:-Directory(\root:-Directory(\

Directory(\Directory(\Directory(\

Directory(\root:-File(\

简单解释一下，上面的内容是先创建My Documents和Program Files 两个根目录，然后在Program Files下面创建My Projects，Accessories和Communication三个子目录，然后拷贝被定义在Windows目录下的存在于ROM中的Myproj.exe文件到My Projects目录下面，且名字为My Project Program。这里需要说明的一点就是，像Myproj.exe 这样的文件都是从ROM中拷贝出来的，所以必须在BIB 文件中包含了该文件。最后一行意思是在

根路径下创建control.lnk，该文件来自ROM中的control.lnk 文件，是一个快捷方式文件。对上面的一些格式做个解释： 1．Root Directory的语法格式：

root:[-Directory(\[-File(\root：表示根目录。

-Directory(“dir_name”)：定义根目录下的目录名。

-Permdir(“dir_name”)：定义一个永久的目录，用户是不能通过RemoveDirectory函数删除的。

-File(\：定义一个目标文件，该文件从ROM中拷贝过来。target_filename为目标文件的文件名，source_location为ROM中的文件，指Windows目录下的某路径下的文件名。 2．Directory的语法格式：

Directory(\[-File(\

Directory(“dir_name”)：表示目录名。””表示根目录。

-Directory(“dir_name”)：表示目录下的路径，就是子目录。

-File(\：定义一个目标文件，该文件从ROM中拷贝过来。target_filename为目标文件的文件名，source_location为ROM中的文件，指Windows目录下的某路径下的文件名。

DAT 中所使用的语法定义比较简单，看看例子就知道如何修改了，一般我们会通过修改project.dat 和platform.dat 来改变WinCE启动后的文件路径结构。其中platform.dat是和平台相关的，而project.dat是和WinCE 工程相关的

WinCE BSP中的Dirs文件和Sources文件 1. Dirs文件

关于Dirs 文件，就是指定要编译的路径，这个地球人都知道。还是简单介绍一下。按照文档上面介绍有三种定义：DIRS，DIRS_CE 和OPTIONAL_DIRS。 DIRS：就是指定要编译的目录。

DIRS_CE：只有目录下的源代码用于WinCE的映像文件时，才编译该目录。

OPTIONAL_DIRS：指定可以选择编译的目录。比如：OPTIONAL_DIRS=proj1，如果想编译proj1目录，可以设置BUILD_OPTIONS=proj1，然后运行build命令就可以了。举个例子：

DIRS= common drivers oal

bootloader

表示需要编译common，drivers，oal 和bootloader 目录。 DIRS=*

表示编译当前的所有目录。 2. Sources文件

在WinCE BSP 中会看到很多sources 文件，一般会和源代码放在同一个目录，当然不是绝对的。这些sources文件里面就是定义了一些宏，主要用于告诉Build.exe在编译源代码

的时候应该如何编译和链接，告诉Nmake.exe 如何编译源代码以及最后生成什么类型的文件。

下面具体介绍一下：

TARGETNAME：最后编译完后生成的目标文件的名字，不包括扩展名。 TARGETTYPE：生成的文件的类型。具体值如下： LIBRARY，一个.lib文件 DYNLINK，一个.dll 文件 PROGRAM，一个.exe文件

RELEASETYPE：该宏设置两个环境变量RELEASEDIR 和RELEASELIBDIR，就是设置编译后生成文件存放的路径。具体值如下：

PLATFORM，生成的文件在PLATFORM LOCAL，生成的文件在当前路径下

CUSTOM，生成的文件在TARGETPATH 指定的位置

MANAGED，生成的文件在%_PROJECTROOT%OAKManaged OAK, SDK, DDK，生成的文件在%_PROJECTROOT%Oak

TARGETPATH：当上面的RELEASETYPE=CUSTOM的时候，该宏指定路径 SOURCELIBS：静态链接。函数的实体被链接过来，生成一份拷贝

TARGETLIBS：动态链接。函数的地址被链接过来，系统执行时会加载该库 INCLUDES：指定额外的要搜索的头文件的路径 SOURCES：指定要被编译的文件

ADEFINES：指定汇编器要使用的参数 CDEFINES：指定编译器要使用的参数 LDEFINES：指定连接器要使用的参数

RDEFINES：指定资源编译器Rc.exe 的参数 DLLENTRY：指定dll 的入口函数 DEFFILE：指定该模块的.def 文件

EXEENTRY：指定可执行文件的入口函数

SKIPBUILD：不做实际的build操作，直接返回成功

WINCECOD：编译后生成一个.cod的汇编文件，用于查看汇编代码调试

WINCECPU：用于说明为指定的CPU 编译，这样被编译出来的目标文件会被放在_TGTCPU环境变量所指定的子目录下面，一般该宏在sources.cmn中定义。 WINCEMAP：编译后生成一个.map文件，用于调试 WINCEOEM：设置该值表示需要使用WinCE 下的一些公用的库和头文件，该值一般在BSP 中的sources.cmn中定义。

WINCETARGETFILE0：用于告诉编译系统在编译当前路径下的源码文件之前，要先由Build.exe编译的目标文件。

WINCETARGETFILES：用于告诉编译系统在链接当前路径下所有的目标文件之前，要先由Build.exe编译的目标文件。

WINCE_OVERRIDE_CFLAGS：用于定义用户自己的编译器参数取代默认的编译器参数。举个例子：

TARGETNAME=serial_smdk2410 TARGETTYPE=DYNLINK RELEASETYPE=PLATFORM

TARGETLIBS=$(_COMMONSDKROOT)lib$(_CPUINDPATH)coredll.lib

$(_SYSGENOAKROOT)lib$(_CPUINDPATH)ceddk.lib

SOURCELIBS=$(_SYSGENOAKROOT)lib$(_CPUINDPATH)serpddcm.lib $(_SYSGENOAKROOT)lib$(_CPUINDPATH)com_mdd2.lib DEFFILE=serial.def

DLLENTRY=_DllEntryCRTStartup SOURCES= ser_smdk2410.cpp pdds3c2410_ser.cpp

需要编译的文件为ser_smdk2410.cpp 和pdds3c2410_ser.cpp，DEF 文件为serial.def，DLL 的入口函数是_DllEntryCRTStartup，静态连接serpddcm.lib和com_mdd2.lib两个库，动态链接coredll.lib 和ceddk.lib 两个库，最终编译为dll 文件，文件名为serial_smdk2410.dll。

最后总结一下，Dirs 文件会和Sources 文件配合使用，但是他们不可能存在同一个目录下面。Dirs文件指定编译目录，Sources文件指定如何编译。

WinCE BSP工程文件pbcxml分析

本文详细介绍WinCE BSP工程文件pbcxml分析

每一个BSP 都有一个工程文件，比如MyBSP.pbcxml，里面描述了BSP 的信息。下面就来介绍一下BSP 的pbcxml 文件。文件的大致格式应该是这样的： ….

…

实际上…相当于一个入口，在这里面包含的就是WinCE BSP的所有内容了，里面包含几个部分，下面分别介绍每个部分。

1. …项：这里面包含了BSP的基本信息，比如BSP的名字，描述，厂家等。下面是一个模板：

Title Name

BSP Description Vendor Name

WinCE Version File Version

这里不做过多介绍了，一看就应该明白，下面给个实际BSP中的用到该项描述的例子： EP94xx

EP94xx BSP Catalog Items Cirrus Logic 6.00 1.0.0

2. …项：该项一般在项后面，用来描述当前的BSP 中都有哪些组件，或者说有哪些Items。具体模板如下： BSP Title

BSP Description

Platform Directory Cpu:CPU ID

Item: VENDOR: VARIABLE Item: VENDOR: VARIABLE …

这里需要做一下解释：

VENDOR：厂家名称，比如三星提供的BSP，那么就应该是SAMSUNG。 BSPDIR：指该BSP 在”/Platform”文件夹下的路径。 CPU：指该BSP 所支持的CPU，比如ARMV4I。

MODULE：指BSP中的各个模块被编译后所生成的dll或者exe的名字，比如audio.dll，那么这里就应该是audio。

VARIABLE：指BSP中和某个模块相关的环境变量。 …：指BSP 的标题

…：指BSP的一些描述

…：指该BSP在”/Platform”目录下的路径。 …：指所支持的CPU，比如ARMV4I。

…：指BSP 中都包含了哪些模块。

这里要注意的是，…有两种表示方法如下： Method 1：Item: VENDOR: VARIABLE

Method 2：Item: VENDOR: MODULE: BSPDIR

可以看一下WinCE6.0中Platform 目录下的一些微软提供的BSP的pbcxml 文件，大多采用第二种方法，我个人更喜欢第一种方法，简单。下面也给个例子：

EP94xx: ARMV4I

Cirrus EP94xx BSP for WinCE 6.0 EP94xx Cpu:ARMV4I

Item: Cirrus Logic: bsp_ep94xx_i2s_audio Item: Cirrus Logic: bsp_ep94xx_flash

Item: Cirrus Logic: bsp_ep94xx_nandflash Item: Cirrus Logic: bsp_ep94xx_ethernet Item: Cirrus Logic: bsp_ep94xx_serial Item: Cirrus Logic: bsp_ep94xx_usb Item: Cirrus Logic: bsp_ep94xx_touch Item: Cirrus Logic: bsp_ep94xx_rtc

3. …项：它会在项后面，详细描述项中的每一个模块，也就是描述BSP 中的每一个驱动的相关信息。模板如下： Driver Title

Driver Description BspSpecific Variable

Device Drivers

Source Code Title Source Code Path

前面我们提到了项中的…有两种表示方法，那么实际上和这里的每一个模块的项是对应的，上面的用哪种方法表示，这里也同样要用相同的方法如下：

Method 1： ……

Method 2： …… 这里再对一些定义作个解释：

VENDOR：厂家名称，比如三星提供的BSP，那么就应该是SAMSUNG。 CPU：指该BSP 所支持的CPU，比如ARMV4I。 VARIABLE：指BSP中和该模块相关的环境变量。 …：该驱动的标题。

…：该驱动的描述。

…：对于BSP中的Item 来说，这里必须是”BSPSpecific”。 …：该驱动用到的环境变量，可以不止一个。

…：指在PB 中的Catalog Items View 中的位置。 …：描述该驱动的源代码。 …：指向该驱动的源代码的路径。

…：描述一个帮助链接链接到帮助页。