uboot 顶层makefile细节分析

uboot的源文件众多，学习庞然大物首先找到脊椎--顶层的makfile，逐一破解。但是，uboot的makefile同样是一个庞然大物，所以也要找到它的主线。倘若过分专注部分细节，很难做到把握全局，实际上也不可能很好理解细节。

介于此，笔者已经写了一篇uboot makefile整体解析，可以先从主体上把握makefile。然后，再读这篇makefile强大功能实现的细节，才能做到循序渐进。

说明：uboot顶层makefile的注释机会全部源码都搬上来了，而注释都是黑体加粗以与源码有强烈的区别。

VERSION = 1 //主版本号

PATCHLEVEL = 1 //次级版本号

SUBLEVEL = 6

EXTRAVERSION = //版本号扩展

U_BOOT_VERSION = $(VERSION).$ (PATCHLEVEL). $(SUBLEVEL)$ (EXTRAVERSION) //这个Uboot的版本为1.1.6

VERSION_FILE = $(obj)include/version_autogenerated.h

//生成uboot的版本信息

HOSTARCH := $(shell uname -m | \

sed -e s/i.86/i386/ \

-e s/sun4u/sparc64/ \

-e s/arm.*/arm/ \

-e s/sa110/arm/ \

-e s/powerpc/ppc/ \

-e s/macppc/ppc/)

//获取主机架构，笔者电脑是酷睿双核，#uname –m输出结构是i686，执行替换命令sed -e s/i.86/i386/后，就变成了i386，

//并且将这个值保存在HOSTARCH变量中。

HOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]' | \

sed -e 's/ $cygwin$ .*/cygwin/')

//获取主机操作系统，执行#uname -s可以查看自己的操作系统类型，笔者使用的操作系统是Linux。tr '[:upper:]' '[:lower:]'

//具有大写转小写的功能，所以最终HOSTOS的值为linux。

export HOSTARCH HOSTOS

//将两个变量导出，可以供嵌套的makefile调用

# Deal with colliding definitions from tcsh etc.

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.

//上边的注释讲的是uboot支持编译时，将目标文件生成在其他的目录中，这样可以保持源文件的干净，另外从目标

//文件的生成目录中查看生成的文件时一目了然。如果想要这样做，提供了两种方法。第一种方法是执行命令

//#make O=/tmp/build all；第二种方法，可以先在命令行模式定义环境变量export BUILD_DIR=/tmp/build'，

//然后再执行make就行了。通常懒惰的编译方式就是让生成的目标文件和源文件混在一起，那么BUILD_DIR就会没定义。

ifdef O

ifeq ("$(origin O)", "command line")

BUILD_DIR := $(O)

endif

//这是第一种方法的实现过程，$(origin O)是输出变量O的定义来源，假设在命令行模式输//入#make O=/tmp/build all

//来编译，那么O的定义来源是命令行，函数的输出是command line。

ifneq ($(BUILD_DIR),)

//倘若BUILD_DIR定义过了，也就是不希望目标文件与源文件混在一起，那么直到“endif # //ifneq ($(BUILD_DIR),)”

//的内容都有效；倘若没有定义BUILD_DIR，那么这部分代码将不起作用。

saved-output := $(BUILD_DIR)

// 将BUILD_DIR保存在saved-output变量中

# Attempt to create a output directory.

$(shell [ -d$ {BUILD_DIR} ] || mkdir -p ${BUILD_DIR})

//-d是判断BUILD_DIR是否存在，倘若不存在就就创建。mkdir的-p参数代表若路径中的

//某些目录不存在，也一并创建

# Verify if it was successful.

//核查BUILD_DIR是否已经创建

BUILD_DIR := $(shell cd$ (BUILD_DIR) && /bin/pwd)

//试图进入$(BUILD_DIR)，倘若能进入，则将它的路径赋给BUILD_DIR，注意这时的BUILD_DIR已经是一个真实存在

//目录的代言人，而之前的只是希望创建的目录。需要说明的是倘若BUILD_DIR还没有创建，那么cd $(BUILD_DIR)将执

//行错误，返回值是空，虽然这时发生错误，但是编译会忽略这个错误还能继续进行。

$(if$ (BUILD_DIR),, $(error output directory "$ (saved-output)" does not exist))

// 如果没有创建成功，就执行error函数，输出信息output directory "$(saved-output)" does not exist)，然后编译终止

endif # ifneq ($(BUILD_DIR),)

OBJTREE := $(if$ (BUILD_DIR), $(BUILD_DIR),$ (CURDIR))

//如果BUILD_DIR不为空，目标目录就等于BUILD_DIR；倘若没定义，就取为当前目录

SRCTREE := $(CURDIR)//源文件目录等于当前文件夹

