查看“︁U-Boot”︁的源代码

== 源代码 ==

=== 主要 ===
https://source.denx.de/u-boot/u-boot

=== 备用 ===
https://github.com/u-boot/u-boot.git

== 说明 ==
通用引导加载器。通常用于加载[[Linux]]。

常用编译命令参数如下(适用于截止编辑时的最新版u-boot):
{| class="wikitable"
!项目
!类型
!说明
!备注
|-
| menuconfig
|Makefile目标
|使用菜单配置u-boot
|必须先加载某个默认配置再使用菜单配置。默认配置在configs目录，可使用<code>make 默认配置名</code>加载。
|-
|all
|Makefile目标
|构建
|这是默认目标，也可省略不带任何目标
|-
|ARCH
|环境变量/Makefile变量
|指定架构
|可在arch目录中查看支持的架构,如32位arm则可指定ARCH=arm
|-
|CROSS_COMPILE
|环境变量/Makefile变量
|指定交叉编译工具链前缀
|如若要使用arm-none-eabi-gcc则可指定CROSS_COMPILE=arm-none-eabi-
|}
==环境变量(Env)==
注意：若未特殊说明，此说明仅适用于截至编辑时的u-boot，不包括旧版u-boot。

Env表示环境变量，很多u-boot的操作及脚本都靠环境变量调控。

默认环境变量主要有以下方式生成:

*[[Kconfig]]配置生成。
*直接文件生成。

默认情况下使用[[Kconfig]]配置生成默认Env，默认环境变量具体定义的头文件/目录/机制如下:

*include/env_default.h文件：定义默认的环境变量与Kconfig配置的关系。
*include/configs目录：各个SOC厂商的配置头文件，一般使用<code>CFG_EXTRA_ENV_SETTINGS</code>宏定义在厂商头文件定义厂商自己的环境变量。
直接使用文件生成默认Env的机制如下:

*厂商的配置文件:默认目录为<code>board/<vendor>/<board>/</code>，文件名可以由<code>CONFIG_ENV_SOURCE_FILE</code>或<code>SYS_BOARD</code>指定，后缀名为.env。
*外部的配置文件:使用<code>CONFIG_USE_DEFAULT_ENV_FILE</code>使能，使用<code>CONFIG_DEFAULT_ENV_FILE</code>指定位置。注意：若启用外部的配置文件将导致[[Kconfig]]中的相关选项不可用，直接完全由用户管理。

== 启动介质 ==
注意：若未特殊说明，此说明仅适用于截至编辑时的u-boot，不包括旧版u-boot。

U-Boot可从多种存储介质上启动，具体支持的启动方式根据硬件方案的不同而不同，本章只描述本人常用的方式。

=== SD卡/TF卡 ===
采用MMC接口,常见于各种开发板。

通常会有一个完整的镜像,采用MBR磁盘分区或者GPT磁盘分区,包含一个FAT分区（方便在Windows更新相关文件）及若干个其他分区，U-boot的启动脚本与Linux内核放在FAT分区。

可使用以下方式烧录镜像:

