u-boot启动流程分析(2)_板级(board)部分

1. 前言

书接上文（u-boot启动流程分析(1)_平台相关部分），本文介绍u-boot启动流程中和具体版型（board）有关的部分，也即board_init_f/board_init_r所代表的、board有关初始化过程。该过程将持续u-boot的整个生命周期，直到main_loop（即传说中的命令行）。

注1：由于u-boot后初始化过程，基本上涉及到了所有的软件模块，因此本文不能一一分析，基本原则就是捡看着顺眼的、熟的下手了~。

2. Generic Board

我们在“u-boot启动流程分析(1)_平台相关部分”中，介绍过board_init_f接口，并在“X-003-UBOOT-基于Bubblegum-96平台的u-boot移植说明”中，通过在SPL image中的board_init_f点亮了一个LED灯。

u-boot的基本策略，就是声明一系列的API（如low_level_init、board_init_f、board_init_r等等），并在u-boot的核心逻辑中调用它们。平台的移植和开发者，所需要做的，就是根据实际情况，实现它们。

与此同时，为了减少开发的工作量，u-boot为大部分API提供了通用实现（一般通过CONFIG配置项或者若定义去控制是否编译）。以board_init_f和board_init_r两个板级的初始化接口为例，u-boot分别在common/board_f.c和common/board_r.c两个文件中提供了通用实现。查看common/Makefile可知：

ifndef CONFIG_SPL_BUILD 
… 
# boards 
obj-$(CONFIG_SYS_GENERIC_BOARD) += board_f.o 
obj-$(CONFIG_SYS_GENERIC_BOARD) += board_r.o 
… 
endif # !CONFIG_SPL_BUILD 

这两个通用接口是由CONFIG_SYS_GENERIC_BOARD配置项控制的，并且只会在u-boot image中被编译。再通过arch/Kconfig中ARM平台有关的配置可知：

config ARM 
        bool "ARM architecture" 
        select CREATE_ARCH_SYMLINK 
        select HAVE_PRIVATE_LIBGCC if !ARM64 
        select HAVE_GENERIC_BOARD 
        select SYS_GENERIC_BOARD 
        select SUPPORT_OF_CONTROL

ARM平台自动使能了CONFIG_SYS_GENERIC_BOARD配置，因此u-boot image有关的板级启动流程，是由Generic Board的代码实现的，具体可参考后续的分析。

注2：由“u-boot启动流程分析(1)_平台相关部分”中的分析可知，SPL image的声明周期，在自定义的board_init_f执行完成后，便结束了，因此本文将只针对u-boot image。

3. _main

接着“u-boot启动流程分析(1)_平台相关部分”的表述，我们从_main函数重新分析（只不过此时不再是SPL build，代码不再贴出）。执行过程如下：

1）设置初始的堆栈

基址由CONFIG_SYS_INIT_SP_ADDR定义。

2）分配global data所需的空间

将堆栈16 bits对齐之后，调用board_init_f_alloc_reserve接口，从堆栈开始的地方，为u-boot的global data（struct global_data）分配空间。如下：

/* common/init/board_init.c */

ulong board_init_f_alloc_reserve(ulong top) 
{ 
        /* Reserve early malloc arena */ 
#if defined(CONFIG_SYS_MALLOC_F) 
        top -= CONFIG_SYS_MALLOC_F_LEN; 
#endif 
        /* LAST : reserve GD (rounded up to a multiple of 16 bytes) */ 
        top = rounddown(top-sizeof(struct global_data), 16);

        return top; 
}

需要注意的是，如果定义了CONFIG_SYS_MALLOC_F_LEN，则会先预留出early malloc所需的空间。

3）初始化global data

global data的空间分配后，调用board_init_f_init_reserve，初始化global data。所谓的初始化，无非就是一些清零操作，不过有几个地方需要注意：

1）如果不是ARM平台（!CONFIG_ARM），则可以调用arch_setup_gd接口，进行arch级别的设置。当然，前提是，对应的arch应该实现这个接口。

2）如果定义了CONFIG_SYS_MALLOC_F，则会初始化gd->malloc_base。

4）执行前置的（front）初始化操作

调用board_init_f接口，执行前置的初始化操作，会再后面的章节详细说明。

