S3C2440A bootloader之Stepldr.bib

在SAMSUNG公司提供的S3C2440A的BSP中有一个Stepldr引导程序。先分析一下Stepldr.bib文件吧：

;
; Copyright (c) Microsoft Corporation.  All rights reserved.
;
;
; Use of this source code is subject to the terms of the Microsoft end-user
; license agreement (EULA) under which you licensed this SOFTWARE PRODUCT.
; If you did not accept the terms of the EULA, you are not authorized to use
; this source code. For a copy of the EULA, please see the LICENSE.RTF on your
; install media.
;
; NOTE: The Steppingstone loader can only be 4096 bytes in length max.  Romimage
;       will need to create and page-align the .pdata section and the linker generates
;       a 1-page header on the file.  In this .bib file we'll call the size 0x3000,
;       but we'll post-process the .nb0 file to remove the .pdata section and the header.
;
; NOTE: The Steppingstone loader and the IPL are concatenated and stored in the
;       first two SmartMedia NAND flash blocks.  If the size of either loader is
;       altered in the .bib file, the bootloader code will need to be updated as
;       it makes an assumption about the first two NAND flash blocks being reserved.
;

MEMORY
;   Name      Start     Size      Type
;   -------   --------  --------  ----
    STEPLDR   00000000  00003000  RAMIMAGE
    STACK     33ff5800  00001000  RESERVED
    RAM       33ff0000  00001000  RAM

CONFIG
 COMPRESSION=ON
 PROFILE=OFF
 KERNELFIXUPS=ON
   
 ROMSTART=00000000
 ROMWIDTH=32
 ROMSIZE=00001000

MODULES
;   Name        Path                                                               Memory Type
;   ----------  --------------------------------------------------------------     -----------
    nk.exe      $(_TARGETPLATROOT)/target/$(_TGTCPU)/$(WINCEDEBUG)/stepldr.exe     STEPLDR

红色部分请注意：由于S3C2410A的芯片的特性，在NAND FLASH作为启动模式时，芯片会自动把NAND FLASH的最开始的4K程序映射到内部的4K SRAM中。同时又由于PB5.0这个软件不能编译小于4K的程序[好像是小于4K时，会有点小问题]，解决办法就是将ROMSIZE设置为4K。STEPLDR的RAMIMAGE设置为12K。这样的话，就会产生stepldr.nb0，stepldr.nb1，stepldr.nb2共三个文件。我们只需要烧录stepldr.nb1就可以了。用什么烧录呢。当然是SJF2410A这个JTAG烧录工具啦。嘿嘿。相信大家都会有这个工具吧。没有还学什么ARM呢。。

堆栈的起始地位为：0x33FF5800 大小为：1K的保留区域，不能作为其它用途。

资料

WINCE的BIB文件解析

BIB的全称为Binary Image Builder，在Wince编译过程中的最后MakeImage阶段会用到BIB文件，BIB文件的作用是指示构建系统如何构建二进制映像。所有的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中。

⑴MEMORY：
定义内存的相关设置，一般在0/PLATFORM/SMDKxx/FILES/config.bib文件中。WINCE构建系统通过MEMORY项知道哪些内存是RAM，哪些内存是ROM，以及它们的大小。MEMORY项的格式如下：

MEMORY

NAME Start Address Memory Size Type

其中

NAME：此段内存的名称，此名称没有特别的规定，但最好是通过这个名称我们就可以知道这段内存的用途，这个名称必须是唯一的，如下文的名称。

Start Address：表示此内存的起始地址，用十六进制数表示，如下文的运行时映像NK所使用的内存的起始地址是0x8C200000。

Memory Size：此内存的大小，用十六进制数表示，如下文config.bib中0x01800000(24M)，次内存的大小需要根据自己系统的NK大小来指定，如果是中文系统，这个大小应该就需要加大了。

Type：此内存段的类型，有如下几种可选的类型：

①FIXUPVAR：用于在WINCE编译的Makeimage阶段，就初始化内核中的全局变量。

②NANDIMAGE：当创建了一个使用BinFS的image的时候，NAND设备上的WINCE内核重定向到RAM中的区域，当系统访问该区域(此块RAM)的时候，BinFS会负责访问NAND设备上相应的位置，并返回数据给系统，实际上就是在NAND设备上面实现了XIP的功能。比如开发板上有NAND的Flash，那么就可以把此段内存标为NANDIMAGE类型。如果Bootloader支持BinFS，那么就可使放在NAND Flash中的bin文件支持本地执行XIP(默认情况下只有NOR的Flash才可支持本地执行)，此段内存必须也对齐。

