1.1.
本文编写的目的主要是为了从整体上理解MTK的编译过程,以便能够较快的处理编译中遇到的问题,同时为以后可能的优化编译过程提供参考。
1.2.
MTK的编译过程主要是在windows命令行下通过MakeFile文件来执行相应的perl脚本或c程序,将资源包生成c源程序,并与相应模块的c程序生成.o,.lib或.obj的中间代码,最终生成在手机上使用的.bin文件和在模拟器上使用的mmiresource.dll资源文件。
1.3.
命 令 | 说 明 |
Clean | 清除所有的目标文件、库文件和日志文件 |
New | 清除并重新编译所有的文件 主要完成工作 gsm2.mak cleanall cmmgen mmi_feature_check asngen codegen asnregen operator_check_lite update |
Update | 重新编译资源文件,生成相应的目标文件 主要完成的工作 gsm2.mak cleanlog cleanbin mcddll_update codegen resgen cksysdrv remake |
Remake | 仅仅编译依赖修改过的文件生成的模块 主要完成的工作 gsm2.mak mcp_check cleanlog cleanbin genverno libs $(BIN_FILE) done |
|
|
1.4.
编译用到的文件主要放在make文件夹中。各个文件的简要说明如下:
文件名 | 说 明 |
Gsm2.mak | 编译过程中主要执行的make文件,这个文件从命令行获得编译参数,做出相应的处理。它定义了各个参数的执行过程,包括:new、remake、update等。以及调用其它perl或c程序生成目标文件。 |
Option.mak | 定义了编译环境中用到的工具及相关的目录,根据大的编译开关定义了小的编译和链接选项,编译中包含文件和生成文件的路径,定义trace的头文件路径,全局的编译开关,用户的一些编译选项,最后定义了编译路径和目录。 |
XXX.lis | XXX模块的.c文件 |
XXX.pth | XXX模块的.c文件存放的路径 |
XXX.def | XXX模块用到的编译开关,当XXX模块引用其它模块中在编译开关下定义的变量、函数或宏时,就需要将这个编译开关加进来。 |
XXX.inc | XXX模块用到的头文件路径,需要将XXX模块引用的头文件及,头文件引用的头文件的路径均要包含进来。 |
XXX_GPRS.mak | 定义了需要编译的模块列表、编译中包含文件和生成文件的路径,定义trace的头文件路径,全局的编译开关,用户的一些编译选项,最后定义了编译路径和目录。 |
Comp.mak | 编译和集成模块源文件,编译生成库文件。构建目标代码依赖列表,设置每个模块的编译路径及编译选项,设置生成目标lib的路径,设置生成obj的路径 |
~buildinfo.tmp | 包含了在Gsm2.mak和Option.mak中用到的项目和平台名称 |
~compbld.tmp | 包含了编译每个模块时的编译信息。 |
MT6218B.log | 记录了Gsm2.mak文件编译过程 |
MT6218Br目录 | 包括了每个模块依赖的头文件 |
MT6218Bo目录 | 包含所有生成的obj文件和lib文件。 |
|
|
1.5.
1、new
功能:全新开始构建整个工程的ARM版,包括图片、声音、字符串等资源都要重做。在构建工程过程中,清除所有的目标文件,库文件,日志文件等。New指令还会自动创建必要的目录、移除临时文件和中间脚本、更新日志文件。
过程简要说明:new->cleanall->sysgen->ckscatter->mmi_feature_check->asngen->codegen->asnregen->operator_check_lit->$(BTLD_BIN_FILE)->update。
依赖指令:new依赖的其他指令最多,其中包括cleanall,sysgen,ckscatter,mmi_feature_check,asngen,codegen,asnregen,operator_check_lite,update.
用途:new指令是最彻底也是耗时最长的一个动作,一般得到一个新的MTK发布版本后由项目负责人要做一次。
使用示例:C: BIRD25_GEMINI_07BRelease>make BIRD25_GEMINI_07B gprs new。
2、update
功能:update是重新更新整个工程的ARM版,该动作会扫描工程中文件和库的依赖关系,若依赖关系有变化会建立新的依赖关系,随后根据新的依赖关系重新编译链接有改动的部分。Update指令不依赖cleanall指令,所以它不会删除目标文件和库文件,也不会去更新日志文件和创建目标目录,这一点和remake相像,这也是为什么执行时间比new短的原因。
过程简要说明:update->cleanlog->cleanbin->mcddll_update->codegen->resgen->cksydrv->remake。
依赖指令:cleanlog,cleanbin,mcddll_updata,codegen,resgen,cksydrv,remake。
用途:update是耗时较长的一个指令,一般在增加或删除一些驱动或应用情况下使用。
使用示例:C: BIRD25_GEMINI_07BRelease>make BIRD25_GEMINI_07B gprs update。
3、remake
功能: remake是重新编译整个工程的ARM版,该动作只是简单的重新编译链接有改动的部分。它不检查依赖关系.不扫描资源,只扫描代码的改变,有改变的重编,资源和无改变的代码不编。
过程简要说明:remake->mcp_check->cleanlog->cleanbin->genverno->libs->$(BTLD_BIN_FIKE)->cmmgen->done。
依赖指令:mcp_check,cleanlog,cleanbin,genverno,libs,$(BIN_FIKE),cmmgen,done。其中最重要的两个指令是libs,$(BIN_FIKE)。Libs调用编译器和连接器将各个模块目录下的C文件编译连接为独立的库。$(BIN_FIKE)是将各个模块编译连接的库和mtk_lib目录下的库一起连接起来得到一个映像文件,然后使用ADS的工具fromelf将映像文件生成以变量BIN_FILE命名的二进制文件,该文件可以下载到硬件板上运行。
用途:remake是耗时最短的一个动作,也是最常用的动作。
使用示例:C: BIRD25_GEMINI_07BRelease>make BIRD25_GEMINI_07B gprs remake。
4、clean
功能:清除所有的目标文件,临时文件,库文件,可执行文件,更新日志文件。还可以用于某个模块相关的清除工作。
过程简要说明:check build root、target folder、comp、lib、comp log folder->clean bin folder、elf、lis、htm、log files、tst database files、obj,lib files。
依赖指令:cleanlog,cleanbin,cleanmod,cleancodegen等。
用途:作为其它命令所依赖的指令,还有就是清除工程或者指定模块对象的类库。
使用示例:C: BIRD25_GEMINI_07BRelease>make BIRD25_GEMINI_07B gprs clean,C: BIRD25_GEMINI_07BRelease>make BIRD25_GEMINI_07B gprs clean Init。
5、其他命令介绍
new_modis:是全新构建整个工程的PC模拟版,其调用VC的编译器和链接器得到一个可以在windows上运行的PC模拟版。MMI应用软件工程师可以在没有硬件板的情况下在PC上检查和调试自己写好的应用。
codegen_modis:产生modis需要的trace文件的datebase。
gen_modis:产生vc工程文件。
remake_modis:重新编译整个工程的PC版。
Codegen:创建TST数据库。它依赖的指令有:cleancodegen,asngen,[umts_gen],codegen,asnregen,cleanbin,mcddll_update,done。
Cleancodegen:删除codegen.lis。
Resgen:生成MMI资源。它依赖的指令有:code_generate,cleancodegen,asngen,codegen,asnregen,cleanbin,mcddll_update,done。
Cmmgen:生成CMM文件。
Sysgen:生成内存映射文件,并放在CUSTOMER文件夹里面。
Emigen:生成flash_opt.h,custom_EMI.h,custom_EMI.c和custom_switchclock.c文件。
Emiclean:清除EMI设置。
Mmi_feature_check:根据MMI_features.h和MMI_features_switch.h中宏定义的不同来产生info.log文件。
Operator_check:检查customer的宏是否被修改,如果修改产生相应log文件。
Fota:生成FOTA二进制文件。
Bootloader:生成bootloader二进制文件。
Ckscatter:检查scatter文件
Mmi_obj_check:检查运行时间值,e.g,联合体元素的大小等。
Med_mem_check:检查media memory。该指令依赖gencustominfo gen_infolog nvram_auto_gen。
Dummy_data_check:检查虚拟数据。
Viewlog:查看日志文件。
Cksysdrv:检查系统驱动是否为满。
Genverno:生成verno.c/h。
Mcddll_update:生成和更新tst mcddll.dll文件。
Gen_bl_verno:生成bootloader版本号。
Del_fota:删除fota二进制文件和elf,lis,sym,htm.*.log文件。
实践:
一,要手动修改flash类型时:
(1)没有打开USB_DOWNLOAD
emiclean -> emigen -> r
(2)打开了USB_DOWNLOAD
emiclean -> emigen -> bootloader -> c,r custom init drv -> r
action = new (codegen, resgen, clean, update) (default)
= update or u (scan, compile, link)
= slim_update (scan, compile, link without generating mcddll)
= remake or r (compile, link)
= clean or c (clean)
= cci or clean_codegen (clean codegen intermedia files)
= resgen (resgen)
= c,u (clean then update)
= c,r (clean then remake)
= codegen (codegen)
= slim_codegen (codegen without generating mcddll)
= update_mcddll (codegen and generate mcddll)
= slim_mcddll (generate mcddll without codegen)
= viewlog (open edit to view build log)
= emigen (emigen)
= emiclean (emiclean)
= check_dep (check dependency module(s) after source(s)/header(s) changed)
= remake_dep (check_dep, remake)
= update_dep (check_dep, update)
Example:
make gsm new (MT6205B EVB new)
make gprs codegen (MT6218B EVB codegen)
make mt6219 gprs update (MT6219 EVB update)
make firefly17_demo gprs new
make milan_demo gprs c,u init custom
make mt6219 gprs r init custom drv
make mt6229 gprs check_dep init/include/init.h
make mt6229 gprs remake_dep @make/init/init.lis
make mt6229 gprs update_dep init/src/init.c
1.6.
1、mtk_resgenerator.exe不能正常运行。可能是ResGenerator文件夹中的某些文件有错误。一个原因是在ResGenerator文件夹中缺少temp.rgb这个文件,并且不能自动生成。
2、240X320屏的Font_res.c文件的错误,因为打开了中文字体的编译开关,只需要将mmi_featurespluto.h文件中__MMI_LANG_SM_CHINESE__的编译开关关闭即可。
3、出现以下错误,"plutommi/mmi/FunAndGames/FunAndGamesSrc/Game.c", line 349: Error: C2455E: array [0] found
"plutommi/mmi/FunAndGames/FunAndGamesSrc/Game.c", line 350: Error: C2455E: array [0] found
因为默认的240X320屏幕打开的关于游戏的编译开关下没有游戏,所以需要打开mmi_featurespluto.h文件中的__MMI_GAME_VSMJ_240x320__编译开关。
4、现象:mmiresource模块生成错误:
"plutommi/Customer/custresource/custimgmapext.c", line 31: Error: C2456E: undeclared name, inventing 'extern int MAX_IMAGE_IDS'
"plutommi/Customer/custresource/custimgmapext.c", line 31: Serious error: C2958E: illegal in constant expression: non constant 'MAX_IMAGE_IDS'
plutommi/Customer/custresource/custimgmapext.c: 0 warnings, 1 error, 1 serious error
原因:改变了屏幕大小后,128X160目录下的图片资源有问题。
解决办法:更换128X160目录下的图片资源,重新编译此模块。
5、现象:Free clusters are NOT enough . Check ckSysDrv.log for detail !
Tools/make.exe: *** [cksysdrv] Error 1
解决办法:删除掉/custom/system/CCDH26_05C_BB目录下的
custom_EMI.c
custom_EMI.h
flash_opt.h
三个文件。
6、现象:在新加模块的.c文件中引用一个b.h,产生b.h中的aaa变量没有定义的错误,具体错误如下:
原因:没有包含定义aaa变量的头文件a.h。
解决办法:在include b.h之前include a.h
7、现象:"plutommi/Customer/custresource/CustImgDataHW.h", line 19361: Serious error: C2934E: duplicate definition of '________CUSTOMER__IMAGES__EMPTYIMAGE_BMP'
原因:
解决办法:删掉CustImgDataHW.h这个文件重新编译
8、现象:在链接bin文件时,出现以下错误:
Error: L6218E: Undefined symbol custom_setAdvEMI (referred from bootarm.obj).
原因:custominfo.pl文件没有修改,默认只打开CCDH26_05C_GPRS.mak一个文件,并不打开其它定义编译开关的文件,导致custom模块中的有些文件没有编译,所以一些变量在最后链接时显示未定义。
解决办法:修改custominfo.pl文件。
8、现象:编译某个模块,出现错误:
Error: L6218E: Error: C2933E: type disagreement for 'mmi_phb_info_entry_list'
原因:调用mmi_phb_info_entry_list函数时传递的参数不正确,或者是函数mmi_phb_info_entry_list在调用时还未定义。
解决办法:修改custominfo.pl文件。
9、现象:编译时出现字符串未定义的错误,
enum_list.h:2046: error: `STR_ENTERTAINMENT_EXPLAIN_WOMANKNOWLEDGE' undeclareere (not in a function)
原因:可能是编译开关没打开,或者是正在使用excel表,readexcel.c中没有添加相关的头文件。
还有一种可能是在使用这个字符串ID的模块的make底下的.inc文件中没有将定义这个字符串的头文件路径加上。还要注意防止头文件引用的宏定义是不是重复。