* dd:在Linux或其他（类）unix中可使用dd命令直接将镜像写入SD卡/TF卡。
* [https://sourceforge.net/projects/win32diskimager win32diskimager]：在windows下可使用此工具写入镜像文件。

对于本人而言，除了开发板厂商提供的方式，本人还可使用[[Buildroot]]产生镜像。

===== 分区 =====
分区采用MBR磁盘分区或者GPT磁盘分区,编辑同pc机一样，有广泛的工具可供使用。

由于磁盘镜像一般都是尽量做小，故烧录后的rootfs可能不是很大，则对于大容量SD卡/TF卡则需要调整rootfs分区。

对于采用ext2/ext3/ext4的rootfs分区而言，可采用以下步骤调整分区：

* 调整分区表:采用各种通用工具调整rootfs的分区表(Linux下可采用fdisk)，扩大分区大小。调整完成后最好进行一次重启。
* 调整文件系统：当分区表调整完成后只是分区大小发生改变，文件系统中的信息并未发生改变，故应当使用resize2fs命令将文件系统调整为分区大小。

===== 数据加载 =====
对于传统的u-boot启动过程而言，所有数据都需要加载到内存中才能继续操作（如启动等）。

可使用mmc命令读取SD卡/TF卡数据,但一般不使用此命令加载数据。

SD卡/TF卡一般采用了MBR磁盘分区或者GPT磁盘分区,并且使用常用的文件系统（如fat、ext2、ext4）,各种文件也是放在文件系统中的.

因此更加常用的是采用文件系统相关命令加载数据到内存,常用的的命令如下:
{| class="wikitable"
!文件系统
!数据加载命令
!说明
|-
|fat32
|fatload
|从fat文件系统加载数据，如启动脚本、Linux内核、设备树dtb、环境变量文件等
|-
|ext2
|ext2load
|从ext2文件系统加载数据。
|-
|ext4
|ext4load
|从ext4文件系统加载数据。
|-
| -
|load
|从文件系统中加载数据。这是一个通用版本，可方便脚本的编写。
|}

===== 移植提示 =====
如需操作mmc设备，需要在 <code>> Command line interface > Device access commands</code>使能 <code>CONFIG_CMD_MMC</code>以启用mmc命令。

如需操作fat文件系统 ，需要在> Command line interface > Filesystem commands使能CONFIG_CMD_FAT启用相关命令。

如需操作ext2文件系统 ，需要在> Command line interface > Filesystem commands使能CONFIG_CMD_EXT2启用相关命令。

如需操作ext4文件系统 ，需要在> Command line interface > Filesystem commands使能CONFIG_CMD_EXT4启用相关命令。

如需使用通用方式操作文件系统，需要在> Command line interface > Filesystem commands使能CONFIG_CMD_FS_GENERIC启用相关命令。

=== SPI Nor Flash ===
采用SPI接口。若未说明，本人一般使用容量大于等于16MBytes的Nor Flash。

Nor Flash的烧录方式根据SOC的不同而不同，具体如下:
*对于全志SOC而言，可进入FEL模式采用[[Xfel]]烧录。

由于Nor Flash容量较小，一般分区使用固定分区，即没有任何分区表与磁盘信息存储在介质上，直接在代码或配置（如[[Devicetree|设备树dts]]）中写死分区信息数据。

==== 分区 ====
MTD设备的分区使用环境变量决定,具体如下：
{| class="wikitable"
!环境变量名称
!u-boot中的注释
!说明
|-
|partition
|'partition' - keeps current partition identifier
<nowiki>*</nowiki>

<nowiki>*</nowiki> partition  := <part-id>

<nowiki>*</nowiki> <part-id>  := <dev-id>,part_num
|相当于其它分区表的激活分区。
dev-id同mtdids中的dev-id。
|-
|mtdids
|'mtdids' - linux kernel mtd device id <-> u-boot device id mapping
<nowiki>*</nowiki>

<nowiki>*</nowiki> mtdids=<idmap>[,<idmap>,...]

<nowiki>*</nowiki>

<nowiki>*</nowiki> <idmap>    := <dev-id>=<mtd-id>

<nowiki>*</nowiki> <dev-id>   := 'nand'|'nor'|'onenand'|'spi-nand'<dev-num>

<nowiki>*</nowiki> <dev-num>  := mtd device number, 0...

<nowiki>*</nowiki> <mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)
|mtd设备id列表。
dev-id的格式是固定(如第一个nor flash的dev-id为nor0)。

此环境变量相当于将mtd设备与linux中的标签对应，使得mtdparts可以直接传给Linux内核。
|-
|mtdparts
|'mtdparts' - partition list
<nowiki>*</nowiki>

<nowiki>*</nowiki> mtdparts=[mtdparts=]<mtd-def>[;<mtd-def>...]

<nowiki>*</nowiki>

<nowiki>*</nowiki> <mtd-def>  := <mtd-id>:<part-def>[,<part-def>...]

<nowiki>*</nowiki> <mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)

<nowiki>*</nowiki> <part-def> := <size>[@<offset>][<name>][<ro-flag>]

<nowiki>*</nowiki> <size>     := standard linux memsize OR '-' to denote all remaining space

<nowiki>*</nowiki> <offset>   := partition start offset within the device

<nowiki>*</nowiki> <name>     := '(' NAME ')'