5）执行relocation操作，后面会详细说明。

6）清除BBS段

7）执行后置的（rear）初始化操作

调用board_init_r接口，执行前置的初始化操作，会再后面的章节详细说明。

4. global data介绍以及背后的思考

4.1 背景知识

要理解global data的意义，需要先理解如下的事实：

u-boot是一个bootloader，有些情况下，它可能位于系统的只读存储器（ROM或者flash）中，并从那里开始执行。

因此，这种情况下，在u-boot执行的前期（在将自己copy到可读写的存储器之前），它所在的存储空间，是不可写的，这会有两个问题：

1）堆栈无法使用，无法执行函数调用，也即C环境不可用。

2）没有data段（或者正确初始化的data段）可用，不同函数或者代码之间，无法通过全局变量的形式共享数据。

对于问题1，通常的解决方案是：

u-boot运行起来之后，在那些不需要执行任何初始化动作即可使用的、可读写的存储区域，开辟一段堆栈（stack）空间。

一般来说，大部分的平台（如很多ARM平台），都有自己的SRAM，可用作堆栈空间。如果实在不行，也有可借用CPU的data cache的方法（不再过多说明）。

对于问题2，解决方案要稍微复杂一些：

首先，对于开发者来说，在u-boot被拷贝到可读写的RAM（这个动作称作relocation）之前，永远不要使用全局变量。

其次，在relocation之前，不同模块之间，确实有通过全局变量的形式传递数据的需求。怎么办？这就是global data需要解决的事情。

4.2 global data

为了在relocation前通过全局变量的形式传递数据，u-boot设计了一个巧妙的方法：

1）定义一个struct global_data类型的数据结构，里面保存了各色各样需要传递的数据

该数据结构的具体内容，后面用到的时候再一个一个解释，这里不再详细介绍。具体可参考：include/asm-generic/global_data.h

2）堆栈配置好之后，在堆栈开始的位置，为struct global_data预留空间（可参考第3章中相关的说明），并将开始地址（就是一个struct global_data指针）保存在一个寄存器中，后续的传递，都是通过保存在寄存器中的指针实现

对arm64平台来说，该指针保存在了X18寄存器中，如下：

/* https://github.com/wowotechX/u-boot/blob/x_integration/arch/arm/lib/crt0_64.S */

bl      board_init_f_alloc_reserve 
mov     sp, x0 
/* set up gd here, outside any C code */ 
mov     x18, x0 
bl      board_init_f_init_reserve

上面board_init_f_alloc_reserve的返回值（x0）就是global data的指针。

/* arch/arm/include/asm/global_data.h */

#ifdef __clang__

#define DECLARE_GLOBAL_DATA_PTR 
#define gd      get_gd()

static inline gd_t *get_gd(void) 
{ 
        gd_t *gd_ptr;

#ifdef CONFIG_ARM64 
        … 
        __asm__ volatile("mov %0, x18\n" : "=r" (gd_ptr)); 
#else 
       … 
}

#else

#ifdef CONFIG_ARM64 
#define DECLARE_GLOBAL_DATA_PTR         register volatile gd_t *gd asm ("x18") 
#else 
… 
#endif 

5. 前置的板级初始化操作

global data准备好之后，u-boot会执行前置的板级初始化动作，即board_init_f。所谓的前置的初始化动作，主要是relocation之前的初始化操作，也就是说：

执行board_init_f的时候，u-boot很有可能还在只读的存储器中。大家记住这一点就可以了！

注3：大家可能会觉得这里的f(front?)和r(rear?)的命名有点奇怪，我猜这个软件工程师应该是车迷，是不是借用了前驱和后驱的概念？不得而知啊。

对于ARM等平台来说，u-boot提供了一个通用的board_init_f接口，该接口使用u-boot惯用的设计思路：

u-boot将需要在board_init_f中初始化的内容，抽象为一系列API。这些API由u-boot声明，由平台的开发者根据实际情况实现。具体可参考本章后续的描述。

5.1 board_init_f

位于common/board_f.c中的board_init_f接口的实现非常简单，如下（省略了一些无用代码）：

