S3C2410 bootloader ----VIVI阅读笔记

建议读一读《嵌入式系统Boot Loader技术内幕》(詹荣开著)，google一下就会找到一片。什么是Bootloader就不再这里废话了，看看上面的文章就明了了。 Bootloader有很多种，如本文将要阅读的vivi，除此之外还有uboot，redboot，lilo等等。Vivi 是韩国mizi公司专门为三星s3c2410芯片设计的Bootloader。

先来看看vivi的源码树：

vivi-+-arch-+-s3c2410

|-Documentation

|-drivers-+-serial

| ‘-mtd-+-maps

| |-nor

| ‘-nand

|-include-+-platform

| |-mtd

| ‘-proc

|-init

|-lib-+-priv_data

|-scripts-+-lxdialog

|-test

|-util

可以google一下，搜到源码vivi.tar.gz。

前面提到的文件已经系统的分析了bootloader的，这里就按源代码来具体说事。vivi也可以分为2个阶段，阶段1的代码在arch/s3c2410/head.S中，阶段2的代码从init/main.c的main函数开始。

阶段1

阶段1从程序arch/s3c2410/head.S开始，按照head.S的代码执行顺序，一次完成了下面几个任务：

1、关WATCH DOG (disable watch dog timer)

上电后，WATCH DOG默认是开着的

2、禁止所有中断 (disable all interrupts)

vivi中不会用到中断，中断是系统的事，bootloader可不能去干这事的(不过这段代码实在多余，上电后中断默认是关闭的)

3、初始化系统时钟(initialise system clocks)

启动MPLL，FCLK=200MHz，HCLK=100MHz，PCLK=50MHz，“CPU bus mode”改为“Asynchronous bus mode”。

4、初始化内存控制寄存器(memsetup)

S3c2410共有15个寄存器，在此开始初始化13个寄存器。

5、检查是否从掉电模式唤醒(Check if this is a wake-up from sleep)

若是，则调用WakeupStart函数进行处理。

6、点亮所有LED (All LED on)

点一下灯，通知外面的同志，告诉他们有情况发生。

7、初始化UART0 (set GPIO for UART & InitUART)

a．设置GPIO，选择UART0使用的引脚

b．初始化UART0，设置工作方式（使用FIFO）、波特率115200 8N1、无流控等。这可是使用串口与s3c2410通信的条件啊，在终端也要如此设置。

8、跳到内存测试函数(simple memory test to find some DRAM flaults)

当然要定义了CONFIG_BOOTUP_MEMTEST这个参数才会跳到内存测试。

