学步园

转载请注明地址：http://blog.csdn.net/zsy2020314/article/details/9309995

       当时写的时候看的是2012-10版本的，但是略对比了一遍和2013.01.01没什么改动，所以这不影响对2013.01.01版本的makefile的理解。本文比较侧重于语法句意的分析，框架性的原理网上已经有很多，makefile在变但原理始终不变，只要理解了其中一个版本，对于其他版本的理解来说就应该不存在问题了。

#########################################################################
# (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 it and/or
# modify it under the terms of the GNU General Public License as
# published by the Free Software Foundation; either version 2 of
# the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# 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-Boot v2012.10	   - 2012年10月发行版
# U-Boot v2012.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程序来完成的,其中$(shell xxx)的语法就是在shell中执行xxx的命令.
# 这里的'|'就是linux中的管道处理符,'\'就是换行的连接符，表示下一行与本行是同行程序处理. uname -m，就是得到
# machine hardware name，中文翻译成机器硬件名。
# sed -e的意思，选项允许在同一行里执行多条命令，就是表示后面跟的是一串命令脚本，s/abc/def/的命令表达式，
# 就是表示要从标准输入中，查找到内容为abc的，然后替换成def。例如电脑使用Intel Core2系列的CPU，因此"uname –m"
# 输出"i686"。 "i686"可以匹配命令"sed -e s/i.86/i386/"中的"i.86"，因此在执行Makefile时，HOSTARCH将被设置成"i386" 。
# 这样执行这一套程序下来，就知道了机器的硬件体系了。
HOSTARCH := $(shell uname -m | \
	sed -e s/i.86/x86/ \
	    -e s/sun4u/sparc64/ \
	    -e s/arm.*/arm/ \
	    -e s/sa110/arm/ \
	    -e s/ppc64/powerpc/ \
	    -e s/ppc/powerpc/ \
	    -e s/macppc/powerpc/\
	    -e s/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 echo sh; 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 separate external
# 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 desired location
# '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 environent variable.
#
# When none of the above methods is used the local build is performed and
# the object files are placed in the source directory.
#

#########################################################################
# U-boot支持定义源码及生成的目标文件存放的目录的功能。有两种方法可以实现：
# 1)指定编译参数 O=目录，例如:make O= /tmp/build all
# 2)设置环境变量BUILD_DIR，该变量指定目录并设置为设置为环境变量
#   例如:export BUILD_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”的命令，则“$(origin O)”值为“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)" does not 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	TOPDIR SRCTREE 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 main Makefile
# we also need them before config.mk is included which is the case for
# 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, when USE_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前必须配置目标板的信息，也就是要执行
# make xxx_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 options are available
# to all top level build files.  We need the dummy all: target to prevent the
# dependency target in autoconf.mk.dep from being the default.

#########################################################################
# 在加载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=CortexA8 BOARD=HY210 SOC=S5pv210 
include $(obj)include/config.mk
export	ARCH CPU BOARD VENDOR SOC

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

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

#########################################################################
# If board code explicitly specified LDSCRIPT or CONFIG_SYS_LDSCRIPT, use
# that (or fail if absent).  Otherwise, search for a 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
	ifdef CONFIG_SYS_LDSCRIPT
		# need to strip 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't expect 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 $(wildcard board/$(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 backwards compatibility
# 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 custom ones
# 始终追加到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-Record format文件，System.map 
# 是U-Boot的符号表，u-boot.bin是最终烧写到开发板的二进制可执行的文件。
all:		$(ALL-y) $(SUBDIR_EXAMPLES)

# 
$(obj)u-boot.dtb:	$(obj)u-boot
		$(MAKE) -C dts 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-boot u-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 $(shell sed -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) -T imximage \
		-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 the ROM
# bootloader can check its integrity. Padding needs to be done to the
# SPL image (with mkimage header) and not the binary. Otherwise the resulting image
# which is loaded/copied by the ROM bootloader to SRAM doesn't fit.
# The resulting image containing both U-Boot images is called u-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
		dd if=$(obj)spl/u-boot-spl.img of=$(obj)spl/u-boot-spl-pad.img \
			conv=notrunc 2>/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) \
			-Map u-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=`$(call SYSTEM_MAP,$(obj)u-boot) | \
			awk '$$2 ~ /[tTwW]/ {printf $$1 $$3 "\\\\000"}'` ; \
		$(CC) $(CFLAGS) -DSYSTEM_MAP="\"$${smap}\"" \
			-c common/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) -C nand_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) -C spl all

updater:
		$(MAKE) -C tools/updater all
#########################################################################
# Explicitly make _depend in subdirs containing multiple targets to prevent
# 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=C sort
$(obj)System.map:	$(obj)u-boot
		@$(call SYSTEM_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 all makefiles)
# This target actually generates 2 files; autoconf.mk and autoconf.mk.dep.
# the dep file is only include in this top level makefile to determine 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.h include/common.h
	@$(XECHO) Generating $@ ; \
	set -e ; \
	: Generate the 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 ; \
	: Extract the config macros ; \
	$(CPP) $(CFLAGS) -DDO_DEPS_ONLY -dM include/common.h | \
		sed -n -f tools/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
	@ exit 1

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=C date +'#define U_BOOT_DATE "%b %d %C%y"' > $@.tmp
		@LC_ALL=C date +'#define U_BOOT_TIME "%T"' >> $@.tmp
		@cmp -s $@ $@.tmp && rm -f $@.tmp || mv -f $@.tmp $@

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

# 编译所有工具
tools-all: easylogo env gdb $(VERSION_FILE) $(TIMESTAMP_FILE)
	$(MAKE) -C tools 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)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 "#undef CONFIG_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
	

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