void board_init_f(ulong boot_flags) 
{ 
…

        gd->flags = boot_flags; 
        gd->have_console = 0;

        if (initcall_run_list(init_sequence_f)) 
                hang();

… 
}

对global data进行简单的初始化之后，调用位于init_sequence_f数组中的各种初始化API，进行各式各样的初始化动作。后面将会简单介绍一些和ARM平台有关的、和平台的移植工作有关的、比较重要的API。其它API，大家可以参考source code自行理解。

注4：下面红色字体标注的API，是u-boot移植时有很大可能需要的API，大家留意就是。

5.2 fdtdec_setup

#ifdef CONFIG_OF_CONTROL 
        fdtdec_setup, 
#endif

如果打开了CONFIG_OF_CONTROL，则调用fdtdec_setup，配置gd->fdt_blob指针（即device tree所在的存储位置）。对ARM平台来说，u-boot的Makefile会通过连接脚本，将dtb文件打包到u-boot image的“__dtb_dt_begin”位置处，因此不需要特别关心。

5.3 trace_early_init

#ifdef CONFIG_TRACE 
        trace_early_init, 
#endif

由CONFIG_TRACE配置项控制，暂且不用关注，后面用到的时候再分析。

5.4 initf_malloc

如果定义了CONFIG_SYS_MALLOC_F_LEN，则调用initf_malloc，初始化malloc有关的global data，如gd->malloc_limit、gd->malloc_ptr。

5.5 arch_cpu_init

cpu级别的初始化操作，可以在需要的时候由CPU有关的code实现。

5.6 initf_dm

driver model有关的初始化操作。如果定义了CONFIG_DM，则调用dm_init_and_scan初始化并扫描系统所有的device。如果定义了CONFIG_TIMER_EARLY，调用dm_timer_init初始化driver model所需的timer。

5.7 board_early_init_f

#if defined(CONFIG_BOARD_EARLY_INIT_F) 
        board_early_init_f, 
#endif

如果定义CONFIG_BOARD_EARLY_INIT_F，则调用board_early_init_f接口，执行板级的early初始化。平台的开发者可以根据需要，实现board_early_init_f接口，以完成特定的功能。

5.8 timer_init

初始化系统的timer。

该接口应该由平台或者板级的代码实现，初始化成功后，u-boot会通过其它的API获取当前的timestamp，后面用到的时候再详细介绍。

5.9 get_clocks

获取当前CPU和BUS的时钟频率，并保存在global data中：

gd->cpu_clk

gd->bus_clk

5.10 env_init

初始化环境变量有关的逻辑，不需要特别关注。

5.11 init_baud_rate

gd->baudrate = getenv_ulong("baudrate", 10, CONFIG_BAUDRATE);

获取当前使用串口波特率，可以有两个途径（优先级从高到低）：从"baudrate"中获取；从CONFIG_BAUDRATE配置项获取。

5.12 serial_init

初始化serial，包括u-boot serial core以及具体的serial driver。该函数执行后，系统的串口（特别是用于控制台的）已经可用。

5.13 console_init_f

/* Called before relocation - use serial functions */ 
int console_init_f(void) 
{ 
        gd->have_console = 1;

#ifdef CONFIG_SILENT_CONSOLE 
        if (getenv("silent") != NULL) 
                gd->flags |= GD_FLG_SILENT; 
#endif

        print_pre_console_buffer(PRE_CONSOLE_FLUSHPOINT1_SERIAL);

        return 0; 
}

初始化系统的控制台，之后串口输出可用。大家可留意CONFIG_SILENT_CONSOLE配置项，如果使能，可以通过“silent”环境变量，控制u-boot的控制台是否输出。

5.14  fdtdec_prepare_fdt

#ifdef CONFIG_OF_CONTROL 
        fdtdec_prepare_fdt, 
#endif

如果定义了CONFIG_OF_CONTROL，调用fdtdec_prepare_fdt接口，准备device tree有关的内容。后续device tree的分析文章会详细介绍。

5.15 display_options/display_text_info/print_cpuinfo/show_board_info

通过控制台，显示一些信息，可用于debug。

5.16 misc_init_f

#if defined(CONFIG_MISC_INIT_F) 
        misc_init_f, 
#endif

如果使能了CONFIG_MISC_INIT_F，则调用misc_init_f执行misc driver有关的初始化。

