u-boot之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
#########################################################################
转载：http://blog.csdn.net/zsy2020314/article/details/9309995
类似资料：