9、如果定义了以Nand flash方式启动(#ifdef CONFIG_S3C2410_NAND_BOOT)，则此时要将vivi所有代码(包括阶段1和阶段2)从Nand flash复制到SDRAM中（因为在Nand flash中是不能执行程序的，它只能做为程序和数据的存储器，而Nor flash可就不同了，Nor flash可以执行程序，但贵是它发展得瓶颈）：

a．设置nand flash控制寄存器

b．设置堆栈指针

c．设置即将调用的函数nand_read_ll的参数：r0=目的地址(SDRAM的地址)，r1=源地址(nand flash的地址)，r2=复制的长度(以字节为单位)

d．调用nand_read_ll进行复制

　　10、跳到bootloader的阶段2运行，亦即调用init/main.c中的main函数(get read to call C functions)

a．重新设置堆栈

b．设置main函数的参数

c．调用main函数

head.S有900多行，都是些arm汇编，看的云山雾罩，汇编看来是忘的差不多了，所以这部分代码也看的相当糙，只知道大概在干什么，至于个中缘由就不是很了解。先学学arm汇编再回来看。

阶段2

从init/main.c中的main函数开始，终于步入C语言的世界了。Main函数总共有8步（8 steps），先看看源代码：

int main(int argc, char *argv[])

{

int ret;

/*

* Step 1:

*/

putstr("\r\n");

putstr(vivi_banner); //vivi_banner是vivi执行开始的显示信息，vivi_banner在文件version.c中定义

reset_handler();

/*

* Step 2:

*/

ret = board_init();

if (ret) {

putstr("Failed a board_init() procedure\r\n");

error();

}

/*

* Step 3:

*/

mem_map_init();

mmu_init();

putstr("Succeed memory mapping.\r\n");

/*

* Now, vivi is running on the ram. MMU is enabled.

* Step 4:

*/

/* initialize the heap area*/

ret = heap_init();

if (ret) {

putstr("Failed initailizing heap region\r\n");

error();

}

/* Step 5:

* MTD

*/

ret = mtd_dev_init();

/* Step 6:

*/

init_priv_data();

/* Step 7:

*/

misc();

init_builtin_cmds();

/* Step 8:

*/

boot_or_vivi();

return 0;

}

下面按照上面的步骤逐步来分析一下。

1、Step 1：reset_handler()

reset_handler用于将内存清零，代码在lib/reset_handle.c中。

1 void

2 reset_handler(void)

3 {

4 int pressed;

5 pressed = is_pressed_pw_btn(); /*判断是硬件复位还是软件复位*/

6 if (pressed == PWBT_PRESS_LEVEL) {

7 DPRINTK("HARD RESET\r\n");

8 hard_reset_handle(); /*调用clear_mem对SDRAM清0*/

9 } else {

10 DPRINTK("SOFT RESET\r\n");

11 soft_reset_handle(); /*此函数为空*/

12 }

13 }

在上电后，reset_handler调用第8行的hard_reset_handle()，此函数在lib/reset_handle.c中：

[main(int argc, char *argv[]) -> reset_handler() -> hard_reset_handle()]

1 static void

2 hard_reset_handle(void)

3 {

4 #if 0

5 clear_mem((unsigned long)(DRAM_BASE + VIVI_RAM_ABS_POS), \

6 (unsigned long)(DRAM_SIZE - VIVI_RAM_ABS_POS));

7 #endif

/*lib/memory.c,将起始地址为USER_RAM_BASE，长度为USER_RAM_SIZE的内存清0*/

8 clear_mem((unsigned long)USER_RAM_BASE, (unsigned long) USER_RAM_SIZE);

9 }

先写到这儿吧。

（未完待续）

S3C2410 bootloader ----VIVI阅读笔记2（续笔记1）

2、Step 2：board_init()

board_init调用2个函数用于初始化定时器和设置各GPIO引脚功能，代码在arch/s3c2410/smdk.c中：

[main(int argc, char *argv[]) > board_init()]

1 int board_init(void)

2 {

3 init_time(); /*arch/s3c2410/proc.c*/

4 set_gpios(); /*arch/s3c2410/smdk.c */

5 return 0;

6 }

init_time() 这个函数对寄存器进行了简单的操作：

void init_time(void)

{

TCFG0 = (TCFG0_DZONE(0) | TCFG0_PRE1(15) | TCFG0_PRE0(0));

/*s3c2410 data sheet P298*/

/*TCFG0 = 0 | 0xf00 | 0 */

}

寄存器TCFG0由三部分组成，prescaler0,prescaler1,deadzone和reserve四部分，前三部分分别对应 TCFG0_PRE0、TCFG0_PRE1、TCFG0_DZONE，TCFG0_PRE0(0)实际值为0x00，TCFG0_PRE1(15)实际值为0x0f00，而TCFG0_DZONE(0)实际值为 0x000000。实际中，vivi并未使用定时器，这个函数就可以忽略。set_gpios()用于选择GPA至GPH端口各引脚的功能及是否使用各引脚的内部上拉电阻，并设置外部中断源寄存器EXTINT0-2(vivi中未使用外部中断)。

1 void set_gpios(void)

2 {

3 GPACON = vGPACON;

4 GPBCON = vGPBCON;

5 GPBUP = vGPBUP;

6 GPCCON = vGPCCON;

7 GPCUP = vGPCUP;

8 GPDCON = vGPDCON;

9 GPDUP = vGPDUP;

10 GPECON = vGPECON;

11 GPEUP = vGPEUP;

12 GPFCON = vGPFCON;

13 GPFUP = vGPFUP;

14 GPGCON = vGPGCON;

15 GPGUP = vGPGUP;

16 GPHCON = vGPHCON;

17 GPHUP = vGPHUP;

18 EXTINT0 = vEXTINT0;

19 EXTINT1 = vEXTINT1;

20 EXTINT2 = vEXTINT2;

21 }

以第三行为例，vGPACON的值为0x007fffff，查找s3c2410用户手册可知，该参数将GPACON的23位全部置1。各位功能需察看s3c2410用户手册

3、Step 3：建立页表和启动MMU

mem_map_init();

mmu_init();

mem_map_init函数用于建立页表，vivi使用段式页表，只需要一级页表。它调用3个函数，代码在arch/s3c2410/mmu.c中：

[main(int argc, char *argv[]) > mem_map_init(void)]

1 void mem_map_init(void)

2 {

3 #ifdef CONFIG_S3C2410_NAND_BOOT

/*CONFIG_S3C2410_NAND_BOOT = y ，在文件include/autoconf.h中定义*/

4 mem_map_nand_boot();

/* 最终调用mem_mepping_linear, 建立页表 */

5 #else

6 mem_map_nor();

7 #endif

8 cache_clean_invalidate();/* 清空cache,使无效cache */

9 tlb_invalidate(); /* 使无效快表TLB */

10 }

第9、 10行的两个函数可以不用管它，他们做的事情在下面的mmu_init函数里又重复了一遍。对于本开发板，在.config中定义了 CONFIG_S3C2410_NAND_BOOT。mem_map_nand_boot()函数调用mem_mapping_linear()函数来最终完成建立页表的工作。页表存放在SDRAM物理地址0x33dfc000开始处，共16K：一个页表项4字节，共有4096个页表项；每个页表项对应 1M地址空间，共4G。mem_map_init先将4G虚拟地址映射到相同的物理地址上，NCNB(不使用cache，不使用write buffer)――这样，对寄存器的操作跟未启动MMU时是一样的；再将SDRAM对应的64M空间的页表项修改为使用cache。 mem_mapping_linear函数的代码在arch/s3c2410/mmu.c中：

[main(int argc, char *argv[]) > mem_map_init(void) > mem_map_nand_boot( ) > mem_mapping_linear(void)]

1 static inline void mem_mapping_linear(void)

2 {

3 unsigned long pageoffset, sectionNumber;

4 putstr_hex("MMU table base address = 0x", (unsigned long)

mmu_tlb_base);

5 /* 4G 虚拟地址映射到相同的物理地址. not cacacheable, not bufferable */

6 /* mmu_tlb_base = 0x33dfc000*/

7 for (sectionNumber = 0; sectionNumber < 4096; sectionNumber++) {

8 pageoffset = (sectionNumber << 20);

9 *(mmu_tlb_base + (pageoffset >> 20)) = pageoffset |

MMU_SECDESC;

10 }

11 /* make dram cacheable */

12 /* SDRAM物理地址0x3000000-0x33ffffff,

13 DRAM_BASE=0x30000000,DRAM_SIZE=64M

14 */

15 for (pageoffset = DRAM_BASE; pageoffset < (DRAM_BASE+DRAM_SIZE); \

16 pageoffset += SZ_1M) {

17 //DPRINTK(3, "Make DRAM section cacheable: 0x%08lx\n", pageoffset);

18 *(mmu_tlb_base + (pageoffset >> 20)) = \

pageoffset | MMU_SECDESC | MMU_CACHEABLE;

19 }

20 }

mmu_init()函数用于启动MMU，它直接调用arm920_setup()函数。arm920_setup()的代码在arch/s3c2410/mmu.c中：

[main(int argc, char *argv[]) > mmu_init( ) > arm920_setup( )]

1 static inline void arm920_setup(void)

2 {

3 unsigned long ttb = MMU_TABLE_BASE;

/* MMU_TABLE_BASE = 0x33dfc000 */

4 __asm__(

5 /* Invalidate caches */

6 "mov r0, #0\n"

7 "mcr p15, 0, r0, c7, c7, 0\n" /* invalidate I,D caches on v4 */

8 "mcr p15, 0, r0, c7, c10, 4\n" /* drain write buffer on v4 */

9 "mcr p15, 0, r0, c8, c7, 0\n" /* invalidate I,D TLBs on v4 */

10 /* Load page table pointer */

11 "mov r4, %0\n"

12 "mcr p15, 0, r4, c2, c0, 0\n" /* load page table pointer */

13 /* Write domain id (cp15_r3) */

14 "mvn r0, #0\n" /* Domains 0b01 = client, 0b11=Manager*/

15 "mcr p15, 0, r0, c3, c0, 0\n"

/* load domain access register，write domain 15:0, 用户手册P548(access permissions)*/

16 /* Set control register v4 */

17 "mrc p15, 0, r0, c1, c0, 0\n" /* get control register v4 */

/*数据手册P545：read control register */

18 /* Clear out 'unwanted' bits (then put them in if we need them) */

19 /* ..VI ..RS B... .CAM */ /*这些位的含义在数据手册P546*/

20 "bic r0, r0, #0x3000\n" /* ..11 .... .... .... */

/*I(bit[12])=0 = Instruction cache disabled*/

21 /*V[bit[13]](Base location of exception registers)=0 = Low addresses = 0x0000 0000*/

22 "bic r0, r0, #0x0300\n" /* .... ..11 .... .... */

23 /*R(ROM protection bit[9])=0*/

/*S(System protection bit[8])=0*/

/*由于TTB中AP=0b11(line141)，所以RS位不使用(P579)*/

24 "bic r0, r0, #0x0087\n" /* 0x0000000010000111 */

/*M(bit[0])=0 = MMU disabled*/

/*A(bit[1])=0 =Data address alignment fault checking disable*/

/*C(bit[2])=0 = Data cache disabled*/

/*B(bit[7])=0= Little-endian operation*/

25 /* Turn on what we want */

26 /* Fault checking enabled */

27 "orr r0, r0, #0x0002\n" /* .... .... .... ..10 */

/*A(bit[1])=1 = Data address alignment fault checking enable*/

28 #ifdef CONFIG_CPU_D_CACHE_ON /*is not set*/

29 "orr r0, r0, #0x0004\n" /* .... .... .... .100 */

/*C(bit[2])=1 = Data cache enabled*/

30 #endif

31 #ifdef CONFIG_CPU_I_CACHE_ON /*is not set*/

32 "orr r0, r0, #0x1000\n" /* ...1 .... .... .... */

/*I(bit[12])=1 = Instruction cache enabled*/

33 #endif

34 /* MMU enabled */

35 "orr r0, r0, #0x0001\n" /* .... .... .... ...1 */

/*M(bit[0])=1 = MMU enabled*/

36 "mcr p15, 0, r0, c1, c0, 0\n" /* write control register */

/*数据手册P545*/

37 : /* no outputs */

38 : "r" (ttb) );

39 }

[未完]

S3C2410 bootloader ----VIVI阅读笔记3

4、Step 4：heap_init()

第4步调用了heap_init(void)函数，并返回值。该值是函数heap_init()调用的mmalloc_init()函数的返回值。其实，这步就是申请一块内存区域。

[lib/heap.c->heap_init(void)]

1 int heap_init(void)

2 {

3 return mmalloc_init((unsigned char *)(HEAP_BASE), HEAP_SIZE);

4 }

内存动态分配函数mmalloc就是从heap（堆）中划出一块空闲内存。相应的mfree函数则将动态分配的某块内存释放回heap中。

heap_init 函数在SDRAM中指定了一块1M大小的内存作为heap(起始地址HEAP_BASE = 0x33e00000)，并在heap的开头定义了一个数据结构blockhead。事实上，heap就是使用一系列的blockhead数据结构来描述和操作的。每个blockhead数据结构对应着一块heap内存，假设一个blockhead数据结构的存放位置为A，则它对应的可分配内存地址为“A + sizeof(blockhead)”到“A + sizeof(blockhead) + size - 1”。blockhead数据结构在lib/heap.c中定义：

1 typedef struct blockhead_t {

2 int32 signature; //固定为BLOCKHEAD_SIGNATURE

3 bool allocated; //此区域是否已经分配出去：0-N，1-Y

4 unsigned long size; //此区域大小

5 struct blockhead_t *next; //链表指针

6 struct blockhead_t *prev; //链表指针

7 } blockhead;

现在来看看heap是如何运作的(如果您不关心heap实现的细节，这段可以跳过)。vivi对heap的操作比较简单，vivi中有一个全局变量 static blockhead *gHeapBase，它是heap的链表头指针，通过它可以遍历所有blockhead数据结构。假设需要动态申请一块sizeA大小的内存，则 mmalloc函数从gHeapBase开始搜索blockhead数据结构，如果发现某个blockhead满足：

(1) allocated = 0 //表示未分配

(2) size > sizeA，则找到了合适的blockhead，

满足上述条件后，进行如下操作：

a．allocated设为1

b．如果size ?C sizeA > sizeof(blockhead)，则将剩下的内存组织成一个新的blockhead，放入链表中

c．返回分配的内存的首地址释放内存的操作更简单，直接将要释放的内存对应的blockhead数据结构的allocated设为0即可。

heap_init函数直接调用mmalloc_init函数进行初始化，此函数代码在lib/heap.c中，比较简单，初始化gHeapBase即可：

[main(int argc, char *argv[]) > heap_init(void) > mmalloc_init(unsigned char *heap, unsigned long size)]

1 static inline int mmalloc_init(unsigned char *heap, unsigned long size)

2 {

3 if (gHeapBase != NULL) return -1;

4 DPRINTK("malloc_init(): initialize heap area at 0x%08lx, size = 0x%08lx\n", heap, size);

5 gHeapBase = (blockhead *)(heap);

6 gHeapBase->allocated=FALSE;

7 gHeapBase->signature=BLOCKHEAD_SIGNATURE;

8 gHeapBase->next=NULL;

9 gHeapBase->prev=NULL;

10 gHeapBase->size = size - sizeof(blockhead);

11 return 0;

12 }

static blockhead *gHeapBase = NULL; 这个就是上面称赞的全局变量了，定义在lib/heap.c中。上面就是个链表操作，数据结构，看来搞这个也得好好学数据结构啊，不然内存搞的溢出、浪费可就哭都来不及了。

5、Step 5：mtd_dev_init()

所谓MTD(Memory Technology Device)相关的技术。在linux系统中，我们通常会用到不同的存储设备，特别是FLASH设备。为了在使用新的存储设备时，我们能更简便地提供它的驱动程序，在上层应用和硬件驱动的中间，抽象出MTD设备层。驱动层不必关心存储的数据格式如何，比如是FAT32、ETX2还是FFS2或其它。它仅仅提供一些简单的接口，比如读写、擦除及查询。如何组织数据，则是上层应用的事情。MTD层将驱动层提供的函数封装起来，向上层提供统一的接口。这样，上层即可专注于文件系统的实现，而不必关心存储设备的具体操作。这段乱七八糟的话也许比较让人晕，也可以这样理解在设备驱动（此处指存储设备）和上层应用之间还存在着一层，共三层，这个中间层就是MTD技术的产物。通常可以将它视为驱动的一部分，叫做上层驱动，而那些实现设备的读、写操作的驱动称为下层驱动，上层驱动将下层驱动封装，并且留给其上层应用一些更加容易简单的接口。

在我们即将看到的代码中，使用mtd_info数据结构表示一个MTD 设备，使用nand_chip数据结构表示一个nand flash芯片。在mtd_info结构中，对nand_flash结构作了封装，向上层提供统一的接口。比如，它根据nand_flash提供的 read_data(读一个字节)、read_addr(发送要读的扇区的地址)等函数，构造了一个通用的读函数read，将此函数的指针作为自己的一个成员。而上层要读写flash时，执行mtd_info中的read、write函数即可。

mtd_dev_init()用来扫描所使用的 NAND Flash的型号，构造MTD设备，即构造一个mtd_info的数据结构。对于S3C2410来说，它直接调用mtd_init()，mtd_init 又调用smc_init()，此函数在drivers/mtd/maps/s3c2410_flash.c中：

[main(int argc,char *argv[])>mtd_dev_init()>mtd_init()]

1 int mtd_init(void)

2 {

3 int ret;

4 #ifdef CONFIG_MTD_CFI /*is not set*/

5 ret = cfi_init();

6 #endif

7 #ifdef CONFIG_MTD_SMC9 /* =y */

8 ret = smc_init();

9 #endif

10 #ifdef CONFIG_S3C2410_AMD_BOOT /*is not set*/

11 ret = amd_init();

12 #endif

13 if (ret) {

14 mymtd = NULL;

15 return ret;

16 }

17 return 0;

18 }

显而易见，该函数应取第二项，这项在autoconf.h中定义了。

[main(int argc, char *argv[]) > mtd_dev_init() > mtd_init() > smc_init()]

1 static int

2 smc_init(void)

3 {

/*struct mtd_info *mymtd，数据类型在include/mtd/mtd.h*/

/*strcut nand_chip在include/mtd/nand.h中定义*/

4 struct nand_chip *this;

5 u_int16_t nfconf;

/* Allocate memory for MTD device structure and private data */

6 mymtd = mmalloc(sizeof(struct mtd_info) + sizeof(struct nand_chip));

7 if (!mymtd) {

8 printk("Unable to allocate S3C2410 NAND MTD device structure.\n");

9 return -ENOMEM;

10 }

/* Get pointer to private data */

11 this = (struct nand_chip *)(&mymtd[1]);

/* Initialize structures */

12 memset((char *)mymtd, 0, sizeof(struct mtd_info));

13 memset((char *)this, 0, sizeof(struct nand_chip));

/* Link the private data with the MTD structure */

14 mymtd->priv = this;

/* set NAND Flash controller */

15 nfconf = NFCONF;

/* NAND Flash controller enable */

16 nfconf |= NFCONF_FCTRL_EN;

/* Set flash memory timing */

17 nfconf &= ~NFCONF_TWRPH1; /* 0x0 */

18 nfconf |= NFCONF_TWRPH0_3; /* 0x3 */

19 nfconf &= ~NFCONF_TACLS; /* 0x0 */

20 NFCONF = nfconf;

/* Set address of NAND IO lines */

21 this->hwcontrol = smc_hwcontrol;

22 this->write_cmd = write_cmd;

23 this->write_addr = write_addr;

24 this->read_data = read_data;

25 this->write_data = write_data;

26 this->wait_for_ready = wait_for_ready;

/* Chip Enable -> RESET -> Wait for Ready -> Chip Disable */

27 this->hwcontrol(NAND_CTL_SETNCE);

28 this->write_cmd(NAND_CMD_RESET);

29 this->wait_for_ready();

30 this->hwcontrol(NAND_CTL_CLRNCE);

31 smc_insert(this);

32 return 0;

33 }

6 －14行构造了一个mtd_info结构和nand_flash结构，前者对应MTD设备，后者对应nand flash芯片(如果您用的是其他类型的存储器件，比如nor flash，这里的nand_flash结构应该换为其他类型的数据结构)。MTD设备是具体存储器件的抽象，那么在这些代码中这种关系如何体现呢――第 14行的代码把两者连结在一起了。事实上，mtd_info结构中各成员的实现(比如read、write函数)，正是由priv变量所指向的 nand_flash的各类操作函数(比如read_addr、read_data等)来实现的。

15－20行是初始化S3C2410上的 NAND FLASH控制器。前面分配的nand_flash结构还是空的，现在当然就是填满它的各类成员了，这正是21－26行做的事情。27－30行对这块 nand flash作了一下复位操作。最后，也是最复杂的部分，根据刚才填充的nand_flash结构，构造mtd_info结构，这由31行的 smc_insert函数调用smc_scan完成。

这才是VIVI启动的第5步，还有三步就完成了启动了，同时我的这篇阅读笔记也就O了。