MTK入门培训教程ver0.2.doc

MTK入门培训教程
MTK入门培训教程 1
一、搭建MTK环境 1
1、安装ARM Developer Suite (ADS) version 1.2 1
2、安装perl解释器 1
3、安装VC6.0 2
4、下载线驱动： 2
5、下载软件 2
二、安装MTK使用工具 2
1、 代码编辑软件 2
2、 代码比较工具 2
3、reflist.txt编辑软件 2
三、软件使用方法 2
1、Flash_Tool 2
四、MTK工程初步上手 3
1、编译方法： 3
2、模拟器的使用： 3
3、如何在MTK上添加一个菜单和图片： 3
4，如何在MTK上创建一个新的application 4
五、入门可以参考的文档有以下： 5

一、搭建MTK环境
1、安装ARM Developer Suite (ADS) version 1.2
路径：mtk环境工具\konka_ads12\ads12
安装步骤：双击setup.exe进行安装，按照提示进行安装。安装结束后程序要求导入序列号，选择导入序列号文件，找到mtk环境工具\konka_ads12\ads12\CRACK，导入LICENSE.DAT即可完成安装。
2、安装perl解释器
路径：mtk环境工具\ActivePerl-5.6.1.626-MSWin32-x86-multi-thread.msi
安装步骤：双击可执行文件按照提示完成安装。
3、安装VC6.0
路径：mtk环境工具\vc_setup\vc6
安装步骤：双击setup.exe安装提示安装即可。安装完后将mfc patch中的文件拷入system32目录中。
4、下载线驱动：
路径：mtk环境工具\6219B_USB_Line_Driver 2.0.1.1 (Recommend)prolific
安装步骤：将下载线插入USB口中，弹出驱动安装窗口，安装提示将目录定位在上面得路径中按照提示安装即可。
5、下载软件
路径：MTK系列工具20070703\FlashTool_v2.9.1002
安装步骤：无须安装，双击可执行文件Flash_tool.exe即可使用。
二、安装MTK使用工具
以下工具可按个人喜好选择安装，非必须。
1、 代码编辑软件：source insight 3.50。
2、 代码比较工具：1) beyond compare2.43 2) Araxis.Merge.v6.5.2241.Professional
3、reflist.txt编辑软件 UltraEdit 32 13.10

三、软件使用方法
1、Flash_Tool
1)打开后选单击Download Agent 按钮，出现文件选择框，选择Flash_Tool.exe所在根目录下的MTK_AllInOne_DA.bin。
2)单击Scatter-loading 按钮，出现文件选择框，选择MTK工程的如MTK6219\custom\system\WLS6219_05B_BB下的类似scat05B.txt(不同工程文件名不同)文件即可。
3)单击name 、region address 、begin address 、 end address、 location下的
ROM按钮。出现文件选择框选择MTK6219\build\WLS6219_05B下的BIN文件。
4)单击Options-COM port，选择下载线所在的com口，如com3口。
5)将手机reset一下，插入下载线，单击Download按钮，然后按手机的power键，等待几秒级可以下载。

四、MTK工程初步上手
MTK软件MMI部分使用C语言进行编写，因此具有一定的C语言基础是必须的。
1、编译方法：
MTK使用ARM编译器进行编译，在CMD中进入工程根目录输入命令make custom=xxx_05B gprs new/update/remake/clean。
几个关键字几个关键字解释如下：
1). xxx_05B，Project名，对应make目录下的xxx_05B _GPRS.mak文件；
2) 最后一个关键字：
a. new:
不管资源、代码是否有改变，全部重编；
b. update:
扫描资源、代码的改变，有改变的重编，无改变的不编；
c. remake:
不扫描资源，只扫描代码的改变，有改变的重编，资源和无改变的代码不编；
d. clean:
清除build目录下的所有内容，保留目录结构。

编译成功后，在build目录下生成所有的.obj，编译信息log文件、下载.bin文件等；
编译失败时，到build目录下查看相应的log文件，可看到出错信息。

2、模拟器的使用：
模拟器和MTK的真机环境MMI部分基本使用同一套代码，因此可以在模拟器上对MMI部分进行调试，不必浪费时间每次修改后下载到手机上进行查看，编译成功后即可使用MTK的模拟器，模拟器的工程文件在目录双击plutommi\mmi\ PixtelMMI.dsp即可启动VC，然后出现两个模块MMI和resource，分别将其编译后执行，出现模拟器窗口后将鼠标移到窗口上，单击回车即可启动。之后就可以像普通的VC程序一样下断点调试或者是预览你修改后的MMI界面。
3、如何在MTK上添加一个菜单和图片：
建议新手可以参考计算器这个工具对MTK的代码进行熟悉，文件Calculator.c
例子：在工具箱中添加一个菜单“电子地图”