TOPDIR := $(SRCTREE)//顶层目录等于源文件目录

LNDIR := $(OBJTREE) //连接目录等于BUILD_DIR

export TOPDIR SRCTREE OBJTREE//将这三个变量导出

MKCONFIG := $(SRCTREE)/mkconfig//指定mkconfig的位置

export MKCONFIG //将MKCONFIG变量导出

ifneq ( $(OBJTREE),$ (SRCTREE)) //如果目标目录和源文件目录不相等

REMOTE_BUILD := 1 //就定义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中的定义由于受下边//红色加粗判断语句的影响，只有

//在“make　*_config”执行后（$(OBJTREE)/include/config.mk就会存在），再执行的make程序才能将config.mk包含进顶

//层makefile中。而在没有先执行“make　*_config”或者$(OBJTREE)/include/config.mk不存在的情况下，如果想执行unconfig

//, clean, clobber, distclean，而这些命令用到了变量obj、src，所以这里提前包含进去。

//但是我也有疑惑，为什么不能将顶层目录的config.mk包含在全局中，设计者为什么要把它放在条件执行里边。

ifneq ( $(OBJTREE),$ (SRCTREE))

obj := $(OBJTREE)/

src := $(SRCTREE)/

else

obj :=

src :=

endif

export obj src

//定义变量obj和src，并将这两个变量导出，obj是编译目标文件的前缀，从而实现生成的目标文件在于源文件相区别的目录中

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

ifeq ( $(OBJTREE)/include/config.mk,$ (wildcard $(OBJTREE)/include/config.mk))

//这个ifeq横跨的范围非常广，用红色加粗字体表明。只有$(OBJTREE)/include/config.mk存在(也就是说已经

//执行了make *.config)的情况下，这部分包含的内容才有效

# load ARCH, BOARD, and CPU configuration

include $(OBJTREE)/include/config.mk //将make *_config生成的config.mk文件包含进来

export ARCH CPU BOARD VENDOR SOC //导出5个变量以供其他子目录的makefile调用

ifndef CROSS_COMPILE

ifeq ($(HOSTARCH),ppc)

CROSS_COMPILE =

else

ifeq ($(ARCH),ppc)

CROSS_COMPILE = powerpc-linux-

endif

ifeq ($(ARCH),arm)

CROSS_COMPILE = arm-linux- //根据变量ARCH可以使这行满足条件，确定了交叉编译使//用arm-linux-

endif

ifeq ($(ARCH),i386)

ifeq ($(HOSTARCH),i386)

CROSS_COMPILE =

else

CROSS_COMPILE = i386-linux-

endif

ifeq ($(ARCH),mips)

CROSS_COMPILE = mips_4KC-

endif

ifeq ($(ARCH),nios)

CROSS_COMPILE = nios-elf-

endif

ifeq ($(ARCH),nios2)

CROSS_COMPILE = nios2-elf-

endif

ifeq ($(ARCH),m68k)

CROSS_COMPILE = m68k-elf-

endif

ifeq ($(ARCH),microblaze)

CROSS_COMPILE = mb-

endif

ifeq ($(ARCH),blackfin)

CROSS_COMPILE = bfin-elf-

endif

ifeq ($(ARCH),avr32)

CROSS_COMPILE = avr32-

endif

export CROSS_COMPILE //导出交叉编译变量

# load other configuration

include $(TOPDIR)/config.mk //将顶层的config.mk也包含进来

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

# U-Boot objects....order is important (i.e. start must be first)

OBJS = cpu/$(CPU)/start.o

ifeq ($(CPU),i386)

OBJS += cpu/$(CPU)/start16.o

OBJS += cpu/$(CPU)/reset.o

endif

ifeq ($(CPU),ppc4xx)

OBJS += cpu/$(CPU)/resetvec.o

endif

ifeq ($(CPU),mpc83xx)

OBJS += cpu/$(CPU)/resetvec.o

endif

ifeq ($(CPU),mpc85xx)

OBJS += cpu/$(CPU)/resetvec.o

endif

ifeq ($(CPU),mpc86xx)

OBJS += cpu/$(CPU)/resetvec.o

endif

ifeq ($(CPU),bf533)

OBJS += cpu/ $(CPU)/start1.o cpu/$ (CPU)/interrupt.o cpu/$(CPU)/cache.o

OBJS += cpu/ $(CPU)/cplbhdlr.o cpu/$ (CPU)/cplbmgr.o cpu/$(CPU)/flush.o

endif

//确定目标文件构成

OBJS := $(addprefix$ (obj),$(OBJS))

//给待生成的目标文件带上路径

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))

//给待生成的库文件带上路径

.PHONY : $(LIBS)

