u-boot2013.01.01 for s5pv210：《Makefile分析》

摘自： http://blog.csdn.net/zsy2020314/article/details/9824035

 當時寫的時候看的是2012-10版本的，但是略對比了一遍和2013.01.01沒什麼改動，所以這不影響對2013.01.01版本的makefile的理解。本文比較側重於語法句意的分析，框架性的原理網上已經有很多，makefile在變但原理始終不變，只要理解了其中一個版本，對於其他版本的理解來說就應該不存在問題了。

#########################################################################
# (C) Copyright 2000-2012
# Wolfgang Denk, DENX Software Engineering, [email protected].
#
# 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 > [email protected] && \
    mv [email protected] $@

$(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}" ; \
        ) > [email protected]
        @( printf '#define CC_VERSION_STRING "%s"\n' \
         '$(shell $(CC) --version | head -n 1)' )>>  [email protected]
        @( printf '#define LD_VERSION_STRING "%s"\n' \
         '$(shell $(LD) -v | head -n 1)' )>>  [email protected]
        @cmp -s $@ [email protected] && rm -f [email protected] || mv -f [email protected] $@

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

# 執行該目標時，進入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−
F


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