#!/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 <wd@denx.de>
#
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 正常退出