//将带生成的库文件作为伪目标来处理

# Add GCC lib

PLATFORM_LIBS += -L $(shell dirname `$ (CC) $(CFLAGS) -print-libgcc-file-name`) -lgcc

//添加系统标准库

# The "tools" are needed early, so put this first

# Don't include stuff already done in $(LIBS)

SUBDIRS = tools \

examples \

post \

post/cpu

.PHONY : $(SUBDIRS)

//定义make执行要首先处理的目录

ifeq ($(CONFIG_NAND_U_BOOT),y)

NAND_SPL = nand_spl

U_BOOT_NAND = $(obj)u-boot-nand.bin

endif

//假若定义了CONFIG_NAND_U_BOOT，那么将总目标all中添加$(obj)u-boot-nand.bin，否则不添加

__OBJS := $(subst$ (obj),,$(OBJS))

__LIBS := $(subst$ (obj),,$(LIBS))

//OBJS、LIBS除去$(obj)部分的路径

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

ALL = $(obj)u-boot.srec$ (obj)u-boot.bin $(obj)System.map$ (U_BOOT_NAND)

//总目标的构成，也可以人为添加其他的目标

all: $(ALL)

//定义总目标all

$(obj)u-boot.hex:$ (obj)u-boot

$(OBJCOPY)$ {OBJCFLAGS} -O ihex $<$ @

//生成16进制的可执行程序

$(obj)u-boot.srec:$ (obj)u-boot

$(OBJCOPY)$ {OBJCFLAGS} -O srec $<$ @

$(obj)u-boot.bin:$ (obj)u-boot

$(OBJCOPY)$ {OBJCFLAGS} -O binary $<$ @

//生成2进制的可执行程序

$(obj)u-boot.img:$ (obj)u-boot.bin

./tools/mkimage -A $(ARCH) -T firmware -C none \

