Uboot顶层Makefile分析

最新推荐文章于 2024-07-13 17:06:23 发布

帕奇洛

最新推荐文章于 2024-07-13 17:06:23 发布

阅读量1k

点赞数

转自：http://blog.csdn.net/zsy2020314/article/details/9309995

#########################################################################

# (C) Copyright 2000-2012
# Wolfgang Denk, DENX Software Engineering, wd@denx.de.
#
# See file CREDITS for list of people who contributed to this
# project.
#
# This program is free software; you can redistribute itand/or
# modify it under the terms of the GNU General Public Licenseas
# published by the Free Software Foundation; either version 2of
# the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will beuseful,
# but WITHOUT ANY WARRANTY; without even the implied warrantyof
# MERCHANTABILITY or FITNESS FOR A PARTICULARPURPOSE.

Seethe
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General PublicLicense
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston,
# MA 02111-1307 USA

#########################################################################
# 从2008年10月，发行版的名称的含义发生了变化,从数字版本号变为使用时间戳作为版本号,
# 即使用发布年份和月份确定发布的版本号(VERSION和PATCHLEVEL),
# 额外的字段(SUBLEVEL和EXTRAVERSION)表示候选发布版或修复bug了的稳定版本
#
# 例子：
# U-Bootv2012.10 - 2012年10月发行版
# U-Bootv2012.10.1 -2012年10月稳定发行版1
# U-Boot v2012.10-rc1 - 2012年10月候选发行版1=

VERSION = 2012
PATCHLEVEL = 10
SUBLEVEL =
EXTRAVERSION =

#########################################################################
#如果子段SUBLEVEL不为空,则U_BOOT_VERSION=主版本号.补丁包号.子段+额外版本字段(例如:2012.10.1)
# 否则U_BOOT_VERSION=主版本号.补丁包号+额外版本字段(例如:2012.10-rc1)
ifneq "$(SUBLEVEL)" ""
U_BOOT_VERSION =$(VERSION).$(PATCHLEVEL).$(SUBLEVEL)$(EXTRAVERSION)
else
U_BOOT_VERSION = $(VERSION).$(PATCHLEVEL)$(EXTRAVERSION)
endif

#########################################################################
# 指定时间信息头文件和版本信息头文件
TIMESTAMP_FILE =$(obj)include/generated/timestamp_autogenerated.h
VERSION_FILE =$(obj)include/generated/version_autogenerated.h

# HOSTARCH这个变量的赋值,是通过执行一套shell程序来完成的,其中$(shellxxx)的语法就是在shell中执行xxx的命令.
# 这里的'|'就是linux中的管道处理符,'\'就是换行的连接符，表示下一行与本行是同行程序处理. uname-m，就是得到
# machine hardware name，中文翻译成机器硬件名。
# sed -e的意思，选项允许在同一行里执行多条命令，就是表示后面跟的是一串命令脚本，s/abc/def/的命令表达式，
# 就是表示要从标准输入中，查找到内容为abc的，然后替换成def。例如电脑使用Intel Core2系列的CPU，因此"uname–m"
# 输出"i686"。 "i686"可以匹配命令"sed -es/i.86/i386/"中的"i.86"，因此在执行Makefile时，HOSTARCH将被设置成"i386" 。
# 这样执行这一套程序下来，就知道了机器的硬件体系了。
HOSTARCH := $(shell uname -m | \
sed -es/i.86/x86/ \
-es/sun4u/sparc64/ \
-es/arm.*/arm/ \
-es/sa110/arm/ \
-es/ppc64/powerpc/ \
-es/ppc/powerpc/ \
-es/macppc/powerpc/\
-es/sh.*/sh/)

#########################################################################
# "uname –s"输出主机内核名字，本人使用Linux发行版Ubuntu11.10，因此"uname–s"结果是"Linux"。
# "tr '[:upper:]' '[:lower:]'"作用是将标准输入中的所有大写字母转换为响应的小写字母。
# 因此执行结果是将HOSTOS 设置为"linux"
HOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]' | \
sed -e's/$cygwin$.*/cygwin/')

#########################################################################
# "$$BASH"的作用实质上是生成了字符串"$BASH"（前一个$号的作用是指明第二个$是普通的字符）。
#若执行当前Makefile的shell中定义了"$BASH"环境变量，且文件"$BASH"是可执行文件，则SHELL的值为"$BASH"。
#否则，若"/bin/bash"是可执行文件，则SHELL值为"/bin/bash"。若以上两条都不成立，则将"sh"赋值给SHELL变量。
SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
else if [ -x/bin/bash ]; then echo /bin/bash; \
else echosh; fi; fi)

#########################################################################
# export相当于C语言中的extern，把变量输出到全局，这样这些变量将设置为环境变量
# 注意:export的语意就是将自定义变量转成环境变量,在系统的任何地方你都可以使用这个变量!
export HOSTARCH HOSTOS SHELL

# 定义生产厂家名
VENDOR=

#########################################################################
# 检查是否禁止在编译过程中向终端输出信息，利用findstring函数检查变量 MAKEFLAGS 是否为参数's'
# 当编译U-boot的时候，我们会输入make [选项] [目标] ...如果输入:make -s，则MAKEFLAGS =s
# XECHO = echo 编译时将输出编译信息，否则则安静编译,不用输出信息
ifeq (,$(findstring s,$(MAKEFLAGS)))
XECHO = echo
else
XECHO = :
endif

#########################################################################
#
# U-boot build supports producing a object files to the separateexternal
# directory. Two use cases are supported:
#
# 1) Add O= to the make command line
# 'make O=/tmp/build all'
#
# 2) Set environement variable BUILD_DIR to point to the desiredlocation
# 'export BUILD_DIR=/tmp/build'
# 'make'
#
# The second approach can also be used with a MAKEALL script
# 'export BUILD_DIR=/tmp/build'
# './MAKEALL'
#
# Command line 'O=' setting overrides BUILD_DIR environentvariable.
#
# When none of the above methods is used the local build isperformed and
# the object files are placed in the source directory.
#

#########################################################################
# U-boot支持定义源码及生成的目标文件存放的目录的功能。有两种方法可以实现：
# 1)指定编译参数 O=目录，例如:make O= /tmp/build all
# 2)设置环境变量BUILD_DIR，该变量指定目录并设置为设置为环境变量
# 例如:exportBUILD_DIR=/tmp/build 然后 make
# 第二种方法同样可以用在一个 MAKEALL脚本
# 例如:export BUILD_DIR=/tmp/build 然后执行之./MAKEALL
# 命令行参数的设置会覆盖到 BUILD_DIR这一环境变量
# 如果不指定任何目录，则编译生成的目标文件存放在源代码的顶层目录下
#
# 下面解释一下几行脚本，如果参数O不为空(即使用了O参数)，则利用函数origin返回的参数O的来源
# 函数$( origin, variable) 输出的结果是一个字符串，输出结果由变量variable定义的方式决定，
# 若variable在命令行中定义过，则origin函数返回值为"command line"。
# 假若在命令行中执行了“export BUILD_DIR=/tmp/build”的命令，则“$(originO)”值为“command line”，
# 而BUILD_DIR被设置为“/tmp/build”。
ifdef O
ifeq ("$(origin O)", "command line")
BUILD_DIR := $(O)
endif
endif

#########################################################################
# 如果BUILD_DIR不为空，也就是指定了创建目录，则把路径保存在saved-output中以备使用
ifneq ($(BUILD_DIR),)
saved-output := $(BUILD_DIR)

