#!/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 <configs/$1.h>" >>config.h

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

exit 0   正常退出