U-Boot-1.1.6顶层目录MKCONFIG脚本配置文件详细分析

kenson

#!/bin/sh -e

# Script to create header files and links to configure
: I% C& A! q1 G6 Q7 d. B# 一个生成头文件和连接文件的脚本配置文件，这个配置文件主要做三件事情，下面会一一介绍。
# U-Boot for a specific board.
( H$ \+ E+ e2 e; g# a# 目的是为一个特定的板子配置uboot
! [! q* E; w" a) f% U  O6 g/ _# Parameters:  Target  Architecture  CPU  Board [VENDOR] [SOC]
# 输入参数（6个）分别为：目标板、体系结构、CPU、板子类型、开发商、片上系统
# (C) 2002-2006 DENX Software Engineering, Wolfgang Denk <wd@denx.de>
; g7 I1 A7 r) [! U+ g#

APPEND=no # Default: Create new config file   APPEND=no算是一个flag吧，看了后文就会了解
BOARD_NAME="" # Name to print in make output  开发板的名称，将会在make命令的输出中打印显示

8 p+ h& L: X0 @2 g7 ]* A* G+ M

###########################################################################################
* [, P0 g8 H. V% X/ V#  下面这两行是在我们执行make smdk2410_config的时候要做的事情，是顶层Makefile中的两行代码。
#  其中$(MKCONFIG)就是我们当前所分析的脚本MKCONFIG，
% X* }$ C1 H" I; K  k, b#  $(@:_config=)、arm、arm920t、smdk2410、NULL、s3c24x0 即被依次传递给MKCONFIG脚本的六个参数
, x6 T  Z2 k5 U, b3 r% x; Y- j" H#  smdk2410_config : unconfig
#           @$(MKCONFIG) $(@:_config=) arm arm920t smdk2410 NULL s3c24x0
- T) [! ]0 N( e( o. n###########################################################################################

#--)、--)、-n)是什么意思？  看来得把shell在学学！！！
# u) ?; n& G6 Ywhile [ $# -gt 0 ] ; do   # "$#"为shell的一个特殊变量，意思是"传递到脚本的参数个数"，这句话的意思是当传递到MKCONFIG脚本的参数个数大于0时...
case "$1" in   # $1是shell的位置变量，这个case语句应该在判断第一个参数，那么第一个参数是$(@:_config=)，应该是smdk2410_config？
* h. ?9 X, z; Y& d2 y2 N, { --) shift ; break ;;
--) shift ; APPEND=yes ;;    //这几句话，我还是没有看懂！
2 G3 ^, K0 l# j, @0 o- E2 q -n) shift ; BOARD_NAME="${1%%_config}" ; shift ;;     
*)  break ;;
; t) G1 y4 j6 d, V( e1 c1 M esac
done

[ "${BOARD_NAME}" ] || BOARD_NAME="$1"   #如果板子名称....，或者板子名称为$1，这是一个什么语句？？？？？？？、

[ $# -lt 4 ] && exit 1                  #如果参数个数小于4，则退出
: }' ^" O8 n& M0 M: o2 ]) g1 D5 Q[ $# -gt 6 ] && exit 1                  #如果参数个数大于6，则退出

echo "Configuring for ${BOARD_NAME} board..."    #这句话我们应该很熟悉，当执行make smdk2410_config的时候，终端会显示这句话。

#
8 @8 s+ U4 o) t: N$ t# Create link to architecture specific headers
: I, v4 t3 _' P; `; D2 D# 生成链接指向特定架构的头文件
4 Z, H5 j% w3 d. ?0 i$ _if [ "$SRCTREE" != "$OBJTREE" ] ; then #如果源码目录不是目标存放目录，这说明我们指定自己的目标存放目录了
. U4 @$ y, G/ e& A2 D$ b  \ mkdir -p ${OBJTREE}/include   #那么，创建${OBJTREE}/include目录，请注意，这个include目录是我们指定的目标存放目录下的include目录
' T0 ?* N# i/ x8 L$ f mkdir -p ${OBJTREE}/include2  #创建${OBJTREE}/include2目录，这个include2目录同样是我们指定的目标存放目录下的include2目录
, M) f# F' ?& u, n- e$ ?' k  q cd ${OBJTREE}/include2   #进入${OBJTREE}/include2目录
) q2 Z& w+ T' |" J rm -f asm    #删除include2下的asm目录
5 `2 l. Y4 @, P6 U: l
1 k" r) o) d1 ?0 c- B- ^+ c
/ k; Q% l  ?9 N: Z #在include2文件夹下建立相应的文件或者文件夹的软连接，这也就是MKCONFIG脚本所干的"第一件事"，即建立链接
ln -s ${SRCTREE}/include/asm-$2 asm  # 如果是arm体系的话，则asm-$2为asm-arm(这里$2位置变量的值为arm)
$ }4 m( |) ]; q+ F LNPREFIX="../../include2/asm/" # 链接的前缀为"../../include2/asm/"
cd ../include # 此时，进入include目录
rm -rf asm-$2  # 删除asm-$2目录（此时为asm-arm）
rm -f asm   # 再删除asm目录
mkdir asm-$2  # 在${SRCTREE}/include目录下，重新创建目录asm-$2
& G' X& [4 @% ]! A8 c2 N# X ln -s asm-$2 asm # 然后建立软链接
else            # 如果源码目录就是目标存放目录，也就是说：不特别定制目标存放目录的话
: Y3 o; P5 H; H- i  A; }4 {; y cd ./include   # 进入uboot顶层目录下的include目录
# m9 g- P: R8 N6 _( d; O& l5 v rm -f asm     # 删除asm目录
ln -s asm-$2 asm   # 建立软连接 ln -s asm-arm asm
* n/ m# P1 Y1 }* }5 |9 \fi

rm -f asm-$2/arch       # 删除asm-arm/arch

if [ -z "$6" -o "$6" = "NULL" ] ; then   # 如果位置参数$6字符串长度为0或者为空NULL的话
ln -s ${LNPREFIX}arch-$3 asm-$2/arch   # 建立软链接：ln -s arch-arm920t asm-arm/arch，这里 LNPREFIX="../../include2/asm/"
. d$ l5 o$ F# e# g- W( qelse
ln -s ${LNPREFIX}arch-$6 asm-$2/arch   # 否则建立软链接：ln -s arch-s3c24x0 asm-arm/arch
& c' M1 u4 [. K9 b7 Nfi

if [ "$2" = "arm" ] ; then         # 如果位置参数$2为"arm"，那么删除asm-arm/proc
" J% B( [; B$ H/ i0 K0 e) X rm -f asm-$2/proc
$ _4 O% X% j0 e% I" x1 F ln -s ${LNPREFIX}proc-armv asm-$2/proc # 建立链接${LNPREFIX}proc-armv asm-arm/proc
7 b8 e( q9 t( A, e& ~fi

5 F" z) b( x+ a/ v% `3 E( _7 {

1 z( r3 v2 C5 Z

# 这是此脚本做的第二件事，生成/include/config.mk/配置文件
, a+ z" R  c: p2 N/ G# Create include file for Make
$ R, C9 ^+ q: Y* t1 e& `! o5 c& [# 为Make生成config.m配置文件
, s' I" Y: Q' P$ A  h# include/config.mk里面内容很简单，定义了几个变量：
echo "ARCH   = $2" >  config.mk
+ r, |- K2 b: G; @" uecho "CPU    = $3" >> config.mk
/ X, r( V9 e& t( Oecho "BOARD  = $4" >> config.mk

[ "$5" ] && [ "$5" != "NULL" ] && echo "VENDOR = $5" >> config.mk #如果指明了开发商VENDOR，则在config.mk中定义它：VENDOR = $5
[ "$6" ] && [ "$6" != "NULL" ] && echo "SOC    = $6" >> config.mk #如果指明了SOC片上系统，则在config.mk中定义它：SOC = $6，这里应该是SOC = s3c24x0

9 v: R! D4 ~8 M3 j9 G+ N% w

# 这是此脚本做的第三件事，包含头文件/include/config.h
# Create board specific header file
1 u! V6 ?9 k" h/ i8 ]if [ "$APPEND" = "yes" ] # Append to existing config file  
9 T, @2 H4 ?9 e+ y" Y0 Tthen
- p- o/ k+ K  `1 o& G echo >> config.h      附加
/ Y) K# u) n7 Z& felse
> config.h  # Create new config file   重建
3 p8 B( {) r* T/ |fi
echo "/* Automatically generated - do not edit */" >>config.h  #可以把/include/config.h文件打开看看，一目了然
. ]7 [. z: J* `  q$ b! S0 X5 Secho "#include <configs/$1.h>" >>config.h

#追加#include <configs/smdk2410.h>到包含头文件config.h中

exit 0   正常退出

kenson

u-boot-1.1.6顶层目录Makefile更详细的解释

#
# i6 U; D: _: \& B' @# (C) Copyright 2000-2006 版权所有：2000~2006
  o" D7 ^. K/ x* _# Wolfgang Denk, DENX Software Engineering, wd@denx.de.  Wolfgang Denk一个开发人员的名字 DENX Software Engineering 公司名称 wd@denx.de是Wolfgang Denk的邮箱吧
#
' i! ^7 ]) i" w/ q+ b# See file CREDITS for list of people who contributed to this  可以看看CREDITS，里面有为uboot做出贡献的所有开发人员
# project.
  n' p/ i3 i1 [+ r2 f% q* k0 q8 C) f#
# This program is free software; you can redistribute it and/or   这个程序是一个自由软件，你可以重新发布它，或者在自由软件基金组织所颁布的
# modify it under the terms of the GNU General Public License as  GNU GPL（GNU 公共许可协议）的前提下修改它；注意，不论是第二版的GPL还是
# published by the Free Software Foundatio; either version 2 of   任何更新的版本，都可以，这由你选择。
# the License, or (at your option) any later version.
( T& W1 \* ?) ?. W2 Z#
, H) v! i4 @" c  _! f# U5 D: @# This program is distributed in the hope that it will be useful,  我门之所以发布这个程序，是希望它能够对你有用，但是我们不做任何担保；
# ]9 @" y' R- U3 i% Y; a# but WITHOUT ANY WARRANTY; without even the implied warranty of   不保证任何的可销售性和任何给予特殊目的的合适性。想要了解详细内容，
% G" F# K6 n. @' e5 ]  K# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the    你可以参考GNU GPL。
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License 你应该已经得到了GNU General Public License的一个拷贝，因为它就包含在
+ L% C5 ^0 J+ ]6 b# along with this program; if not, write to the Free Software       这个工程的源代码包中。如果没有，你可以写信给自由软件基金组织，以获取一份。
# Foundation, Inc., 59 Temple Place, Suite 330, Boston,
# MA 02111-1307 USA
; a/ d. B2 H9 S#
7 R( K! P3 k& g+ P. n' ^
+ A7 j  x5 P4 h  G8 \4 }3 T
5 ]( B) o. v2 T8 v4 n# G  v

VERSION = 1
PATCHLEVEL = 1
SUBLEVEL = 6
EXTRAVERSION =
U_BOOT_VERSION = $(VERSION).$(PATCHLEVEL).$(SUBLEVEL)$(EXTRAVERSION)
2 d9 E$ A, }, _5 K  d5 l6 bVERSION_FILE = $(obj)include/version_autogenerated.h #版本文件

# uname 命令将正在使用的操作系统名写到标准输出中
# -m 显示硬件运行系统的机器 ID 号

# 定义变量，HOSTARCH里面存储的是机器ID号，即主机架构类型
HOSTARCH := $(shell uname -m | \           #可以把shell脚本写到makefile里面，这是make中的shell function, 相当于shell中的命令替换。
' N, c" A) {/ o sed -e s/i.86/i386/ \                    #shell uname -m 获得机器硬件名称
, F( t: s; Q7 ]$ N* t/ V     -e s/sun4u/sparc64/ \                #sed -e s/arm.*/arm/ 的意思是把前缀为arm的所有模式替换为arm。结合前面的uname命令来理解就是：
     -e s/arm.*/arm/ \                    #把uname -m的结果（主机架构类型或者称为机器ID号）通过管道传递给sed命令，然后把前缀为arm的所有模式替换为arm。
3 X9 f5 A2 s* }4 t- L' Q     -e s/sa110/arm/ \                    #sed的语法：sed [  -n ] Script [ File ... ]
     -e s/powerpc/ppc/ \                  #           sed [  -n ] [  -e Script ] ... [  -f ScriptFile ] ... [ File ... ]
      -e s/macppc/ppc/)                    #sed 命令根据编辑脚本，去修改指定的 File 文件（这里file是作为一个输入参数的）的行，并将其写到标准输出。
     #sed 命令包含很多功能，用于选择要修改的行（请注意，sed是针对行进行操作的），并只对选择的行作更改。
) }+ B3 H$ m* q4 r     #sed 命令使用两个工作空间来保留修改的行：保留选定行的 "模式空间" 和暂时存储行的 "保留空间"。
      #这里所谓的编辑脚本是由单独的子命令构成的，每个单独的行上对应着一个子命令。sed 子命令的一般格式如下：[address-range] function[modifiers]，即：[地址范围] 函数[修改符]
      #sed 命令通过将一个输入行读入模式空间，依次应用所有的 sed 子命令（这些子命令的地址选择了该行），
      #并将模式空间写到标准输出来处理每个输入的 File 输入文件（file就是输入参数）。然后清除模式空间，并对输入的 File 中指定的每行重复该过程。
, z: V6 K) r, Y6 i% |6 N8 s      #一些 sed 子命令使用保留空间来保存后继检索的所有的，或部分的模式空间。
" _' ^' A7 I0 Q9 m5 U( D) u0 J      #当命令包含地址（行号或搜索模式）时，该命令只会对被寻址的行起作用。否则，该命令适用于所有的行。
      #注意，这里的参数"-e"的意思是：使用 Script 变量作为编辑脚本。如果你只使用一个 -e 标志并且不使用-f 标志，则可以省略 -e 标志。
  S  T8 q6 g9 k      #注意，这里的 "sed -e s/arm.*/arm/"表示把前缀为arm的所有模式替换为arm，也就是sed s/pattern/replacement/flags
* S! A5 G, {' H- n& m      #用 replacement 字符串代替在模式空间中首次出现的 pattern 参数。除了空格或换行符，在 s 子命令之后显示的任何字符都能代替 /（斜杠）分隔符。

/ Y: o, R9 V; l7 i! L

     
7 m3 `1 N7 c: k  I* p5 p1 S4 Q5 F5 B#uname -s 表示：显示系统名，标志缺省为开，即uname命令不带任何参数的输出和加参数-s输出相同，即Linux
#tr是一个shell命令，这里 tr '[:upper:]' '[:lower:]'的意思是把管道中的Linux 中的大写字母L 转换成小写字母l
#下面这句话的意思是定义变量HOSTOS，HOSTOS里面存放的是主机安装的，并且当前正在运行的操作系统。
5 i- ?+ ~! z0 R: q; A$ aHOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]' | \
) W3 u! }* o' h- U     sed -e 's/\(cygwin\).*/cygwin/')    # 这一句的意思是检测出主机安装的，并且当前正在运行的操作系统名，并把这个系统名中的大写字母转换为小写字母，   
* U, ~& q6 `) a0 `5 R7 c                                          # 然后在通过sed流编辑器匹配所有的，这个系统名中出现的"\(cygwin\).*"模式，然后再用"cygwin"模式替换。
/ {) t5 Y7 }( H; n! _  N9 n9 a#export HOSTARCH HOSTOS  的意思是输出两个makefile变量HOSTARCH HOSTOS               

export HOSTARCH HOSTOS               

# Deal with colliding definitions from tcsh etc.   用来处理来自tcsh的互相冲突的定义等等
0 v; Y4 o. ~1 g1 B! Q  r# 一般来说，shell可以分成两类。第一类是由　Bourne　shell　衍生出来的包括　
# sh，ksh，bash，与zsh。第二类是由　C　shell　衍生出来的，包括　csh　与　
) t/ \. X7 @( @( g; P# tcsh。除此之外还有一个　rc，有人认为该自成一类，有人认为该归类在Bourne　shell。　

VENDOR=  #开发商

#########################################################################
#
# U-boot build supports producing a object files to the separate external
# U-boot 的编译过程可以支持向一个自己定义的路径生成最终的目标文件
# directory. Two use cases are supported:
# 这里提供了两种用法：
#
' R" Y) }3 c: |6 N' N) q# 1) Add O= to the make command line #第一种用法：通过在终端执行命令make O=/dir(即你指定的生成的目标文件的存放目录)
+ u. z3 a, q+ t# w( T# 'make O=/tmp/build all'
#
6 m3 v" |6 g6 k- e9 T# 2) Set environement variable BUILD_DIR to point to the desired location #第二种用法：通过设置环境变量来指定目标文件存放目录，如下所示：
4 m) L1 G/ p4 W5 F* o# 'export BUILD_DIR=/tmp/build'
( R( P0 T; {( Y# 'make'
! {! z3 E( r5 Q  G#
# The second approach can also be used with a MAKEALL script #第二种方法也可以写成一个MAKEALL脚本，然后执行MAKEALL，如下所示:
- P8 L" }- |; K. I& L5 O# 'export BUILD_DIR=/tmp/build'
# './MAKEALL'
" q2 D5 g- p' y& k* ]#
9 D$ f( I3 C( m8 C1 U8 m. G8 X# Command line 'O=' setting overrides BUILD_DIR environent variable.    #命令行'O='设置会覆盖环境变量BUILD_DIR的设置
1 E7 H  B# w) i0 _#
# When none of the above methods is used， the local build is performed and   #如果都不采用上面两种方法，那么目标文件最终要存放到源码顶层目录，也就是U-BOOT顶层目录
. d; H6 [' m9 t4 x# the object files are placed in the source directory.
! J+ Y8 ^/ B% {  x) O#

#理解了上面一段英文，这里就不难理解了
9 P. l& c. d; i' M3 m+ [- f#方法1

ifdef O #如果变量'O' 已经被定义过
ifeq ("$(origin O)", "command line") #如果变量'O' 在命令行中定义过
BUILD_DIR := $(O)   #就把变量'O' 的值(目标文件存放目录)赋给BUILD_DIR
endif
( O. h: }7 Q. p7 Kendif

" ]! t- A( R. m2 k5 C#方法2
ifneq ($(BUILD_DIR),)           #如果变量BUILD_DIR不为空，即环境变量BUILD_DIR 被定义过
saved-output := $(BUILD_DIR)    #那么把它的值赋给saved-output

# Attempt to create a output directory.   #生成一个输出路径，即目标文件存放目录BUILD_DIR
" r4 z, x. d+ X* d; T$(shell [ -d ${BUILD_DIR} ] || mkdir -p ${BUILD_DIR})

#shell [ -d ${BUILD_DIR} ] 是什么意思?是不是生成一个目录的意思?

# Verify if it was successful. 测试目录是否创建成功
) r5 m& A) R. ~7 \7 j* MBUILD_DIR := $(shell cd $(BUILD_DIR) && /bin/pwd)  #这又是什么意思，说明对shell还不够理解！
$(if $(BUILD_DIR),,$(error output directory "$(saved-output)" does not exist))
$ w6 I" d, a6 e- Q  S& l#这里用了一个if函数，意思是如果如果$(BUILD_DIR) 非空，则什么都不执行(返回空)，否则执行error函数，输出错误信息
endif

# ifneq ($(BUILD_DIR),) #意思是：如果没有定义目标文件存放目录
/ E6 @9 {' G: x2 X0 `#Makefile中定义了源码以及生成目标文件存放的目录，目标文件存放目录BUILD_DIR可以通过make O=dir指定。如果没有指定，则设定为源码顶层目录。
0 ~. k0 ]. A6 ?' f; O#一般编译的时候不指定输出目录，则BUILD_DIR为空。其他目录变量如下：
+ @5 x( Z3 l3 z# B7 y. MOBJTREE  := $(if $(BUILD_DIR),$(BUILD_DIR),$(CURDIR))  #如果$(BUILD_DIR)不为空，则返回$(BUILD_DIR)，并赋给OBJTREE，即自己定制的目标存放目录
SRCTREE  := $(CURDIR) #把当前源码所在目录 $(CURDIR) 赋给SRCTREE
/ _& n9 J+ t: A$ R/ qTOPDIR  := $(SRCTREE) #把当前源码所在目录 $(CURDIR) 赋给SRCTREE
9 X/ U9 C  T  u$ ZLNDIR  := $(OBJTREE)   #存放生成的目录文件
export TOPDIR SRCTREE OBJTREE

7 w% F* Z7 n7 ~* D1 Q1 l3 {

  w$ A4 p. t5 n9 N+ P' f3 VMKCONFIG := $(SRCTREE)/mkconfig    #MKCONFIG指向源码所在目录(U-BOOT顶层目录)下的mkconfig配置文件
export MKCONFIG

#在编译UBOOT之前，我们先要执行：
#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
. @+ O/ H! S3 }5 s#然后执行命令： @$(MKCONFIG) $(@:_config=) arm arm920t smdk2410 NULL s3c24x0
#arm 表示CPU的构架是基于ARM体系的
. k5 F+ `  ~- o# [& N#arm920t 表示CPU的类型是arm920t
: J% j/ a- E# H3 ?6 z1 L#smdk2410 表示开发板的型号
1 Y: x  ]3 K( m* C2 x- n, D#NULL 表示开发商或者经销商的名称，这里为空
% {0 H$ Z' y( R+ u8 V/ G  z#s3c24x0 表示基于S3C2410的片上系统
3 M1 f; Z/ [( {) A6 g#MKCONFIG指向UBOOT顶层目录下的mkconfig脚本配置文件，后面五个字符串是传入的参数（好像$(@:_config=)也是一个参数）。
6 w0 f$ K& n  x#下面来分析一下mkconfig这个脚本配置文件，点击链接：
0 A; q0 i& _- X8 Whttp://zqwt.012.blog.163.com/blog/static/120446842010325102158182/

ifneq ($(OBJTREE),$(SRCTREE)) #当目标存放目录不是U-BOOT顶层目录（源码目录）时
4 d; E: J$ X; e0 mREMOTE_BUILD  := 1   #定义变量REMOTE_BUILD  := 1  这个变量算是一个flag吧
export REMOTE_BUILD
% A* P1 n9 f7 ^4 B, Nendif

# $(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.
+ c4 L' m) g. M7 B9 E7 B. h! G% R# $(obj) and $(src)都被定义在顶层目录下的config.mk脚本配置文件里面，
# 但是在这个主Makefile里面，我们同样需要他们，
# 因为在主Makefile文件包含config.mk之前，$(obj) and $(src)偶尔地会成为这些目标的case:
& Q: @6 i7 v- Z  M# unconfig, clean, clobber, distclean, etc

ifneq ($(OBJTREE),$(SRCTREE))  #当目标存放目录不是U-BOOT顶层目录（源码目录）时
obj := $(OBJTREE)/             #定义变量obj，让其等于目标存放目录
src := $(SRCTREE)/             #定义变量src，让其等于uboot顶层目录
else
obj :=                         #否则，这两个变量都定义为空
src :=
$ a. X. v1 ]. w- I6 W0 u9 fendif
  _: V. \4 v$ K6 G7 }( l" e: bexport obj src

/ f. {5 m$ k( ^$ R0 R
' K) {2 [7 Y7 O/ K
5 S  R3 d( }/ f& w

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

; R8 v& c  t+ Q
- h2 b& s6 ?3 v' G8 D7 p" p. p

ifeq ($(OBJTREE)/include/config.mk,$(wildcard $(OBJTREE)/include/config.mk)) #这句话让人费解！
" j# ~, H+ D5 v& O: `# 通配符在规则中可以自动扩展，但设置在变量中或在函数的参数中通配符一般不能正常扩展。
+ B1 E: |8 ^& I1 s# 如果您需要在这些场合扩展通配符，您应该使用函数wildcard，格式如下：
# $(wildcard pattern...)

# load ARCH, BOARD, and CPU configuration
# 加载ARCH, BOARD, and CPU 配置
include $(OBJTREE)/include/config.mk   # 这时候，开始包含/include/config.mk的
export ARCH CPU BOARD VENDOR SOC

#指定交叉编译器前缀
1 c; P! p& U0 P  Yifeq ($(ARCH),arm)  
CROSS_COMPILE = arm-linux-
3 }' E+ ~7 t, b9 U#这里你可以把交叉编译器的安装路径加到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-
5 Z( X0 Y: }- [5 w, h8 |#这样一来，你在终端进行编译的时候就不用指定CROSS_COMPILE=arm-linux-了
( z& y; L, F& [# d#但请注意：在编译内核的时候，交叉编译器必须安装在/usr/local/arm下，否则会发生错误！！！！！
endif

export CROSS_COMPILE

# load other configuration  加载其他设置，这里是包含顶层目录下的config.mk配置文件，这个文件主要做了三个工作：
1 D) b# S+ O  ~1 `. |# 1、定义了交叉编译器 2、定义了编译选项 3、定义了编译规则
7 ~# X" F5 a8 |- _1 l* o# 对本文件具体的分析，请查看链接：
http://zqwt.012.blog.163.com/blog/static/12044684201032541139914/

include $(TOPDIR)/config.mk   

#########################################################################
) O4 v; ?2 x6 F5 b# U-Boot objects....order is important (i.e. start must be first)
" M! l1 q& ], u2 h# uboot目标...书写顺序很重要，比如start.o必须排在第一位
#########################################################################
OBJS  = cpu/$(CPU)/start.o
#start.o必须放在目标文件的第一位，因为uboot执行的第一段代码就是start.S
) C: U* l$ F  t- E8 e% V( ]# j#具体原因可以查看链接脚本/u-boot-1.1.6/board/smdk2410/u-boot.lds，点击连接：
http://zqwt.012.blog.163.com/blog/static/120446842010320101137932/

- X( I3 E7 t+ A+ M+ K4 V5 T

.....................................

4 c, p4 |# f9 k

OBJS := $(addprefix $(obj),$(OBJS))  #这句的意思是把目标文件存放路径以前缀的形式加到start.O之前，然后再赋给OBJS

* \; s( N) M' E% }. W/ Z4 ]#以下是编译UBOOT需要的库文件
8 e: S9 r) c3 X7 j9 kLIBS  = 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 # 严重平台依赖的

0 {3 N) q# b" [' m" b5 ~LIBS += fs/cramfs/libcramfs.a fs/fat/libfat.a fs/fdos/libfdos.a fs/jffs2/libjffs2.a \
4 e& N* N( ?7 v( Z# H0 }  x  F fs/reiserfs/libreiserfs.a fs/ext2/libext2fs.a
% U8 A- l+ ]# PLIBS += net/libnet.a
3 K  @7 O0 L0 z/ N  RLIBS += disk/libdisk.a
3 N; e! n- G* O3 U( q# [$ A2 yLIBS += rtc/librtc.a
' l4 ?( c! C; v! dLIBS += dtt/libdtt.a
LIBS += drivers/libdrivers.a
LIBS += drivers/nand/libnand.a
, M8 _) `' u) O& C& [$ m( aLIBS += drivers/nand_legacy/libnand_legacy.a
LIBS += drivers/sk98lin/libsk98lin.a
LIBS += post/libpost.a post/cpu/libcpu.a
* K  g* h0 d2 u6 r. x* R" n/ i5 mLIBS += common/libcommon.a
LIBS += $(BOARDLIBS)

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

.PHONY : $(LIBS)   # 这是一个伪目标

#根据所生成的include/config.mk文件定义的几个变量ARCH, CPU, BOARD, SOC，我们可以
5 ~5 S8 c& ~7 Y3 N#确定硬件平台依赖的目录文件。smdk2410平台相关（依赖）目录以及对应生成的库文件如下：
#board/smdk2410/: 库文件board/smdk2410/libsmdk2410.a
/ ?% Y" i7 N5 G#cpu/arm920t/: 库文件cpu/arm920t/libarm920t.a
# |; u& G3 F' M2 H$ D  ]#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

# The "tools" are needed early, so put this first
; d, B* }. B  |2 ^! V9 A# Don't include stuff already done in $(LIBS)   不要包含已经在 $(LIBS) 中的任何东西
3 @: K. X- d+ D. b* Q" s#
( @* W) {( T' |! f/ c# 伪目标SUBDIRS：用于执行tools、examples、post、post\cpu子目录下的make文件
( ]7 {9 u1 K9 rSUBDIRS = tools \
   examples \
. Q1 y" x. g% L# t+ V( a. r. O   post \
; f. Y% Y* y/ H   post/cpu
; h3 j0 b* r9 G/ u$ L.PHONY : $(SUBDIRS)

ifeq ($(CONFIG_NAND_U_BOOT),y)
; l; c2 i+ r# u% S4 F  S8 Y+ CNAND_SPL = nand_spl
. [/ f( @' m# cU_BOOT_NAND = $(obj)u-boot-nand.bin
1 m, g9 x* x7 L8 tendif

__OBJS := $(subst $(obj),,$(OBJS))
* h( y3 ^% i- G7 R__LIBS := $(subst $(obj),,$(LIBS))

#########################################################################
9 I* A% `% j$ F& q; ~#########################################################################

" x; d/ \/ _6 o- \5 \' z: p) U/ j

6 ?& ]; Y: I& N- F#这里是最终要生成的各种镜像文件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)
all:  $(ALL)
0 B/ m5 w) o" ?$(obj)u-boot.hex: $(obj)u-boot
7 q1 |2 O+ u* j+ d) G  $(OBJCOPY) ${OBJCFLAGS} -O ihex $< $@       # $<，$@ 分别表示使用该规则的源文件和目标文件

$(obj)u-boot.srec: $(obj)u-boot               
& _0 W7 B/ Q* {( B: g# t1 }4 b  $(OBJCOPY) ${OBJCFLAGS} -O srec $< $@

$(obj)u-boot.bin: $(obj)u-boot
. H$ w$ U( w% P- b" j  $(OBJCOPY) ${OBJCFLAGS} -O binary $< $@

$(obj)u-boot.img: $(obj)u-boot.bin
: d* m) g# l* x  ./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"/') \
+ j- i- @% [% c) Q% z  -d $< $@

$(obj)u-boot.dis: $(obj)u-boot
* F0 `' K. d3 R+ R: p  $(OBJDUMP) -d $< > $@

#此处生成的是uboot的ELF文件镜像
! U) @3 M) d  O. Q: g9 y$(obj)u-boot:  depend version $(SUBDIRS) $(OBJS) $(LIBS) $(LDSCRIPT)
8 L( X  N) |* @0 v  UNDEF_SYM=`$(OBJDUMP) -x $(LIBS) |sed  -n -e 's/.*\(__u_boot_cmd_.*\)/-u\1/p'|sort|uniq`;\
  cd $(LNDIR) && $(LD) $(LDFLAGS) $$UNDEF_SYM $(__OBJS) \
# M5 B; p) }+ v( Z) w   --start-group $(__LIBS) --end-group $(PLATFORM_LIBS) \
! Q9 H! m. e5 j; D$ k   -Map u-boot.map -o u-boot

#依赖目标$(OBJS)，也就是cpu/start.o
' u" D& b! P1 S3 S$(OBJS):
  $(MAKE) -C cpu/$(CPU) $(if $(REMOTE_BUILD),$@,$(notdir $@))
' T) t; n7 s5 \1 W% q  
#依赖目标$(LIBS)，目标很多，都是每个子目录的库文件*.a，通过执行相应子目录下的make来完成
( S% O" {* t. k. R* e7 e; `$(LIBS):
  $(MAKE) -C $(dir $(subst $(obj),,$@))
  
#这里解释一下这个makefile函数 $(dir names...)
#抽取‘names’中每一个文件名的路径部分，文件名的路径部分包括从文件名的开始到最后一个斜杠（含斜杠）
/ N6 k  @1 g; Z* g* M#之前的一切字符。如果文件名中没有斜杠，路径部分是‘./’。如：
#$(dir src/foo.c hacks)
#产生的结果为 ‘src/ ./’。

4 H* N1 g: C  t  I( s0 a7 M$(SUBDIRS):
8 H1 N$ h% |$ X& z" X* R  $(MAKE) -C $@ all

$(NAND_SPL): version
, Y: ~: ?. M, A  X8 u% L  $(MAKE) -C nand_spl/board/$(BOARDDIR) all

$(U_BOOT_NAND): $(NAND_SPL) $(obj)u-boot.bin
/ A! Y6 X8 ?0 V$ z0 O  cat $(obj)nand_spl/u-boot-spl-16k.bin $(obj)u-boot.bin > $(obj)u-boot-nand.bin

, [. u' e8 w. m: h; q6 H- b% g#依赖目标version：生成版本信息到版本文件VERSION_FILE中
2 l! P& |1 T4 z) ]  M3 Sversion:
  @echo -n "#define U_BOOT_VERSION \"U-Boot " > $(VERSION_FILE); \
, H- V) |# L- K# u8 H  echo -n "$(U_BOOT_VERSION)" >> $(VERSION_FILE); \
+ [" p. _  |3 W1 K  echo -n $(shell $(CONFIG_SHELL) $(TOPDIR)/tools/setlocalversion \
    $(TOPDIR)) >> $(VERSION_FILE); \
% b. y2 k0 V& J* f' d( C  echo "\"" >> $(VERSION_FILE)

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

updater:
$ a. z4 g! c: v  $(MAKE) -C tools/updater all || exit 1

env:
7 i6 \2 `: N7 _% v2 o  $(MAKE) -C tools/env all || exit 1

#依赖目标depend：生成各个子目录.depend文件，.depend列出每个目标文件的依赖文件。
#生成方法：调用每个子目录的make_depend
4 S. x  z  }# j6 i9 B- L1 O6 _3 Jdepend dep:
  for dir in $(SUBDIRS) ; do $(MAKE) -C $$dir _depend ; done

# ~: v) @' f! V/ j& f9 h- Ltags ctags:
  ctags -w -o $(OBJTREE)/ctags `find $(SUBDIRS) include \
    lib_generic board/$(BOARDDIR) cpu/$(CPU) lib_$(ARCH) \
+ E- |0 W4 o: Q    fs/cramfs fs/fat fs/fdos fs/jffs2 \
  H- r% l" x/ G. s# u    net disk rtc dtt drivers drivers/sk98lin common \
9 h6 L  K3 D" ^8 }9 I   \( -name CVS -prune \) -o \( -name '*.[ch]' -print \)`

etags:
% N8 k# \- }. c3 \+ I  etags -a -o $(OBJTREE)/etags `find $(SUBDIRS) include \
    lib_generic board/$(BOARDDIR) cpu/$(CPU) lib_$(ARCH) \
    fs/cramfs fs/fat fs/fdos fs/jffs2 \
6 F* q+ H7 q( j# ?8 g    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

; V, R6 d5 t8 ~& ^# k# p5 a' V" o9 a6 X

#########################################################################
+ U3 V  Q7 e  c1 I# z$ G/ _else
; Z" ]7 Y; B! N9 {2 rall $(obj)u-boot.hex $(obj)u-boot.srec $(obj)u-boot.bin \
8 ~0 M" n( l+ q" z' B$(obj)u-boot.img $(obj)u-boot.dis $(obj)u-boot \
: C# K8 w  ]# A$(SUBDIRS) version gdbtools updater env depend \
! o0 K9 U. R# e* O" Y( odep tags ctags etags $(obj)System.map:
8 _+ S) `  I, ?: b" f3 c. ?( x @echo "System not configured - see README" >&2
@ exit 1
endif

.PHONY : CHANGELOG
CHANGELOG:
  L# E9 _4 w; H git log --no-merges U-Boot-1_1_5.. | \
# L% ^5 a( S( A4 _5 B" G  J unexpand -a | sed -e 's/\s\s*$$//' > $@

$ y2 S3 ?, C8 P$ ]9 I8 Q#########################################################################
8 q) @& {0 s3 o  s; [# 这里就是我们所谓的unconfig，应该比较熟悉了！
# 很明显，它所做的工作就是清除上次生成的include/config.h和include/config.mk
# 以及开发板目录下的一些临时配置文件
* s1 t2 x$ j" O- }% R# unconfig:
#  @rm -f $(obj)include/config.h $(obj)include/config.mk \
#   $(obj)board/*/config.tmp $(obj)board/*/*/config.tmp
#########################################################################

( J4 ~4 y, p" o0 t

................................
. P  X2 I  ?3 _9 A# ?7 Xsmdk2400_config : unconfig
@$(MKCONFIG) $(@:_config=) arm arm920t smdk2400 NULL s3c24x0
. z, k" e7 p4 I3 k
................................

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

1 z9 u# }* O1 A( g( L#我删了一部分内容，那些几乎都是各种不同板子的*_config，也就是目标的定义。

最后总结一下，当然这里也参考了前辈们的许多宝贵经验，顶层Makefile的主要任务就是组织整个u-boot工程的编译，概括可以分为一下几个步骤：

1、首先通过执行make *_config传入$(@:_config=), ARCH, CPU, BOARD, VENDOR, SOC参数（一共六个参数但不
( [/ I9 M1 M3 ~, d/ h: b( |   
   一定同时存在），给mkconfig。

2、mkconfig接收到传递过来的参数后，将include头文件夹相应的头文件夹链接好，生成config.h

3、然后执行make分别调用各个子目录的makefile文件，以生成所有的obj文件（包括start.o）和obj库文件*.a。

4、最后，通过链接器把所有目标文件链接起来，生成uboot镜像。不同格式的镜像都是调用相应工具，经

   由elf镜像间接或者直接的生成的。

2 R1 q, n& C6 h1 G& ^& i* O7 f, I
5 \  `, U7 E6 \! q7 v

kenson

不看不知道自己对SHELL的认识还有好多的不足

zhixiaoyuhong

kenson 发表于 2017-5-19 16:58
不看不知道自己对SHELL的认识还有好多的不足

make的语法和shell还有区别，唉，搞嵌入式这行要学的太多了。。。
" B+ x7 d6 O8 j" s

kenson

zhixiaoyuhong 发表于 2017-5-19 17:50
6 L$ q( V' j2 v' j$ J% e8 |) A5 V2 Jmake的语法和shell还有区别，唉，搞嵌入式这行要学的太多了。。。

是的makefile跟SHELL 是不一样的，但makefile要调用shell这个才要命，只能硬着学啰
# J* f, p! Q7 \; v( {) X