#########################################################################
# 判断BUILD_DIR变中存放的目录是否存在，如果不存在则创建目录
$(shell [ -d ${BUILD_DIR} ] || mkdir -p ${BUILD_DIR})

#########################################################################
# 接下来这一段就是执行cd命令，进入到新建的目录里，然后执行pwd命令来得到当前目录的真实位置。
#为什么需要这样做呢，因为前面的创建目录工作可能不成功，所以导致后面的cd命令也没有进去，所以需要后面的pwd命令来确认一下。
#接下来的if用了一个三段式的形式，#if(a,b,c)这样的形式，执行步骤为，先判断a的真假，如果为真，则执行b，如果为假，则执行c。
# 所以这里的意思就是判断目录建成没有建成，如果建成，则什么也不干，没建成，就使用error，输出错误信息且退出。
BUILD_DIR := $(shell cd $(BUILD_DIR) && /bin/pwd)
$(if $(BUILD_DIR),,$(error output directory "$(saved-output)" doesnot exist))
endif # ifneq ($(BUILD_DIR),)

#########################################################################
# 下面是普通的变量赋值，其它目录变量定义如下，OBJTREE和LNDIR为存放生成文件的目录，
# TOPDIR与SRCTREE为源码所在目录；CURDIR变量指示Make当前的工作目录，由于当前
# Make在U-Boot顶层目录执行Makefile，因此CURDIR此时就是U-Boot顶层目录。
# 例如U-boot源码在"/temp/bootloader/u-boot2012-10"目录中，则
# OBJTREE = SRCTREE = TOPDIR = LNDIR = /temp/bootloa
# 最后设置这些变量设置为环境变量
OBJTREE := $(if$(BUILD_DIR),$(BUILD_DIR),$(CURDIR))
SPLTREE :=$(OBJTREE)/spl
SRCTREE :=$(CURDIR)
TOPDIR :=$(SRCTREE)
LNDIR :=$(OBJTREE)
export TOPDIRSRCTREE OBJTREE SPLTREE

#########################################################################
# MKCONFIG指向源码根目录下的mkconfig脚本文件，并设置为设置为环境变量
MKCONFIG :=$(SRCTREE)/mkconfig
export MKCONFIG

#########################################################################
# 如果存放生成文件的目录和源码目录一致则REMOTE_BUILD = 1，并设置为设置为环境变量
ifneq ($(OBJTREE),$(SRCTREE))
REMOTE_BUILD := 1
export REMOTE_BUILD
endif

#########################################################################
# $(obj) and (src) are defined in config.mk but here in mainMakefile
# we also need them before config.mk is included which is the casefor
# some targets like unconfig, clean, clobber, distclean, etc.

#$(obj)和$(src)在config.mk中有定义，但是在包含config.mk之前主Makefile在执行某些目标
# 如unconfig, clean, clobber, distclean,etc等的时候同样需要$(obj)和$(src)
# 判断如果OBJTREE和SRCTREE不是同一个目录，则分别指定各自目录给obj和src，并设置为设置为环境变量
# obj = 编译文件的输出目录 src =U-boot代码的顶层目录，一般我们默认使用U-boot源码顶层目录
# 作为编译输出文件的存放目录，一般OBJTREE和SRCTREE是相同的路径，则obj和src为空
ifneq ($(OBJTREE),$(SRCTREE))
obj := $(OBJTREE)/
src := $(SRCTREE)/
else
obj :=
src :=
endif
export obj src

#########################################################################
# 把CDPATH变量设为文件私有，这佯做是为了防止冲突
unexport CDPATH

#########################################################################
# The "tools" are needed early, so put this first
# Don't include stuff already done in $(LIBS)
# The "examples" conditionally depend on U-Boot (say, whenUSE_PRIVATE_LIBGCC
# is "yes"), so compile examples after U-Boot is compiled.

#########################################################################
#　"tool"里边的工具是马上要用到的，所以把它放在首位。不要把已经做好的东西包含在$(LIBS)中，
#因为"examples"里边的例子是有条件(即,当USE_PRIVATE_LIBGCC为yes的时候)的依赖U-boot的，
# 所以U-Boot编译完成后再编译examples

SUBDIR_TOOLS = tools
SUBDIR_EXAMPLES = examples/standalone examples/api
SUBDIRS = $(SUBDIR_TOOLS)

#########################################################################
# 其中VERSION_FILE =$(obj)include/generated/version_autogenerated.h
# TIMESTAMP_FILE =$(obj)include/generated/timestamp_autogenerated.h
# 即前面定义的版本信息头文件和时间信息头文件 .PHONY修饰为为目标
.PHONY : $(SUBDIRS) $(VERSION_FILE) $(TIMESTAMP_FILE)

#########################################################################
# 检查一下include目录下是否存在config.mk文件，具体解释如下:wildcard函数是取匹配模式的文件名
# $(wildcard$(obj)include/config.mk)就会返回符合$(obj)include/config.mk的文件名
# 如果include下存在config.mk文件，则$(wildcard$(obj)include/config.mk)就会
# 返回$(obj)include/config.mk，如果不存在config.mk文件，则返回值为空，如此便完成了检查
# include目录下是否存在config.mk文件。
# 为什么要检查config.mk存在与否呢？原因是:我们在编译U-boot前必须配置目标板的信息，也就是要执行
# makexxx_config，xxx为目标板的名称，执行了这一步，会在$(obj)include/中生成一个config.mk
# 文件，里边一般记录有5个变量信息，这是U-boot必须获得的信息，没有它们U-boot就不能编译，会跳转到该
# ifeq的else分支执行，也就是提示错，else分支在文件尾部。
# 信息:System not configured - see README
# make ***[all] error 1
# 所以如果没有make xxx_config，直接make是编译不过去的，通过这样的判断U-boot就知道你是否已经做过
# make xxx_config这一步了。(PS:一句ifeq可谓意味深长，巧妙至极!)
#
ifeq ($(obj)include/config.mk,$(wildcard$(obj)include/config.mk))

#########################################################################
# Include autoconf.mk before config.mk so that the config optionsare available
# to all top level build files. We need the dummyall: target to prevent the
# dependency target in autoconf.mk.dep from being thedefault.

#########################################################################
# 在加载config.mk文件之前先加载autoconf.mk，这样就可以使配置选项对所有顶层编译文件有效。
# 我们要需要定义一个all:伪目标来防止autoconf.mk.dep中的依赖目标成为默认目标
#在include目录下：autoconf.mk文件中是一些和目标板相关的配置，autoconf.mk.dep则为一些列的
# .h头文件的包含
all:
sinclude $(obj)include/autoconf.mk.dep
sinclude $(obj)include/autoconf.mk

#########################################################################
#如果在config.mk中定义了CONFIG_SANDBOX选项，这把SUBDIR_EXAMPLES追加到SUBDIRS中
# 其中SUBDIR_EXAMPLES = examples/standalone examples/api
ifndef CONFIG_SANDBOX
SUBDIRS += $(SUBDIR_EXAMPLES)
endif

#########################################################################
# 加载$(obj)include/config.mk，导出ARCH CPU BOARD VENDOR SOC5个变量
# ARCH = 目标板的CPU架构 CPU =具体使用的CPU型号 BOARD =目标板名称 SOC = 芯片名称
# 例如:对于一个三星S5pv210的板子:ARCH=arm CPU=CortexA8BOARD=HY210 SOC=S5pv210
include $(obj)include/config.mk
export ARCHCPU BOARD VENDOR SOC