<nowiki>*</nowiki> <ro-flag>  := when set to 'ro' makes partition read-only (not used, passed to kernel)
|mtd设备分区表。
|}
u-boot的mtd分区信息可以通过内核命令行传给启用了命令行传MTD分区参数的[[Linux]]内核,但更加常见的是使用[[Devicetree|设备树dts]]传MTD分区参数给[[Linux]]内核。

u-boot中mtd分区的例子如下：<syntaxhighlight lang="c++" line="1">
/*
 * Examples:
 *
 * 1 NOR Flash, with 1 single writable partition:
 * mtdids=nor0=edb7312-nor
 * mtdparts=[mtdparts=]edb7312-nor:-
 *
 * 1 NOR Flash with 2 partitions, 1 NAND with one
 * mtdids=nor0=edb7312-nor,nand0=edb7312-nand
 * mtdparts=[mtdparts=]edb7312-nor:256k(ARMboot)ro,-(root);edb7312-nand:-(home)
 *
 */

</syntaxhighlight>默认分区信息的[[Kconfig]]在启用mtdparts命令时可填写，如下：
{| class="wikitable"
!Kconfig项
!环境变量项
|-
|CONFIG_MTDIDS_DEFAULT
|mtdids
|-
|CONFIG_MTDPARTS_DEFAULT
|mtdparts
|}

===== 全志SOC =====
默认情况下(u-boot在全志SOC默认设置)，采用以下分区:
{| class="wikitable"
!起始地址
!大小(字节)
!名称
!说明
|-
|0
|0xF0000(960KBytes)
|u-boot
|u-boot二进制代码所在位置
|-
|0xF0000
|0x10000(64KBytes)
|u-boot-env
|u-boot的env数据，可保存一些u-boot使用的环境变量,可保存修改后的启动行为。 
|-
|0x100000
| -
| -
|剩余位置，可继续划分分区。
|}
==== 数据加载 ====
对于传统的u-boot启动过程而言，所有数据都需要加载到内存中才能继续操作（如启动等）。

一般使用mtd命令加载mtd设备或mtd分区数据到内存中,一般通过偏移加大小确定数据位置。

由于SPI Nor Flash一般不包含传统分区表，如需使用文件系统也是特殊的文件系统，所以一般不使用文件系统相关命令加载数据。
====移植提示====
SPI Nor Flash使用条件： 

*SOC支持从SPI Nor Flash启动。
*u-boot已经移植有对应SOC的spi驱动。

配置SPI Nor Flash的支持如下： 

*配置[[Kconfig]]。<syntaxhighlight lang="text" line="1">
启用属于MTD设备的SPI Nor Flash
    Kconfig路径: > Device Drivers > MTD Support > SPI Flash Support 
    选中CONFIG_SPI_FLASH并CONFIG_BOOTDEV_SPI_FLASH且选中需要支持的Nor Flash。

启用SPI驱动设备(只需要选中对应SOC的驱动)
    Kconfig路径:> Device Drivers > SPI Support


</syntaxhighlight>
*配置[[Devicetree|设备树]](同Linux一样)。<syntaxhighlight lang="dts" line="1">
/*以下代码主要用于启用spi0上的flash*/
&spi0 {
        flash@0 {
                compatible = "jedec,spi-nor";
                reg = <0>;
                spi-max-frequency = <40000000>;
        };
};

</syntaxhighlight>

若u-boot需要使用spl则需要在spl中启用spi nor flash支持(具体方法根据芯片及板子的不同而不同)，粗略配置如下： 

*配置[[Kconfig]]。<syntaxhighlight lang="text" line="1">
启用属于MTD设备的SPI Nor Flash的SPL支持
    Kconfig路径: > Device Drivers > MTD Support > SPI Flash Support 
    选中CONFIG_SPL_SPI_FLASH_MTD。

在SPL中选中MTD支持
    Kconfig路径: > SPL configuration options
    选中SPI FLASH相关选项。
</syntaxhighlight>
有些spi nor flash的jedec id可能不在u-boot的支持列表中，可能需要手动向drivers/mtd/spi/spi-nor-ids.c中添加需要支持的id。