步骤A)找到文件Res_MainMenu.c (plutommi\customer\custresource\pluto_mmi\res_mmi)
记得必须是这个路径的，另外一个同名的文件是会被这个文件覆盖的，然后找到这一行ADD_APPLICATION_MENUITEM((MAIN_MENU_ORGANIZER_MENUID,MAIN_MENU_SYSTEM_MENU_ID,5, (注意看控制的开关是否有效)。
将5改成6，既多一个菜单。在下面添加ORGANIZER_MAP_MENU。

步骤B)找到文件GlobalMenuItems.h (plutommi\mmi\inc)
在enum GLOBALMENUITEMSID {}中添加一个MenuID，如ORGANIZER_MAP_MENU。

步骤C)可新建一个文件res_map.c或者在res_mainmenu.c下添加
ADD_APPLICATION_MENUITEM((ORGANIZER_MAP_MENU,MAIN_MENU_ORGANIZER_MENUID, 0,SHOW,MOVEABLEACROSSPARENT|SHORTCUTABLE,DISP_LIST,STR_MENU_MAP,IMG_MAP_IMAGE));
其中STR_MENU_MAP为菜单显示的字符串，IMG_MAP_IMAGE为菜单前面的图标

步骤D）将字符串和图片添加到MTK工程中去。
在文件res_map.c中，或者在res_mainmenu.c中添加
ADD_APPLICATION_STRING2(STR_MENU_MAP,"Image Editor","Picture Editor");//字符串
ADD_APPLICATION_IMAGE2(IMG_MAP_IMAG,CUST_IMG_PATH"\\\\MainLCD\\\\ImageEditor\\\\TH_IM_Pen1.PBM","Backgropund image for Picture Editor Screen"); //图片
图片路径需要自己修改成图片所在的路径。然后将真实的图片放到\plutommi\Customer\Images\PLUTO176X220\MainLCD中去，将外面的image.zip删除后，重新压缩MainLCD成image.zip。PLUTO176X220表示你用的屏幕是什么尺寸的，这里是176X220的。
这里的STR_MENU_MAP和IMG_MAP_IMAG变量我们可以在相应的头文件中定义，如图片编辑器的文字、图片的资源文件变量定义在PictureEditorDefs.h中，这里我们可以临时将STR_MENU_MAP和IMG_MAP_IMAG也放在PictureEditorDefs.h中，仿照其枚举定义的方式将STR_MENU_MAP放在STR_PE_HELP_DESCRIPTION后面，将IMG_MAP_IMAG放在IMG_PE_IM_ARROW后面。

步骤E) 将字符串显示支持各种语言。
上面添加只是显示了英文，如果需要显示其他语言的字体，如汉字，需要在plutommi\Customer\CustResource\PLUTO_MMI\ref_list.txt中新建一行对应STR_MENU_MAP的内容。对应的内容有Enum Value（STR_ID） | Module Name(所在模块名，如GLOBAL，MainMenu) | Max String Length （字符串长度） | Description(描述) | English (要显示的英文字)| Tr_Chinese（要显示的繁体字） | Si_Chinese（简体字） | Thai（泰文）。可以仿照其中的一行，将其添加进去，如：
STR_MENU_MAP GLOBAL 20 MAPSTR MAP 地图 地圖
注意每个内容之间用TAB分隔开。
然后update或者是new一次工程，因为这里修改添加了资源和资源文件。

4，如何在MTK上创建一个新的application
MTK具有良好的扩展性，我们可以在上面进行二次开发，新增一些应用程序。以电子地图为例，新建一个EleMap.c及头文件EleMap.h文件后，可放入\plutommi\mmi\Organizer中，源代码可以放入ElemapSrc文件夹中， 头文件可以放入EleMapInc文件夹中。然后修改工程根目录下的Make文件夹make\plutommi中的plutommi.inc，这里是添加要编译的头文件目录的，plutommi.lis是要编译的源代码文件，plutommi.pth是源代码目录的文件夹。然后编译即可。入口程序可以参照其他应用程序来设计：例如可以使用：
SetHiliteHandler(MENU_PICTURE_EDITOR, Highlight_MENU_PICTURE_EDITOR);
这个是图片编辑器的highlight回调函数，即将光标移动到图片编辑器这个菜单后执行的函数。
五、入门可以参考的文档有以下：
MMI Platform Source Code Training.pdf、
GDI Introduction.pdf、
gdi_sample.c、
MMI Resource & Customization Tool.pdf
Writing Applications Using Pixtel MMI Platform.pdf、
Guide to Pixtel Network Simulator.pdf、
MTK_MakeBuild_Design_Customer_040930.pdf、
How_to_install_USB_cable_driver.pdf、
FlashTool v2.6 Application Note.pdf、
MTK入门导读.doc、
MTK软件说明.doc、
免费的mtk开发资料.doc

2007.08.17
前进动力科技

20070821 ver0.2