U-boot移植
需要阅读的文档:u-boot根目录下的README 文件。
1、u-boot工程的总体结构:
源代码组织
board 平台依赖 存放电路板相关的目录文件,每一套板子对应一个目录,如spear(arm926ejs)
cpu 平台依赖 存放CPU相关的目录文件,每一款CPU对应一个目录,例如:arm926ejs、 mpc8xx、mips、i386等目录
lib_arm 平台依赖 存放对ARM体系结构通用的文件,主要用于实现ARM平台通用的函数,如软件浮点
lib_ppc 平台依赖 存放对PowerPC体系结构通用的文件,主要用于实现PowerPC平台通用的函数
common 通用 通用的多功能函数实现,如环境,命令,控制台相关的函数实现。
include 通用 头文件和开发板配置文件,所有开发板的配置文件都在configs目录下
lib_generic 通用 通用库函数的实现
net 通用 存放网络协议的程序
drivers 通用 通用的设备驱动程序,主要有以太网接口的驱动,nand驱动
examples 例程 一些独立运行的应用程序的例子,例如helloworld
tools 工具 存放制作S-Record或者u-boot格式的映像等工具,例如mkimage
doc 文档 开发使用文档
.......
makefile简要分析
所有这些目录的编译连接都是由顶层目录的makefile来确定的。
在执行make之前,先要执行make $(board)_config 对工程进行配置,以确定特定于目标板的各个子目录和头文件。$(board)_config:是makefile 中的一个伪目标,它传入指定的“Target Architecture CPU Board [VENDOR] [SOC]”参数去执行mkconfig脚本。
这个脚本的主要功能在于连接目标板平台相关的头文件夹,生成config.h文件包含板子的配置头文件。使得makefile能根据目标板的这些参数去编译正确的平台相关的子目录。
以spear310板为例,顺序分析Makefile大致的流程及结构
1)首先定义了源码及生成的目标文件存放的目录,目标文件存放目录BUILD_DIR可以通过makeO=dir 指定。如果没有指定,则设定为源码顶层目录。一般编译的时候不指定输出目录,则BUILD_DIR为空。其它目录变量定义如下:
#OBJTREE和LNDIR为存放生成文件的目录,TOPDIR与SRCTREE为源码所在目录
OBJTREE := $(if$(BUILD_DIR),$(BUILD_DIR),$(CURDIR))
SRCTREE := $(CURDIR)
TOPDIR := $(SRCTREE)
LNDIR := $(OBJTREE)
export TOPDIR SRCTREE OBJTREE
2)定义变量MKCONFIG:这个变量指向一个脚本,即顶层目录的mkconfig。
MKCONFIG := $(SRCTREE)/mkconfig
export MKCONFIG
在编译u-boot之前,先要执行
# make spear310_config
spear310_config是Makefile的一个目标,定义如下:
spear310_config : unconfig
@$(MKCONFIG) $(@:_config=) arm arm926ejs spear310 spear spear
显然,执行#make spear310_config时,先执行unconfig目标,注意不指定输出目标时,obj,src变量均为空,unconfig下面的命令清理上一次执行make *_config时生成的头文件和makefile的包含文件。主要是include/config.h和include/config.mk文件。然后才执行命令。
MKCONFIG 是顶层目录下的mkcofig脚本文件,后面五个是传入的参数”arm arm926ejs spear310 spear spear”(ARCH CPU BOARD VENDOR SOC),在include文件夹下建立相应的文件夹软连接。
#ln –s asm-arm asm
#ln –s arch-spear310 asm-arm/arch
#ln –s proc-armv asm-arm/proc
然后生成Makefile包含文件include/config.mk,内容很简单,定义了五个变量:
ARCH = arm
CPU = arm926ejs
BOARD = spear310
VENDOR = spear
SOC = spear
最后生成include/config.h头文件,只有一行:
/*Automatically generated - do not edit */
#include"config/spear310.h"
mkconfig脚本文件的执行至此结束,继续分析Makefile剩下部分。
3)包含include/config.mk,其实也就相当于在Makefile里定义了上面四个变量而已。
4) 指定交叉编译器前缀:
ifeq($(ARCH),arm)#这里根据ARCH变量,指定编译器前缀。
CROSS_COMPILE = arm-linux-
endif
5)包含config.mk:
#包含顶层目录下的config.mk,这个文件里面主要定义了交叉编译器及选项和编译规则
# load otherconfiguration
include$(TOPDIR)/config.mk
下面分析config.mk的内容:
@包含体系,开发板,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# include SoC specific rules
sinclude$(TOPDIR)/cpu/$(CPU)/$(SOC)/config.mk
endif
ifdef VENDOR
BOARDDIR = $(VENDOR)/$(BOARD)
else
BOARDDIR = $(BOARD)
endif
ifdef BOARD #指定特定板子的镜像连接时的内存基地址,重要!
sinclude$(TOPDIR)/board/$(BOARDDIR)/config.mk # include board specific rules
endif
@/board/spear/spear310/config.mk分析:
TEXT_BASE = 0x01000000 #指定镜像link时的内存基地址
###### Environment variables inNAND
ifeq ($(ENV),NAND) #指定SPEAr310 Board’s Envirenment存放于Nand Flash
PLATFORM_RELFLAGS +=-DENV_IN_NAND
endif
ifeq ($(FLASH),PNOR) #指定SPEAr310 Board’s ROM is PNOR Flash
PLATFORM_RELFLAGS +=-DPNOR_FLASH
endif
ifeq ($(CONSOLE),USB) #指定SPEAr310 Board’s CONSOLE use USB
PLATFORM_RELFLAGS +=-DTTY_OVER_USB
endif
@定义交叉编译链工具
# 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
@部分编译、链接选项,定义AR选项ARFLAGS,调试选项DBGFLAGS,优化选项OPTFLAGS
#预处理选项CPPFLAGS,C编译器选项CFLAGS,连接选项LDFLAGS
@指定编译规则:
$(obj)%.s: %.S
$(CPP) $(AFLAGS) -o $@ $<
$(obj)%.o: %.S
$(CC) $(AFLAGS) -c -o $@ $<
$(obj)%.o: %.c
$(CC) $(CFLAGS) -c -o $@ $<
config.mk执行完毕,回到顶层makefile文件;
6)U-boot需要的目标文件。
OBJS = cpu/$(CPU)/start.o # 顺序很重要,start.o必须放第一位
7)需要的库文件:
LIBS =lib_generic/libgeneric.a
LIBS += $(shell if [ -f board/$(VENDOR)/common/Makefile]; then echo \
"board/$(VENDOR)/common/lib$(VENDOR).a";fi)
LIBS += board/$(BOARDDIR)/lib$(BOARD).a
LIBS += cpu/$(CPU)/lib$(CPU).a
ifdef SOC
LIBS += cpu/$(CPU)/$(SOC)/lib$(SOC).a
endif
ifeq ($(CPU),ixp)
LIBS += cpu/ixp/npe/libnpe.a
endif
LIBS += lib_$(ARCH)/lib$(ARCH).a
LIBS += fs/cramfs/libcramfs.a fs/fat/libfat.afs/fdos/libfdos.a fs/jffs2/libjffs2.a \
fs/reiserfs/libreiserfs.afs/ext2/libext2fs.a fs/yaffs2/libyaffs2.a
LIBS += net/libnet.a
LIBS += disk/libdisk.a
LIBS += drivers/bios_emulator/libatibiosemu.a
LIBS += drivers/block/libblock.a
LIBS += drivers/hwmon/libhwmon.a
LIBS += drivers/i2c/libi2c.a
LIBS += drivers/input/libinput.a
LIBS += drivers/misc/libmisc.a
LIBS += drivers/mtd/libmtd.a
LIBS += drivers/mtd/nand/libnand.a
LIBS += drivers/mtd/nand_legacy/libnand_legacy.a
LIBS += drivers/mtd/onenand/libonenand.a
LIBS += drivers/net/libnet.a
LIBS += drivers/net/sk98lin/libsk98lin.a
LIBS += drivers/pci/libpci.a
LIBS += drivers/pcmcia/libpcmcia.a
ifeq ($(CPU),mpc83xx)
LIBS += drivers/qe/qe.a
endif
ifeq ($(CPU),mpc85xx)
LIBS += drivers/qe/qe.a
endif
LIBS += drivers/rtc/librtc.a
LIBS += drivers/serial/libserial.a
LIBS += drivers/usb/libusb.a
LIBS += drivers/video/libvideo.a
LIBS += post/libpost.a post/drivers/libpostdrivers.a
LIBS += $(shell if [ -d post/lib_$(ARCH) ]; then echo \
"post/lib_$(ARCH)/libpost$(ARCH).a";fi)
LIBS += $(shell if [ -d post/lib_$(ARCH)/fpu ]; then echo\
"post/lib_$(ARCH)/fpu/libpost$(ARCH)fpu.a";fi)
LIBS += $(shell if [ -d post/cpu/$(CPU) ]; then echo \
"post/cpu/$(CPU)/libpost$(CPU).a";fi)
LIBS += $(shell if [ -d post/board/$(BOARDDIR) ]; thenecho \
"post/board/$(BOARDDIR)/libpost$(BOARD).a";fi)
LIBS += common/libcommon.a
LIBS += libfdt/libfdt.a
根据上面的include/config.mk文件定义的ARCH、CPU、BOARD、VENDOR、SOC这些变量。硬件平台依赖的目录文件可以根据这些定义来确定。SPEAr310平台相关目录及对应生成的库文件如下。
cpu/$(CPU)/start.o
board/spear/common/ :库文件board/ spear/common/libspear.a
board/spear/spear310/ :库文件board/ spear/spear310/libspear310.a
cpu/arm926ejs/ :库文件cpu/ arm926ejs /libarm926ejs.a
cpu/arm926ejs/spear/ :库文件cpu/ arm926ejs /spear/libspear.a
lib_arm/ :库文件lib_arm/libarm.a
显然这几个目标文件(库)对应的目录跟平台相关,移植时主要考虑。
8)最终生成的各种镜像文件:
ALL += $(obj)u-boot.srec $(obj)u-boot.bin$(obj)System.map $(U_BOOT_NAND) $(obj)u-boot.img
all: $(ALL)
$(obj)u-boot.hex: $(obj)u-boot
$(OBJCOPY)${OBJCFLAGS} -O ihex $< $@
$(obj)u-boot.srec: $(obj)u-boot
$(OBJCOPY)${OBJCFLAGS} -O srec $< $@
$(obj)u-boot.bin: $(obj)u-boot
$(OBJCOPY)${OBJCFLAGS} -O binary $< $@
$(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.sha1: $(obj)u-boot.bin
$(obj)tools/ubsha1$(obj)u-boot.bin
$(obj)u-boot.dis: $(obj)u-boot
$(OBJDUMP) -d $< > $@
#这里生成的是U-boot 的ELF文件镜像
$(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) \
-Mapu-boot.map -o u-boot
分析一下最关键的u-bootELF文件镜像的生成:
@依赖目标depend :生成各个子目录的.depend文件,.depend列出每个目标文件的依赖文件。生成方法,调用每个子目录的make_depend。
depend dep: for dir in $(SUBDIRS) ; do $(MAKE) -C $$dir _depend ; done
@依赖目标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)
@伪目标SUBDIRS: 执行tools,examples ,post,post\cpu 子目录下面的make文件。
SUBDIRS = tools \
examples \
post \
post/cpu
.PHONY : $(SUBDIRS)
$(SUBDIRS):
$(MAKE) -C $@all
@依赖目标$(OBJS),即cpu/start.o
$(OBJS):
$(MAKE) -Ccpu/$(CPU) $(if $(REMOTE_BUILD),$@,$(notdir $@))
@依赖目标$(LIBS),这个目标太多,都是每个子目录的库文件*.a ,通过执行相应子目录下的make来完成:
$(LIBS):$(MAKE) -C $(dir $(subst $(obj),,$@))
@依赖目标$(LDSCRIPT):
LDSCRIPT := $(TOPDIR)/board/$(BOARDDIR)/u-boot.lds
LDFLAGS += -Bstatic -T $(LDSCRIPT) -Ttext $(TEXT_BASE)$(PLATFORM_LDFLAGS)
对于spear310,LDSCRIPT即连接脚本文件是board/spear/spear310/u-boot.lds,定义了连接时各个目标文件是如何组织的。内容如下:
OUTPUT_FORMAT("elf32-littlearm","elf32-littlearm", "elf32-littlearm")
/*OUTPUT_FORMAT("elf32-arm", "elf32-arm","elf32-arm")*/
OUTPUT_ARCH(arm)
ENTRY(_start)
SECTIONS
{
. = 0x00000000;
. = ALIGN(4);
.text :/*.text的基地址由LDFLAGS中-Ttext $(TEXT_BASE)指定*/
{ /*smdk2410指定的基地址为0x33f80000*/
cpu/arm920t/start.o (.text) /*start.o为首*/
*(.text)
}
. = ALIGN(4);
.rodata : {*(.rodata) }
. = ALIGN(4);
.data : { *(.data) }
. = ALIGN(4);
.got : { *(.got) }
. = .;
__u_boot_cmd_start =.;
.u_boot_cmd : {*(.u_boot_cmd) }
__u_boot_cmd_end = .;
. = ALIGN(4);
__bss_start = .;
.bss : { *(.bss) }
_end = .;
}
@执行连接命令:
cd $(LNDIR) && $(LD) $(LDFLAGS) $$UNDEF_SYM$(__OBJS) \
--start-group$(__LIBS) --end-group $(PLATFORM_LIBS) \
-Mapu-boot.map -o u-boot
其实就是把start.o和各个子目录makefile生成的库文件按照LDFLAGS连接在一起,生成ELF文件u-boot 和连接时内存分配图文件u-boot.map。
9)对于各子目录的makefile文件,主要是生成*.o文件然后执行AR生成对应的库文件。如lib_generic文件夹Makefile:
LIB = $(obj)libgeneric.a
COBJS = bzlib.o bzlib_crctable.o bzlib_decompress.o\
bzlib_randtable.obzlib_huffman.o \
crc32.o ctype.odisplay_options.o ldiv.o \
string.ovsprintf.o zlib.o
SRCS := $(COBJS:.o=.c)
OBJS := $(addprefix $(obj),$(COBJS))
$(LIB): $(obj).depend $(OBJS) #项层Makefile执行make libgeneric.a
$(AR) $(ARFLAGS) $@ $(OBJS)
整个makefile剩下的内容全部是各种不同的开发板的*_config:目标的定义了。
概括起来,工程的编译流程也就是通过执行执行一个make*_config传入ARCH,CPU,BOARD,VENDOR,SOC参数,mkconfig根据参数将include头文件夹相应的头文件夹连接好,生成config.h。然后执行make分别调用各子目录的makefile生成所有的obj文件和obj库文件*.a. 最后连接所有目标文件,生成镜像。不同格式的镜像都是调用相应工具由elf镜像直接或者间接生成的。