wince中的BSP工程的相关文件介绍

一.pbcxml分析

       

每一个BSP都有一个工程文件,比如MyBSP.pbcxml,里面描述了BSP的信息。下面就来介绍一下BSPpbcxml文件。

 

文件的大致格式应该是这样的:

<CatalogFile …>

<FileInformation ….>

….

</FileInformation>

<BSP …>

</BSP>

<Item …>

</Item>

<Item …>

</Item>

<Item …>

</Item>

<Item …>

</Item>

</CatalogFile>

 

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

 

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

VENDOR:CATALOGFILENAME ">

    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

    MODULEBSP中的各个模块被编译后所生成的dll或者exe的名字,比如audio.dll,那么这里就应该是audio

    VARIABLEBSP中和某个模块相关的环境变量。

 

    BSP的标题

    BSP的一些描述

    指该BSP”/Platform”目录下的路径。

    指所支持的CPU,比如ARMV4I

    BSP中都包含了哪些模块。

 

 

这里要注意的是,有两种表示方法如下:

Method 1Item: VENDOR: VARIABLE

Method 2Item: VENDOR: MODULE: BSPDIR

 

可以看一下WinCE6.0Platform目录下的一些微软提供的BSPpbcxml文件,大多采用第二种方法,我个人更喜欢第一种方法,简单。

 

下面也给个例子:

    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

    VARIABLEBSP中和该模块相关的环境变量。

 

    该驱动的标题。

    该驱动的描述。

    对于BSP中的Item来说,这里必须是”BSPSpecific”

    该驱动用到的环境变量,可以不止一个。

    指在PB中的Catalog Items View中的位置。

    描述该驱动的源代码。

    指向该驱动的源代码的路径。

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

 

下面举个例子:

    Audio I2S

    Audio Driver for I2S

    BspSpecific

    BSP_EP94XX_AUDIO

    BSP_EP94XX_I2S_AUDIO

    Device Drivers

    

        $(_WINCEROOT)/PLATFORM/EP94XX/SRC/DRIVERS/WAV

        $(_WINCEROOT)/PLATFORM/EP94XX/SRC/DRIVERS/WAV

    

 

 

上面对WinCE中的BSP的工程文件pbcxml做了个介绍,相信有点描述语言基础,了解一些WinCE知识的看懂绝对没有问题了。很多时候,在向BSP中添加驱动或者删除驱动的时候,我们就可以直接用记事本打开该文件,然后在里面编辑就可以了,这样很方便。

 

二.REG文件和DB文件

   

1.       REG文件

注册表文件,这个和Windows操作系统中使用的注册表文件基本一样,在BSP中主要是Platform.reg,该注册表文件描述了和硬件平台相关的配置,大部分是用来描述驱动的相关信息。

注册标的格式如下:

[KEY1]

"ValueName1"={Value Type}:{data}

"ValueName2"={Value Type}:{data}

[KEY2]

"ValueName1"={Value Type}:{data}

 

其中Value Typedata相互对应,不同的Value type对应不同的data,具体如下:

Value Type

data

 

REG_SZ

”my string”

字符串类型

REG_DWORD

dword:NNNN(hex number)

DWORD类型

REG_MULTI_SZ

multi_sz:”my_string_1”,”my_string_2”

多字符串类型

REG_BINARY

hex:xx,xx,xx

二进制类型

HEX

hex(xxxxxxxx):xx,xx,xx,xx

十六进制类型

 

在注册表中,同样可以使用IF/ENDIF来进行条件包含,其中条件可以是一个WinCE中的环境变量,还可以在该环境变量后加一个空格再加一个惊叹号(“!”),表示没有设置或者不等于的情况,比如:

IF environment variable [= value] [!]

[KEY1]

"ValueName1"={Value Type}:{data}

"ValueName2"={Value Type}:{data}

[KEY2]

"ValueName1"={Value Type}:{data}

ENDIF

 

如果注册表某一行是以分号(“;”)开始,表示这行是被注释掉的。当然也有一些例外,比如在支持Hive注册表的时候,如下:

; HIVE BOOT SECTION

 ... reg data...

; END HIVE BOOT SECTION

 

关于Hive注册表,以前介绍过,这里不多说了。我们在注册表中无非就是创建,删除key,赋值等操作。

创建一个注册表key

[Key1]

"ValueName"="Value Type"

 

