1. 程式人生 > >MTK 軟體工程的配置說明

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)/

[email protected]$<
  @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)/
[email protected]
$<
  @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資訊,最後打出時間標籤。