③RAM：指定此段内存是RAM，定义了WINCE系统使用的RAM区域，WINCE系统可用这些内存来执行程序和存放RAM文件系统。这块内存必须是连续的，这里有一点要注意就是从硬件的角度来说，这块内存不能跨越两片SDRAM，也就是说整个区域空间必须在一片硬件SDRAM上。

④RAMIMAGE：指定这块内存用于加载WINCE image(也就是NK.bin)，实际上WINCE启动以后，image会被拷贝到这块内存区域上面运行。一个image只能有一个连续的RAMIMAGE区域。

⑤RESERVED：这块内存区域会被预留出来，一般用于Framebuffer或者是DMA buffer，或者是一块共享内存用于EBOOT传递参数给WINCE系统，WINCE不会使用这段内存。

⑥EXTENSION：定义了一块WINCE image中的区域作为ROMHDR extension的数据区域。

如下面的config.bib文件所示

以下是我们公司产品的WINCE500/PLATFORM/SMDK2440/FILES/config.bib文件

MEMORY

NK 8C200000 01800000 RAMIMAGE

RAM 8DA00000 04D00000 RAM

; Common RAM areas

AUD_DMA 8c002000 00002000 RESERVED

DRV_GLB 8c010000 00010000 RESERVED

SD_DMA 8c028000 00008000 RESERVED

EDBG 8c030000 00020000 RESERVED

CAMERA 8c087487 000A0000 RESERVED

DISPLAY 8c183000 0007d000 RESERVED

/*****************************************************************/

此段内容表示从地址0x8c200000开始的24MB空间用来存放运行时影响(NK.bin)；从0x8DA00000开始的77M内存是RAM区，可供应用程序使用；从0x8c002000开始到0x8c200000的内存是被保留的，主要是声音和显示的DMA区域。

/*****************************************************************/

⑵CONFIG：这一项是一些附加的选项，一般在config.bib文件中定义，用来告诉构建系统如何生成运行时映像，其格式如下：

CONFIG

ITEM=Parameter

ITEM比较常用的有：

①AUTOSIZE：默认值为ON，如果WINCE image在RAM中，此选项允许自动地把WINCE image没有使用的RAM分配给WINCE操作系统，也就是被用作WINCE系统的RAM。

②PROFILE：指定是否在WINCE image中包含用来性能剖分(profile)的结构和符号，默认值为OFF。

③BOOTJUMP：指定启动时系统的跳转地址，默认会跳向Startup函数的地址。

④COMPRESSION：指定构建系统是否压缩WINCE image中的可写部分。如果此部分被压缩，那么WINCE运行时会把这部分解压缩到RAM中；如果没有被压缩，则直接把这部分复制到RAM中。

⑤KERNELFIXUPS：指定构建系统是否对内核的可写区域进行重定位。默认为ON，把内核的可写区域重定位到RAM的起始地址。

⑥RAMFLAGS：指定内核特性的一些位掩码，可以进行组合

0x01：表示禁用按需调页，这样某个模块在运行前就要被完全装入RAM中。

0x02：表示禁用Full Kernel(完全内核模式)。

0x10：表示只信赖bib文件中放在MODULES块中的文件。

0x20：指示内核不要清空x86的TLB。

0x40：表示按照DLL的/base链接选项中的地址加载DLL，这样DLL就可被加载到某个预先定义的地址。

⑦ROMSTART：指WINCE image在内存中的起始地址，如下文的0x8C200000.

⑧ROMWIDTH：指定数据总线的宽度，可为8，16或32。

8：表示构建系统会把WINCE image分为4个文件，按8位BYTE依次存放。

16：表示构建系统会把整个WINCE image分成两个文件。

32：表示构建系统会把整个WINCE image作为一个文件。

⑨ROMSIZE：指定WINCE image的大小。

⑩FSRAMPERCENT：定义了文件系统使用的内存的百分比，默认值为0x80808080。

Byte 0：第一个2MB中，每1MB所包含的4KB的倍数。

Byte 1：第一个2MB中，每1MB所包含的4KB的倍数。

Byte 2：第一个2MB中，每1MB所包含的4KB的倍数。

Byte 3：剩余的内存中，每1MB所包含的4KB的倍数。

