WinCE BSP工程文件pbcxml分析

作者：ARM-WinCE

 

 

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

 

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

<CatalogFile …>

<FileInformation ….>

….

</FileInformation>

<BSP …>

…

</BSP>

<Item …>

…

</Item>

<Item …>

…

</Item>

<Item …>

…

</Item>

<Item …>

…

</Item>

</CatalogFile>

 

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

 

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

<FileInformation Id="FileInformation: VENDOR:CATALOGFILENAME ">

    <Title>Title Name</Title>

    <Description>BSP Description</Description>

    <Vendor>Vendor Name</Vendor>

    <OSVersion>WinCE Version</OSVersion>

    <FileVersion>File Version</FileVersion>

</FileInformation>

 

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

<FileInformation Id="FileInformation:Cirrus Logic:EP94xx">

    <Title>EP94xx</Title>

    <Description>EP94xx BSP Catalog Items</Description>

    <Vendor>Cirrus Logic</Vendor>

    <OSVersion>6.00</OSVersion>

    <FileVersion>1.0.0</FileVersion>

</FileInformation>

 

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

<Bsp Id="Bsp: VENDOR: BSPDIR: CPU">

    <Title>BSP Title</Title>

    <Description>BSP Description</Description>

    <PlatformDirectory>Platform Directory</PlatformDirectory>

    <CpuId>Cpu:CPU ID</CpuId>

    <BspItemId>Item: VENDOR: VARIABLE</BspItemId>

    <BspItemId>Item: VENDOR: VARIABLE</BspItemId>

    …

</Bsp>

 

这里需要做一下解释：

    VENDOR：厂家名称，比如三星提供的BSP，那么就应该是SAMSUNG。

    BSPDIR：指该BSP在”/Platform”文件夹下的路径。

    CPU：指该BSP所支持的CPU，比如ARMV4I。

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

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

 

    <Title>…</Title>：指BSP的标题

    <Description>…</Description>：指BSP的一些描述

    <PlatformDirectory>…</PlatformDirectory>：指该BSP在”/Platform”目录下的路径。

    <CpuId>…</CpuId>：指所支持的CPU，比如ARMV4I。

    <BspItemId>…</BspItemId>：指BSP中都包含了哪些模块。

 

 

这里要注意的是，<BspItemId>…</BspItemId>有两种表示方法如下：

Method 1：<BspItemId>Item: VENDOR: VARIABLE</BspItemId>

Method 2：<BspItemId>Item: VENDOR: MODULE: BSPDIR</BspItemId>

 

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

 

下面也给个例子：

<Bsp Id="Bsp:Cirrus Logic:EP94xx:ARMV4I">

    <Title>EP94xx: ARMV4I</Title>

    <Description>Cirrus EP94xx BSP for WinCE 6.0</Description>

    <PlatformDirectory>EP94xx</PlatformDirectory>

    <CpuId>Cpu:ARMV4I</CpuId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_i2s_audio</BspItemId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_flash</BspItemId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_nandflash</BspItemId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_ethernet</BspItemId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_serial</BspItemId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_usb</BspItemId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_touch</BspItemId>

    <BspItemId>Item: Cirrus Logic: bsp_ep94xx_rtc</BspItemId>

</Bsp>

 

 

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

<Item Id="Item: VENDOR: VARIABLE">

    <Title>Driver Title</Title>

    <Description>Driver Description</Description>

    <Type>BspSpecific</Type>

    <Variable>Variable</Variable>

    <Location>Device Drivers</Location>

    <SourceCode>

    <Title>Source Code Title</Title>

    <Path>Source Code Path</Path>

    </SourceCode>

</Item>

 

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

Method 1：<Item Id=”Item: VENDOR: VARIABLE”> …… </Item>

Method 2：<Item Id=”Item: VENDOR: MODULE: BSPDIR”>  …… </Item>

 

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

    VENDOR：厂家名称，比如三星提供的BSP，那么就应该是SAMSUNG。

    CPU：指该BSP所支持的CPU，比如ARMV4I。

    VARIABLE：指BSP中和该模块相关的环境变量。

 

    <Title>…</Title>：该驱动的标题。

    <Description>…</Description>：该驱动的描述。

    <Type>…</Type>：对于BSP中的Item来说，这里必须是”BSPSpecific”。

    <Variable>…</Variable>：该驱动用到的环境变量，可以不止一个。

    <Location>…</Location>：指在PB中的Catalog Items View中的位置。

    <SourceCode>…</SourceCode>：描述该驱动的源代码。

    <Path>…</Path>：指向该驱动的源代码的路径。

    <HelpLink>…</HelpLink>：描述一个帮助链接链接到帮助页。

 

下面举个例子：

<Item Id="Item:Cirrus Logic:bsp_ep94xx_i2s_audio">

    <Title>Audio I2S</Title>

    <Description>Audio Driver for I2S</Description>

    <Type>BspSpecific</Type>

    <Variable>BSP_EP94XX_AUDIO</Variable>

    <Variable>BSP_EP94XX_I2S_AUDIO</Variable>

    <Location>Device Drivers</Location>

    <SourceCode>

        <Title>$(_WINCEROOT)/PLATFORM/EP94XX/SRC/DRIVERS/WAV</Title>

        <Path>$(_WINCEROOT)/PLATFORM/EP94XX/SRC/DRIVERS/WAV</Path>

    </SourceCode>

</Item>

 

 

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