#########################################################################
# 判断如果宿主机的架构和目标板的架构是同一种架构，则CROSS_COMPILE为空，也即采用宿主机默认的交叉编译链
# 通常我们将目标板使用的交叉工具链安装好以后，在宿主机中设置环境变量，指定开发板使用的交叉编译链
# 如果不采用设置环境变量的方法，则应该在使用make的时候指定工具链，例如:makeCROSS_COMPILE=arm-linux-
ifeq ($(HOSTARCH),$(ARCH))
CROSS_COMPILE ?=
endif

#########################################################################
# 加载config.mk
include $(TOPDIR)/config.mk

#########################################################################
# If board code explicitly specified LDSCRIPT orCONFIG_SYS_LDSCRIPT, use
# that (or fail if absent). Otherwise, search fora linker script in a
# standard location.

#########################################################################
# 如果板子代码明确指定了LDSCRIPT或者CONFIG_SYS_LDSCRIPT，则就使用(或则失败，如果不存在的话)
# 否则，在标准的位置中搜索链接脚本文件
LDSCRIPT_MAKEFILE_DIR = $(dir $(LDSCRIPT))

#########################################################################
# 这里LDSCRIPT和CONFIG_SYS_LDSCRIPT均没有定义，所以下面几句脚本均没执行。
# 注意：如果CONFIG_SYS_LDSCRIPT有定义也是在include/autoconf.mk中定义
ifndef LDSCRIPT
#LDSCRIPT :=$(TOPDIR)/board/$(BOARDDIR)/u-boot.lds.debug
ifdefCONFIG_SYS_LDSCRIPT
# need tostrip off double quotes
LDSCRIPT :=$(subst ",,$(CONFIG_SYS_LDSCRIPT))
endif
endif

#########################################################################
# 如果没有指定链接脚本，接下来会从下面几个地方搜索:
ifndef LDSCRIPT
#########################################################################
#如果定义了CONFIG_NAND_U_BOOT,则在$(TOPDIR)/board/$(BOARDDIR)目录中搜索
ifeq($(CONFIG_NAND_U_BOOT),y)
LDSCRIPT :=$(TOPDIR)/board/$(BOARDDIR)/u-boot-nand.lds
# ifeq($(wildcard$(LDSCRIPT)),)这句的意思是如果$(TOPDIR)/board/$(BOARDDIR)下
#不存在u-boot-nand.lds文件，则转到$(TOPDIR)/$(CPUDIR)目录中去搜索u-boot-nand.lds文件
ifeq($(wildcard $(LDSCRIPT)),)
LDSCRIPT :=$(TOPDIR)/$(CPUDIR)/u-boot-nand.lds
endif
endif
#########################################################################
#如果上面定义了CONFIG_NAND_U_BOOT并且搜索到了u-boot-nand.lds的话，则后面几个
# ifeq($(wildcard $(LDSCRIPT)),)均不执行，如果上面进行过了搜索而仍没有找到链接脚本的话
#则继续在$(TOPDIR)/board/$(BOARDDIR)目录中搜索u-boot.lds文件(根据运行条件不同名称稍有不同哦^_^!)
ifeq($(wildcard $(LDSCRIPT)),)
LDSCRIPT :=$(TOPDIR)/board/$(BOARDDIR)/u-boot.lds
endif
#########################################################################
#如果$(TOPDIR)/board/$(BOARDDIR)目录中没有u-boot.lds文件则转到$(TOPDIR)/$(CPUDIR)目录中去搜索
ifeq($(wildcard $(LDSCRIPT)),)
LDSCRIPT :=$(TOPDIR)/$(CPUDIR)/u-boot.lds
endif
#########################################################################
#如果$(TOPDIR)/$(CPUDIR)目录中没有u-boot.lds文件则转到$(TOPDIR)/arch/$(ARCH)目录中去搜索
ifeq($(wildcard $(LDSCRIPT)),)
LDSCRIPT :=$(TOPDIR)/arch/$(ARCH)/cpu/u-boot.lds
# We don'texpect a Makefile here
LDSCRIPT_MAKEFILE_DIR =
endif
#########################################################################
#经过上面的搜索仍没有找到链接脚本文件的话，Makefile就要歇菜不干活了，直接输出错误信息!
ifeq($(wildcard $(LDSCRIPT)),)
$(error could not find linker script)
endif
endif

#########################################################################
# 好戏好上演了，从这里开始，定义编译的目标对象，start.o是必须放在第一位的，顺序很重要
# 没事别乱改这些目标对象和库的顺序!
# 其中CPUDIR=arch/$(ARCH)/cpu/$(CPU)，定义在源码顶层目录的config.mk中

OBJS = $(CPUDIR)/start.o

#########################################################################
# 我们用的是arm的架构，下面的x86,ppc4xx,mpc85xx的文件均不会被加载进来，略去不管..
ifeq ($(CPU),x86)
OBJS += $(CPUDIR)/start16.o
OBJS += $(CPUDIR)/resetvec.o
endif
ifeq ($(CPU),ppc4xx)
OBJS += $(CPUDIR)/resetvec.o
endif
ifeq ($(CPU),mpc85xx)
OBJS += $(CPUDIR)/resetvec.o
endif

# 利用加前缀函数给OBJS中的对象都加上$(obj)，即OBJS = $(obj)$(OBJS)
OBJS := $(addprefix $(obj),$(OBJS))

#如果board/$(VENDOR)/common目录中有Makefile文件，则HAVE_VENDOR_COMMON_LIB为y否则为n
# 这是为了后面是否能追加入库所做的标志
# 例如:LIBS-y += lib/libgeneric.o，这个时候libgeneric.o才会被追加到LIBS中!
# 如果 LIBS-n +=lib/libgeneric.o，这个时候libgeneric.o不会被追加到LIBS中!
HAVE_VENDOR_COMMON_LIB = $(if $(wildcardboard/$(VENDOR)/common/Makefile),y,n)

LIBS-y += lib/libgeneric.o
LIBS-y += lib/lzma/liblzma.o
LIBS-y += lib/lzo/liblzo.o
LIBS-y += lib/zlib/libz.o
LIBS-$(CONFIG_TIZEN) += lib/tizen/libtizen.o
LIBS-$(HAVE_VENDOR_COMMON_LIB) +=board/$(VENDOR)/common/lib$(VENDOR).o
LIBS-y += $(CPUDIR)/lib$(CPU).o
ifdef SOC
LIBS-y += $(CPUDIR)/$(SOC)/lib$(SOC).o
endif

###################################
# 如果不是ixp架构的cpu则不会把该对象追加进来
ifeq ($(CPU),ixp)
LIBS-y += drivers/net/npe/libnpe.o
endif

LIBS-$(CONFIG_OF_EMBED) += dts/libdts.o
LIBS-y += arch/$(ARCH)/lib/lib$(ARCH).o
LIBS-y += fs/cramfs/libcramfs.o \
fs/ext4/libext4fs.o \
fs/fat/libfat.o \
fs/fdos/libfdos.o \
fs/jffs2/libjffs2.o \
fs/reiserfs/libreiserfs.o \
fs/ubifs/libubifs.o \
fs/yaffs2/libyaffs2.o \
fs/zfs/libzfs.o
LIBS-y += net/libnet.o
LIBS-y += disk/libdisk.o
LIBS-y += drivers/bios_emulator/libatibiosemu.o
LIBS-y += drivers/block/libblock.o
LIBS-$(CONFIG_BOOTCOUNT_LIMIT) +=drivers/bootcount/libbootcount.o
LIBS-y += drivers/dma/libdma.o
LIBS-y += drivers/fpga/libfpga.o
LIBS-y += drivers/gpio/libgpio.o
LIBS-y += drivers/hwmon/libhwmon.o
LIBS-y += drivers/i2c/libi2c.o
LIBS-y += drivers/input/libinput.o
LIBS-y += drivers/misc/libmisc.o
LIBS-y += drivers/mmc/libmmc.o
LIBS-y += drivers/mtd/libmtd.o
LIBS-y += drivers/mtd/nand/libnand.o
LIBS-y += drivers/mtd/onenand/libonenand.o
LIBS-y += drivers/mtd/ubi/libubi.o
LIBS-y += drivers/mtd/spi/libspi_flash.o
LIBS-y += drivers/net/libnet.o
LIBS-y += drivers/net/phy/libphy.o
LIBS-y += drivers/pci/libpci.o
LIBS-y += drivers/pcmcia/libpcmcia.o
LIBS-y += drivers/power/libpower.o
LIBS-y += drivers/spi/libspi.o
LIBS-y += drivers/dfu/libdfu.o

#########################################################
# 如果不是mpc83xx,mpc85xx,mpc86xx架构的cpu则不会把下列对象追加进来
ifeq ($(CPU),mpc83xx)
LIBS-y += drivers/qe/libqe.o
LIBS-y += arch/powerpc/cpu/mpc8xxx/ddr/libddr.o
LIBS-y += arch/powerpc/cpu/mpc8xxx/lib8xxx.o
endif
ifeq ($(CPU),mpc85xx)
LIBS-y += drivers/qe/libqe.o
LIBS-y += drivers/net/fm/libfm.o
LIBS-y += arch/powerpc/cpu/mpc8xxx/ddr/libddr.o
LIBS-y += arch/powerpc/cpu/mpc8xxx/lib8xxx.o
endif
ifeq ($(CPU),mpc86xx)
LIBS-y += arch/powerpc/cpu/mpc8xxx/ddr/libddr.o
LIBS-y += arch/powerpc/cpu/mpc8xxx/lib8xxx.o
endif

LIBS-y += drivers/rtc/librtc.o
LIBS-y += drivers/serial/libserial.o

LIBS-$(CONFIG_GENERIC_LPC_TPM) += drivers/tpm/libtpm.o

LIBS-y += drivers/twserial/libtws.o
LIBS-y += drivers/usb/eth/libusb_eth.o
LIBS-y += drivers/usb/gadget/libusb_gadget.o
LIBS-y += drivers/usb/host/libusb_host.o
LIBS-y += drivers/usb/musb/libusb_musb.o
LIBS-y += drivers/usb/phy/libusb_phy.o
LIBS-y += drivers/usb/ulpi/libusb_ulpi.o
LIBS-y += drivers/video/libvideo.o
LIBS-y += drivers/watchdog/libwatchdog.o
LIBS-y += common/libcommon.o
LIBS-y += lib/libfdt/libfdt.o
LIBS-y += api/libapi.o
LIBS-y += post/libpost.o
LIBS-y += test/libtest.o

###############################################################################
# 下面这些均是跟硬件架构相关的对象
ifneq($(CONFIG_AM33XX)$(CONFIG_OMAP34XX)$(CONFIG_OMAP44XX)$(CONFIG_OMAP54XX),)
LIBS-y += $(CPUDIR)/omap-common/libomap-common.o
endif

ifneq (,$(filter $(SOC), mx25 mx27 mx5 mx6 mx31 mx35))
LIBS-y += arch/$(ARCH)/imx-common/libimx-common.o
endif

###############################################
# s5pc1xx系列芯片需要libs5p-common.o
ifeq ($(SOC),s5pc1xx)
LIBS-y += $(CPUDIR)/s5p-common/libs5p-common.o
endif
ifeq ($(SOC),exynos)
LIBS-y += $(CPUDIR)/s5p-common/libs5p-common.o
endif
ifeq ($(SOC),tegra20)
LIBS-y += arch/$(ARCH)/cpu/$(SOC)-common/lib$(SOC)-common.o
endif

##################################################
# 给LIBS中的对象按名称的首字母进行排序(a-z)按后加上前缀$(obj)
LIBS := $(addprefix $(obj),$(sort $(LIBS-y)))
# 声明为伪目标
.PHONY : $(LIBS)

LIBBOARD = board/$(BOARDDIR)/lib$(BOARD).o
LIBBOARD := $(addprefix $(obj),$(LIBBOARD))

# 添加 GCC 库
ifdef USE_PRIVATE_LIBGCC
ifeq ("$(USE_PRIVATE_LIBGCC)", "yes")
PLATFORM_LIBGCC = $(OBJTREE)/arch/$(ARCH)/lib/libgcc.o
else
PLATFORM_LIBGCC = -L $(USE_PRIVATE_LIBGCC) -lgcc
endif
else
PLATFORM_LIBGCC := -L $(shell dirname `$(CC) $(CFLAGS)-print-libgcc-file-name`) -lgcc
endif
PLATFORM_LIBS += $(PLATFORM_LIBGCC)
export PLATFORM_LIBS

#########################################################################
# Special flags for CPP when processing the linker script.
# Pass the version down so we can handle backwardscompatibility
# on the fly.

#########################################################################
# 执行链接脚本的时候，设置一些用于CPP特殊标志，这样才能让发布的版本做到向下兼容
# 如果我们的目标板是smdkc100，则
# LDPPFLAGS = -include /源码顶层目录/include/u-boot/u-boot.lds.h
# -DCPUDIR = arch/arm/cpu/armv7
# LD = arm-linux-ld
LDPPFLAGS += \
-include$(TOPDIR)/include/u-boot/u-boot.lds.h \
-DCPUDIR=$(CPUDIR) \
$(shell$(LD) --version | \
sed -ne 's/GNU ld version$[0-9][0-9]*$\.$[0-9][0-9]*$.*/-DLD_MAJOR=\1-DLD_MINOR=\2/p')
#########################################################################
# __OBJS = arch/arm/cpu/armv7/start.o(这是smdkc100的信息,如果换了别的目标板该值会有变动)
# __LIBS = 按名称首字母排序(a-z)的各种库文件和目标对象文件
__OBJS := $(subst $(obj),,$(OBJS))
__LIBS := $(subst $(obj),,$(LIBS)) $(subst$(obj),,$(LIBBOARD))

#########################################################################
#########################################################################
# 如果没有定义则CONFIG_BOARD_SIZE_LIMIT为空(一般为空)
ifneq ($(CONFIG_BOARD_SIZE_LIMIT),)
BOARD_SIZE_CHECK = \
@actual=`wc-c $@ | awk '{print $$1}'`; \
limit=$(CONFIG_BOARD_SIZE_LIMIT); \
if test$$actual -gt $$limit; then \
echo "$@exceeds file size limit:"; \
echo" limit: $$limit bytes";\
echo" actual: $$actual bytes"; \
echo" excess: $$((actual - limit)) bytes"; \
exit 1;\
fi
else
BOARD_SIZE_CHECK =
endif

# Always append ALL so that arch config.mk's can add customones
# 始终追加到c中，以便架构配置文件config.mk可以添加自定义项
c += $(obj)u-boot.srec $(obj)u-boot.bin $(obj)System.map

ALL-$(CONFIG_NAND_U_BOOT) += $(obj)u-boot-nand.bin
ALL-$(CONFIG_ONENAND_U_BOOT) += $(obj)u-boot-onenand.bin
ALL-$(CONFIG_SPL) += $(obj)spl/u-boot-spl.bin
ALL-$(CONFIG_OF_SEPARATE) += $(obj)u-boot.dtb$(obj)u-boot-dtb.bin

# 下面tegra20与arm架构无关，不执行
# enable combined SPL/u-boot/dtb rules for tegra
ifeq ($(SOC),tegra20)
ifeq ($(CONFIG_OF_SEPARATE),y)
ALL-y += $(obj)u-boot-dtb-tegra.bin
else
ALL-y += $(obj)u-boot-nodtb-tegra.bin
endif
endif

# 定义all为目标，生成各种镜像。
# 其中u-boot是ELF文件，u-boot.srec是Motorola S-Recordformat文件，System.map
# 是U-Boot的符号表，u-boot.bin是最终烧写到开发板的二进制可执行的文件。
all: $(ALL-y)$(SUBDIR_EXAMPLES)

#
$(obj)u-boot.dtb: $(obj)u-boot
$(MAKE) -Cdts binary
mv$(obj)dts/dt.dtb $@

$(obj)u-boot-dtb.bin: $(obj)u-boot.bin $(obj)u-boot.dtb
cat $^>$@

# 生成16进制的镜像
$(obj)u-boot.hex: $(obj)u-boot
$(OBJCOPY)${OBJCFLAGS} -O ihex $< $@

$(obj)u-boot.srec: $(obj)u-boot
$(OBJCOPY)-O srec $< $@

# arm-linux-objcopy --gap-fill=0xff -O binary u-bootu-boot.bin
# 编译命令中的“-O binary”选项指定了输出的文件为二进制文件。而“--gap-fill=0xff”
# 选项指定使用“0xff”填充段与段间的空闲区域。这条编译命令实现了ELF格式的U-Boot文件到BIN格式的转换。
$(obj)u-boot.bin: $(obj)u-boot
$(OBJCOPY)${OBJCFLAGS} -O binary $< $@
$(BOARD_SIZE_CHECK)

$(obj)u-boot.ldr: $(obj)u-boot
$(CREATE_LDR_ENV)
$(LDR) -T$(CONFIG_BFIN_CPU) -c $@ $< $(LDR_FLAGS)
$(BOARD_SIZE_CHECK)

$(obj)u-boot.ldr.hex: $(obj)u-boot.ldr
$(OBJCOPY)${OBJCFLAGS} -O ihex $< $@ -I binary

$(obj)u-boot.ldr.srec: $(obj)u-boot.ldr
$(OBJCOPY)${OBJCFLAGS} -O srec $< $@ -I binary

$(obj)u-boot.img: $(obj)u-boot.bin
$(obj)tools/mkimage -A $(ARCH) -T firmware -C none \
-O u-boot -a$(CONFIG_SYS_TEXT_BASE) -e 0 \
-n $(shellsed -n -e 's/.*U_BOOT_VERSION//p' $(VERSION_FILE) | \
sed -e's/"[ ]*$$/ for $(BOARD) board"/') \
-d $<$@

$(obj)u-boot.imx: $(obj)u-boot.bin
$(obj)tools/mkimage -n $(CONFIG_IMX_CONFIG) -Timximage \
-e$(CONFIG_SYS_TEXT_BASE) -d $< $@

$(obj)u-boot.kwb: $(obj)u-boot.bin
$(obj)tools/mkimage -n $(CONFIG_SYS_KWD_CONFIG) -T kwbimage \
-a$(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) -d $<$@

$(obj)u-boot.pbl: $(obj)u-boot.bin
$(obj)tools/mkimage -n $(CONFIG_PBLRCW_CONFIG) \
-R$(CONFIG_PBLPBI_CONFIG) -T pblimage \
-d $<$@

$(obj)u-boot.sha1: $(obj)u-boot.bin
$(obj)tools/ubsha1 $(obj)u-boot.bin

$(obj)u-boot.dis: $(obj)u-boot
$(OBJDUMP)-d $< > $@

$(obj)u-boot.ubl: $(obj)spl/u-boot-spl.bin $(obj)u-boot.bin
$(OBJCOPY)${OBJCFLAGS} --pad-to=$(PAD_TO) -O binary $(obj)spl/u-boot-spl$(obj)spl/u-boot-spl-pad.bin
cat$(obj)spl/u-boot-spl-pad.bin $(obj)u-boot.bin >$(obj)u-boot-ubl.bin
$(obj)tools/mkimage -n $(UBL_CONFIG) -T ublimage \
-e$(CONFIG_SYS_TEXT_BASE) -d $(obj)u-boot-ubl.bin$(obj)u-boot.ubl
rm$(obj)u-boot-ubl.bin
rm$(obj)spl/u-boot-spl-pad.bin

$(obj)u-boot.ais: $(obj)spl/u-boot-spl.bin $(obj)u-boot.img
$(obj)tools/mkimage -s -n $(if$(CONFIG_AIS_CONFIG_FILE),$(CONFIG_AIS_CONFIG_FILE),"/dev/null")\
-T aisimage\
-e$(CONFIG_SPL_TEXT_BASE) \
-d$(obj)spl/u-boot-spl.bin \
$(obj)spl/u-boot-spl.ais
$(OBJCOPY)${OBJCFLAGS} -I binary \
--pad-to=$(CONFIG_SPL_MAX_SIZE) -O binary \
$(obj)spl/u-boot-spl.ais $(obj)spl/u-boot-spl-pad.ais
cat$(obj)spl/u-boot-spl-pad.ais $(obj)u-boot.img > \
$(obj)u-boot.ais

# Specify the target for use in elftosb call
ELFTOSB_TARGET-$(CONFIG_MX28) = imx28

$(obj)u-boot.sb: $(obj)u-boot.bin $(obj)spl/u-boot-spl.bin
elftosb -zdf$(ELFTOSB_TARGET-y) -c$(TOPDIR)/$(CPUDIR)/$(SOC)/u-boot-$(ELFTOSB_TARGET-y).bd \
-o$(obj)u-boot.sb

# On x600 (SPEAr600) U-Boot is appended to U-Boot SPL.
# Both images are created using mkimage (crc etc), so that theROM
# bootloader can check its integrity. Padding needs to be done tothe
# SPL image (with mkimage header) and not the binary. Otherwise theresulting image
# which is loaded/copied by the ROM bootloader to SRAM doesn'tfit.
# The resulting image containing both U-Boot images is calledu-boot.spr
$(obj)u-boot.spr: $(obj)u-boot.img $(obj)spl/u-boot-spl.bin
$(obj)tools/mkimage -A $(ARCH) -T firmware -C none \
-a$(CONFIG_SPL_TEXT_BASE) -e $(CONFIG_SPL_TEXT_BASE) -n XLOADER\
-d$(obj)spl/u-boot-spl.bin $(obj)spl/u-boot-spl.img
tr "\000""\377" < /dev/zero | dd ibs=1 count=$(CONFIG_SPL_PAD_TO) \
of=$(obj)spl/u-boot-spl-pad.img 2>/dev/null
ddif=$(obj)spl/u-boot-spl.img of=$(obj)spl/u-boot-spl-pad.img \
conv=notrunc2>/dev/null
cat$(obj)spl/u-boot-spl-pad.img $(obj)u-boot.img > $@

ifeq ($(SOC),tegra20)
ifeq ($(CONFIG_OF_SEPARATE),y)
$(obj)u-boot-dtb-tegra.bin: $(obj)spl/u-boot-spl.bin $(obj)u-boot.bin $(obj)u-boot.dtb
$(OBJCOPY)${OBJCFLAGS} --pad-to=$(CONFIG_SYS_TEXT_BASE) -O binary$(obj)spl/u-boot-spl $(obj)spl/u-boot-spl-pad.bin
cat$(obj)spl/u-boot-spl-pad.bin $(obj)u-boot.bin $(obj)u-boot.dtb >$@
rm$(obj)spl/u-boot-spl-pad.bin
else
$(obj)u-boot-nodtb-tegra.bin: $(obj)spl/u-boot-spl.bin $(obj)u-boot.bin
$(OBJCOPY)${OBJCFLAGS} --pad-to=$(CONFIG_SYS_TEXT_BASE) -O binary$(obj)spl/u-boot-spl $(obj)spl/u-boot-spl-pad.bin
cat$(obj)spl/u-boot-spl-pad.bin $(obj)u-boot.bin > $@
rm$(obj)spl/u-boot-spl-pad.bin
endif
endif

ifeq ($(CONFIG_SANDBOX),y)
GEN_UBOOT = \
cd $(LNDIR)&& $(CC) $(SYMS) -T $(obj)u-boot.lds \
-Wl,--start-group $(__LIBS) -Wl,--end-group \
$(PLATFORM_LIBS) -Wl,-Map -Wl,u-boot.map -o u-boot
else
# 编译命令GEN_UBOOT，使用以下命令使用$(LDFLAGS)作为连接脚本，最终生成“u-boot”文件。
GEN_UBOOT = \
UNDEF_SYM=`$(OBJDUMP) -x $(LIBBOARD) $(LIBS) | \
sed -n -e's/.*$$(SYM_PREFIX)__u_boot_cmd_.*$/-u\1/p'|sort|uniq`;\
cd $(LNDIR)&& $(LD) $(LDFLAGS) $(LDFLAGS_$(@F)) $$UNDEF_SYM $(__OBJS)\
--start-group $(__LIBS) --end-group $(PLATFORM_LIBS) \
-Mapu-boot.map -o u-boot
endif

$(obj)u-boot: depend \
$(SUBDIR_TOOLS) $(OBJS) $(LIBBOARD) $(LIBS) $(LDSCRIPT)$(obj)u-boot.lds
$(GEN_UBOOT)
ifeq ($(CONFIG_KALLSYMS),y)
smap=`$(callSYSTEM_MAP,$(obj)u-boot) | \
awk '$$2 ~/[tTwW]/ {printf $$1 $$3 "\\\\000"}'` ; \
$(CC)$(CFLAGS) -DSYSTEM_MAP="\"$${smap}\"" \
-ccommon/system_map.c -o $(obj)common/system_map.o
$(GEN_UBOOT)$(obj)common/system_map.o
endif

$(OBJS): depend
$(MAKE) -C$(CPUDIR) $(if $(REMOTE_BUILD),$@,$(notdir $@))

$(LIBS): depend $(SUBDIR_TOOLS)
$(MAKE) -C$(dir $(subst $(obj),,$@))

$(LIBBOARD): depend $(LIBS)
$(MAKE) -C$(dir $(subst $(obj),,$@))

$(SUBDIRS): depend
$(MAKE) -C$@ all

$(SUBDIR_EXAMPLES): $(obj)u-boot
#########################################################################
# “$(MAKE) -C $(dir $@) $(notdir $@)”命令经过变量替换后就是
# “make -C arch/arm/cpu/armv7/u-boot.lds”。也就是转到
# arch/arm/cpu/armv7/目录下，执行“make u-boot.lds”命令。
$(LDSCRIPT): depend
$(MAKE) -C$(dir $@) $(notdir $@)
# 以下执行结果实质上是将arch/arm/cpu/armv7/u-boot.lds经编译器
# 简单预处理后输出到U-Boot顶层目录下的u-boot.lds文件。
$(obj)u-boot.lds: $(LDSCRIPT)
$(CPP)$(CPPFLAGS) $(LDPPFLAGS) -ansi -D__ASSEMBLY__ -P - <$^>$@

nand_spl: $(TIMESTAMP_FILE) $(VERSION_FILE) depend
$(MAKE) -Cnand_spl/board/$(BOARDDIR) all

# 生成用于nand启动的二进制镜像
$(obj)u-boot-nand.bin: nand_spl $(obj)u-boot.bin
cat$(obj)nand_spl/u-boot-spl-16k.bin $(obj)u-boot.bin >$(obj)u-boot-nand.bin

$(obj)spl/u-boot-spl.bin: $(SUBDIR_TOOLS) depend
$(MAKE) -Cspl all

updater:
$(MAKE) -Ctools/updater all
#########################################################################
# Explicitly make _depend in subdirs containing multiple targets toprevent
# parallel sub-makes creating .depend files simultaneously.
#
# 定义依赖目标depend,dep，加载各种文件并进入各种中目录执行对应的makfile
# 对于$(SUBDIRS) $(CPUDIR)$(LDSCRIPT_MAKEFILE_DIR)中的每个元素都进入该目录执行
# “make _depend”，生成各个子目录的.depend文件，.depend列出每个目标文件的依赖文件。
depend dep: $(TIMESTAMP_FILE) $(VERSION_FILE) \
$(obj)include/autoconf.mk \
$(obj)include/generated/generic-asm-offsets.h \
$(obj)include/generated/asm-offsets.h
for dir in$(SUBDIRS) $(CPUDIR) $(LDSCRIPT_MAKEFILE_DIR) ; do \
$(MAKE) -C$$dir _depend ; done

TAG_SUBDIRS = $(SUBDIRS)
TAG_SUBDIRS += $(dir $(__LIBS))
TAG_SUBDIRS += include

FIND := find
FINDFLAGS := -L

checkstack:
$(CROSS_COMPILE)objdump -d $(obj)u-boot \
`$(FIND)$(obj) -name u-boot-spl -print` | \
perl$(src)tools/checkstack.pl $(ARCH)

tags ctags:
ctags -w -o$(obj)ctags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
-name'*.[chS]' -print`

etags:
etags -a -o$(obj)etags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
-name'*.[chS]' -print`
cscope:
$(FIND)$(FINDFLAGS) $(TAG_SUBDIRS) -name '*.[chS]' -print > \
cscope.files
cscope -b -q-k
#########################################################################
# System.map是U-Boot的符号表，它包含了U-Boot的全局变量和函数的地址信息
# 也就是将arm-linux-nm命令查看u-boot的输出信息经过过滤和排序后输出到System.map
# System.map表示的是地址标号到该标号表示的地址的一个映射关系。System.map每一行的
# 格式都是“addr type name”，addr是标号对应的地址值，name是标号名，type表示标号的类型。
# U-Boot的编译和运行并不一定要生成System.map，这个文件主要是提供给用户或外部程序调试时使用的。
SYSTEM_MAP = \
$(NM) $1 |\
grep -v'$compiled$\|$\.o$$$\|$ [aUw]$\|$\.\.ng$$$\|$LASH[RL]DI$' | \
LC_ALL=Csort
$(obj)System.map: $(obj)u-boot
@$(callSYSTEM_MAP,$<) > $(obj)System.map
#########################################################################
# 检查gcc版本如果低于 0404则告知该GCC版本无法进行生成工作并说明单板配置成THUMB模式
checkthumb:
@if test$(call cc-version) -lt 0404; then \
echo -n '***Your GCC does not produce working '; \
echo'binaries in THUMB mode.'; \
echo '***Your board is configured for THUMB mode.'; \
false;\
fi
#########################################################################
# Auto-generate the autoconf.mk file (which is included by allmakefiles)
# This target actually generates 2 files; autoconf.mk andautoconf.mk.dep.
# the dep file is only include in this top level makefile todetermine when
# to regenerate the autoconf.mk file.
# 自动生成autoconf.mk文件(所有makefile文件都应该包含该文件)，实际上这个目标生成两个文件
#autoconf.mk和autoconf.mk.dep。只有顶层的makefile直接包含autoconf.mk.dep文件以
# 生成autoconf.mk文件。
$(obj)include/autoconf.mk.dep: $(obj)include/config.hinclude/common.h
@$(XECHO)Generating $@ ; \
set -e ;\
: Generatethe dependancies ; \
$(CC) -x c-DDO_DEPS_ONLY -M $(CFLAGS) $(CPPFLAGS) \
-MQ$(obj)include/autoconf.mk include/common.h > $@

$(obj)include/autoconf.mk: $(obj)include/config.h
@$(XECHO)Generating $@ ; \
set -e ;\
: Extractthe config macros ; \
$(CPP)$(CFLAGS) -DDO_DEPS_ONLY -dM include/common.h | \
sed -n -ftools/scripts/define2mk.sed > $@.tmp && \
mv $@.tmp$@

$(obj)include/generated/generic-asm-offsets.h: $(obj)include/autoconf.mk.dep \
$(obj)lib/asm-offsets.s
@$(XECHO)Generating $@
tools/scripts/make-asm-offsets $(obj)lib/asm-offsets.s $@

$(obj)lib/asm-offsets.s: $(obj)include/autoconf.mk.dep \
$(src)lib/asm-offsets.c
@mkdir -p$(obj)lib
$(CC)-DDO_DEPS_ONLY \
$(CFLAGS)$(CFLAGS_$(BCURDIR)/$(@F)) $(CFLAGS_$(BCURDIR)) \
-o $@$(src)lib/asm-offsets.c -c -S

$(obj)include/generated/asm-offsets.h: $(obj)include/autoconf.mk.dep \
$(obj)$(CPUDIR)/$(SOC)/asm-offsets.s
@$(XECHO)Generating $@
tools/scripts/make-asm-offsets $(obj)$(CPUDIR)/$(SOC)/asm-offsets.s$@

$(obj)$(CPUDIR)/$(SOC)/asm-offsets.s: $(obj)include/autoconf.mk.dep
@mkdir -p$(obj)$(CPUDIR)/$(SOC)
if [ -f$(src)$(CPUDIR)/$(SOC)/asm-offsets.c ];then \
$(CC)-DDO_DEPS_ONLY \
$(CFLAGS)$(CFLAGS_$(BCURDIR)/$(@F)) $(CFLAGS_$(BCURDIR)) \
-o $@$(src)$(CPUDIR)/$(SOC)/asm-offsets.c -c -S; \
else \
touch $@;\
fi

#########################################################################
# ifeq ($(obj)include/config.mk,$(wildcard$(obj)include/config.mk))
# 下面的else分支和文件前面的上句对应，也就是include目录下不存在config.mk文件的时候
# 提示错误信息:
# System not configured - see README
# make ***[all] error 1

else #!config.mk
all $(obj)u-boot.hex $(obj)u-boot.srec $(obj)u-boot.bin \
$(obj)u-boot.img $(obj)u-boot.dis $(obj)u-boot \
$(filter-out tools,$(SUBDIRS)) \
updater depend dep tags ctags etags cscope $(obj)System.map:
@echo"System not configured - see README" >&2
@ exit1

tools: $(VERSION_FILE) $(TIMESTAMP_FILE)
$(MAKE) -C$@ all
endif #config.mk

#########################################################################
# TIMESTAMP_FILE =$(obj)include/generated/timestamp_autogenerated.h
# VERSION_FILE =$(obj)include/generated/version_autogenerated.h
# $(VERSION_FILE):生成版本信息文件version_autogenerated.h
# $(TIMESTAMP_FILE):生成时间戳信息文件timestamp_autogenerated.h
$(VERSION_FILE):
@mkdir -p$(dir $(VERSION_FILE))
@(localvers='$(shell $(TOPDIR)/tools/setlocalversion $(TOPDIR))' ;\
printf '#define PLAIN_VERSION"%s%s"\n' \
"$(U_BOOT_VERSION)" "$${localvers}" ; \
printf '#define U_BOOT_VERSION"U-Boot %s%s"\n' \
"$(U_BOOT_VERSION)" "$${localvers}" ; \
) >$@.tmp
@( printf'#define CC_VERSION_STRING "%s"\n' \
'$(shell $(CC) --version | head -n 1)')>> $@.tmp
@( printf'#define LD_VERSION_STRING "%s"\n' \
'$(shell $(LD) -v | head -n 1)')>> $@.tmp
@cmp -s $@$@.tmp && rm -f $@.tmp || mv -f $@.tmp $@

$(TIMESTAMP_FILE):
@mkdir -p$(dir $(TIMESTAMP_FILE))
@LC_ALL=Cdate +'#define U_BOOT_DATE "%b %d %C%y"' > $@.tmp
@LC_ALL=Cdate +'#define U_BOOT_TIME "%T"' >> $@.tmp
@cmp -s $@$@.tmp && rm -f $@.tmp || mv -f $@.tmp $@

# 执行该目标时，进入tools目录编译easylogo env gdb这些工具
easylogo env gdb:
$(MAKE) -Ctools/$@ all MTD_VERSION=${MTD_VERSION}

# gdb工具
gdbtools: gdb

# 编译所有工具
tools-all: easylogo env gdb $(VERSION_FILE) $(TIMESTAMP_FILE)
$(MAKE) -Ctools HOST_TOOLS_ALL=y

# 改变LOGO信息
.PHONY : CHANGELOG
CHANGELOG:
git log--no-merges U-Boot-1_1_5.. | \
unexpand -a| sed -e 's/\s\s*$$//' > $@

include/license.h: tools/bin2header COPYING
cat COPYING| gzip -9 -c | ./tools/bin2header license_gzip >include/license.h
#########################################################################
# 没别的，就是删除生成的各种配置文件
unconfig:
@rm -f$(obj)include/config.h $(obj)include/config.mk \
$(obj)board*/config.tmp \
$(obj)include/autoconf.mk $(obj)include/autoconf.mk.dep
#########################################################################
# 当make smdkc100_config的时候，下面的为目标%_config会被执行，先删除上次的配置文件
# 然后@$(MKCONFIG) -A$(@:_config=)，@$(MKCONFIG)就是执行mkconfig脚本，传入的参数
# 为 -A和$(@:_config=)，就是把@中的"_config"替换为空$@ = %_config =smdkc100_config
# $(@:_config=) = smdkc100
#
# awk处理中，(NF && $$1 !~ /^#/)，NF表示字段总数不为零，"&& $$1 !~/^#/"表示而且第一个字
# 段不是'#'开头的，总的意思是匹配不以'#'开头的行。{ print $$1 ": " $$1 "_config;$$(MAKE)" }'
# 意思就是打印"$1 : $1_config; $$(MAKE)", $< >$@意思就是把打印的字符串信息写入到目标
# $(obj).boards.depend中。
# (补充知识 $@:表示规则的目标文件名 $<:表示规则的第一个依赖文件名 '>'为输出导向符)
%_config:: unconfig
@$(MKCONFIG)-A $(@:_config=)

sinclude $(obj).boards.depend
$(obj).boards.depend: boards.cfg
@awk '(NF&& $$1 !~ /^#/) { print $$1 ": " $$1 "_config; $$(MAKE)" }'$< > $@

#########################################################################
# Functions to generate common board directory names
# $1为空，所以lcname和ucname均为空,sed中-e参数表示直接在命令行上进行sed的操作编辑。
# 's/$.*$_config/\L\1/'意思是搜索匹配xxxxx_config/L1的字符串
# 's/$.*$_config/\U\1/'同理。
lcname =$(shell echo $(1) | sed -e 's/$.*$_config/\L\1/')
ucname =$(shell echo $(1) | sed -e 's/$.*$_config/\U\1/')

#========================================================================
# ARM (SX1不是我们常用的，不执行)
#========================================================================
SX1_stdout_serial_config \
SX1_config: unconfig
@mkdir -p$(obj)include
@if ["$(findstring _stdout_serial_, $@)" ] ; then \
echo "#undefCONFIG_STDOUT_USBTTY" >> $(obj)include/config.h ; \
else \
echo"#define CONFIG_STDOUT_USBTTY" >> $(obj)include/config.h ;\
fi;
@$(MKCONFIG)-n $@ SX1 arm arm925t sx1

#########################################################################
## ARM1176 Systems (arm11的架构，我们研究的是CortexA8，这里也不会执行到)
#########################################################################
smdk6400_noUSB_config \
smdk6400_config : unconfig
@mkdir -p$(obj)include $(obj)board/samsung/smdk6400
@mkdir -p$(obj)nand_spl/board/samsung/smdk6400
@echo"#define CONFIG_NAND_U_BOOT" > $(obj)include/config.h
@echo"CONFIG_NAND_U_BOOT = y" >> $(obj)include/config.mk
@if [ -z"$(findstring smdk6400_noUSB_config,$@)" ];then \
echo"RAM_TEXT = 0x57e00000" >>$(obj)board/samsung/smdk6400/config.tmp;\
else \
echo"RAM_TEXT = 0xc7e00000" >>$(obj)board/samsung/smdk6400/config.tmp;\
fi
@$(MKCONFIG)smdk6400 arm arm1176 smdk6400 samsung s3c64xx
@echo"CONFIG_NAND_U_BOOT = y" >> $(obj)include/config.mk

#########################################################################
#########################################################################
# clean伪目标，删除编译生成的文件，但不删除一些库文件，避免再次编译以节省时间
clean:
@rm -f$(obj)examples/standalone/82559_eeprom \
$(obj)examples/standalone/atmel_df_pow2 \
$(obj)examples/standalone/eepro100_eeprom \
$(obj)examples/standalone/hello_world \
$(obj)examples/standalone/interrupt \
$(obj)examples/standalone/mem_to_mem_idma2intr \
$(obj)examples/standalone/sched \
$(obj)examples/standalone/smc911{11,x}_eeprom \
$(obj)examples/standalone/test_burst \
$(obj)examples/standalone/timer
@rm -f$(obj)examples/api/demo{,.bin}
@rm -f$(obj)tools/bmp_logo $(obj)tools/easylogo/easylogo \
$(obj)tools/env/{fw_printenv,fw_setenv} \
$(obj)tools/envcrc \
$(obj)tools/gdb/{astest,gdbcont,gdbsend} \
$(obj)tools/gen_eth_addr $(obj)tools/img2srec \
$(obj)tools/mk{env,}image $(obj)tools/mpc86x_clk \
$(obj)tools/mk{smdk5250,}spl \
$(obj)tools/mxsboot \
$(obj)tools/ncb $(obj)tools/ubsha1
@rm -f$(obj)board/cray/L1/{bootscript.c,bootscript.image} \
$(obj)board/matrix_vision/*/bootscript.img \
$(obj)board/voiceblue/eeprom \
$(obj)u-boot.lds \
$(obj)arch/blackfin/cpu/bootrom-asm-offsets.[chs] \
$(obj)arch/blackfin/cpu/init.{lds,elf}
@rm -f$(obj)include/bmp_logo.h
@rm -f$(obj)include/bmp_logo_data.h
@rm -f$(obj)lib/asm-offsets.s
@rm -f$(obj)include/generated/asm-offsets.h
@rm -f$(obj)$(CPUDIR)/$(SOC)/asm-offsets.s
@rm -f$(TIMESTAMP_FILE) $(VERSION_FILE)
@find$(OBJTREE) -type f \
$ -name'core' -o -name '*.bak' -o -name '*~' -o -name '*.su' \
-o -name'*.o' -o-name '*.a' -o -name'*.exe' $-print \
| xargs rm-f

# Removes everything not needed for testing u-boot
# tidy伪目标:删除所有不需要的测试u-boot的文件
tidy: clean
@find$(OBJTREE) -type f $ -name '*.depend*' $ -print | xargs rm-f

# clobber伪目标:删除包括镜像在内的编译文件
clobber: tidy
@find$(OBJTREE) -type f $ -name '*.srec' \
-o -name'*.bin' -o -name u-boot.img $ \
-print0 |xargs -0 rm -f
@rm -f$(OBJS) $(obj)*.bak $(obj)ctags $(obj)etags $(obj)TAGS \
$(obj)cscope.* $(obj)*.*~
@rm -f$(obj)u-boot $(obj)u-boot.map $(obj)u-boot.hex $(ALL-y)
@rm -f$(obj)u-boot.kwb
@rm -f$(obj)u-boot.pbl
@rm -f$(obj)u-boot.imx
@rm -f$(obj)u-boot.ubl
@rm -f$(obj)u-boot.ais
@rm -f$(obj)u-boot.dtb
@rm -f$(obj)u-boot.sb
@rm -f$(obj)u-boot.spr
@rm -f$(obj)nand_spl/{u-boot.lds,u-boot-nand_spl.lds,u-boot-spl,u-boot-spl.map,System.map}
@rm -f$(obj)spl/{u-boot-spl,u-boot-spl.bin,u-boot-spl.lds,u-boot-spl.map}
@rm -f$(obj)MLO
@rm -f$(obj)tools/xway-swap-bytes
@rm -f$(obj)arch/powerpc/cpu/mpc824x/bedbug_603e.c
@rm -f$(obj)arch/powerpc/cpu/mpc83xx/ddr-gen?.c
@rm -fr$(obj)include/asm/proc $(obj)include/asm/arch$(obj)include/asm
@rm -fr$(obj)include/generated
@[ ! -d$(obj)nand_spl ] || find $(obj)nand_spl -name "*" -type l -print |xargs rm -f
@rm -f$(obj)dts/*.tmp
@rm -f$(obj)spl/u-boot-spl{,-pad}.ais

# distclean伪目标:删除所有编译生成的文件和配置文件，这是个常用选项!
mrproper \
distclean: clobber unconfig
ifneq ($(OBJTREE),$(SRCTREE))
rm -rf$(obj)*
endif

# backup:备份，basename命令作用是从文件名中剥离目录和后缀，TOPDIR是u-boot源码顶层目录
# 这样剥离了目录和后缀后，F就是uboot源码包的名称。cd ..返回上级目录，也就是-boot源码顶层目录的上一层目录
# 对于gtar，我找不到这个命令，搜索了一下也没发现这是啥，我把它换成tar便可正常备份!!!!!!!!
# --force-local参数意思是强制使用本地存档，即使存在克隆。z:表示用gzip对存档压缩或者解压。
# c:建立新的压缩文件，v:详细显示处理的文件，f:指定文件名,f参数之后一定要立即接文件名，不能
# 再加别的参数。
# LC_ALL=C设计本地环境为C，即POXSI，这么做是为了去除所有本地化设置，让命令能正确执行
# date:显示日期的命令，%Y-%m-%d-%T，也就是年月日时分秒了
# 所以最后得到备份包的名称是:uboot源码包的名称-年-月-日-时分秒.tar.gz
backup:
F=`basename$(TOPDIR)` ; cd .. ; \
tar--force-local -zcvf `LC_ALL=C date "+$$F-%Y-%m-%d-%T.tar.gz"`$$F
#gtar--force-local -zcvf `LC_ALL=C date "+$$F-%Y-%m-%d-%T.tar.gz"`$$F

#########################################################################