(二)u-boot2013.01.01 for TQ210：《Makefile分析》

时间：2024-04-23 12:36:12

       当时写的时候看的是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

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

相关文章