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)/[email protected] $<
@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)/[email protected] $<
有兩個編譯環節,針對不同的編譯動作,兩者的不同點在於中間有個$(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資訊,最後打出時間標籤。