5.17 init_func_i2c

#if defined(CONFIG_HARD_I2C) || defined(CONFIG_SYS_I2C) 
        init_func_i2c, 
#endif

如果使能了CONFIG_HARD_I2C或者CONFIG_SYS_I2C，则调用init_func_i2c执行i2c driver有关的初始化。

5.18 init_func_spi

#if defined(CONFIG_HARD_SPI) 
        init_func_spi, 
#endif

如果使能了CONFIG_HARD_SPI，则调用init_func_spi执行spi driver有关的初始化。

5.19 announce_dram_init

宣布我们要进行DDR的初始化动作了（其实就是一行打印）。

5.20 dram_init

#if defined(CONFIG_ARM) || defined(CONFIG_X86) || defined(CONFIG_NDS32) || \ 
                defined(CONFIG_MICROBLAZE) || defined(CONFIG_AVR32) 
        dram_init,              /* configure available RAM banks */ 
#endif

调用dram_init接口，初始化系统的DDR。dram_init应该由平台相关的代码实现。

如果DDR在SPL中已经初始化过了，则不需要重新初始化，只需要把DDR信息保存在global data中即可，例如：

gd->ram_size = …

5.21 testdram

#if defined(CONFIG_SYS_DRAM_TEST) 
        testdram, 
#endif /* CONFIG_SYS_DRAM_TEST */

如果定义了CONFIG_SYS_DRAM_TEST，则会调用testdram执行DDR的测试操作。可以在开发阶段打开，系统稳定后关闭。

5.22 DRAM空间的分配

DRAM初始化完成后，就可以着手规划u-boot需要使用的部分，如下图：

图片1 u-boot中DRAM的使用情况

总结如下：

1）考虑到后续的kernel是在RAM的低端位置解压缩并执行的，为了避免麻烦，u-boot将使用DRAM的顶端地址，即gd->ram_top所代表的位置。其中gd->ram_top是由setup_dest_addr函数配置的。

2）u-boot所使用的DRAM，主要分为三类：各种特殊功能所需的空间，如log buffer、MMU page table、LCD fb buffer、trace buffer、等等；u-boot的代码段、数据段、BSS段所占用的空间（就是u-boot relocate之后的执行空间），由gd->relocaddr标示；堆栈空间，从gd->start_addr_sp处递减。

3）特殊功能以及u-boot所需空间，是由reserve_xxx系列函数保留的，具体可参考source code，这里不再详细分析。

4）reserve空间分配完毕后，堆栈紧随其后，递减即可。

5.23 setup_dram_config

调用dram_init_banksize接口（由具体的平台代码实现），初始化DDR的bank信息。

5.24 reloc_fdt

如果没有定义CONFIG_OF_EMBED，则先将device tree拷贝到图片1 new_fdt所在的位置，也就是device tree的relocation操作。

5.25 setup_reloc

计算relocation有关的信息，主要是 gd->reloc_off，计算公式如下：

gd->reloc_off = gd->relocaddr - CONFIG_SYS_TEXT_BASE;

其中CONFIG_SYS_TEXT_BASE是u-boot relocation之前在（只读）memory的位置（也是编译时指定的位置），gd->relocaddr是relocation之后的位置，因此gd->reloc_off代表u-boot relocation操作之后的偏移量，后面relocation时会用到。

同时，该函数顺便把global data拷贝到了图片1所示的“new global data”处，其实就是global data的relocation。

6. u-boot的relocation

前面讲过，u-boot是有可能在只读的memory中启动的。简单起见，u-boot假定所有的启动都是这样，因此u-boot的启动逻辑，都是针对这种情况设计的。在这种情况下，基于如下考虑：

1）只读memory中执行，代码需要小心编写（不能使用全局变量，等等）。

2）只读memory执行速度通常比较慢。

u-boot需要在某一个时间点，将自己从“只读memory”中，拷贝到可读写的memory（如SDRAM，后面统称RAM，注意和SRAM区分，不要理解错了）中继续执行，这就是relocation（重定位）操作。

relocation的时间点，可以是“系统可读写memory始化完成之后“的任何时间点。根据u-boot当前的代码逻辑，是在board_init_f执行完成之后，因为board_init_f中完成了很多relocation有关的准备动作，具体可参考第5章的描述。