-a $(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.dis:$ (obj)u-boot

$(OBJDUMP) -d$ < > $@

//生成反汇编文件u-boot.dis

$(obj)u-boot: depend version$ (SUBDIRS) $(OBJS)$ (LIBS) $(LDSCRIPT)

UNDEF_SYM=` $(OBJDUMP) -x$ (LIBS) |sed -n -e 's/.* $__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

//生成elf格式的u-boot文件

$(OBJS):

$(MAKE) -C cpu/$ (CPU) $(if$ (REMOTE_BUILD), $@,$ (notdir $@))

//中间目标文件生成

$(LIBS):

$(MAKE) -C$ (dir $(subst$ (obj),,$@))

//中间库文件生成

$(SUBDIRS):

$(MAKE) -C$ @ all

//SUBDIRS目录处理

$(NAND_SPL): version

$(MAKE) -C nand_spl/board/$ (BOARDDIR) all

$(U_BOOT_NAND):$ (NAND_SPL) $(obj)u-boot.bin

cat $(obj)nand_spl/u-boot-spl-16k.bin$ (obj)u-boot.bin > $(obj)u-boot-nand.bin

version:

@echo -n "#define U_BOOT_VERSION \"U-Boot " > $(VERSION_FILE); \

echo -n " $(U_BOOT_VERSION)" >>$ (VERSION_FILE); \

echo -n $(shell$ (CONFIG_SHELL) $(TOPDIR)/tools/setlocalversion \

$(TOPDIR)) >>$ (VERSION_FILE); \

echo "\"" >> $(VERSION_FILE)

//版本头文件生成

gdbtools:

$(MAKE) -C tools/gdb all || exit 1

updater:

$(MAKE) -C tools/updater all || exit 1

env:

$(MAKE) -C tools/env all || exit 1

depend dep:

for dir in $(SUBDIRS) ; do$ (MAKE) -C $$dir _depend ; done

//执行make depend或者make dep都能触发命令

tags ctags:

ctags -w -o $(OBJTREE)/ctags `find$ (SUBDIRS) include \

lib_generic board/ $(BOARDDIR) cpu/$ (CPU) lib_$(ARCH) \

fs/cramfs fs/fat fs/fdos fs/jffs2 \

net disk rtc dtt drivers drivers/sk98lin common \

$-name CVS -prune$ -o $-name '*.[ch]' -print$ `

etags:

etags -a -o $(OBJTREE)/etags `find$ (SUBDIRS) include \

lib_generic board/ $(BOARDDIR) cpu/$ (CPU) lib_$(ARCH) \

fs/cramfs fs/fat fs/fdos fs/jffs2 \

net disk rtc dtt drivers drivers/sk98lin common \

$-name CVS -prune$ -o $-name '*.[ch]' -print$ `

$(obj)System.map:$ (obj)u-boot

@ $(NM)$ < | \

grep -v ' $compiled$ \| $\.o$$$ \| $[aUw]$ \| $\.\.ng$$$ \| $LASH[RL]DI$ ' | \

sort > $(obj)System.map

//生成map文件

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

else

all $(obj)u-boot.hex$ (obj)u-boot.srec $(obj)u-boot.bin \

$(obj)u-boot.img$ (obj)u-boot.dis $(obj)u-boot \

$(SUBDIRS) version gdbtools updater env depend \

dep tags ctags etags $(obj)System.map:

@echo "System not configured - see README" >&2

@ exit 1

endif

//倘若没有include $(OBJTREE)/include/config.mk 文件，将打印出错误信息“System not configured

//- see README”，并且make程序也结束

.PHONY : CHANGELOG

CHANGELOG:

git log --no-merges U-Boot-1_1_5.. | \

unexpand -a | sed -e 's/\s\s*$$//' > $@

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

unconfig:

@rm -f $(obj)include/config.h$ (obj)include/config.mk \

$(obj)board/*/config.tmp$ (obj)board/*/*/config.tmp

//删除配置文件，即与make *_config过程相反

//剩下的*_config，属于相似内容，只举一个常见的smdk2410_config，以作说明

smdk2410_config : unconfig
@ $(MKCONFIG)$ (@:_config=) arm arm920t smdk2410 NULL s3c24x0

//执行make smdk2410_config，就会调用顶层目录中的mkconfig（shell脚本），同时给这个脚本传入参数

//arm arm920t smdk2410 NULL s3c24x0。mkconfig脚本根据这些传入的参数生成与开发板相适应的一系列配置文件。

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

//不要忘记makfile的最后边，还有一部分很重要的内容

clean: //clean删除
find $(OBJTREE) -type f \ $ -name 'core' -o -name '*.bak' -o -name '*~' \ -o -name '*.o' -o -name '*.a' $ -print \ | xargs rm -f rm -f$ (obj)examples/hello_world $(obj)examples/timer \$ (obj)examples/eepro100_eeprom $(obj)examples/sched \$ (obj)examples/mem_to_mem_idma2intr $(obj)examples/82559_eeprom \$ (obj)examples/smc91111_eeprom $(obj)examples/interrupt \$ (obj)examples/test_burst
rm -f $(obj)tools/img2srec$ (obj)tools/mkimage $(obj)tools/envcrc \$ (obj)tools/gen_eth_addr
rm -f $(obj)tools/mpc86x_clk$ (obj)tools/ncb
rm -f $(obj)tools/easylogo/easylogo$ (obj)tools/bmp_logo
rm -f $(obj)tools/gdb/astest$ (obj)tools/gdb/gdbcont $(obj)tools/gdb/gdbsend rm -f$ (obj)tools/env/fw_printenv $(obj)tools/env/fw_setenv rm -f$ (obj)board/cray/L1/bootscript.c $(obj)board/cray/L1/bootscript.image rm -f$ (obj)board/netstar/eeprom $(obj)board/netstar/crcek$ (obj)board/netstar/crcit
rm -f $(obj)board/netstar/*.srec$ (obj)board/netstar/*.bin
rm -f $(obj)board/trab/trab_fkt$ (obj)board/voiceblue/eeprom
rm -f $(obj)board/integratorap/u-boot.lds$ (obj)board/integratorcp/u-boot.lds
rm -f $(obj)include/bmp_logo.h rm -f$ (obj)nand_spl/u-boot-spl $(obj)nand_spl/u-boot-spl.map

clobber: clean //除了调用clean删除，还要再执行额外的删除命令
find $(OBJTREE) -type f $ -name .depend \ -o -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)include/version_autogenerated.h rm -fr$ (obj)*.*~
rm -f $(obj)u-boot$ (obj)u-boot.map $(obj)u-boot.hex$ (ALL)
rm -f $(obj)tools/crc32.c$ (obj)tools/environment.c $(obj)tools/env/crc32.c rm -f$ (obj)tools/inca-swap-bytes $(obj)cpu/mpc824x/bedbug_603e.c rm -f$ (obj)include/asm/proc $(obj)include/asm/arch$ (obj)include/asm
[ ! -d $(OBJTREE)/nand_spl ] || find$ (obj)nand_spl -lname "*" -print | xargs rm -f

ifeq ( $(OBJTREE),$ (SRCTREE))
mrproper \
distclean: clobber unconfig //倘若目标目录与源目录相同，distclean调用clobber unconfig来删除
else
mrproper \
distclean: clobber unconfig //倘若目标目录与源目录不相同，distclean调用clobber unconfig来删除
rm -rf $(OBJTREE)/* //而且，还要删除OBJTREE目录下的所有内容
endif