展讯MMI软件开发平台_最完整版.ppt

MMI软件开发平台,Date：3/3/2005,Created by：Phoebe Chen Figo Feng Lin Lin,2023年2月21日,Proprietary and Confidential Information,2,Contents,平台介绍和计划安排Kenel接口GUI接口开发和调试实例,2023年2月21日,Proprietary and Confidential Information,3,平台介绍和计划,Spreadtrum提供了一套基于类似 mini widows机制的MMI开发平台，并且提供了与网络相关部分的MMI源码。同时我们也提供了MMI开发的配套工具软件包。客户可以基于此方便的做二次开发。现已有多款手机使用此平台进行开发。,2023年2月21日,Proprietary and Confidential Information,4,平台结构,SOFTWARE APPLICATION PLATFORM,RTOS,Diagnostics,Drivers(HAL),MN(Call,CB,NV,SS,SMS,GPRS),Layer 3,Layer 1,Layer 2,TCP/UDP,IP/PPP,RTP/RTCP,Multimedia ApplicationsAudio/Video/Test,Call SMSCBS SSPB Game.MMI,WAP,MMS/WEB,E-Mail,SIP,H.324/M,PTT,ATC,MIDIMP3MPEG4H.263Engines,J2ME,Java App,DAL（LCD,KPD,CHR）AUDIO,VIDEO,OSAEFS,MMI Platform,2023年2月21日,Proprietary and Confidential Information,5,一个MMI示例,2023年2月21日,Proprietary and Confidential Information,6,简述MMI开发平台的三个重要概念,Application:描述了MMI Kernel中处理PS消息非常重要的模块，例如sms,cc.WINDOW：窗口，用于处理focus消息（在此窗口下面才需要处理的消息）Control：控件，也就是窗口要用到的公共的特性，比如编辑特性、Text显示特性、动画特性等等,2023年2月21日,Proprietary and Confidential Information,7,Application、Window和Control的关系,APPLICATION,WINDOW,CONTROL,CONTROL,CONTROL,2023年2月21日,Proprietary and Confidential Information,8,2.Kernel接口,MMI Kernel主要提供完善的消息驱动流程和窗口管理机制。为各种上层应用（CC、SMS、WAP、MMS等）提供良好的支持。,2023年2月21日,Proprietary and Confidential Information,9,Kernel提供的功能,1.对消息流程进行管理外部消息主要包括PS消息、key消息、Timer消息和一些由其它模块发送过来的消息；内部消息MMI模块内部发送、接收和处理的消息，不与其它模块发生任何关系.(现在我们用到的就是focus消息，由窗口处理，这类消息使用最多最频繁)2.提供窗口管理机制了解Kernel对窗口的管理机制：通过维护一个全局变量：是MMI Kernel中一个非常核心的数据结构，它是整个窗口调度过程的核心，这个数据结构由MMI Kernel维护。,2023年2月21日,Proprietary and Confidential Information,10,Application的概念,Application：描述了MMI Kernel中非常重要的应用处理模块。可以分为两类：需要注册系统消息的（SMS Application,Call Application,Stk Application）不需要注册系统消息的（DC,Multimedia）,2023年2月21日,Proprietary and Confidential Information,11,注册消息APPLICATION举例,系统消息由Application处理。如果需要系统消息，Application在初始化时要注册需处理的消息。Kernel只会根据注册的Application来分发。一个PS消息可以被多个Application注册，Kernel会依次分发消息给各个Application。我们现在需要注册消息的应用：g_main_app g_cc_app g_sms_app g_mmiphone_app g_stk_app.静态的，全局，一般在初始化时建立。,2023年2月21日,Proprietary and Confidential Information,12,Window的概念,Window：窗口是最终用户可以直接看到的一个个实在的屏幕，是直接和用户打交道的，专门处理用户的按键输入等操作，并且将最终用户输入后的处理结果显示在屏幕上。窗口的消息处理函数，用来处理最终用户的直接输入。窗口还要管理其所属的控件，将部分消息交给控件处理。,2023年2月21日,Proprietary and Confidential Information,13,Control的概念,Control：控件，也就是窗口要用到的公共的特性，比如编辑特性、Text显示特性、动画特性等等。使用控件可以使开发人员专注于应用的功能开发，而不是过多限制在界面的开发。,2023年2月21日,Proprietary and Confidential Information,14,Kernel中的窗口管理,窗口管理是MMI Kernel中非常重要的部分，直接决定了上层应用的开发。窗口管理主要包括应用窗口和控件之间的管理和通信、各个窗口间稳定的切换。应用窗口负责上层的应用和显示等。,2023年2月21日,Proprietary and Confidential Information,15,Kernel中的窗口管理，举例,建立窗口的一些常量的属性：建立窗口wintab:WINDOW_TABLE(MMISMS_EDIT_WIN_TAB)=CLEAR_LCD,/清屏WIN_PRIO(WIN_ONE_LEVEL),/窗口优先级WIN_TITLE_ID(TXT_SMS_WRITE),/固定的titleWIN_FUNC(uint32)HandleEditWinMsg),/窗口消息处理函数WIN_ID(MMISMS_EDIT_WIN_ID),/IDCREATE_TEXTEDITBOX_CTRL(MMISMS_FULLSCREEN_CLIENT_LEFT,MMISMS_FULLSCREEN_CLIENT_TOP,MMISMS_FULLSCREEN_CLIENT_RIGHT,MMI_INPUT_EDITBOX_BOTTOM,MMISMS_MAX_UCS2_MESSAGE_LEN,MMISMS_MAX_MESSAGE_LEN,T9_PINYIN|T9_STROKE|T9_ENGLISH|T9_CHARACTER|T9_DIGITAL,T9_PINYIN_MODE,MMISMS_EDITWIN_EDITCTRL_ID),/控件END_WIN;详细的讲解请见后面应用实例,2023年2月21日,Proprietary and Confidential Information,16,窗口Priority,设置窗口优先级的目的是为了保护那些重要的窗口在处于Focus状态下不被打断，比如Call窗口，在Call的过程中不应该出现被SMS或者Alarm窗口打断，否则会影响Call的过程。我们在这里暂时制定了4个优先级：WIN_LOWEST_LEVEL,WIN_ONE_LEVEL，WIN_TWO_LEVEL，WIN_THREE_LEVEL。我们提供了操作窗口优先级的两个函数：GetWinPriority，SetWinPriority。用户可以根据应用来调用这两个操作窗口优先级的函数。在窗口的初始化（针对静态常口）和创建（针对动态窗口）过程中，需要对窗口优先级进行设置。,2023年2月21日,Proprietary and Confidential Information,17,窗口Priority（续）,2023年2月21日,Proprietary and Confidential Information,18,虚拟窗口,虚拟窗口主要是指那种已经打开了但是无法得到Focus的应用窗口。比如在打电话的过程中来了一条短信，因为Call的窗口的等级比较高，这个时候来短信的窗口无法得到Focus，也无法显示出来。当前应用窗口结束后，系统会优先使虚拟窗口链表中的应用窗口得到Focus。等级越高的应用窗口越先打开，当应用窗口处于同一等级时，按照先进先出方式（后打开的得到Focus）打开应用窗口。,2023年2月21日,Proprietary and Confidential Information,19,Kernel中的消息机制,2023年2月21日,Proprietary and Confidential Information,20,消息分类,从消息的接收情况，分为外部消息主要包括PS消息、key消息、Timer消息和一些由其它模块发送过来的消息；内部消息，MMI模块内部发送、接收和处理的消息，不与其它模块发生任何关系.在App_Task的消息循环当中总是处理完内部消息之后再处理外部消息。,2023年2月21日,Proprietary and Confidential Information,21,消息分类（续）,根据不同的消息发送和处理流程来划分，消息分为4个类别：第一类消息为系统消息（主要为PS消息和其它一些System消息），只有App在注册后才能够处理这条消息，对于没有注册的系统消息，将交给默认的MainApp处理。一条系统消息可以被多个App注册和处理。第二类为Focus消息，系统直接将这种类型的消息直接发送给处于Focus状态的APP，由APP对消息进行处理。第三类广播消息，将根据Application的链表，调用每一个的消息处理过程，这属于每一个App都要处理的过程，每个App只处理自己感兴趣的消息，至于App的处理方式（是交给Window处理还是App本身处理），系统没有任何限制。（这个暂时没有用过）第四类定时器消息，由于定时器使用的比较广泛，而且无法将其归为系统消息或Focus消息，为了更好的处理，将其单独的作为一类消息处理。,2023年2月21日,Proprietary and Confidential Information,22,外部消息处理,外部消息由Application来处理；外部消息需要Application事先在mmk_regapp.def中定义应用所关心的消息；外部消息队列由嵌入式操作系统维护；,2023年2月21日,Proprietary and Confidential Information,23,内部消息处理,内部消息不需要应用模块进行注册；内部消息由Window，Control处理；内部消息队列由Kernel模块维护；内部消息定义在mmk_msg.h中；,2023年2月21日,Proprietary and Confidential Information,24,消息处理流程,MMI KERNEL,Queue,(external),Control,WINDOW,APPLICATION,2023年2月21日,Proprietary and Confidential Information,25,窗口通信,一般的窗口（包括应用窗口和控件）都需要彼此之间能够传送消息，比如应用窗口需要将消息传给控件（一个刷新的消息）或者一个控件需要另一个控件处理消息等，这些都会涉及到窗口间的通信，一般有两种通信方式：异步通信方式，用MMK_PostMsg()函数来实现。异步通信方式主要将消息发送到内部消息队列中，即当发送消息的窗口返回后，这条消息才会被处理。因为这是一种Focus消息，所以接收的窗口必须是应用窗口，只有应用窗口才可以得到Focus。同步通信方式，用MMK_SendMsg()函数来实现。,2023年2月21日,Proprietary and Confidential Information,26,3 GUI接口,GUI 模块的主要功能就是给应用开发提供最基本的图形控件接口，并跟窗口系统、消息机制结合，处理基本的人机操作。,2023年2月21日,Proprietary and Confidential Information,27,Control的基本属性,图形化，和用户交互可以Active可接受消息，有消息处理函数依赖于窗口存在每个具体的control有唯一ID,2023年2月21日,Proprietary and Confidential Information,28,控件的使用,有2种形式1.在wintable中加入一个控件2.动态创建,2023年2月21日,Proprietary and Confidential Information,29,控件的使用-wintable,CREATE_MENU_CTRLCREATE_LISTBOX_CTRLCREATE_TEXTEDITBOX_CTRLCREATE_ANIMATION.,2023年2月21日,Proprietary and Confidential Information,30,控件的使用动态创建,创建控件:GUIANIMATE_Init()将该控件加入到window中 MMK_CreateDynaCtrl()设定控件的参数:GUIANIMATE_SetParam,2023年2月21日,Proprietary and Confidential Information,31,GUI提供的控件,Menu控件：菜单控件EditBox控件：编辑框控件ListBox控件：列表框控件TextBox控件：文本框控件Animate控件：图形控件MessageBox控件：消息框控件ProgressBox控件：进度条控件Punctuation控件：标点符号控件SoftKey控件：软键盘控件Calendar控件：日历控件字库：字体LCD：显示屏T9：输入法,2023年2月21日,Proprietary and Confidential Information,32,Menu控件介绍,树状结构，显示多级菜单实现菜单项的设定，显示，上下左右按键选择，选中后自动进入下级子菜单，或者执行相应的操作菜单项文字过长滚动显示 分为两类：静态菜单，动态菜单目前已实现的风格：文字菜单，旋转图，九宫格,2023年2月21日,Proprietary and Confidential Information,33,添加静态菜单,1.添加menu id(mmi_menutable.h)2.添加menu and menu item(mmi_menutable.c)3.将新增加的menu加入menutable中(mmi_menutable.def)4.为菜单项写处理函数,2023年2月21日,Proprietary and Confidential Information,34,添加动态菜单,1.调用GUIMENU_InsertNode,2023年2月21日,Proprietary and Confidential Information,35,EditBox控件,能正确编辑、录入数字号码、密码、字母及文字包括标题、软键盘；日期、时间、秒表、密码、数字号码、字母、非ascii码文字等正文的各种特殊显示显示编辑中的光标显示编辑中候选字的显示；自动分页支持滚动条支持的输入法：T9,2023年2月21日,Proprietary and Confidential Information,36,ListBox控件,分为三类：单选，多选，文字支持上下滚动，连续滚动支持数据分批载入在标题上显示当前项和总项数（例如 2/200）动态添加，删除，更改,2023年2月21日,Proprietary and Confidential Information,37,TextBox控件,显示一段文本包括标题、软键盘；文本内容文本内容超过屏幕大小自动换行支持滚动条响应向上键向上卷动或翻页响应向下键向下卷动或翻页,2023年2月21日,Proprietary and Confidential Information,38,Animate控件,显示图形、图象、动画。bmp,icon图像以及jpg,gif等流行的图像格式示，自定义动画以及gif等流行的动画格式的显示。,2023年2月21日,Proprietary and Confidential Information,39,MessageBox控件,显示弹出框支持图片，动画，文字，softkey，背景色的设定支持多种显示风格,2023年2月21日,Proprietary and Confidential Information,40,Punctuation控件,显示当前支持的所有标点符号和编辑框配合使用，将选中的标点符号插入到文本中,2023年2月21日,Proprietary and Confidential Information,41,Calendar控件,显示日历一页显示一个月的内容，12个月份有不同的背景图片，年月，周日周六，日期，当前日与其他日有不一样的颜色响应上键向前移一月，响应下键向后移一月，响应左键向前移一天，响应右键向后移一天。,2023年2月21日,Proprietary and Confidential Information,42,其他控件,SoftKey控件：可设定文字，背景，iconProgressBox控件显示当前进度 可设定最大值，最小值，当前值Label控件显示一行文字，过长则滚动显示可动态更改显示区域，文字,2023年2月21日,Proprietary and Confidential Information,43,GUI_LCD,直接在屏幕上画线，显示图片对底层lcd驱动进行包装LCD_DrawHLine,LCD_DrawVLine,LCD_DrawRect,LCD_FillRect,LCD_DisplayCompressedBmp,LCD_DrawLine.,2023年2月21日,Proprietary and Confidential Information,44,GUI_Font,直接在屏幕上显示字符串获得字体的高度，宽度GUI_GetFontWidth，GUI_GetFontHeight，LCD_DisplayStringInRect，LCD_DisplayString.,2023年2月21日,Proprietary and Confidential Information,45,Control风格,每一类control和window的缺省显示风格定义在文件mmi_theme.c/h中用户可自定义各种不同的字体，背景色，前景色mmidisplay_data.c/h,2023年2月21日,Proprietary and Confidential Information,46,GUI接口的参考,详情参考GUI接口说明书及其相关头文件。,2023年2月21日,Proprietary and Confidential Information,47,应用实例：（以SMS应用为例）,开发实例一、Application的创建开发实例二、利用Window Table设计窗口开发实例三、更改图片铃声资源,2023年2月21日,Proprietary and Confidential Information,48,开发实例一、Application的创建,Step 1：创建工作目录和相应的文件。Step 2：定义Application变量。Step 3：在mmk_ext_app.h中增加sms全局应用变量。Step 4：注册系统消息。Step 5：初始化sms应用模块。Step 6：编写应用消息处理函数。,2023年2月21日,Proprietary and Confidential Information,49,Step 1：创建工作目录和相应的文件。,建立以下三个目录：.MS_APPBMMISourceAppSMS.MS_APPBMMISourceAppSMSc.MS_APPBMMISourceAppSMSh增加以下C/H文件(根据模块需要而定)mmismsapp_main.cmmismsapp_order.cmmismsapp_wintab.cmmisms_api.hmmisms_app.hmmismsapp_wintab.h,2023年2月21日,Proprietary and Confidential Information,50,Step 2：定义Application变量。,在mmisms_main.c中增加变量定义：MMI_APPLICATION_T g_mmisms_app;/SMS的实体,2023年2月21日,Proprietary and Confidential Information,51,Step 3：在mmk_ext_app.h中增加sms 全局应用变量,#ifdef _cplusplus extern C#endif.extern MMI_APPLICATION_T g_cc_app;extern MMI_APPLICATION_T g_mmisms_app;/SMS的实体 extern MMI_APPLICATION_T g_mmipb_app;.#ifdef _cplusplus#endif,2023年2月21日,Proprietary and Confidential Information,52,Step 4：注册系统消息,在mmk_regapp.def文件中增加此应用模块希望处理的系统消息。例如，SMS应用可以接收消息ID号码在APP_MN_SMS_READY_IND到APP_MN_SMSCB_REJ_IND之间的消息。则在mmk_regapp.def文件中增加：REG_APP(APP_MN_SMS_READY_IND,APP_MN_SMSCB_REJ_IND,&g_mmisms_app),2023年2月21日,Proprietary and Confidential Information,53,Step 5：初始化sms应用模块。,在MMIMAIN.C中增加对sms应用模块的初始化：void APP_Init(void).MMIPHONE_AppInit();MMISMS_AppInit();/sms应用模块的初始化MMIPB_InitApp();.,2023年2月21日,Proprietary and Confidential Information,54,Step 5：初始化sms应用模块(续),在sms模块的初始化函数中指定消息处理函数和component类型void MMISMS_AppInit().g_mmisms_app.ProcessMsg=HandlePsMsg;g_mmisms_ponent_type=CT_APPLICATION;.,2023年2月21日,Proprietary and Confidential Information,55,Step 6：编写应用消息处理函数,LOCAL MMI_RESULT_E HandlePsMsg(PWND app_ptr,uint16 msg_id,DPARAM param)uint8 result=MMI_RESULT_TRUE;switch(msg_id)case APP_MN_SMS_READY_IND:break;case APP_MN_READ_SMS_CNF:break;,2023年2月21日,Proprietary and Confidential Information,56,Step 6：编写应用消息处理函数（续）,case APP_MN_UPDATE_SMS_STATE_CNF:break;.default:result=MMI_RESULT_FALSE;break;return(result);,2023年2月21日,Proprietary and Confidential Information,57,开发实例二、利用Window Table设计窗口,请参考MMK_Window_Table开发说明书.docStep 1：在win.def文件中声明窗口表。Step 2：在mmk_type.h文件中声明窗口ID。Step 3：在mmk_type.h文件中声明控件ID。Step 4：在mmi_text.def文件中声明文本的ID。Step 5：创建Window Table表。Step 6：使用Window Table表打开窗口。Step 7：实现窗口的消息处理函数。Step 8：依次类似编写每个Window。,2023年2月21日,Proprietary and Confidential Information,58,Step 1：在win.def文件中声明窗口表。,.WIN_DEF(MMISMS_MENUWIN_TAB)WIN_DEF(MMISMS_EDIT_WIN_TAB)WIN_DEF(MMISMS_EDITOPTION_WIN_TAB).,2023年2月21日,Proprietary and Confidential Information,59,Step 2：在mmk_type.h文件中声明窗口ID,typedef enum BEGIN_WIN_ID,.MMISMS_MENU_WIN_ID,MMISMS_EDIT_WIN_ID,MMISMS_EDITOPTION_WIN_ID,.MMI_WINDOW_ID_E;,2023年2月21日,Proprietary and Confidential Information,60,Step 3：在mmk_type.h文件中声明控件ID,typedef enum BEGIN_CTRL_ID,.MMISMS_MENU_CTRL_ID,MMISMS_EDITWIN_EDITCTRL_ID,MMISMS_SENDNUMOPTION_LISTCTRL_ID,.MMI_CONTROL_ID_E;,2023年2月21日,Proprietary and Confidential Information,61,Step 4：在mmi_text.def文件中声明文本的 ID。,.TEXT_DEF(TXT_SMS_WRITE,Write,x06x51x99x6dx88x60 x6f)/写消息.,2023年2月21日,Proprietary and Confidential Information,62,Step 5：创建Window Table表。,WINDOW_TABLE(MMISMS_EDIT_WIN_TAB)=CLEAR_LCD,WIN_PRIO(WIN_ONE_LEVEL),WIN_TITLE_ID(TXT_SMS_WRITE),WIN_FUNC(uint32)HandleEditWinMsg),WIN_ID(MMISMS_EDIT_WIN_ID),CREATE_TEXTEDITBOX_CTRL(0,20,127,110,MMISMS_MAX_UCS2_MESSAGE_LEN,MMISMS_MAX_MESSAGE_LEN,T9_PINYIN|T9_STROKE|T9_ENGLISH|T9_CHARACTER|T9_DIGITAL,T9_PINYIN_MODE,MMISMS_EDITWIN_EDITCTRL_ID),END_WIN;,2023年2月21日,Proprietary and Confidential Information,63,Step 5：创建Window Table表（续）,说明：WINDOW_TABLE：是用来定义Table数组的，后面的参数是数组名，在应用调用MMK_CreateWin的时候需要用到。CLEAR_LCD：清除LCD Buffer。WIN_PRIO：设置窗口优先级的，参数为MMI_WIN_PRIORITY_E枚举类型。WIN_TITLE_ID：用于设置窗口的标题。后面的参数是窗口文本的ID。WIN_FUNC：设置窗口的消息处理函数。后面的参数是该窗口的消息处理函数。WIN_ID：设置窗口ID，参数为MMI_WINDOW_ID_E枚举类型。CREATE_TEXTEDITBOX_CTRL：用于创建一个Text EditBox控件。END_WIN：Window Table的结束标志，每一个Window Table的最后一个成员必须是END_WIN宏。,2023年2月21日,Proprietary and Confidential Information,64,Step 6：使用Window Table表打开窗口。,MMK_CreateWin(uint32*)MMISMS_EDIT_WIN_TAB,PNULL);,2023年2月21日,Proprietary and Confidential Information,65,Step 7：实现窗口的消息处理函数,LOCAL MMI_RESULT_E HandleEditWinMsg(MMI_WINDOW_ID_E win_id,MMI_MESSAGE_ID_E msg_id,DPARAM param)MMI_RESULT_E recode=MMI_RESULT_TRUE;TEXTEDIT_STRING_INFO_T edit_string;switch(msg_id)case MSG_OPEN_WINDOW:break;case MSG_FULL_PAINT:break;,2023年2月21日,Proprietary and Confidential Information,66,Step 7：实现窗口的消息处理函数（续）,case MSG_CLOSE_WINDOW:break;.default:recode=MMI_RESULT_FALSE;break;return recode;,2023年2月21日,Proprietary and Confidential Information,67,Step 8：依次类似编写每个Window,2023年2月21日,Proprietary and Confidential Information,68,Thanks!,