Config.bib文件的一部分：

CONFIG

COMPRESSION=ON

KERNELFIXUPS=ON

/**************************************************/

此段代码指定了构建系统压缩WINCE image的可写部分和对WINCE image的可写部分进行重定位。

/***************************************************/*

IF IMGPROFILER

PROFILE=ON

ENDIF

IF IMGPROFILER !

PROFILE=OFF

ENDIF

/*****************************************************/

如果设置了环境变量IMGPROFILER，就启动PROFILE。

/*******************************************************/

IF IMGTRUSTROMONLY

IF IMGNOTALLKMODE

ROMFLAGS=12

/*************************************/

表示禁用Full Kernel(完全内核模式)并且只信赖bib文件中放在MODULES块中的文件。

/***************************************/

ENDIF

IF IMGNOTALLKMODE !

ROMFLAGS=10 //表示只信赖bib文件中放在MODULES块中的文件。

ENDIF

ENDIF

IF IMGTRUSTROMONLY !

IF IMGNOTALLKMODE

ROMFLAGS=2 //表示禁用Full Kernel(完全内核模式)。

ENDIF

IF IMGNOTALLKMODE !

ROMFLAGS=0

ENDIF

ENDIF

ROMSTART=8C200000

ROMWIDTH=32

ROMSIZE=01500000

FSRAMPERCENT=0x08080808

⑶MODULES和FILES

这两项列出了所有被包含到WINCE image中的模块以及文件，以及这些模块和文件以什么方式被加载到内存中，具体格式如下所示：

MODULES

Name Path Memory Type

Name：此文件的名字，比如一个dll或者exe文件的文件名。

Path：是要打包文件的完整路径和名称，一般都是WINCE的工程的release目录。

Memory：指定此文件放在上面提到的MEMORY项的哪一段内存中。

Type：文件的类型，常用的有如下几种：

①S：表示系统文件。

②H: 表示隐藏文件。

③U: 表示不压缩此文件。

④D：表示不能对此文件进行调试。

⑤N：表示此文件不受信任。

⑥M：表示对此文件禁止按需调页。

以下内容是摘之platform.bib文件的部分内容

MODULES

; Name Path Memory Type

IF BSP_NODISPLAY !

s3c2440disp.dll $(_FLATRELEASEDIR)/s3c2440disp.dll NK SH

ENDIF BSP_NODISPLAY !

/*****************************************************/

如果在XXX:/WINCE500/PLATFORM/SMDK2440目录下的SMDK2440 DOS批处理文件设置了：SET BSP_NODISPLAY =1，那么构建系统将不会打包s3c2440disp.dll到WINCE image(NK.bin)中。

/***********************************************************/

backlite.dll $(_FLATRELEASEDIR)/backlite.dll NK SH

camera.dll $(_FLATRELEASEDIR)/camera.dll NK SH

AVOUT.dll $(_FLATRELEASEDIR)/AVOUT.dll NK SH

/**********************************************************/

根据上面的内容，构建系统就把_FLATRELEASEDIR目录下的backlite.dll、camera.dll 和AVOUT.dll打包到WINCE image中，放在NK内存中，并指定它们为系统文件和隐藏文件。

/**********************************************************/

FILES

; Name Path Memory Type

events.wav $(_FLATRELEASEDIR)/events.wav NK H

LoadGuid.exe $(_FLATRELEASEDIR)/LoadGuid.exe NK U

PowerApp.exe $(_FLATRELEASEDIR)/PowerApp.exe NK U

usbcnect.lnk $(_FLATRELEASEDIR)/usbcnect.lnk NK U

usbcnect.exe $(_FLATRELEASEDIR)/usbcnect.exe NK U

IB文件支持“条件编译”，我们可以通过设置环境变量来选择性地将某些模块打包到WINCE image中。一般在BSP中，对于一些驱动模块的环境变量我们通过IF来进行条件判断，而对于WINCE系统模块来说，一般都是SYSGEN变量，应该使用@CESYSGEN IF来判断。

在我们的BSP开发中最常见的主要有stepldr.bib、eboot.bib 、config.bib、platform.bib和project.bib，其中：

project.bib：该文件的配置主要是针对当前的OS Design。

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

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

eboot.bib：该文件描述了WINCE系统的eboot的内存的配置。

stepldr.bib:该文件描述了WINCE系统的nboot的内存的配置。