u-boot relocation的代码如下（以arm64为例）：

/* https://github.com/wowotechX/u-boot/blob/x_integration/arch/arm/lib/crt0_64.S */

        ldr     x0, [x18, #GD_START_ADDR_SP]    /* x0 <- gd->start_addr_sp */ 
        bic     sp, x0, #0xf    /* 16-byte alignment for ABI compliance */ 
        ldr     x18, [x18, #GD_BD]              /* x18 <- gd->bd */ 
        sub     x18, x18, #GD_SIZE              /* new GD is below bd */

        adr     lr, relocation_return 
        ldr     x9, [x18, #GD_RELOC_OFF]        /* x9 <- gd->reloc_off */ 
        add     lr, lr, x9      /* new return address after relocation */ 
        ldr     x0, [x18, #GD_RELOCADDR]        /* x0 <- gd->relocaddr */ 
        b       relocate_code

relocation_return:

逻辑比较简单：

1）从global data中取出relocation之后的堆栈基址，16-byte对齐后，保存到sp中。

2）将新的global data的指针，保存在x18寄存器中。

3）计算relocation之后的执行地址（relocation_return处），计算的方法就是当前的relocation_return位置加上gd->reloc_off。

4）以relocation的目的地址（gd->relocaddr）为参数，调用relocate_code执行实际的relocation动作，就是将u-boot的代码段、data段、bss段等数据，拷贝到新的位置（gd->relocaddr）。

7. 后置的板级初始化操作

relocate完成之后，真正的C运行环境才算建立了起来，接下来会执行“后置的板级初始化操作”，即board_init_r函数。board_init_r和board_init_f的设计思路基本一样，也有一个很长的初始化序列----init_sequence_r，该序列中包含如下的初始化函数（逻辑比较简单，这里不再涉及细节，权当列出index吧）：

注5：老规矩，红色字体标注的函数是比较重要的函数。

1）initr_trace，初始化并使能u-boot的tracing system，涉及的配置项有CONFIG_TRACE。

2）initr_reloc，设置relocation完成的标志。

3）initr_caches，使能dcache、icache等，涉及的配置项有CONFIG_ARM。

4）initr_malloc，malloc有关的初始化。

5）initr_dm，relocate之后，重新初始化DM，涉及的配置项有CONFIG_DM。

6）board_init，具体的板级初始化，需要由board代码根据需要实现，涉及的配置项有CONFIG_ARM。

7）set_cpu_clk_info，Initialize clock framework，涉及的配置项有CONFIG_CLOCKS。

8）initr_serial，重新初始化串口（不太明白什么意思）。

9）initr_announce，宣布已经在RAM中执行，会打印relocate后的地址。

10）board_early_init_r，由板级代码实现，涉及的配置项有CONFIG_BOARD_EARLY_INIT_R。

11）arch_early_init_r，由arch代码实现，涉及的配置项有CONFIG_ARCH_EARLY_INIT_R。

12）power_init_board，板级的power init代码，由板级代码实现，例如hold住power。

13）initr_flash、initr_nand、initr_onenand、initr_mmc、initr_dataflash，各种flash设备的初始化。

14）initr_env，环境变量有关的初始化。

15）initr_secondary_cpu，初始化其它的CPU core。

16）stdio_add_devices，各种输入输出设备的初始化，如LCD driver等。

17）interrupt_init，中断有关的初始化。

18）initr_enable_interrupts，使能系统的中断，涉及的配置项有CONFIG_ARM（ARM平台u-boot实在开中断的情况下运行的）。

19）initr_status_led，状态指示LED的初始化，涉及的配置项有CONFIG_STATUS_LED、STATUS_LED_BOOT。

20）initr_ethaddr，Ethernet的初始化，涉及的配置项有CONFIG_CMD_NET。

21）board_late_init，由板级代码实现，涉及的配置项有CONFIG_BOARD_LATE_INIT。

22）等等…

23）run_main_loop/main_loop，执行到main_loop，开始命令行操作。

原创文章，转发请注明出处。蜗窝科技，www.wowotech.net。

标签: uboot board init relocate relocation dram

评论：