#!/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 正常退出