如需操作mtd设备，需要在 <code>> Command line interface > Device access commands</code>使能<code>CONFIG_CMD_MTD</code>以启用mtd命令。

如需使用mtd分区，需要在<code>> Command line interface > Filesystem commands</code>使能<code>CONFIG_CMD_MTDPARTS</code> 以启用mtdparts命令。

== 启动设置 ==
注意：若未特殊说明，此说明仅适用于截至编辑时的u-boot，不包括旧版u-boot。

启动设置的Kconfig菜单在> Boot options ，实际主要通过环境变量影响启动行为(若使用外部文件作为默认环境变量可能使设置无效)。

所有的启动过程其实都是使用u-boot脚本，将对应的脚本内容写入对应的环境变量即可启动，常用的启动相关环境变量如下：
{| class="wikitable"
!环境变量
!Kconfig项
!说明
|-
|bootargs
|CONFIG_BOOTARGS 
|[[Linux]]内核命令行参数，但现在更加常用的是使用[[Devicetree|设备树dts]]传参。
|-
|bootcmd
|CONFIG_BOOTCOMMAND
|启动脚本，当使用自动启动时自动执行此环境变量中的命令。
|-
|preboot
|CONFIG_PREBOOT
|在自动启动前运行的脚本，主要推荐用途：在bootcmd中修改此值实现在下一次启动时执行不同的行为(比如重启进入其他模式)。
个人认为的用途：提前初始化一些硬件,这样bootcmd不变，只改变preboot。
|}
默认情况下，尝试启动失败（而非执行应用失败）会进入shell，这样其实可以测试一些命令及脚本（使用run命令调用）。

=== 传统启动过程 ===
传统启动过程在此wiki中指直接使用u-boot传统方式(写脚本到环境变量加载数据然后启动)启动的过程 ,通常这不是默认的，且基本上都是针对各个具体硬件定制的。

具体指将数据加载在内存中后采用以下命令启动的过程:

* bootm:启动应用。可启动各种u-boot支持的镜像，一般用于启动Linux uImage.
* bootz:启动Linux zImage。
传统启动时环境变量bootcmd是自定义的，也不用考虑内存驻留问题，当启动到内核时将控制权交给内核，因此可将几乎所有内存给内核使用，某些特殊启动模式下需要保留一部分内存。

=== 通用发行版(distro)启动过程 ===
发行版启动过程（参考见源代码doc/develop/distro.rst）主要提供一个通用的启动Linux发行版的方式,通常这是默认的值之一，这无需对u-boot进行任何定制。

实现时环境变量<code>bootcmd=run distro_bootcmd</code>。

发行版启动主要有以下方式：

* U-Boot's "syslinux" (disk)
* "pxe boot" (network)

简单来说就是分磁盘启动与网络pxe启动，网络pxe启动在嵌入式上的应用较少因此不予赘述，磁盘启动主要有以下条件：

