1. 大纲

大概内容如下：

• u-boot功能概述
  • 目的
  • 功能细分
• u-boot源码结构
• u-boot的配置、编译、连接过程
  • Makefile深入练习
  • 分析u-boot的Makefile
  • u-boot可执行程序的组成
• u-boot源码分析
  • SPL与第1阶段
  • 第2阶段
  • 核心：命令
  • 让u-boot的使用更加便利：env
• u-boot的设备树
• u-boot实战
  • 移植其他版本的u-boot
  • 修改设备树支持网卡

2. u-boot核心功能

就是启动内核：

• 读Flash，把内核读入内存
• 启动内核

3. 配置u-boot的过程分析

3.1 源码结构

在u-boot目录下执行"tree . -d > 1.txt"，可以得到目录的结构，精简如下：

├── arch    
│   ├── arm              // 1. 架构相关
│   │   ├── cpu
│   │   │   ├── armv7
│   │   │   │   ├── mx6
│   │   ├── dts
│   │   │   └── include
│   │   │       └── dt-bindings -> ../../../../include/dt-bindings
│   │   ├── include
│   │   │   ├── asm
│   │   │   │   ├── arch-imx
│   │   │   │   ├── arch-imx8
│   │   │   │   ├── arch-imx8m
│   │   │   │   ├── imx-common
│   │   │   └── debug
│   │   ├── lib
│   │   ├── mach-rockchip
│   │   │   ├── rk3036
│   │   │   ├── rk3288
│   │   │   └── rk3399
│   │   ├── lib
├── board             // 单板相关
│   ├── freescale
│   │   ├── common
│   │   │   └── p_corenet
│   │   ├── corenet_ds
│   │   ├── mx6ul_14x14_ddr3_arm2
│   │   ├── mx6ul_14x14_evk
│   │   ├── mx6ul_14x14_lpddr2_arm2
│   │   ├── mx6ull_ddr3_arm2
│   │   ├── mx6ullevk
├── cmd                   // 通用的命令
│   ├── fastboot
│   └── mvebu
├── common                // 通用的
│   ├── eeprom
│   ├── init
│   └── spl
├── configs
├── disk
├── drivers               // 各类驱动
├── fs                    // 文件系统
│   ├── cbfs
│   ├── cramfs
│   ├── ext4
│   ├── fat
│   ├── jffs2
│   ├── reiserfs
│   ├── sandbox
│   ├── ubifs
│   ├── yaffs2
│   └── zfs
├── include
├── lib                  // 库
├── net                  // 网络协议

3.2 Makefile分析

3.2.1 基础知识

文档：本Git仓库01_all_series_quickstart\04_嵌入式Linux应用开发基础知识\doc_pic\04.2018_Makefile

3.2.2 make的技巧

打印Makefile的规则和变量：make -p

可以把make命令规则和变量存入文件：make -p > 1.txt

然后执行vi 1.txt，使用vi命令删除注释：:g/^#/d

3.3 u-boot的默认配置

3.3.1 默认配置的过程

IMX6ULL: make mx6ull_14x14_evk_defconfig

STM32MP157: make stm32mp15_trusted_defconfig

执行过程：

• 制作工具：scripts/kconfig/conf
• 把默认配置信息写入文件".config"
  

分析过程：

mx6ull_14x14_evk_defconfig: scripts/kconfig/conf$(Q)$< $(silent) --defconfig=arch/$(SRCARCH)/configs/$@ $(Kconfig)

就是：

UBOOTVERSION=2017.03 scripts/kconfig/conf --defconfig=arch/../configs/mx6ull_14x14_evk_defconfig Kconfig

3.3.2 conf命令概述

总体分析：scripts/kconfig/conf.c

更详细的配置过程：make mx6ull_14x14_evk_defconfig V=1

defconfig_file = "arch/../configs/mx6ull_14x14_evk_defconfig";
name = "Kconfig"conf_parse(name);  // 解析uboot根目录下的Kconfig文件conf_read(defconfig_file); // 读配置文件conf_set_all_new_symbols(def_default); // 设置new_symbols为默认值conf_write(NULL); // 写到.config

• Kconfig：这是一个通用文件，里面规定了一些依赖，比如：
  • 如果是ARM架构，就默认选中A、B、C配置
  • 如果是RISC-V架构，就默认选中a、b、c配置
• defconfig_file：这是厂家提供的，里面定义了
  • ARM架构
  • 自己的一些配置项
