MTK 软件工程的配置说明

本文详解MTK的编译过程，并会根据我的理解来更新。阅读上文对本文的一些文件和术语会有很好的帮助。

导读：
　　Comp.mak 完成模块编译连接，生成bin
　　Gsm2.mak 主编译文件，完成clean,remake,new等工作
　　XXX_GPRS.mak 客户私有的配置，根据客户的不同，而设定不同的配置文件
　　Option.mak 工程中的基本配置及宏定义文件
　　Verno_XXX.bld 版本文件
　　Custom.bld 要保证在客户版本中都使用相同的配置的地方要写在这里，这个里面的一些文件不能被改变
　　第一步：
　　1.Make.bat命令首先调用ChgFileMode.bat，将编译过程中需要用到的文件的只读属性修改为可读写，再调用make2.pl。
　　2.Make2.pl的主要工作就是匹配gsm2.mak的参数，然后通过命令
　　system("${makeCmd} -f${makeFolder}${myMF} -r -R CUSTOMER=$custom PROJECT=$project $action");来调用gsm2.mak。
　　具体解析出来就是
　　make -f make\gsm2.mak -r –R CUSTOMER=工程名 PROJECT=gprs new|update|remake
　　第二步：整个过程如图
　　Gsm2.mak
　　Option.mak
　　XXX_GPRS.mak
　　REL_CR_MMI_GPRS.mak
　　USER_SPECIFIC.mak
　　
　　1.在Gsm2.mak文件的开始处调用了option.mak文件。
　　2.Option.mak又将make\$(strip $(CUSTOMER))_$(strip$(PROJECT)).mak文件包含进来，这个模式匹配结果为：make目录下，工程名称_GPRS.mak，如K500GSD_GPRS.mak。
　　3.在$(strip $(CUSTOMER))_$(strip$(PROJECT)).mak文件中又调用了REL_CR_MMI_$(strip$(PROJECT)).mak文件，这个文件模式具体被解析为make目录下的REL_CR_MMI_GPRS.mak文件。
　　REL_CR_MMI_GPRS.mak这个文件定义了哪些文件需要加入到编译目录中。
　　其中定义了MMI部分的编译目录为MMIDIR = plutommi。
　　在变量CUS_REL_BASE_COMP中定义了资源的编译目录：
　　CUS_REL_BASE_COMP += $(strip $(MMIDIR))\mmi $(strip $(MMIDIR))\mtkapp $(strip$(MMIDIR))\tool $(MMIDIR)\WIN32FS
　　CUS_REL_BASE_COMP += $(strip$(MMIDIR))\Customer\CustomerInc \
　　$(strip $(MMIDIR))\Customer\Customize \
　　$(strip $(MMIDIR))\Customer\CustResource\$(strip $(MMI_VERSION))\
　　$(strip $(MMIDIR))\Customer\debug \
　　$(strip $(MMIDIR))\Customer\Images\GameImages \
　　$(strip $(MMIDIR))\Customer\Images\decoder \
　　$(strip $(MMIDIR))\Customer\Res_MMI \
　　$(strip $(MMIDIR))\Customer\ResGenerator \
　　$(strip $(MMIDIR))\Customer\ResourceDLL \
　　$(strip $(MMIDIR))\Customer\Resources \
　　$(strip $(MMIDIR))\Customer\Audio
　　客户的资源需要编译如下文件：CUS_REL_SRC_COMP += mmiresource mtkapp gdi_arm plutommi vendorapp
　　图片名称为：CUS_REL_BASE_COMP += $(strip$(MMIDIR))\Customer\Images\$(strip $(MMI_PROJ))$(strip$(MAIN_LCD_SIZE))，可解析为如：
　　plutommi\customer\images\K500GSD176X220
　　
　　REL_CR_MMI_$(strip $(PROJECT)).mak
　　其中CUS_REL_OBJ_LIST这个变量存储了连接过程中所需要的文件名称
　　
　　4．make\$(strip $(CUSTOMER))_$(strip$(PROJECT)).mak文件的功能。
　　CUSTOM_OPTION定义了所有需要编译进去的功能模块的宏。
　　COMPLIST变量的功能：
　　ifeq ($(strip $(RTOS)),NUCLEUS)
　　COMPLIST = nucleus nucleus_int nucleus_ctrl_code nucleus_critical_data
　　Endif
　　如果操作系统为NUCLEUS，那么COMPLIST为后面的值，COMPLIST为所要编译的文件列表，里面存放了很多*.inc文件，展开后就变为
　　config\include
　　stacklib\include
　　adaptation\include
　　kal\include等等
　　
　　5． option.mak文件的在后面调用了make\USER_SPECIFIC.mak
　　如果使用CPU为ARM，则编译工具目录为如下定义
　　ifeq ($(strip $(COMPILER)),ADS)
　　DIR_ARM = c:\progra~1\arm\adsv1_2
　　DIR_ARM := $(strip $(DIR_ARM))
　　DIR_TOOL = $(DIR_ARM)\bin
　　DIR_ARMLIB = $(DIR_ARM)\lib
　　DIR_ARMINC = $(DIR_ARM)\include
　　Endif
　　连接打包工具等为如下几个：
　　DIR_TOOL := $(strip $(DIR_TOOL))
　　LINK = $(DIR_TOOL)\armlink.exe # Linker
　　ASM = $(DIR_TOOL)\armasm.exe # ARM assembler
　　LIB = $(DIR_TOOL)\armar.exe # Library tool
　　BIN_CREATE = $(DIR_TOOL)\fromelf.exe # Binary tool
　　下面这段代码告诉我们需要用什么编译工具来编译
　　ifeq ($(strip $(COMPILER)),ADS)
　　ifeq ($(strip $(COMPILE_MODE)),INST16)
　　CC = $(DIR_TOOL)\tcc.exe # Thumb Mode(16bits), use tcc
　　CC32 = $(DIR_TOOL)\armcc.exe # ARM Mode(32bits), use armcc
　　CPPC = $(DIR_TOOL)\tcpp.exe # Thumb Mode(16bits), use tcc
　　CPPC32 = $(DIR_TOOL)\armcpp.exe # ARM Mode(32bits), use armcc
　　else
　　ifeq ($(strip $(COMPILE_MODE)),INST32)
　　CC = $(DIR_TOOL)\armcc.exe # ARM Mode(32bits), use armcc
　　CPPC = $(DIR_TOOL)\armcpp.exe # ARM Mode(32bits), use armcc
　　else
　　CC = $(DIR_TOOL)\tcc.exe # Default tcc
　　CC32 = $(DIR_TOOL)\armcc.exe # ARM Mode(32bits), use armcc
　　CPPC = $(DIR_TOOL)\tcpp.exe # Thumb Mode(16bits), use tcc
　　CPPC32 = $(DIR_TOOL)\armcpp.exe # ARM Mode(32bits), use armcc
　　endif
　　endif
　　endif
　　
　　ifeq ($(strip $(PLATFORM)),MT6223P)
　　AFLAGS := -g -littleend -cpu ARM7EJ-S
　　Endif
　　
　　COMMINCDIRS变量在先包含了基本功能模块的inc目录后再包含如下文件
　　COMMINCDIRS += $(DIR_ARMINC) $(CUSTOM_COMMINC)，
　　
　　6．Option.mak中定义了一些附加功能模块的编译模式（是否被编译，被编译成什么样的结果），比如说蓝牙，UART3，WIFI，USB，WAP等等，还有一些编译器的设置。
　　我们的版本号和Scat文件被定义在这个变量中：5056L
　　SCATTERFILE = custom\system\$(strip$(BOARD_VER))\scat$(strip $(PLATFORM)).txt
　　VERNOFILE = make\Verno_$(CUSTOMER).bld
　　.bin文件的名称设置在这个变量TARGNAME = $(CUSTOMER)_$(strip$(SUB_BOARD_VER))_$(PROJECT)_$(strip $(PLATFORM))_$(strip$(CHIP_VER))
　　TST_DB := $(strip $(TSTDIR))\database_classb
　　然后被包含到Option.mak文件中来，include $(strip$(VERNOFILE))。
　　
　　7．Gsm2.mak文件中new执行的指令
　　new : cleanall cmmgen mmi_feature_check asngen codegen asnregen operator_check_lite update
　　
　　update所执行的指令
　　update : cleanlog cleanbin mcddll_update codegen resgen cksysdrv remake
　　
　　remake所执行的指令
　　remake : mcp_check cleanlog cleanbin genverno libs $(BIN_FILE) done
　　
　　resgen用来编译资源文件：Res_XXX.c
　　
　　(echo CUSTOM_OPTION = $(foreach def,$(BOARD_VER) $(PLATFORM) $(LCD_MODULE) $(EXT_CAM_MODULE)$(CMOS_SENSOR),-D "$(def)") \>$(MMIDIR)\customer\resGenerator\custom_option.txt)
　　首先将CUSTOM_OPTION重定向到custom_option.txt中
　　
　　(type make\~cus_opt.tmp >>$(MMIDIR)\customer\resGenerator\custom_option.txt)
　　使用tools\strcmpex.exe生成~cus_opt.tmp, ~tgt_opt.tmp,~inc.tmp三个文件
　　将~cus_opt.tmp 重定向到custom_option.txt中
　　
　　(@del $(MMIDIR)\mmi\TargetOption.txt) &\
　　(copy /Y make\~tgt_opt.tmp $(MMIDIR)\MMI\TargetOption.txt)
　　再将TargetOption.txt更新一下，将~tgt_opt.tmp重定向到TargetOption.txt中
　　
　　(type make\~inc.tmp >$(MMIDIR)\customer\resGenerator\custom_include.tmp)
　　再将~inc.tmp重定向到custom_include.tmp中，
　　
　　执行replace_project_name.pl文件，编译Res_XXX.c
　　再执行ResGenerator_HW.bat，编译资源文件。
　　
　　8．Remake中的编译过程是在libs中完成的
　　目标依赖：libs: cleanlib startbuildlibs $(COMPLIBLIST)
　　Cleanlib在这个依赖中做的动作是清掉上次生成的.bin，.elf，.lis等文件，接着清掉需要重新来生成的.lib文件。$(COMPLIBLIST)这个依赖就是我们需要重新生成的.lib文件。
　　.lib文件的依赖关系：%.lib:
　　在这个依赖关系中所做的动作是设置编译器，链接器以及这个过程的参数等其他信息，然后将这些信息输出到：~compbld.tmp临时文件中。
　　
　　(tools\make.exe -fmake\comp.mak -k -r -R $(strip $(CMD_ARGU)) COMPONENT=$* >$(strip $(COMPLOGDIR))\$*.log) \
　　调用了make命令来执行comp.mak文件，并且可以看到> $(strip$(COMPLOGDIR))\$*.log
　　该语句将执行comp.mak文件时产生的信息存放在当前编译部分的.log文件中，通常看编译信息的比如custom.log等就是该中类型的文件。
　　
　　依赖关系：update_lib: $(TARGLIB)
　　$(TARGLIB) : $(COBJS) $(CPPOBJS) $(AOBJS) $(ARMOBJS)
　　$(TARGLIB)依赖很多.c和.obj
　　.c.obj:
　　@echo Compiling $< ...
　　@tools\strcmpex.exe $(ACTION) remake e $(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS) $(CINCDIRS) -o $(COMPOBJS_DIR)/$@$<
　　@tools\strcmpex.exe $(ACTION) remake n $(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS) $(CINCDIRS) $(MD) -o$(COMPOBJS_DIR)/$@ $<
　　@if exist $(*F).via tools\warp.exe $(*F).via
　　@if exist $(*F).via $(CMPLR) $(VIA) $(*F).via
　　@if not $(ACTION)==remake if exist $(FIXPATH)\$(*F).d perl.\tools\pack_dep.pl $(FIXPATH)\$(*F).d >$(RULESDIR)\$(COMPONENT)_dep\$(*F).det
　　@if not $(ACTION)==remake if exist $(FIXPATH)\$(*F).d del /f /q$(FIXPATH)\$(*F).d >nul
　　@if exist $(*F).via del /f /q $(*F).via
　　要生成.o依赖于.c文件，如果我的.c文件经过更新，那么该.o就需要重新生成，该.c就需要重新来编译。
　　@tools\strcmpex.exe $(ACTION) remake e$(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS)$(CINCDIRS) -o $(COMPOBJS_DIR)/$@ $<
　　@tools\strcmpex.exe $(ACTION) remake n $(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS) $(CINCDIRS) $(MD) -o$(COMPOBJS_DIR)/$@ $<
　　有两个编译环节，针对不同的编译动作，两者的不同点在于中间有个$(MD)编译选项，在有该选项的时间编译的时候就会生成依赖关系文件.d。
　　@if not $(ACTION)==remake if exist $(FIXPATH)\$(*F).d perl.\tools\pack_dep.pl $(FIXPATH)\$(*F).d >$(RULESDIR)\$(COMPONENT)_dep\$(*F).det
　　在这个的语句中有$(FIXPATH)\$(*F).d >$(RULESDIR)\$ (COMPONENT)_dep\$(*F).det该动作又将.d文件作为.pl文件的参数，执行该perl文件后将结果输出放在.det文件中。
　　@if not $(ACTION)==remake if exist $(FIXPATH)\$(*F).d del /f /q$(FIXPATH)\$(*F).d >nul
　　然后又执行这个语句，将.d文件删除。
　　在make文件中可以看到-include$(RULESDIR)\$(COMPONENT).dep
　　在查看各个.o的依赖关系的时间要查看该.dep文件来决定是否需要来重新编译生成该.o。
　　如果新添加了.h文件又没有来更新.dep文件就可能导致该.o查找依赖时没有依赖该.h。不去更新该.o。
　　@if exist $(FIXPATH)\$(CUS_MTK_LIB)\$(COMPONENT).lib \
　　(copy /z $(FIXPATH)\$(CUS_MTK_LIB)\$(COMPONENT).lib $(subst/,\,$(TARGLIB))) &\
　　($(LIB) -r $(TARGLIB) $(COMPOBJS_DIR)/*.obj) \
　　else \
　　($(LIB) -create $(TARGLIB) $(COMPOBJS_DIR)/*.obj)
　　在生成了.o文件后在.lib的依赖中可以看到($(LIB) -r$(TARGLIB) $(COMPOBJS_DIR)/*.obj)
　　该语句将生成的.o文件打包成.lib库文件。
　　
　　连接过程：$(BIN_FILE)：
　　最后完成编译：done:
　　# -----------------------------
　　# Clean temporary files in make directory
　　# -----------------------------
　　@echo Cleaning make\~*.tmp files ...
　　@if exist make\~*.tmp \
　　del make\~*.tmp
　　@echo Done.
　　@perl tools\time.pl -n
　　清掉临时文件，打出done信息，最后打出时间标签。