WinCE BSP的BIB檔案介紹

原文地址

http://tech.e800.com.cn/articles/2009/619/1245382898317_1.html

 

 

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