删除一个注册表key

[-KEY1]

 

删除一个注册表值:

"ValueName1"=-

 

BSP以及硬件平台相关的注册表配置都放在platform.reg文件中,和WinCE工程相关的配置应该放在project.reg文件中。

 

 

2.       DB文件

数据库文件,同样也有platform.dbproject.db两个文件。但是很少会被用到,特别是platform.db,这些数据库文件都是基于WinCE的对象存储的,会在WinCE启动以后被加载到RAM中,掉电就会丢失,具体格式如下:

Database : "db_name" : hex_type : num_sort_order : 1

Record :

Field : field_hex_propid : value

End

End Database

 

可以使用上面的格式在.db文件中添加数据库记录,由于本人从未使用过,所以对上述格式没有太多了解,相信搞过数据库的人士,看看上面的格式可能就明白了。

 

 

三.Dirs文件和Sources文件

   

1.  Dirs文件

关于Dirs文件,就是指定要编译的路径,这个地球人都知道。还是简单介绍一下。按照文档上面介绍有三种定义:DIRSDIRS_CEOPTIONAL_DIRS

 

DIRS:就是指定要编译的目录。

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

OPTIONAL_DIRS:指定可以选择编译的目录。比如:OPTIONAL_DIRS=proj1,如果想编译proj1目录,可以设置BUILD_OPTIONS=proj1,然后运行build命令就可以了。

 

举个例子:

DIRS= common /

            drivers /

            oal /

            bootloader

表示需要编译commondriversoalbootloader目录。

 

 

DIRS=* 

表示编译当前的所有目录。

 

 

 

2. Sources文件

WinCE BSP中会看到很多sources文件,一般会和源代码放在同一个目录,当然不是绝对的。这些sources文件里面就是定义了一些宏,主要用于告诉Build.exe在编译源代码的时候应该如何编译和链接,告诉Nmake.exe如何编译源代码以及最后生成什么类型的文件。

 

下面具体介绍一下:

 

TARGETNAME:最后编译完后生成的目标文件的名字,不包括扩展名。

TARGETTYPE:生成的文件的类型。具体值如下:

        LIBRARY,一个.lib文件

        DYNLINK,一个.dll文件

        PROGRAM,一个.exe文件

RELEASETYPE:该宏设置两个环境变量RELEASEDIRRELEASELIBDIR,就是设置编译后生成文件存放的路径。具体值如下:

        PLATFORM,生成的文件在PLATFORM//

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

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

        MANAGED,生成的文件在%_PROJECTROOT%/OAK//Managed

        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.cpppdds3c2410_ser.cppDEF文件为serial.defDLL的入口函数是_DllEntryCRTStartup,静态连接serpddcm.libcom_mdd2.lib两个库,动态链接coredll.libceddk.lib两个库,最终编译为dll文件,文件名为serial_smdk2410.dll

 

 

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

 

 

四.DAT文件介绍

  

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

 

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

 

关于DAT文件的具体格式,来举个例子:

root:-Directory("My Documents")

root:-Directory("Program Files")

Directory("/Program Files"):-Directory("My Projects")

Directory("/Program Files"):-Directory("Accessories")

Directory("/Program Files"):-Directory("Communication")

Directory("/Program Files/My Projects"):-File("My Project Program", "/Windows/Myproj.exe")

root:-File("/control.lnk", "/Windows/control.lnk")

 

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

 

对上面的一些格式做个解释:

 

1Root Directory的语法格式:

root:[-Directory("dir_name")] [-Permdir("dir_name")]

[-File("target_filename", "source_location")]

 

root表示根目录。

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

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

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

 

 

2Directory的语法格式:

Directory("dir_name"):[-Directory("dir_name")]

[-File("target_filename", "source_location")]

 

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

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

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

 

 

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

 

五.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中的模块或者文件,比如dllexe等。这些文件会被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

当创建了一个使用BinFSimage的时候,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的数据区域。

 

 

2CONFIG

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

CONFIG

    ITEM=Parameter

 

ITEM

描述

AUTOSIZE

允许未被使用的WinCE imageRAM被用作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复位向量地址的时候。

 

 

3MODULES项和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只支持SHND几个类型,而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.bibconfig.bibplatform.bibproject.bib。下面简单介绍一下:

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

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

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

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

 

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

 

 

 

你可能感兴趣的:(嵌入式系统)