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

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

#!/bin/sh -e

# Script to create header files and links to configure
# 一个生成头文件和连接文件的脚本配置文件，这个配置文件主要做三件事情，下面会一一介绍。
# U-Boot for a specific board.
# 目的是为一个特定的板子配置uboot
# Parameters:  Target  Architecture  CPU  Board [VENDOR] [SOC]
# 输入参数（6个）分别为：目标板、体系结构、CPU、板子类型、开发商、片上系统
# (C) 2002-2006 DENX Software Engineering, Wolfgang Denk <>
#

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

 

 

###########################################################################################
#  下面这两行是在我们执行make smdk2410_config的时候要做的事情，是顶层Makefile中的两行代码。
#  其中$(MKCONFIG)就是我们当前所分析的脚本MKCONFIG，
#  $(@:_config=)、arm、arm920t、smdk2410、NULL、s3c24x0 即被依次传递给MKCONFIG脚本的六个参数
#  smdk2410_config : unconfig
#           @$(MKCONFIG) $(@:_config=) arm arm920t smdk2410 NULL s3c24x0
###########################################################################################

#--)、--)、-n)是什么意思？  看来得把shell在学学！！！
while [ $# -gt 0 ] ; do   # "$#"为shell的一个特殊变量，意思是"传递到脚本的参数个数"，这句话的意思是当传递到MKCONFIG脚本的参数个数大于0时...
 case "$1" in   # $1是shell的位置变量，这个case语句应该在判断第一个参数，那么第一个参数是$(@:_config=)，应该是smdk2410_config？
 --) shift ; break ;;
 --) shift ; APPEND=yes ;;    //这几句话，我还是没有看懂！
 -n) shift ; BOARD_NAME="${1%%_config}" ; shift ;;    
 *)  break ;;
 esac
done

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

[ $# -lt 4 ] && exit 1                  #如果参数个数小于4，则退出
[ $# -gt 6 ] && exit 1                  #如果参数个数大于6，则退出

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

#
# Create link to architecture specific headers
# 生成链接指向特定架构的头文件
if [ "$SRCTREE" != "$OBJTREE" ] ; then #如果源码目录不是目标存放目录，这说明我们指定自己的目标存放目录了
 mkdir -p ${OBJTREE}/include   #那么，创建${OBJTREE}/include目录，请注意，这个include目录是我们指定的目标存放目录下的include目录
 mkdir -p ${OBJTREE}/include2  #创建${OBJTREE}/include2目录，这个include2目录同样是我们指定的目标存放目录下的include2目录
 cd ${OBJTREE}/include2   #进入${OBJTREE}/include2目录
 rm -f asm    #删除include2下的asm目录
 
 
 #在include2文件夹下建立相应的文件或者文件夹的软连接，这也就是MKCONFIG脚本所干的"第一件事"，即建立链接
 ln -s ${SRCTREE}/include/asm-$2 asm  # 如果是arm体系的话，则asm-$2为asm-arm(这里$2位置变量的值为arm)
 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
 ln -s asm-$2 asm # 然后建立软链接
else            # 如果源码目录就是目标存放目录，也就是说：不特别定制目标存放目录的话
 cd ./include   # 进入uboot顶层目录下的include目录
 rm -f asm     # 删除asm目录
 ln -s asm-$2 asm   # 建立软连接 ln -s asm-arm asm
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/"
else
 ln -s ${LNPREFIX}arch-$6 asm-$2/arch   # 否则建立软链接：ln -s arch-s3c24x0 asm-arm/arch
fi

if [ "$2" = "arm" ] ; then         # 如果位置参数$2为"arm"，那么删除asm-arm/proc
 rm -f asm-$2/proc
 ln -s ${LNPREFIX}proc-armv asm-$2/proc # 建立链接${LNPREFIX}proc-armv asm-arm/proc
fi

 

 

 

# 这是此脚本做的第二件事，生成/include/config.mk/配置文件
# Create include file for Make
# 为Make生成config.m配置文件
# include/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 #如果指明了开发商VENDOR，则在config.mk中定义它：VENDOR = $5
[ "$6" ] && [ "$6" != "NULL" ] && echo "SOC    = $6" >> config.mk #如果指明了SOC片上系统，则在config.mk中定义它：SOC = $6，这里应该是SOC = s3c24x0

 

 

 

# 这是此脚本做的第三件事，包含头文件/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  #可以把/include/config.h文件打开看看，一目了然
echo "#include " >>config.h

#追加#include 到包含头文件config.h中

exit 0   正常退出