* 磁盘采用通用分区表（如MBR、GPT等，具体可通过Kconfig配置）。
* 分区采用通用文件系统（如ext2/3/4 、FAT等，具体可通过Kconfig配置）。
* 分区上存在菜单文件 extlinux.conf（具体可为/extlinux/extlinux.conf或者/boot/extlinux/extlinux.conf等）或者u-boot脚本文件(具体可为/boot/boot.scr等,具体可通过Kconfig配置)。
* 厂商提供了必要的环境变量以提供内存布局, 具体如下： 
{| class="wikitable" 
!环境变量 
!含义 
|- 
|fdt_addr 
|设备树dtb地址（在ROM中），仅当可以直接通过地址访问的系统需要，其余系统不能使用此环境变量。 
|- 
|fdt_addr_r 
|设备树dtb内存地址。 
|- 
|fdtoverlay_addr_r 
|设备树dtb overlay内存地址。 
|- 
|fdtfile 
|设备树dtb设备树文件名，有些情况下会自动设置此值。 
|- 
|ramdisk_addr_r 
|ramdisk内存地址，推荐放在高地址。 
|- 
|kernel_addr_r 
|内核内存地址。 
|- 
|kernel_comp_addr_r 
|内核压缩文件内存地址,若使用booti命令则需要此值。 
|- 
|kernel_comp_size 
|内核压缩文件大小，若使用booti命令则需要此值。 
|- 
|scriptaddr 
|U-Boot脚本加载内存地址。若启用了u-boot脚本,则在此处执行脚本。 
|-
|pxefile_addr_r
|extlinux.conf菜单加载内存地址。
|}
实际菜单文件 extlinux.conf写法同pxe启动时菜单写法（参考见源代码doc/README.pxe），菜单示例如下：<syntaxhighlight lang="rst" line="1">
One example extlinux.conf generated by the Fedora installer is::

    # extlinux.conf generated by anaconda

    ui menu.c32

    menu autoboot Welcome to Fedora. Automatic boot in # second{,s}. Press a key for options.
    menu title Fedora Boot Options.
    menu hidden

    timeout 50
    #totaltimeout 9000

    default Fedora (3.17.0-0.rc4.git2.1.fc22.armv7hl+lpae) 22 (Rawhide)

    label Fedora (3.17.0-0.rc4.git2.1.fc22.armv7hl) 22 (Rawhide)
        kernel /boot/vmlinuz-3.17.0-0.rc4.git2.1.fc22.armv7hl
        append ro root=UUID=8eac677f-8ea8-4270-8479-d5ddbb797450 console=ttyS0,115200n8 LANG=en_US.UTF-8 drm.debug=0xf
        fdtdir /boot/dtb-3.17.0-0.rc4.git2.1.fc22.armv7hl
        initrd /boot/initramfs-3.17.0-0.rc4.git2.1.fc22.armv7hl.img

    label Fedora (3.17.0-0.rc4.git2.1.fc22.armv7hl+lpae) 22 (Rawhide)
        kernel /boot/vmlinuz-3.17.0-0.rc4.git2.1.fc22.armv7hl+lpae
        append ro root=UUID=8eac677f-8ea8-4270-8479-d5ddbb797450 console=ttyS0,115200n8 LANG=en_US.UTF-8 drm.debug=0xf
        fdtdir /boot/dtb-3.17.0-0.rc4.git2.1.fc22.armv7hl+lpae
        initrd /boot/initramfs-3.17.0-0.rc4.git2.1.fc22.armv7hl+lpae.img

    label Fedora-0-rescue-8f6ba7b039524e0eb957d2c9203f04bc (0-rescue-8f6ba7b039524e0eb957d2c9203f04bc)
        kernel /boot/vmlinuz-0-rescue-8f6ba7b039524e0eb957d2c9203f04bc
        initrd /boot/initramfs-0-rescue-8f6ba7b039524e0eb957d2c9203f04bc.img
        append ro root=UUID=8eac677f-8ea8-4270-8479-d5ddbb797450 console=ttyS0,115200n8
        fdtdir /boot/dtb-3.16.0-0.rc6.git1.1.fc22.armv7hl+lpae


One example of hand-crafted extlinux.conf::

   menu title Select kernel
   timeout 100

   label Arch with uart devicetree overlay
       kernel /arch/Image.gz
       initrd /arch/initramfs-linux.img
       fdt /dtbs/arch/board.dtb
       fdtoverlays /dtbs/arch/overlay/uart0-gpio0-1.dtbo
       append console=ttyS0,115200 console=tty1 rw root=UUID=fc0d0284-ca84-4194-bf8a-4b9da8d66908

   label Arch with uart devicetree overlay but with Boot Loader Specification keys
       kernel /arch/Image.gz
       initrd /arch/initramfs-linux.img
       devicetree /dtbs/arch/board.dtb
       devicetree-overlay /dtbs/arch/overlay/uart0-gpio0-1.dtbo
       append console=ttyS0,115200 console=tty1 rw root=UUID=fc0d0284-ca84-4194-bf8a-4b9da8d66908