• 怎么处理呢？
  • 使用defconfig_file的内容去解析Kconfig，确定各个依赖的配置项
  • 其他未涉及的配置项，给它们指定默认值
  • 写入.config

3.3.3 conf命令详解

深入分析：scripts/kconfig/conf.c

3.4. Kconfig介绍

参考文档：

任一个Linux内核的Documentation\kbuild\kconfig-language.rsthttps://www.rt-thread.org/document/site/programming-manual/kconfig/kconfig/

对于各类内核，只要支持menuconfig配置界面，都是使用Kconfig。
在配置界面中，可以选择、设置选项，这些设置会保存在.config文件里。
编译脚本会包含.config，根据里面的值决定编译哪些文件、怎么编译文件。
.config文件也会被转换为头文件，C程序可以从头文件中获得配置信息。

1.1 配置界面示例

问题：

• 这个界面里，各个配置项来自哪里
• 这个界面里，这些配置项是怎么组织的
• 这个界面里，我们的选择、设置，结果保存在哪里
• 这些配置结果，怎么使用

1.2 配置结果的保存

1.2.1 示例

在配置界面中操作的结果保存在.config文件中，示例如下：

#
# Automatically generated file; DO NOT EDIT.
# U-Boot  Configuration
#
CONFIG_CREATE_ARCH_SYMLINK=y
# CONFIG_ARC is not set
CONFIG_ARM=y
# CONFIG_AVR32 is not set
# CONFIG_BLACKFIN is not set
# CONFIG_M68K is not set
# CONFIG_MICROBLAZE is not set
# CONFIG_MIPS is not set
# CONFIG_NDS32 is not set
# CONFIG_NIOS2 is not set
# CONFIG_OPENRISC is not set
# CONFIG_PPC is not set
# CONFIG_SANDBOX is not set
# CONFIG_SH is not set
# CONFIG_SPARC is not set
# CONFIG_X86 is not set
# CONFIG_XTENSA is not set
CONFIG_SYS_ARCH="arm"
CONFIG_SYS_CPU="armv7"
CONFIG_SYS_SOC="mx6"
CONFIG_SYS_VENDOR="freescale"
CONFIG_SYS_BOARD="mx6ullevk"
CONFIG_SYS_CONFIG_NAME="mx6ullevk"#
# ARM architecture
#
CONFIG_HAS_VBAR=y
CONFIG_HAS_THUMB2=y
CONFIG_CPU_V7=y
CONFIG_SYS_ARM_ARCH=7
CONFIG_SYS_CACHE_SHIFT_6=y
CONFIG_SYS_CACHELINE_SIZE=64

编译脚本会包含.config文件，它会根据里面的变量比如CONFIG_CPU_V7选择u-boot特性。

1.2.2 配置项的前缀

在Kconfig文件中，假设配置项的名字是XXX，在.config文件中：

• 默认情况下，它对应的变量名为CONFIG_XXX
• 如果设置了环境变量CONFIG_=ABC，则对应的变量名为ABC_XXX

1.3 描述单个配置项config

1.3.1 示例

在menuconfig界面，可以看到这个配置项：

在配置界面，使用方向箭头游走到Display information about the CPU during start up后，可以：

• 输入Y，选择配置项，在.config中对应CONFIG_DISPLAY_CPUINFO=y

• 输入N，不选择配置项，在.config中对应# CONFIG_DISPLAY_CPUINFO is not set

上图中的配置项怎么实现的？
在common/Kconfig文件中，它对应下列代码：

1.3.2 语法

上面是一个精简的例子，完整的例子可以从Linux中获得，如下：

config SGI_SNSCbool "SGI Altix system controller communication support"depends on (IA64_SGI_SN2 || IA64_GENERIC)default yhelpIf you have an SGI Altix and you want to enable systemcontroller communication from user space (you want this!),say Y.  Otherwise, say N.

解释如下：

