U-BOOT顶层MAKEFILE详解
1) U-Boot配置过程
# (C) Copyright 2000-2006
# 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 Foundatio; 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
#
版权所有：2000~2006
Wolfgang Denk一个开发人员的名字DENX Software Engineering公司名称wd@denx.de邮箱
可以看看CREDITS，里面有为uboot做出贡献的所有开发人员
这个程序是一个自由软件，你可以重新发布它，或者在自由软件基金组织所颁布的
GNU GPL（GNU公共许可协议）的前提下修改它；注意，不论是第二版的GPL还是
任何更新的版本，都可以，这由你选择。
我们之所以发布这个程序，是希望它能够对你有用，但是我们不做任何担保；
不保证任何的可销售性和任何给予特殊目的的合适性。想要了解详细内容，
你可以参考GNU GPL。
你应该已经得到了GNU General Public License的一个拷贝，因为它就包含在
这个工程的源代码包中。如果没有，你可以写信给自由软件基金组织，以获取一份。
VERSION = 1 #主版本号
PATCHLEVEL = 1 #次版本号
SUBLEVEL = 6 #修正版本号
EXTRAVERSION = #扩展版本号
U_BOOT_VERSION = $(VERSION).$(PATCHLEVEL).$(SUBLEVEL)$(EXTRAVERSION) #1.1.6版
VERSION_FILE=$(obj)include/version_autogenerated.h #版本文件
# uname命令将正在使用的操作系统名写到标准输出中
# -m显示硬件运行系统的机器 ID号
#定义变量，HOSTARCH里面存储的是机器ID号，即主机架构类型
HOSTARCH := $(shell uname -m | \ #可以把shell脚本写到makefile里面，这是make中的shell function，相当于shell中的命令替换。
sed -e s/i.86/i386/ \ #shell uname -m获得机器硬件名称
-e s/sun4u/sparc64/ \
-e s/arm.*/arm/ \ #sed -e s/arm.*/arm/ 的意思是把前缀为arm.的有模式替换为arm，结合前面的uname命令来理解就是
-e s/sa110/arm/ \ #把uname -m的结果（主机架构类型或者称为机器ID号）通过管道传递给sed命令，然后把前缀为arm的所有模式替换为arm。
-e s/powerpc/ppc/ \ #sed的语法： sed [ -n ] Script [ File ... ]
-e s/macppc/ppc/) # sed [ -n ] [ -e Script ] ... [ -f ScriptFile ] ... [ File ... ]
#sed命令根据编辑脚本，去修改指定的 File文件（这里file是作为一个输入参数的）的行,
并将其写到标准输出。
#sed命令包含很多功能，用于选择要修改的行（请注意，sed是针对行进行操作的），并只对选择的行作更改。
#sed命令使用两个工作空间来保留修改的行：保留选定行的 "模式空间"和暂时存储行的 "保留空间"。
#这里的编辑脚本由单独的子命令构成，每个单独的行对应着一个子命令。sed子命令的格式如下：[address-range] function[modifiers]，即：[地址范围]函数[修改符]
#sed命令通过将一个输入行读入模式空间，依次应用所有的 sed子命令（这些子命令的地址选择了该行），
#并将模式空间写到标准输出来处理每个输入的 File输入文件（file就是输入参数）。然后清除模式空间，并对输入的 File 中指定的每行重复该过程。
#一些 sed子命令使用保留空间来保存后继检索的所有的，或部分的模式空间。
#当命令包含地址（行号或搜索模式）时，该命令只会对被寻址的行起作用。否则，该命令适用于所有的行。
#注意，这里的参数"-e"的意思是：使用 Script 变量作为编辑脚本。如果你只使用一个 -e标志并且不使用-f标志，则可以省略 -e标志。
#注意，这里的 "sed -e s/arm.*/arm/"表示把前缀为arm的所有模式替换为arm，也就是sed s/pattern/replacement/flags
#用 replacement字符串代替在模式空间中首次出现的pattern参数。除了空格或换行符，在 s子命令之后显示的任何字符都能代替 /（斜杠）分隔符。
#uname -s表示：显示系统名，标志缺省为开，即uname命令不带任何参数的输出和加参数-s输出相同，即Linux
#tr是一个shell命令，可以实现许多sed的功能，这里 tr '[:upper:]' '[:lower:]'的意思是把管道中的Linux中的大写字母L转换成小写字母l
#下面这句话的意思是定义变量HOSTOS，HOSTOS里面存放的是主机安装的，并且当前正在运行的操作系统。
HOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]' | \
sed -e 's/\(cygwin\).*/cygwin/') # 这一句的意思是检测出主机安装的，并且当前正在运行的操作系统名，并把这个系统名中的大写字母转换为小写字母，
# 然后在通过sed流编辑器匹配所有的，这个系统名中出现的"\(cygwin\).*"模式，然后再用"cygwin"模式替换。
#export HOSTARCH HOSTOS 的意思是输出两个makefile变量HOSTARCH和HOSTOS
export HOSTARCH HOSTOS
# Deal with colliding definitions from tcsh etc. 用来处理来自tcsh的互相冲突的定义等等
#一般来说，shell可以分成两类。第一类是由 Bourne shell 衍生出来的包括
# sh，ksh，bash，与zsh。第二类是由 C shell 衍生出来的，包括 csh 与
# tcsh。除此之外还有一个rc，有人认为该自成一类，有人认为该归类在Bourne shell。
VENDOR = #开发商
#########################################################################
#
# 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的编译过程可以支持向一个自己定义的路径生成最终的目标文件
#这里提供了两种用法：
#第一种用法：通过在终端执行命令make O=/dir(即你指定的生成的目标文件的存放目录)
#第二种用法：通过设置环境变量来指定目标文件存放目录，如下所示：
#第二种方法也可以写成一个MAKEALL脚本，然后执行MAKEALL，如下所示:
#命令行'O='设置会覆盖环境变量BUILD_DIR的设置
#如果都不采用上面两种方法，那么目标文件放到源码顶层目录，也就是U-BOOT顶层目录
#理解了上面一段英文，这里就不难理解了
#方法1：
ifdef O #如果变量'O'已经被定义过
ifeq ("$(origin O)", "command line") #如果变量'O'在命令行中定义过
BUILD_DIR := $(O) #就把变量'O'的值(目标文件存放目录)赋给BUILD_DIR
endif
endif
#方法2
ifneq ($(BUILD_DIR),) #如果变量BUILD_DIR不为空，即环境变量BUILD_DIR被定义过
saved-output := $(BUILD_DIR) #那么把它的值赋给saved-output
# Attempt to create a output directory. #生成一个输出路径，即目标文件存放目录BUILD_DIR
$(shell [ -d ${BUILD_DIR} ] || mkdir -p ${BUILD_DIR})
#shell [ -d ${BUILD_DIR} ]是判断BUILD_DIR目录是否存在，如果存在则不会在创建目录，否则，创建目录。
# Verify if it was successful.测试目录是否创建成功
BUILD_DIR := $(shell cd $(BUILD_DIR) && /bin/pwd) #先打开这个路径，再通过pwd显示路径，最后把路径赋值给BUILD_DIR
$(if $(BUILD_DIR),,$(error output directory "$(saved-output)" does not exist))
#这里用了一个if函数，意思是如果如果$(BUILD_DIR)非空，则什么都不执行(返回空)，否则执行error函数，输出错误信息
endif
# ifneq ($(BUILD_DIR),) #如果BUILD_DIR还不存在的话，则输出
Saved-output :=$(BUILD_DIR) saved-output中的目录does not exist
#Makefile中定义了源码以及生成目标文件存放的目录，目标文件存放目录BUILD_DIR可以通过make O=dir指定。如果没有指定，则设定为源码顶层目录。
#一般编译的时候不指定输出目录，则BUILD_DIR为空。其他目录变量如下：
OBJTREE := $(if $(BUILD_DIR),$(BUILD_DIR),$(CURDIR)) #如果$(BUILD_DIR)不为空，则返回$(BUILD_DIR)，并赋给OBJTREE，即自己定制的目标存放目录
SRCTREE := $(CURDIR) #把当前源码所在目录 $(CURDIR)赋给SRCTREE
TOPDIR := $(SRCTREE) #把当前源码所在目录 $(CURDIR)赋给SRCTREE
LNDIR := $(OBJTREE) #存放生成的目录文件
export TOPDIR SRCTREE OBJTREE
MKCONFIG := $(SRCTREE)/mkconfig #MKCONFIG指向源码所在目录(U-BOOT顶层目录)下的mkconfig配置文件
export MKCONFIG
ifneq ($(OBJTREE),$(SRCTREE)) #当目标存放目录不是U-BOOT顶层目录（源码目录）
REMOTE_BUILD := 1 #定义变量REMOTE_BUILD := 1 这个变量算是一个flag吧
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) and $(src)都被定义在顶层目录下的config.mk脚本配置文件里面，
#但是在这个主Makefile里面，我们同样需要他们，
#因为在主Makefile文件包含config.mk之前，$(obj) and $(src)偶尔地会成为这些目标的case:
# unconfig, clean, clobber, distclean, etc
ifneq ($(OBJTREE),$(SRCTREE)) #当目标存放目录不是U-BOOT顶层目录（源码目录）
obj := $(OBJTREE)/ #定义变量obj，让其等于目标存放目录
src := $(SRCTREE)/ #定义变量src，让其等于uboot顶层目录
else
obj := #否则，这两个变量都定义为空
src :=
endif
export obj src
执行完上面的代码后， SRCTREE，src变量就是U-Boot代码顶层目录，而OBJTREE，obj变量就是输出目录，若没有定义BUILD_DIR环境变量，则SRCTREE，src变量与OBJTREE，obj变量都是U-Boot源代码目录。而MKCONFIG则表示U-Boot根目录下的mkconfig脚本。
2 ) make smdk2410_config命令执行过程
#从本Makefile的下文可以判断出smdk2410_config为Makefile的一个目标。
#smdk2410_config: unconfig的意思是为smdk2410开发板建立一个编译项。
#显然，执行#make smdk2410_config时，先执行unconfig目标（不指定输出目标时，obj，src变量均为空），unconfig下面的命令主要任务是清理上
#一次执行make *_config时生成的头文件和makefile的包含文件。
#主要是include/config.h和include/config.mk
#然后执行命令：@$(MKCONFIG) $(@:_config=) arm arm920t smdk2410 NULL s3c24x0
# Parameters: Target Architecture CPU Board [VENDOR] [SOC]
#arm表示CPU的构架是基于ARM体系的
#arm920t表示CPU的类型是arm920t
#smdk2410表示开发板的型号
#NULL表示开发商或者经销商的名称，这里为空
#s3c24x0表示基于S3C2410的片上系统
smdk_config : unconfig
@$(MKCONFIG) $(@:_config=) arm arm920t smdk2410 samsung s3c24x0
其中的依赖“unconfig”定义如下：
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
其中“@”的作用是执行该命令时不在shell显示。“obj”变量就是编译输出的目录，因
此“unconfig”的作用就是清除上次执行make *_config命令生成的配置文件（如
include/config.h，include/config.mk等）。
$(MKCONFIG)在上面指定为“$(SRCTREE)/mkconfig”。$(@:_config=)为将传进来的所有参数中的_config替换为空（其中“@”指规则的目标文件名，在这里就是“smdk2410_config”。
$(text:patternA=patternB)，这样的语法表示把text变量每一个元素中结尾的patternA的文
本替换为patternB，然后输出）。因此$(@:_config=)的作用就是将smdk2410_config中的
_config去掉，得到smdk2410。
因此“@$(MKCONFIG) $(@:_config=) smdk2410 arm arm920t smdk2410 samsung s3c24x0”实际上就
是执行了如下命令：
./mkconfigsmdk2410 arm arm920tsmdk2410samsungs3c24x0
mkconfig脚本文件
既然我们使用到这个mkconfig脚本文件，那我们就看看到底这个文件做了些什么工作？
（1）确定开发板名称BOARD_NAME
APPEND=no # no表示创建新的配置文件，yes表示追加到配置文件中
BOARD_NAME="" # Name to print in make output
TARGETS=""
while [ $# -gt 0 ] ; do
case "$1" in
--) shift ; break ;;
-a) shift ; APPEND=yes ;;
-n) shift ; BOARD_NAME="${1%%_config}" ; shift ;;
-t) shift ; TARGETS="`echo $1 | sed 's:_: :g'` ${TARGETS}" ; shift ;;
*) break ;;
esac
done
[ "${BOARD_NAME}" ] || BOARD_NAME="$1"
环境变量$#表示传递给脚本的参数个数，这里的命令有6个参数，因此$#是6。shift的
作用是使$1=$2，$2=$3，$3=$4„.，而原来的$1将丢失。因此while循环的作用是，依次处理传递给mkconfig脚本的选项。由于我们并没有传递给mkconfig任何的选项，因此while循环中的代码不起作用,最后将BOARD_NAME的值设置为$1的值，在这里就是“smdk2410”。
（2）检查参数合法性
[ $# -lt 4 ] && exit 1
[ $# -gt 6 ] && exit 1
if [ "${ARCH}" -a "${ARCH}" != "$2" ]; then
echo "Failed: \$ARCH=${ARCH}, should be '$2' for ${BOARD_NAME}" 1>&2
exit 1
fi
上面代码的作用是检查参数个数和参数是否正确，参数个数少于4个或多于6个都被认为
是错误的。
（3）创建到目标板相关的目录的链接
#
# Create link to architecture specific headers
#
if [ "$SRCTREE" != "$OBJTREE" ] ; then #若编译目标输出到外部目录，则下面的代
码有效
mkdir -p ${OBJTREE}/include
mkdir -p ${OBJTREE}/include2
cd ${OBJTREE}/include2
rm -f asm
ln -s ${SRCTREE}/include/asm-$2 asm
LNPREFIX="http://www.cnblogs.com/include2/asm/"
cd ../include
rm -rf asm-$2
rm -f asm
mkdir asm-$2
ln -s asm-$2 asm
else
cd ./include
rm -f asm
ln -s asm-$2 asm
fi
若将目标文件设定为输出到源文件所在目录，则以上代码在include目录下建立了到
asm-arm目录的符号链接asm。其中的ln -s asm-$2 asm即ln -s asm-arm asm。
rm -f asm-$2/arch
if [ -z "$6" -o "$6" = "NULL" ] ; then
ln -s ${LNPREFIX}arch-$3 asm-$2/arch
else
ln -s ${LNPREFIX}arch-$6 asm-$2/arch
fi
建立符号链接include/asm-arm/arch，若$6（SOC）为空，则使其链接到
include/asm-arm/arch-arm920t目录，否则就使其链接到include/asm-arm/arch-s3c24x0目录。
（事实上include/asm-arm/arch-arm920t并不存在，因此$6是不能为空的，否则会编译失败）
if [ "$2" = "arm" ] ; then
rm -f asm-$2/proc
ln -s ${LNPREFIX}proc-armv asm-$2/proc
fi
若目标板是arm架构，则上面的代码将建立符号连接include/asm-arm/proc，使其链接到
目录proc-armv目录。
建立以上的链接的好处：编译U-Boot时直接进入链接文件指向的目录进行编译，而不必根据不同开发板来选择不同目录。
（4）构建include/config.mk文件
#
# Create include file for Make
#
echo "ARCH = $2" > config.mk
echo "CPU = $3" >> config.mk
echo "BOARD = $4" >> config.mk
[ "$5" ] && [ "$5" != "NULL" ] && echo "VENDOR = $5" >> config.mk
[ "$6" ] && [ "$6" != "NULL" ] && echo "SOC = $6" >> config.mk
上面代码将会把如下内容写入文件inlcude/config.mk文件(>和>>实现重定向功能，并且后者是追加)：
ARCH = arm
CPU = arm920t
BOARD = smdk2410
VENDOR = samsung
SOC = s3c24x0
（5）指定开发板代码所在目录
# Assign board directory to BOARDIR variable
if [ -z "$5" -o "$5" = "NULL" ] ; then
BOARDDIR=$4
else
BOARDDIR=$5/$4
fi
以上代码指定board目录下的一个目录为当前开发板专有代码的目录。若$5（VENDOR）为
空则BOARDDIR设置为$4（BOARD），否则设置为$5/$4（VENDOR/BOARD）。在这里由于$5不为空，
因此BOARDDIR被设置为samsung/mini2440。
（6）构建include/config.h文件
#
# Create board specific header file
#
if [ "$APPEND" = "yes" ] # Append to existing config file
then
echo >> config.h
else
> config.h # Create new config file
fi
echo "/* Automatically generated - do not edit */" >>config.h
for i in ${TARGETS} ; do
echo "#define CONFIG_MK_${i} 1" >>config.h ;
done
cat << EOF >> config.h
#define CONFIG_BOARDDIR board/$BOARDDIR
#include <config_defaults.h>
#include <configs/$1.h>
#include <asm/config.h>
EOF
exit 0
这里的“cat << EOF >> config.h”表示将输入的内容追加到config.h中，直到出现“EOF”
这样的标识为止。
若APPEND为no，则创建新的include/config.h文件。若APPEND为yes，则将新的配置内
容追加到include/config.h文件后面。由于APPEND的值保持“no”，因此config.h被创建了，
并添加了如下的内容：
/* Automatically generated - do not edit */
#define CONFIG_BOARDDIR board/samsung/mini2440
#include <config_defaults.h>
#include <configs/mini2440.h>
#include <asm/config.h>
3) make all命令执行过程
ifeq ($(OBJTREE)/include/config.mk,$(wildcard $(OBJTREE)/include/config.mk))
all：
sinclude $(obj)include/autoconf.mk.dep
sinclude $(obj)include/autoconf.mk
#通配符在规则中可以自动扩展，但设置在变量中或在函数的参数中通配符一般不能正常扩展，如果您需要在这些场合扩展通配符，您应该使用函数wildcard，格式如下：
# $(wildcard pattern...)
# load ARCH, BOARD, and CPU configuration #加载ARCH, BOARD, and CPU配置
include $(obj)/include/config.mk 若include/config.mk文件存在，则$(wildcard $(obj)include/config.mk)命令执行的结果是“$(obj)include/config.mk”展开的字符串，否则结果为空。
export ARCH CPU BOARD VENDOR SOC
#指定交叉编译器前缀
ifeq ($(ARCH),arm)
CROSS_COMPILE = arm-linux-
#这里你可以把交叉编译器的安装路径加到arm-linux-之前，比如你的交叉编译器安装路径是
/root/u-boot/usr/local/arm/3.3.2/bin/
那你可以这样定义CROSS_COMPILE = /root/u-boot/usr/local/arm/3.3.2/bin/arm-linux-
# load other configuration
include $(TOPDIR)/config.mk 包含顶层目录下的config.mk
endif
export CROSS_COMPILE
else # config.mk不存在
…
@echo "System not configured - see README" >&2
@ exit 1
…
endif # config.mk
（1） include/autoconf.mk生成过程
sinclude $(obj)include/autoconf.mk.dep
sinclude $(obj)include/autoconf.mk
include/autoconf.mk文件中是与开发板相关的一些宏定义，在Makefile执行过程中需要
根据某些宏来确定执行哪些操作。下面简要分析include/autoconf.mk生成的过程，
include/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 $(HOSTCFLAGS) $(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 $@
CPP C 程序的预处理器（输出是标准输出设备）。默认命令是“$(CC) –E”。
CFLAGS C 语言编译器参数。
CPPFLAGS C 预处理器参数。
include/autoconf.mk依赖于make <board_name>_config命令生成的include/config.h。
因此执行make <board_name>_config命令后再执行make all将更新include/autoconf.mk。
编译选项“-dM”的作用是输出include/common.h中定义的所有宏。根据上面的规则，编
译器提取include/common.h中定义的宏，然后输出给tools/scripts/define2mk.sed脚本处理，
处理的结果就是include/autoconf.mk文件。其中tools/scripts/define2mk.sed脚本的主要完
成了在include/common.h中查找和处理以“CONFIG_”开头的宏定义的功能。
（2） config.mk文件执行过程
①设置obj与src
ifneq ($(OBJTREE),$(SRCTREE))
ifeq ($(CURDIR),$(SRCTREE))
dir :=
else
dir := $(subst $(SRCTREE)/,,$(CURDIR))
endif
obj := $(if $(dir),$(OBJTREE)/$(dir)/,$(OBJTREE)/)
src := $(if $(dir),$(SRCTREE)/$(dir)/,$(SRCTREE)/)
$(shell mkdir -p $(obj))
else
obj :=
src :=
endif
如果BUILD_DIR没有建立，则obj和src目录为空，这里我们编译没有指定目录，所以obj和src都为空。
②设置编译选项
PLATFORM_RELFLAGS =
PLATFORM_CPPFLAGS = #编译选项
PLATFORM_LDFLAGS = #连接选项
用这3个变量表示交叉编译器的编译选项，在后面Make会检查交叉编译器支持的编译选项，然后将适当的选项添加到这3个变量中。
# Option checker (courtesy linux kernel) to ensure
# only supported compiler options are used
cc-option = $(shell if $(CC) $(CFLAGS) $(1) -S -o /dev/null -xc /dev/null \
> /dev/null 2>&1; then echo "$(1)"; else echo "$(2)"; fi ;)
变量CC和CFLAGS在后面的代码定义为延时变量，其中的CC即arm-linux-gcc。函数
cc-option用于检查编译器CC是否支持某选项。将2个选项作为参数传递给cc-option函数，
该函数调用CC编译器检查参数1是否支持，若支持则函数返回参数1，否则返回参数2（因此CC编译器必须支持参数1或参数2，若两个都不支持则会编译出错）。可以像下面这样调用cc-option函数，并将支持的选项添加到FLAGS中：
FLAGS +=$(call cc-option,option1,option2)
③指定交叉编译工具
# Include the make variables (CC, etc...)
#
AS = $(CROSS_COMPILE)as
LD = $(CROSS_COMPILE)ld
CC = $(CROSS_COMPILE)gcc
CPP= $(CC) -E
AR = $(CROSS_COMPILE)ar
NM = $(CROSS_COMPILE)nm
LDR = $(CROSS_COMPILE)ldr
STRIP = $(CROSS_COMPILE)strip
OBJCOPY = $(CROSS_COMPILE)objcopy
OBJDUMP = $(CROSS_COMPILE)objdump
RANLIB= $(CROSS_COMPILE)RANLIB
对于arm开发板，其中的CROSS_COMPILE在lib_arm/config.mk文件中定义：
CROSS_COMPILE ?= arm-linux-
因此以上代码指定了使用前缀为“arm-linux-”的编译工具，即arm-linux-gcc，
arm-linux-ld等等。
④包含与开发板相关的配置文件
# Load generated board configuration
sinclude $(OBJTREE)/include/autoconf.mk
ifdef ARCH
sinclude $(TOPDIR)/lib_$(ARCH)/config.mk # include architecture dependend rules
endif
$(ARCH)的值是“arm”，因此将“lib_arm/config.mk”包含进来。lib_arm/config.mk脚
本指定了交叉编译器，添加了一些跟CPU架构相关的编译选项，最后还指定了
cpu/arm920t/u-boot.lds为U-Boot的连接脚本。
ifdef CPU
sinclude $(TOPDIR)/cpu/$(CPU)/config.mk # include CPU specific rules
endif
$(CPU)的值是“arm920t”，因此将“cpu/arm920t/config.mk”包含进来。这个脚本主要
设定了跟arm920t处理器相关的编译选项。
ifdef SOC
sinclude $(TOPDIR)/cpu/$(CPU)/$(SOC)/config.mk # include SoC specific rules
endif
$(SOC)的值是s3c24x0，因此Make程序尝试将cpu/arm920t/s3c24x0/config.mk包含进来，
而这个文件并不存在，但是由于用的是“sinclude”命令，所以并不会报错。
ifdef VENDOR
BOARDDIR = $(VENDOR)/$(BOARD)
else
BOARDDIR = $(BOARD)
endif
$(BOARD)的值是smdk2410，VENDOR的值是samsung，因此BOARDDIR的值是samsung/smdk2410。
BOARDDIR变量表示开发板特有的代码所在的目录。
ifdef BOARD
sinclude $(TOPDIR)/board/$(BOARDDIR)/config.mk # include board specific rules
endif
Make将“board/samsung/smdk2410/config.mk”包含进来。该脚本只有如下的一行代码：
TEXT_BASE = 0x33F80000
U-Boot编译时将使用TEXT_BASE作为代码段连接的起始地址。
LDFLAGS += -Bstatic -T $(obj)u-boot.lds $(PLATFORM_LDFLAGS)
ifneq ($(TEXT_BASE),)
LDFLAGS += -Ttext $(TEXT_BASE)
endif
执行完以上代码后，LDFLAGS中包含了“-Bstatic -T u-boot.lds ”和“-Ttext 0x33F80000”
的字样。
⑤指定隐含的编译规则
# Allow boards to use custom optimize flags on a per dir/file basis
BCURDIR := $(notdir $(CURDIR))
$(obj)%.s: %.S
$(CPP) $(AFLAGS) $(AFLAGS_$(@F)) $(AFLAGS_$(BCURDIR)) -o $@ $<
$(obj)%.o: %.S
$(CC) $(AFLAGS) $(AFLAGS_$(@F)) $(AFLAGS_$(BCURDIR)) -o $@ $< -c
$(obj)%.o: %.c
$(CC) $(CFLAGS) $(CFLAGS_$(@F)) $(CFLAGS_$(BCURDIR)) -o $@ $< -c
$(obj)%.i: %.c
$(CPP) $(CFLAGS) $(CFLAGS_$(@F)) $(CFLAGS_$(BCURDIR)) -o $@ $< -c
$(obj)%.s: %.c
$(CC) $(CFLAGS) $(CFLAGS_$(@F)) $(CFLAGS_$(BCURDIR)) -o $@ $< -c -S
例如：根据以上的定义，以“.s”结尾的目标文件将根据第一条规则由同名但后缀为“.S”
的源文件来生成，若不存在“.S”结尾的同名文件则根据最后一条规则由同名的“.c”文件生成。
4）U-Boot需要的库文件
#########################################################################
# U-Boot objects....order is important (i.e. start must be first)
# uboot目标...书写顺序很重要，比如start.o必须排在第一位
#########################################################################
OBJS = cpu/$(CPU)/start.o #与平台相关的
#start.o必须放在目标文件的第一位，因为uboot执行的第一段代码就是start.S
#具体原因可以查看链接脚本/u-boot-1.1.6/board/smdk2410/u-boot.lds，点击连接：
http://zqwt.012.blog.163.com/blog/static/120446842010320101137932/
OBJS := $(addprefix $(obj),$(OBJS)) #这句的意思是把目标文件存放路径以前缀的形式加到start.O之前，然后再赋给OBJS
LIBS变量指明了U-Boot需要的库文件，包括平台/开发板相关的目录、通用目录下相应的
库，都通过相应的子目录编译得到的
LIBS = lib_generic/libgeneric.a
LIBS += board/$(BOARDDIR)/lib$(BOARD).a #与平台相关的
LIBS += cpu/$(CPU)/lib$(CPU).a #与平台相关的
ifdef SOC
LIBS += cpu/$(CPU)/$(SOC)/lib$(SOC).a #与平台相关的
endif
LIBS += lib_$(ARCH)/lib$(ARCH).a #与平台相关的
LIBS += fs/cramfs/libcramfs.a fs/fat/libfat.a fs/fdos/libfdos.a fs/jffs2/libjffs2.a \
fs/reiserfs/libreiserfs.a fs/ext2/libext2fs.a
……
LIBS += net/libnet.a
LIBS += disk/libdisk.a
LIBS += rtc/librtc.a
LIBS += dtt/libdtt.a
LIBS += drivers/libdrivers.a
LIBS += drivers/nand/libnand.a
LIBS += drivers/nand_legacy/libnand_legacy.a
LIBS += drivers/sk98lin/libsk98lin.a
LIBS += post/libpost.a post/cpu/libcpu.a
LIBS += common/libcommon.a
LIBS += $(BOARDLIBS)
LIBS := $(addprefix $(obj),$(LIBS))
根据所生成的include/config.mk文件定义的几个变量ARCH, CPU, BOARD, SOC，我们可以确定硬件平台依赖的目录文件。smdk2410平台相关（依赖）目录以及对应生成的库文件如下：
#board/smdk2410/: 库文件board/smdk2410/libsmdk2410.a
#cpu/arm920t/: 库文件cpu/arm920t/libarm920t.a
#cpu/arm920t/s3c24x0: 库文件cpu/arm920t/s3c24x0/libs3c24x0.a
#lib_arm： 库文件lib_arm/libarm.a
#include/asm-arm: 头文件
#include/cnofigs/smdk2410.h： 头文件
# Add GCC lib
PLATFORM_LIBS += -L $(shell dirname `$(CC) $(CFLAGS) -print-libgcc-file-name`) -lgcc
ifeq ($(CONFIG_NAND_U_BOOT),y)
NAND_SPL = nand_spl
U_BOOT_NAND = $(obj)u-boot-nand.bin
endif
__OBJS := $(subst $(obj),,$(OBJS))
__LIBS := $(subst $(obj),,$(LIBS))
#########################################################################
#这里是最终要生成的各种镜像文件u-boot.hex、u-boot.srec、u-boot.bin、System.map、u-boot.img
#########################################################################
ALL += $(obj)u-boot.srec $(obj)u-boot.bin $(obj)System.map $(U_BOOT_NAND)
$(U_BOOT_ONENAND)
all: $(ALL)
u-boot.srec，u-boot.bin，System.map都依赖与u-boot。因此执行“make all”命令将生成u-boot，u-boot.srec，u-boot.bin，System.map。其中u-boot是ELF文件，u-boot.srec是Motorola S-Record format文件，System.map是U-Boot的符号表，u-boot.bin是最终烧写到开发板的二进制可执行的文件。
下面再来分析u-boot.bin文件生成的过程。ELF格式“u-boot”文件生成规则如下：
$(obj)u-boot: depend $(SUBDIRS) $(OBJS) $(LIBBOARD) $(LIBS) $(LDSCRIPT)
$(obj)u-boot.lds
$(GEN_UBOOT)
ifeq ($(CONFIG_KALLSYMS),y)
smap=`$(call SYSTEM_MAP,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
这里生成的$(obj)u-boot目标就是ELF格式的U-Boot文件了。由于CONFIG_KALLSYMS未定义，因此ifeq ($(CONFIG_KALLSYMS),y)与endif间的代码不起作用。
其中depend，$(SUBDIRS)，$(OBJS)，$(LIBBOARD)，$(LIBS)，$(LDSCRIPT)，
$(obj)u-boot.lds是$(obj)u-boot的依赖，而$(GEN_UBOOT)编译命令。
下面分析$(obj)u-boot的各个依赖：
①依赖目标depend
#依赖目标depend：生成各个子目录.depend文件，.depend列出每个目标文件的依赖文件。
#生成方法：调用每个子目录的make_depend
# Explicitly make _depend in subdirs containing multiple targets to prevent
# parallel sub-makes creating .depend files simultaneously.
depend dep: $(TIMESTAMP_FILE) $(VERSION_FILE) $(obj)include/autoconf.mk
for dir in $(SUBDIRS) cpu/$(CPU) $(dir $(LDSCRIPT)) ; do \
$(MAKE) -C $$dir _depend ; done
对于$(SUBDIRS)，cpu/$(CPU)，$(dir $(LDSCRIPT))中的每个元素都进入该目录执行“make
_depend”，生成各个子目录的.depend文件，.depend列出每个目标文件的依赖文件。
#########################################################################
②依赖SUBDIRS
# The "tools" are needed early, so put this first
# Don't include stuff already done in $(LIBS) 不要包含已经在 $(LIBS)中的任何东西
#
#伪目标SUBDIRS：用于执行执行tools，examples/standalone，examples/api目录下的Makefile。
SUBDIRS = tools \
examples/standalone \
examples/api
$(SUBDIRS): depend
③OBJS
OBJS的值是“cpu/arm920t/start.o”。它使用如下代码编译得到：
$(OBJS): depend
$(MAKE) -C cpu/$(CPU) $(if $(REMOTE_BUILD),$@,$(notdir $@))
以上规则表明，对于OBJS包含的每个成员，都进入cpu/$(CPU)目录（即cpu/arm920t）编译它们。
④LIBBOARD
LIBBOARD = board/$(BOARDDIR)/lib$(BOARD).a
LIBBOARD := $(addprefix $(obj),$(LIBBOARD))
……
$(LIBBOARD): depend $(LIBS)
$(MAKE) -C $(dir $(subst $(obj),,$@))
这里LIBBOARD的值是 $(obj)board/samsung/smdk2410/libsmdk2410.a。make执行
board/samsung/smdk2410/目录下的Makefile，生成libsmdk2410.a。
⑤LIBS
LIBS变量中的每个元素使用如下的规则编译得到：
$(LIBS): depend $(SUBDIRS)
$(MAKE) -C $(dir $(subst $(obj),,$@))
上面的规则表明，对于LIBS中的每个成员，都进入相应的子目录执行“make”命令编译它们。例如对于LIBS中的“common/libcommon.a”成员，程序将进入common目录执行Makefile，生成libcommon.a。
⑥LDSCRIPT
LDSCRIPT := $(SRCTREE)/cpu/$(CPU)/u-boot.lds
……
$(LDSCRIPT): depend
$(MAKE) -C $(dir $@) $(notdir $@)
“$(MAKE) -C $(dir $@) $(notdir $@)”命令经过变量替换后就是“make -C cpu/arm920t/
u-boot.lds”。也就是转到cpu/arm920t/目录下，执行“make u-boot.lds”命令。
⑦$(obj)u-boot.lds
$(obj)u-boot.lds: $(LDSCRIPT)
$(CPP) $(CPPFLAGS) $(LDPPFLAGS) -ansi -D__ASSEMBLY__ -P - <$^ >$@
以上执行结果实质上是将cpu/arm920t/u-boot.lds经编译器简单预处理后输出到U-Boot
顶层目录下的u-boot.lds文件。其中的cpu/arm920t/u-boot.lds文件内容如下：
/*输出为ELF文件，小端方式， */
OUTPUT_FORMAT("elf32-littlearm", "elf32-littlearm", "elf32-littlearm")
OUTPUT_ARCH(arm)
ENTRY(_start)
SECTIONS
{
. = 0x00000000;
. = ALIGN(4);
.text :
{
/* cpu/arm920t/start.o放在最前面，保证最先执行的是start.o */
cpu/arm920t/start.o (.text)
/*以下2个文件必须放在前4K，因此也放在前面，其中
board/samsung/mini2440/lowlevel_init.o包含内存初始化所需代码，而
board/samsung/mini2440/nand_read.o包含U-Boot从NAND Flash搬运自身的代码 */
board/samsung/mini2440/lowlevel_init.o (.text)
board/samsung/mini2440/nand_read.o (.text)
/*其他文件的代码段 */
*(.text)
}
/*只读数据段 */
. = ALIGN(4);
.rodata : { *(SORT_BY_ALIGNMENT(SORT_BY_NAME(.rodata*))) }
/*代码段 */
. = ALIGN(4);
.data : { *(.data) }
/* u-boot自定义的got段 */
. = ALIGN(4);
.got : { *(.got) }
. = .;
__u_boot_cmd_start = .; /*将 __u_boot_cmd_start指定为当前地址 */
.u_boot_cmd : { *(.u_boot_cmd) } /* 存放所有U-Boot命令对应的cmd_tbl_t结构
体 */
__u_boot_cmd_end = .; /* 将__u_boot_cmd_end指定为当前地址 */
/* bss段 */
. = ALIGN(4);
__bss_start = .;
.bss (NOLOAD) : { *(.bss) . = ALIGN(4); }
_end = .; /* 将_end指定为当前地址 */
}
u-boot.lds实质上是U-Boot连接脚本。对于生成的U-Boot编译生成的“u-boot”文件，
可以使用objdump命令可以查看它的分段信息：
$ objdump -x u-boot | more
部分输出信息如下：
u-boot: file format elf32-little
u-boot
architecture: UNKNOWN!, flags 0x00000112:
EXEC_P, HAS_SYMS, D_PAGED
start address 0x33f80000
Program Header:
LOAD off 0x00008000 vaddr 0x33f80000 paddr 0x33f80000 align 2**15
filesz 0x0002f99c memsz 0x00072c94 flags rwx
STACK off 0x00000000 vaddr 0x00000000 paddr 0x00000000 align 2**2
filesz 0x00000000 memsz 0x00000000 flags rwx
Sections:
Idx Name Size VMA LMA File off Algn
0 .text 00024f50 33f80000 33f80000 00008000 2**5
CONTENTS, ALLOC, LOAD, READONLY, CODE
1 .rodata 00008b78 33fa4f50 33fa4f50 0002cf50 2**3
CONTENTS, ALLOC, LOAD, READONLY, DATA
2 .data 00001964 33fadac8 33fadac8 00035ac8 2**2
CONTENTS, ALLOC, LOAD, DATA
3 .u_boot_cmd 00000570 33faf42c 33faf42c 0003742c 2**2
CONTENTS, ALLOC, LOAD, DATA
4 .bss 00043294 33fafa00 33fafa00 0003799c 2**8
ALLOC
……
u-boot.lds还跟U-Boot启动阶段复制代码到RAM空间的过程以及U-Boot命令执行过程密切相关，具体请结合U-Boot源代码理解。
编译命令GEN_UBOOT
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) $$UNDEF_SYM $(__OBJS) \
--start-group $(__LIBS) --end-group $(PLATFORM_LIBS) \
-Map u-boot.map -o u-boot
以上命令使用$(LDFLAGS)作为连接脚本，最终生成“u-boot”文件。
5) u-boot.bin文件生成过程
生成u-boot.bin文件的规则如下：
$(obj)u-boot.bin: $(obj)u-boot
$(OBJCOPY) ${OBJCFLAGS} -O binary $< $@
从U-Boot编译输出信息中可以知道上面的命令实质上展开为：
arm-linux-objcopy --gap-fill=0xff -O binary u-boot u-boot.bin
编译命令中的“-O binary”选项指定了输出的文件为二进制文件。而“--gap-fill=0xff”
选项指定使用“0xff”填充段与段间的空闲区域。这条编译命令实现了ELF格式的U-Boot文件
到BIN格式的转换。
6) System.map文件的生成
System.map是U-Boot的符号表，它包含了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
arm-linux-nm u-boot | grep -v '\(compiled\)\|\(\.o$$\)\|\( [aUw]
\)\|\(\.\.ng$$\)\|\(LASH[RL]DI\)' | LC_ALL=C sort > System.map
也就是将arm-linux-nm命令查看u-boot的输出信息经过过滤和排序后输出到System.map。
为了了解System.map文件的作用，打开System.map：
33f80000 T _start
33f80020 t _undefined_instruction
33f80024 t _software_interrupt
33f80028 t _prefetch_abort
33f8002c t _data_abort
33f80030 t _not_used
33f80034 t _irq
33f80038 t _fiq
33f80040 t _TEXT_BASE
33f80044 T _armboot_start
33f80048 T _bss_start
33f8004c T _bss_end
…….
System.map表示的是地址标号到该标号表示的地址的一个映射关系。System.map每一行的格式都是“addr type name”，addr是标号对应的地址值，name是标号名，type表示标号的类型。
U-Boot的编译和运行并不一定要生成System.map，这个文件主要是提供给用户或外部程序调试时使用的。
#########################################################################
顶层Makefile的主要任务就是组织整个u-boot工程的编译，概括可以分为一下几个步骤：
1、首先通过执行make *_config传入$(@:_config=), ARCH, CPU, BOARD, VENDOR, SOC参数（一共六个参数但不一定同时存在），给mkconfig。
2、mkconfig接收到传递过来的参数后，将include头文件夹相应的头文件夹链接好，生成config.h
3、然后执行make分别调用各个子目录的makefile文件，以生成所有的obj文件（包括start.o）和obj库文件*.a。
4、最后，通过链接器把所有目标文件链接起来，生成uboot镜像。不同格式的镜像都是调用相应工具，经由elf镜像间接或者直接的生成的。
167
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