Another hand-crafted network boot configuration file is::

    TIMEOUT 100

    MENU TITLE TFTP boot options

    LABEL jetson-tk1-emmc
            MENU LABEL ../zImage root on Jetson TK1 eMMC
            LINUX ../zImage
            FDTDIR ../
            APPEND console=ttyS0,115200n8 console=tty1 loglevel=8 rootwait rw earlyprintk root=PARTUUID=80a5a8e9-c744-491a-93c1-4f4194fd690b

    LABEL venice2-emmc
            MENU LABEL ../zImage root on Venice2 eMMC
            LINUX ../zImage
            FDTDIR ../
            APPEND console=ttyS0,115200n8 console=tty1 loglevel=8 rootwait rw earlyprintk root=PARTUUID=5f71e06f-be08-48ed-b1ef-ee4800cc860f

    LABEL sdcard
            MENU LABEL ../zImage, root on 2GB sdcard
            LINUX ../zImage
            FDTDIR ../
            APPEND console=ttyS0,115200n8 console=tty1 loglevel=8 rootwait rw earlyprintk root=PARTUUID=b2f82cda-2535-4779-b467-094a210fbae7

    LABEL fedora-installer-fk
            MENU LABEL Fedora installer w/ Fedora kernel
            LINUX fedora-installer/vmlinuz
            INITRD fedora-installer/initrd.img.orig
            FDTDIR fedora-installer/dtb
            APPEND loglevel=8 ip=dhcp inst.repo=http://10.0.0.2/mirrors/fedora/linux/development/rawhide/armhfp/os/ rd.shell cma=64M
</syntaxhighlight>

=== U-Boot标准启动（U-Boot Standard Boot）过程 ===
U-Boot标准启动过程（参考见源代码doc/develop/bootstd.rst）更像是PC上的启动过程，即依次尝试在各个启动设备上使用各种启动方法（包括但不限于 通用发行版(distro)启动过程，如EFI启动管理器或者VBE启动管理器 ），主要提供一个通用的启动方式,通常这是默认的值之一。

此过程需要厂商提供必要的环境变量以提供内存布局，具体如下：
{| class="wikitable" 
!环境变量 
!含义 
|- 
|fdt_addr 
|设备树dtb地址（在ROM中），仅当可以直接通过地址访问的系统需要，其余系统不能使用此环境变量。 
|- 
|fdt_addr_r 
|设备树dtb内存地址。 
|- 
|fdtoverlay_addr_r 
|设备树dtb overlay内存地址。 
|- 
|fdtfile 
|设备树dtb设备树文件名，有些情况下会自动设置此值。 
|- 
|ramdisk_addr_r 
|ramdisk内存地址，推荐放在高地址。 
|- 
|kernel_addr_r 
|内核内存地址。 
|- 
|kernel_comp_addr_r 
|内核压缩文件内存地址,若使用booti命令则需要此值。 
|- 
|kernel_comp_size 
|内核压缩文件大小，若使用booti命令则需要此值。 
|- 
|scriptaddr 
|脚本（菜单）加载内存地址。若启用了u-boot脚本,则在此处执行脚本。 
|-
|pxefile_addr_r
|PXE文件加载内存地址。
|-
|script_offset_f
|U-Boot脚本在Flash上的偏移，用于加载SPI Flash上的启动脚本。
|-
|script_size_f
|U-Boot脚本的大小，配合script_offset_f使用。
|-
|devtype
|启动设备类型。由bootmeth使用。
|-
|devnum
|启动设备编号。由bootmeth使用。
|-
|distro_bootpart
|启动分区编号。由bootmeth使用。
|-
|prefix
|脚本目录。由bootmeth使用。
|-
|mmc_bootdev
|启动设备编号（仅限全志SOC）。由bootmeth使用。
|}
U-Boot标准启动过程主要使用以下命令：

* bootdev 
* bootmeth
* bootflow
在u-boot脚本或者shell中可使用以下命令启动 U-Boot标准启动过程：<syntaxhighlight lang="shell" line="1">
#启用CONFIG_BOOTSTD_FULL时使用
bootflow scan -lb
#未启用CONFIG_BOOTSTD_FULL时使用
bootflow scan
</syntaxhighlight>将环境变量bootcmd设置为<code>bootflow scan</code>（未启用CONFIG_BOOTSTD_FULL）或者<code>bootflow scan -lb</code>（启用CONFIG_BOOTSTD_FULL）即可启用U-Boot标准启动过程。

==官方资料==
网站：https://www.denx.de/project/u-boot/

== 相关资料 ==

* syslinux:https://wiki.syslinux.org/wiki/
*extlinux：https://wiki.syslinux.org/wiki/index.php?title=EXTLINUX