• config
  表示config option，这是Kconfig的基本entry；其他entry是用来管理config的。
  config 表示一个配置选项的开始，紧跟着的 SGI_SNSC 是配置选项的名称。
  config 下面几行定义了该配置选项的属性。
  属性可以是该配置选项的：类型、输入提示、依赖关系、默认值、帮助信息。
  • bool 表示配置选项的类型，每个 config 菜单项都要有类型定义，变量有5种类型
    • bool 布尔类型
    • tristate 三态类型
    • string 字符串
    • hex 十六进制
    • int 整型
  • “SGI Altix system controller communication support”：提示信息
  • depends on：表示依赖关系，只有(IA64_SGI_SN2 || IA64_GENERIC)被选中，才可以选择SGI_SNSC
  • select XXX：表示反向依赖关系，即当前配置选项被选中后，XXX选项就会被选中。
  • default 表示配置选项的默认值，bool 类型的默认值可以是 y/n。
  • help 帮助信息，在menuconfig界面输入H键时，就会提示帮助信息。

1.4 实现菜单menu/endmenu

1.4.1 示例

示例代码：rt-smart/kernel/src/Kconfig，代码如下：

menu "Boot media"config NOR_BOOTbool "Support for booting from NOR flash"depends on NORhelpEnabling this will make a U-Boot binary that is capable of beingbooted via NOR.  In this case we will enable certain pinmux earlyas the ROM only partially sets up pinmux.  We also default to usingNOR for environment.config NAND_BOOTbool "Support for booting from NAND flash"default nhelpEnabling this will make a U-Boot binary that is capable of beingbooted via NAND flash. This is not a must, some SoCs need this,some not.config ONENAND_BOOTbool "Support for booting from ONENAND"default nhelpEnabling this will make a U-Boot binary that is capable of beingbooted via ONENAND. This is not a must, some SoCs need this,some not.config QSPI_BOOTbool "Support for booting from QSPI flash"default nhelpEnabling this will make a U-Boot binary that is capable of beingbooted via QSPI flash. This is not a must, some SoCs need this,some not.config SATA_BOOTbool "Support for booting from SATA"default nhelpEnabling this will make a U-Boot binary that is capable of beingbooted via SATA. This is not a must, some SoCs need this,some not.config SD_BOOTbool "Support for booting from SD/EMMC"default nhelpEnabling this will make a U-Boot binary that is capable of beingbooted via SD/EMMC. This is not a must, some SoCs need this,some not.config SPI_BOOTbool "Support for booting from SPI flash"default nhelpEnabling this will make a U-Boot binary that is capable of beingbooted via SPI flash. This is not a must, some SoCs need this,some not.endmenu

界面如下：

1.4.2 语法

解释如下：

• menu “xxx"表示一个菜单，菜单名是"xxx”

• menu和endmenu之间的entry都是"xxx"菜单的选项

• 在上面的例子中子菜单有6个选项：

  

1.5 实现单选choice/endchoice

1.5.1 示例

示例代码：rt-smart/kernel/src/Kconfig，代码如下：

config DEBUG_UARTbool "Enable an early debug UART for debugging"helpThe debug UART is intended for use very early in U-Boot to debugproblems when an ICE or other debug mechanism is not available.choiceprompt "Select which UART will provide the debug UART"depends on DEBUG_UARTdefault DEBUG_UART_NS16550config DEBUG_UART_ALTERA_JTAGUARTbool "Altera JTAG UART"helpSelect this to enable a debug UART using the altera_jtag_uart driver.You will need to provide parameters to make this work. The driver willbe available until the real driver model serial is running.config DEBUG_UART_ALTERA_UARTbool "Altera UART"helpSelect this to enable a debug UART using the altera_uart driver.You will need to provide parameters to make this work. The driver willbe available until the real driver model serial is running.endchoice

界面如下：

在上述界面中，设置了DEBUG_UART，才有后续的"选择菜单"。

1.5.2 语法

解释如下：

• choice表示"选择"
• choice和endchoice之间的entry是可以选择的项目
  • 它们之间，只能有一个被设置为"y"：表示编进内核
  • 它们之间，可以设置多个为"m"：表示编译为模块
  • 比如一个硬件有多个驱动程序
    • 同一时间只能有一个驱动能编进内核
    • 但是多个驱动都可以单独编译为模块

1.6 menuconfig

menuconfig XXX和config XXX类似，
唯一不同的是该选项除了能设置y/m/n外，还可以实现菜单效果(能回车进入该项内部)。

1.6.1 示例

示例代码：Kconfig

