S3C2410 vivi阅读笔记

S3C2410 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=0xC0000000,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 – 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步，还有三步就完成了启动了，同时我的这篇阅读笔记也就OVER了。