u-boot的Makefile分析
U-BOOT是一个LINUX下的工程,在编译之前必须已经安装对应体系结构的交叉编译环境,这里只针对ARM,编译器系列软件为 ppc_6xx-。U-BOOT的下载地址: http://sourceforge.net/projects/u-boot
我下载的是1.1.5版本
要了解一个LINUX工程的结构必须看懂Makefile,尤其是顶层的,没办法,UNIX世界就是这么无奈,什么东西都用文档去管理、配置。首先在这方面我是个新手,时间所限只粗浅地看了一些Makefile规则,请各位多多指教。以cpci5200为例:
几个重要的文件分析:
u-boot-1.1.5/Makefile
u-boot-1.1.5/mkconfig
u-boot-1.1.5/config.mk
u-boot根目录下的Makefile文件(u-boot-1.1.5/Makefile)它负责配置u-boot的编译方式,具体说来包括:使用何种指令集,需包含哪些接口驱动、库等。Makefile的内容从上到下分别是:分定义编译环境:使用何种编译器、编译方式、目标文件的生成及它们最终镜像中的链接次序等。Mkconfig和config.mk在接下来的分析中会涉及到。
在编译U-BOOT之前,先要执行
# make cpci5200_config
cpci5200_config是Makefile的一个目标,定义如下:
cpci5200_config: unconfig
@$(MKCONFIG) -a cpci5200 ppc mpc5xxx cpci5200 esd
其中,unconfig定义如下:
unconfig:
@rm -f $(obj)include/config.h $(obj)include/config.mk \
$(obj)board/*/config.tmp $(obj)board/*/*/config.tmp
显然,执行# make cpci5200_config时,先执行unconfig目标,注意不指定输出目标时,obj,src变量均为空,unconfig下面的命令清理上一 次执行make *_config时生成的头文件和makefile的包含文件。主要是include/config.h 和include/config.mk文件。
然后才执行命令
@$(MKCONFIG) -a cpci5200 ppc mpc5xxx cpci5200 esd
$(MKCONFIG)就会被替换成$(SRCTREE)/mkconfig文件路径, MKCONFIG 是顶层目录下的mkcofig脚本文件(u-boot-1.1.5/mkconfig),后面五个是传入的参数。Mkconfig文件的详细分析见文档末尾。
注意一下u-boot对板卡的分类方法:
Target:宿主机平台
Architecture:定义芯片架构(如MIPS、POWERPC、ARM等)
CPU:定义芯片指令集版本(如ARM7、ARM9、ARM11等)
Board:芯片厂商,它细分为两类
[VENDOR]:按厂商划分(如AT9200、S3C44B0等)
[SOC]:按SOC类型(如S3C2440、S3C2410等)
1)对于cpci5200_config而言,mkconfig主要做三件事:
在include文件夹下建立相应的文件(夹)软(符号)连接,
#如果是PPC体系将执行以下操作:
#ln -s asm-ppc asm
#ln -s arch-mpc5xxx asm-ppc/arch
#ln -s proc-armv asm-ppc/proc
生成Makefile包含文件include/config.mk,内容很简单,定义了四个变量:
ARCH = ppc
CPU = mpc5xxx
BOARD = cpci5200
VENDOR = esd
这些变量可以供其它的makefile使用,作为一个基本配置.
生成include/config.h头文件,只有一行:
echo“/* Automatically generated - do not edit */”>>config.h
echo“#include
这两行代码生成一个include/config.h文件,这个文件很简单,只有一句话:
#include <$1.h> 当然这里的$1时要被替换成不同的board名字的.这个取决于我们在主Makefile中xxxx_config目标中的xxxx是什么.
mkconfig脚本文件的执行至此结束
2)分析config.mk的内容:
u-boot根目录下自带一个config.mk文件(u-boot-1.1.5/config.mk),应 该说这才是真正的Makefile,以上介绍的两个脚本Makefile和mkconfig完成了环境配置之后,在该文件中才定义具体的编译规则,所以你会发现在各个子模块(board、 cpu、lib_xxx、net、disk...)目录中的Makefile第一句就是:include $(TOPDIR)/config.mk。文件内容分析如下:
这个文件的功能就是给各个在编译过程中的变量赋值,包括编译执行的函数与编译的时候所带的参数等等。还会根据是否定义了ARCH,CPU,SOC,VENDOR,BOARD来决定是否包含相应位置的config.mk文件,这些个文件里,也是定义了相应的平台在编译的时候应该加的参数。所以如果你为你自己的开发板取了别的名字了,那么就要检查一下这个文件,看一下相应的位置上的config.mk文件有没有,内容是否为你要想的。
l 包含体系,开发板,CPU特定的规则文件:
#指定预编译体系结构选项
ifdef ARCH
sinclude $(TOPDIR)/$(ARCH)_config.mk # include architecture dependend rules
endif
#定义编译时对齐,浮点等选项
ifdef CPU
sinclude $(TOPDIR)/cpu/$(CPU)/config.mk # include CPU specific rules
endif
ifdef SOC
sinclude $(TOPDIR)/cpu/$(CPU)/$(SOC)/config.mk # include SoC specific rules
endif
ifdef VENDOR
BOARDDIR = $(VENDOR)/$(BOARD)
else
BOARDDIR = $(BOARD)
Endif
#指定特定板子的镜像连接时的内存基地址,重要!
ifdef BOARD
sinclude $(TOPDIR)/board/$(BOARDDIR)/config.mk # include board specific rules
endif
l 定义交叉编译链工具
# 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
STRIP = $(CROSS_COMPILE)strip
OBJCOPY = $(CROSS_COMPILE)objcopy
OBJDUMP = $(CROSS_COMPILE)objdump
RANLIB = $(CROSS_COMPILE)RANLIB
l 定义AR选项ARFLAGS,调试选项DBGFLAGS,优化选项OPTFLAGS 预处理选项CPPFLAGS,C编译器选项CFLAGS,连接选项LDFLAGS
#制定了在编译的时候告诉编译器生成的代码的基地址是TEXT_BASE
CPPFLAGS := $(DBGFLAGS) $(OPTFLAGS) $(RELFLAGS) \
-D__KERNEL__ -DTEXT_BASE=$(TEXT_BASE) \
AFLAGS := $(AFLAGS_DEBUG) -D__ASSEMBLY__ $(CPPFLAGS)
#指定了起始地址TEXT_BASE
LDFLAGS += -Bstatic -T $(LDSCRIPT) -Ttext $(TEXT_BASE) $(PLATFORM_LDFLAGS)
l 指定编译规则
ifndef REMOTE_BUILD
%.s: %.S
$(CPP) $(AFLAGS) -o $@ $<
%.o: %.S
$(CC) $(AFLAGS) -c -o $@ $<
%.o: %.c
$(CC) $(CFLAGS) -c -o $@ $<
else
$(obj)%.s: %.S
$(CPP) $(AFLAGS) -o $@ $<
$(obj)%.o: %.S
$(CC) $(AFLAGS) -c -o $@ $<
$(obj)%.o: %.c
$(CC) $(CFLAGS) -c -o $@ $<
endif
3)分析最关键的u-boot ELF文件镜像的生成
Makefile文件中的各个依赖目标分析如下:
l 依赖目标depend :生成各个子目录的.depend文件,.depend列出每个目标文件的依赖文件。生成方法,调用每个子目录的make _depend。
depend dep:
for dir in $(SUBDIRS) ; do $(MAKE) -C $$dir _depend ; done
l 依赖目标version:生成版本信息到版本文件VERSION_FILE中。
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)
l 伪目标SUBDIRS: 执行tools ,examples ,post,post\cpu 子目录下面的make文件。
SUBDIRS = tools \
examples \
post \
post/cpu
.PHONY : $(SUBDIRS)
$(SUBDIRS):
$(MAKE) -C $@ all
l 依赖目标$(OBJS),即cpu/start.o
$(OBJS):
$(MAKE) -C cpu/$(CPU) $(if $(REMOTE_BUILD),$@,$(notdir $@))
l 依赖目标$(LIBS),这个目标太多,都是每个子目录的库文件*.a ,通过执行相应子目录下的make来完成:
$(LIBS):
$(MAKE) -C $(dir $(subst $(obj),,$@))
l 依赖目标$(LDSCRIPT):
LDSCRIPT := $(TOPDIR)/board/$(BOARDDIR)/u-boot.lds
LDFLAGS += -Bstatic -T $(LDSCRIPT) -Ttext $(TEXT_BASE) $(PLATFORM_LDFLAGS)
对于每一种开发板来说,LDSCRIPT即连接脚本文件,例如board/esd/cpci5200/u-boot.lds,定义了连接时各个目标文件是如何组织的。内容如下:
OUTPUT_ARCH(powerpc)
SEARCH_DIR(/lib); SEARCH_DIR(/usr/lib); SEARCH_DIR(/usr/local/lib); SEARCH_DIR(/usr/local/powerpc-any-elf/lib);
/* Do we need any of these for elf?
__DYNAMIC = 0; */
SECTIONS
{
/* Read-only sections, merged into text segment: */
. = + SIZEOF_HEADERS;
.interp : { *(.interp) }
.hash : { *(.hash) }
.dynsym : { *(.dynsym) }
.dynstr : { *(.dynstr) }
.rel.text : { *(.rel.text) }
.rela.text : { *(.rela.text) }
.rel.data : { *(.rel.data) }
.rela.data : { *(.rela.data) }
.rel.rodata : { *(.rel.rodata) }
.rela.rodata : { *(.rela.rodata) }
.rel.got : { *(.rel.got) }
.rela.got : { *(.rela.got) }
.rel.ctors : { *(.rel.ctors) }
.rela.ctors : { *(.rela.ctors) }
.rel.dtors : { *(.rel.dtors) }
.rela.dtors : { *(.rela.dtors) }
.rel.bss : { *(.rel.bss) }
.rela.bss : { *(.rela.bss) }
.rel.plt : { *(.rel.plt) }
.rela.plt : { *(.rela.plt) }
.init : { *(.init) }
.plt : { *(.plt) }
#.text的基地址由LDFLAGS中-Ttext $(TEXT_BASE)指定
.text :
{
#start.o为首
cpu/mpc5xxx/start.o (.text)
*(.text)
*(.fixup)
*(.got1)
. = ALIGN(16);
*(.rodata)
*(.rodata1)
*(.rodata.str1.4)
*(.eh_frame)
}
.fini : { *(.fini) } =0
.ctors : { *(.ctors) }
.dtors : { *(.dtors) }
/* Read-write section, merged into data segment: */
. = (. + 0x0FFF) & 0xFFFFF000;
_erotext = .;
PROVIDE (erotext = .);
.reloc :
{
*(.got)
_GOT2_TABLE_ = .;
*(.got2)
_FIXUP_TABLE_ = .;
*(.fixup)
}
__got2_entries = (_FIXUP_TABLE_ - _GOT2_TABLE_) >> 2;
__fixup_entries = (. - _FIXUP_TABLE_) >> 2;
.data :
{
*(.data)
*(.data1)
*(.sdata)
*(.sdata2)
*(.dynamic)
CONSTRUCTORS
}
_edata = .;
PROVIDE (edata = .);
. = .;
__u_boot_cmd_start = .;
.u_boot_cmd : { *(.u_boot_cmd) }
__u_boot_cmd_end = .;
. = .;
__start___ex_table = .;
__ex_table : { *(__ex_table) }
__stop___ex_table = .;
. = ALIGN(4096);
__init_begin = .;
.text.init : { *(.text.init) }
.data.init : { *(.data.init) }
. = ALIGN(4096);
__init_end = .;
__bss_start = .;
.bss :
{
*(.sbss) *(.scommon)
*(.dynbss)
*(.bss)
*(COMMON)
}
_end = . ;
PROVIDE (end = .);
}
整个makefile剩下的内容全部是各种不同的开发板的*_config:目标的定义了。
对于各子目录的makefile文件,主要是生成*.o文件然后执行AR生成对应的库文件。
概括起来,工程的编译流程也就 是通过执行执行一个make *_config传入ARCH,CPU,BOARD,SOC参数,mkconfig根据参数将include头文件夹相应的头文件夹连接好,生成 config.h。然后执行make分别调用各子目录的makefile 生成所有的obj文件和obj库文件*.a. 最后连接所有目标文件,生成镜像。不同格式的镜像都是调用相应工具由elf镜像直接或者间接生成的。
Mkconfig源码注解
#下面这一行的内容,表示这个shell脚本的解释器是/bin/sh,给的解释器的参数为-e,这个#参数的意思就是,当shell返回值为非零值的时候,shell马上退出执行。在shell脚本里也
#可以没有这一行,这一行不是必须的,如果没有这一行的话,那么shell脚本就会用当前运
#行环境下的默认的shell来执行。
#!/bin/sh -e
# Script to create header files and links to configure
# U-Boot for a specific board.
#
# Parameters: Target Architecture CPU Board [VENDOR] [SOC]
#
# (C) 2002-2006 DENX Software Engineering, Wolfgang Denk
#
#APPEND变量与BOARD_NAME变量都设置了默认值,如果后面对变量值有修改就以后面的为准,#没有就是默认值了。这里的APPEND的参数的意义,实际上就是用来标识是否产生一个新的配#置文件,还是直接把生成的配置信息写到旧文件后面。
APPEND=no # Default: Create new config file
BOARD_NAME="" # Name to print in make output
#$#代表的是传入脚本的参数的个数,-gt表示是如果左边参数比右边参数大,则返回true,
#否则为false。$1代表的是传入的第一个参数的内容,$2表示传入的第二个参数的内容,以
#此类推。shift表示参数都左移一位,原来的$3变为$2,$2为$1,$1的内容则被丢弃。这个
#地方,实际上是处理了一些附加的参数的问题,如果是--,则仅丢弃不做其它处理;如果是#-a,则把APPEND的值置为yes;如果是-n,则表示后面跟的是板子的名字。${a%%pattern}是#shell中的一个替换语法,表示把变量a中的内容,从右至左,最大程度上把符合pattern样
#式的字符串删掉。这里可以看出,如果-n后面跟的是类似于smdk2410_config的参数的话,
#则最后会变成smdk2410;如果是其它的值,则退出循环,不执行了。在Makefile中的动作,#其实并不会触发这里的处理逻辑,估计这里是作者为了调试方便,需要单独运行此脚本的时#候,加的一些对参数的处理。
while [ $# -gt 0 ] ; do
case "$1" in
--) shift ; break ;;
-a) shift ; APPEND=yes ;;
-n) shift ; BOARD_NAME="${1%%_config}" ; shift ;;
*) break ;;
esac
done
#第一行的语法表示如果BOARD_NAME没有被设置过,则把它置为变量1的值。然后进行参数个
#数的判断,-lt表示less than则返回true,也就是如果参数少于4个或是参数大于6个,则退#出,不执行。如果没有退出执行的话,则输出Configuring for ${BOARD_NAME} board...这#句话,其中${BOARD_NAME}会被替换成用户输入的板子的名字。
[ "${BOARD_NAME}" ] || BOARD_NAME="$1"
[ $# -lt 4 ] && exit 1
[ $# -gt 6 ] && exit 1
echo "Configuring for ${BOARD_NAME} board..."
#
# Create link to architecture specific headers
#
#当用户指定的$OBJTREE与$SRCTREE不一致的时候会做如下一些事情:
#在$OBJTREE下建立include文件夹
#在$OBJTREE下建立include2文件夹
#进入到include2文件夹,其实就是$OBJTREE文件夹下的include2
#删除asm,其实往后看就知道了,这是一个文件夹,是以link的方式建立的
#然后建立一个asm的文件夹,这个文件夹是指向${SRCTREE}/include/asm-$2的,$2这个参数#多指CPU架构类型如:PPC,ARM。
#给变量LNPREFIX赋值。这个变量在以后的执行会用到,所以这里给的asm的位置,是相对于
#后来执行的时候,当前工作目录与asm之间的关系来定的。
#进入到$OBJTREE中的include文件夹(之前是在include2里)。
#删除掉asm-$2文件夹,其实就是asm-arm文件夹。
#删除掉asm文件夹
#建立一个新的asm-$2文件夹,其实就是asm-arm文件夹
#建立一个名为asm的link,这个link指向新建立的asm-arm文件夹。
#现在看一下整个目录大概的结构:
${OBJTREE}
Include
asm-arm
asm -> ./asm-arm
include2
asm -> ${SRCTREE}/include/asm-arm
#可以看到,目前在include下的asm-arm与asm其实是同一个文件夹,并且内容为空,include2
#文件夹下的asm是指向了源码树中的${SRCTREE}/include/asm-arm文件夹。
#如果"$SRCTREE"与"$OBJTREE"是同一个文件(大多数情况下,咱们都是这种方式来编译的),#那么就是仅仅在include文件夹下,建立一个名为asm的link,直接指向asm-$2,即asm-arm。
#最后删除asm-arm/arch文件夹。
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="../../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
rm -f asm-$2/arch
#下面第一句中连接两个判断的-o,相当于or的意思,就是表示的“或”。意思就是如果第6
#个参数为空或是为NULL,则在include下建立一个asm-$2/arch的link,指向#${LNPREFIX}arch-$3,否则就在include下建立一个asm-$2/arch的link,指向#${LNPREFIX}arch-$6
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
#如果第二个参数是arm的话,则删除include/asm-$2/proc文件,实际上就是#include/asm-arm/proc文件夹,建立一个新的link,在include/asm-$2/proc处,也即#include/asm-arm/proc,指向${LNPREFIX}proc-armv文件夹
if [ "$2" = "arm" ] ; then
rm -f asm-$2/proc
ln -s ${LNPREFIX}proc-armv asm-$2/proc
fi
#
# Create include file for Make
#
#第一行,输出ARCH = $2,即ARCH = arm到config.mk,也即include/config.mk,注意这里
#用了一个>,它表示重新生成一个config.mk文件,如果有旧的,则覆盖
#第二行,同理,输出CPU = arm920t到config.mk中
#第三行,同理,输出BOARD = smdk2410到config.mk
#第四行,判断,如果$5不为空,且$5的值不为NULL,
#则把VENDOR = $5的值输出到config.mk中
#第五行,同理,把SOC输出到config.mk中
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
#
# Create board specific header file
#
#如果APPEND的值为yes,则写入一空行到已经存在的config.h中,也即include/config.h中,#如果不是,则生成一个新的config.h,如果旧的文件存在,则覆盖。
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
echo "#include
exit 0