menuconfig EXPERTbool "Configure standard U-Boot features (expert users)"default yhelpThis option allows certain base U-Boot options and settingsto be disabled or tweaked. This is for specializedenvironments which can tolerate a "non-standard" U-Boot.Use this only if you really know what you are doing.if EXPERTconfig SYS_MALLOC_CLEAR_ON_INITbool "Init with zeros the memory reserved for malloc (slow)"default yhelpThis setting is enabled by default. The reserved mallocmemory is initialized with zeros, so first malloc callswill return the pointer to the zeroed memory. But thisslows the boot time.It is recommended to disable it, when CONFIG_SYS_MALLOC_LENvalue, has more than few MiB, e.g. when uses bzip2 or bmp logo.Then the boot time can be significantly reduced.Warning:When disabling this, please check if malloc calls, maybeshould be replaced by calloc - if one expects zeroed memory.config TOOLS_DEBUGbool "Enable debug information for tools"helpEnable generation of debug information for tools such as mkimage.This can be used for debugging purposes. With debug informationit is possible to set breakpoints on particular lines, single-stepdebug through the source code, etc.endif # EXPERT

界面如下：

1.6.2 语法

menuconfig常用格式有2种：

  menuconfig Mif Mconfig C1config C2endif

或：

  menuconfig Mconfig C1depends on Mconfig C2depends on M

第1项menuconfig M跟config M语法是一样的，
不同之处在于menuocnfig M后面可以跟着好几个依赖于M的config C1、config C2等子配置项。

1.7 if/endif

1.7.1 语法

在上面的menuconfig中就有if/endif的使用，它的语法如下：

"if" <expr>
<if block>
"endif"

1.7.2 示例

示例如下，只有定义了的EXPERT项，SYS_MALLOC_CLEAR_ON_INIT等才会显示出来：

if EXPERTconfig SYS_MALLOC_CLEAR_ON_INITbool "Init with zeros the memory reserved for malloc (slow)"default yhelpThis setting is enabled by default. The reserved mallocmemory is initialized with zeros, so first malloc callswill return the pointer to the zeroed memory. But thisslows the boot time.It is recommended to disable it, when CONFIG_SYS_MALLOC_LENvalue, has more than few MiB, e.g. when uses bzip2 or bmp logo.Then the boot time can be significantly reduced.Warning:When disabling this, please check if malloc calls, maybeshould be replaced by calloc - if one expects zeroed memory.config TOOLS_DEBUGbool "Enable debug information for tools"helpEnable generation of debug information for tools such as mkimage.This can be used for debugging purposes. With debug informationit is possible to set breakpoints on particular lines, single-stepdebug through the source code, etc.endif # EXPERT

1.8 source

source 语句用于读取另一个文件中的 Kconfig 文件，
比如Kconfig中就包含了其他Kconfig：

source "arch/Kconfig"

1.9 comment

comment 语句出现在界面的第一行，用于定义一些提示信息，如cmd/Kconfig：

comment "Commands"

界面如下：

1.10 测试代码

1.10.1 config

config 100ASKbool "test for 100ask"default yhelpjust for Kconfig test

1.10.2 menu(多选)

menu "100ASK menu"config IMX6ULL_TESTtristate "menu test item 1 IMX6ULL"helpjust for test menu.config STM32MP157_TESTtristate "menu test item 2 IMX6ULLh"helpjust for test menu.
endmenu

1.10.3 choice(单选)

config CHOICE_ON_100ASKbool "Enable choice for 100ask"helpEnable choice for 100askchoiceprompt "choice test for 100ask"depends on CHOICE_ON_100ASKconfig CHOICE_ITEM1bool "CHOICE_ITEM1"helpCHOICE_ITEM1.config CHOICE_ITEM2bool "CHOICE_ITEM2"helpCHOICE_ITEM2.endchoice

1.10.4 menuconfig

menuconfig 100ASK_MENUCFGbool "test for menuconfig of 100ask"if 100ASK_MENUCFG
config IMX6ULL_TEST_MENUCFGtristate "menuconfig test item 1 IMX6ULL"helpjust for test menuconfig.config STM32MP157_MENUCFGtristate "menuconfig test item 2 IMX6ULLh"helpjust for test menuconfig.
endif

menu "test menu"
config TEST_Abool "TEST A"default yconfig TEST_Bbool "TEST B"default yendmenuchoiceprompt "test choise"default TEST_Cconfig TEST_Cbool "TEST C"default yconfig TEST_Dbool "TEST D"default yendchoice        menuconfig TEST_MENUCONFIGbool "test menuconfig"default nif TEST_MENUCONFIG
config TEST_Ebool "TEST E"default yconfig TEST_Fbool "TEST F"default yendif