MMI软件开发平台

2023年11月21日ProprietaryandConfidentialInformation1Contents平台介绍和计划安排Kenel接口GUI接口开发和调试实例2023年11月21日ProprietaryandConfidentialInformation2平台介绍和计划 Spreadtrum提供了一套基于类似miniwidows机制的MMI开发平台，并且提供了与网络相关部分的MMI源码。同时我们也提供了MMI开发的配套工具软件包。客户可以基于此方便的做二次开发。现已有多款手机使用此平台进行开发。2023年11月21日ProprietaryandConfidentialInformation3平台结构SOFTWAREAPPLICATIONPLATFORMRTOSDiagnosticsDrivers(HAL)MN(Call,CB,NV,SS,SMS,GPRS)Layer3Layer1Layer2TCP/UDPIP/PPPRTP/RTCPMultimediaApplicationsAudio/Video/TestCallSMSCBSSSPBGame….MMIWAPMMS/WEBE-MailSIPH.324/MPTTATCMIDIMP3MPEG4H.263EnginesJ2MEJavaAppDAL（LCD,KPD,CHR）AUDIO,VIDEOOSAEFSMMIPlatform2023年11月21日ProprietaryandConfidentialInformation4一个MMI示例2023年11月21日ProprietaryandConfidentialInformation5简述MMI开发平台的三个重要概念Application

:描述了MMIKernel中处理PS消息非常重要的模块，例如sms,cc…..WINDOW：窗口，用于处理focus消息（在此窗口下面才需要处理的消息）…Control：控件，也就是窗口要用到的公共的特性，比如编辑特性、Text显示特性、动画特性等等…2023年11月21日ProprietaryandConfidentialInformation6Application、Window和Control的关系APPLICATIONWINDOWCONTROLCONTROLCONTROL2023年11月21日ProprietaryandConfidentialInformation72.Kernel接口MMIKernel主要提供完善的消息驱动流程和窗口管理机制。为各种上层应用（CC、SMS、WAP、MMS等）提供良好的支持。2023年11月21日ProprietaryandConfidentialInformation8Kernel提供的功能1.对消息流程进行管理外部消息主要包括PS消息、key消息、Timer消息和一些由其它模块发送过来的消息；内部消息MMI模块内部发送、接收和处理的消息，不与其它模块发生任何关系.(现在我们用到的就是focus消息，由窗口处理，这类消息使用最多最频繁)2.提供窗口管理机制 了解Kernel对窗口的管理机制：通过维护一个全局变量：是MMIKernel中一个非常核心的数据结构，它是整个窗口调度过程的核心，这个数据结构由MMIKernel维护。2023年11月21日ProprietaryandConfidentialInformation9Application的概念Application：描述了MMIKernel中非常重要的应用处理模块。可以分为两类：需要注册系统消息的（SMSApplication,CallApplication,StkApplication…）不需要注册系统消息的（DC,Multimedia）2023年11月21日ProprietaryandConfidentialInformation10注册消息APPLICATION举例系统消息由Application处理。如果需要系统消息，Application在初始化时要注册需处理的消息。Kernel只会根据注册的Application来分发。一个PS消息可以被多个Application注册，Kernel会依次分发消息给各个Application。我们现在需要注册消息的应用：

g_main_appg_cc_appg_sms_app

g_mmiphone_appg_stk_app…….静态的，全局，一般在初始化时建立。2023年11月21日ProprietaryandConfidentialInformation11Window的概念Window：窗口是最终用户可以直接看到的一个个实在的屏幕，是直接和用户打交道的，专门处理用户的按键输入等操作，并且将最终用户输入后的处理结果显示在屏幕上。窗口的消息处理函数，用来处理最终用户的直接输入。窗口还要管理其所属的控件，将部分消息交给控件处理。2023年11月21日ProprietaryandConfidentialInformation12Control的概念Control：控件，也就是窗口要用到的公共的特性，比如编辑特性、Text显示特性、动画特性等等。使用控件可以使开发人员专注于应用的功能开发，而不是过多限制在界面的开发。2023年11月21日ProprietaryandConfidentialInformation13Kernel中的窗口管理窗口管理是MMIKernel中非常重要的部分，直接决定了上层应用的开发。窗口管理主要包括应用窗口和控件之间的管理和通信、各个窗口间稳定的切换。应用窗口负责上层的应用和显示等。2023年11月21日ProprietaryandConfidentialInformation14Kernel中的窗口管理，举例建立窗口的一些常量的属性：建立窗口wintab:WINDOW_TABLE(MMISMS_EDIT_WIN_TAB

)=

{ CLEAR_LCD,

//清屏

WIN_PRIO(WIN_ONE_LEVEL),

//窗口优先级

WIN_TITLE_ID(TXT_SMS_WRITE),

/固定的title

WIN_FUNC((uint32)

HandleEditWinMsg),

//窗口消息处理函数

WIN_ID(

MMISMS_EDIT_WIN_ID),

//ID

CREATE_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年11月21日ProprietaryandConfidentialInformation15窗口Priority设置窗口优先级的目的是为了保护那些重要的窗口在处于Focus状态下不被打断，比如Call窗口，在Call的过程中不应该出现被SMS或者Alarm窗口打断，否则会影响Call的过程。我们在这里暂时制定了4个优先级：WIN_LOWEST_LEVEL,WIN_ONE_LEVEL，WIN_TWO_LEVEL，WIN_THREE_LEVEL。

我们提供了操作窗口优先级的两个函数：GetWinPriority，SetWinPriority。用户可以根据应用来调用这两个操作窗口优先级的函数。在窗口的初始化（针对静态常口）和创建（针对动态窗口）过程中，需要对窗口优先级进行设置。2023年11月21日ProprietaryandConfidentialInformation16窗口Priority（续）2023年11月21日ProprietaryandConfidentialInformation17虚拟窗口虚拟窗口主要是指那种已经打开了但是无法得到Focus的应用窗口。比如在打电话的过程中来了一条短信，因为Call的窗口的等级比较高，这个时候来短信的窗口无法得到Focus，也无法显示出来。当前应用窗口结束后，系统会优先使虚拟窗口链表中的应用窗口得到Focus。等级越高的应用窗口越先打开，当应用窗口处于同一等级时，按照先进先出方式（后打开的得到Focus）打开应用窗口。2023年11月21日ProprietaryandConfidentialInformation18Kernel中的消息机制2023年11月21日ProprietaryandConfidentialInformation19消息分类从消息的接收情况，分为外部消息主要包括PS消息、key消息、Timer消息和一些由其它模块发送过来的消息；内部消息，MMI模块内部发送、接收和处理的消息，不与其它模块发生任何关系.在App_Task的消息循环当中总是处理完内部消息之后再处理外部消息。2023年11月21日ProprietaryandConfidentialInformation20消息分类（续）根据不同的消息发送和处理流程来划分，消息分为4个类别：第一类消息为系统消息（主要为PS消息和其它一些System消息），只有App在注册后才能够处理这条消息，对于没有注册的系统消息，将交给默认的MainApp处理。一条系统消息可以被多个App注册和处理。第二类为Focus消息，系统直接将这种类型的消息直接发送给处于Focus状态的APP，由APP对消息进行处理。第三类广播消息，将根据Application的链表，调用每一个的消息处理过程，这属于每一个App都要处理的过程，每个App只处理自己感兴趣的消息，至于App的处理方式（是交给Window处理还是App本身处理），系统没有任何限制。（这个暂时没有用过）第四类定时器消息，由于定时器使用的比较广泛，而且无法将其归为系统消息或Focus消息，为了更好的处理，将其单独的作为一类消息处理。

2023年11月21日ProprietaryandConfidentialInformation21外部消息处理外部消息由Application来处理；外部消息需要Application事先在mmk_regapp.def中定义应用所关心的消息；外部消息队列由嵌入式操作系统维护；2023年11月21日ProprietaryandConfidentialInformation22内部消息处理内部消息不需要应用模块进行注册；内部消息由Window，Control处理；内部消息队列由Kernel模块维护；内部消息定义在mmk_msg.h中；2023年11月21日ProprietaryandConfidentialInformation23消息处理流程MMIKERNELQueue(internal)Queue(external)ControlWINDOWAPPLICATION2023年11月21日ProprietaryandConfidentialInformation24窗口通信

一般的窗口（包括应用窗口和控件）都需要彼此之间能够传送消息，比如应用窗口需要将消息传给控件（一个刷新的消息）或者一个控件需要另一个控件处理消息等，这些都会涉及到窗口间的通信，一般有两种通信方式：异步通信方式，用MMK_PostMsg()函数来实现。 异步通信方式主要将消息发送到内部消息队列中，即当发送消息的窗口返回后，这条消息才会被处理。因为这是一种Focus消息，所以接收的窗口必须是应用窗口，只有应用窗口才可以得到Focus。同步通信方式，用MMK_SendMsg()函数来实现。

2023年11月21日ProprietaryandConfidentialInformation253GUI接口GUI模块的主要功能就是给应用开发提供最基本的图形控件接口，并跟窗口系统、消息机制结合，处理基本的人机操作。2023年11月21日ProprietaryandConfidentialInformation26Control的基本属性图形化，和用户交互可以Active可接受消息，有消息处理函数依赖于窗口存在每个具体的control有唯一ID2023年11月21日ProprietaryandConfidentialInformation27控件的使用有2种形式1.在wintable中加入一个控件2.动态创建2023年11月21日ProprietaryandConfidentialInformation28控件的使用--wintableCREATE_MENU_CTRLCREATE_LISTBOX_CTRLCREATE_TEXTEDITBOX_CTRLCREATE_ANIMATION……….2023年11月21日ProprietaryandConfidentialInformation29控件的使用—动态创建创建控件:GUIANIMATE_Init()将该控件加入到window中

MMK_CreateDynaCtrl()设定控件的参数:GUIANIMATE_SetParam2023年11月21日ProprietaryandConfidentialInformation30GUI提供的控件Menu控件：菜单控件EditBox控件：编辑框控件ListBox控件：列表框控件TextBox控件：文本框控件Animate控件：图形控件MessageBox控件：消息框控件ProgressBox控件：进度条控件Punctuation控件：标点符号控件SoftKey控件：软键盘控件Calendar控件：日历控件字库：字体LCD：显示屏T9：输入法2023年11月21日ProprietaryandConfidentialInformation31Menu控件介绍树状结构，显示多级菜单实现菜单项的设定，显示，上下左右按键选择，选中后自动进入下级子菜单，或者执行相应的操作菜单项文字过长滚动显示分为两类：静态菜单，动态菜单目前已实现的风格：文字菜单，旋转图，九宫格2023年11月21日ProprietaryandConfidentialInformation32添加静态菜单1.添加menuid(mmi_menutable.h)2.添加menuandmenuitem(mmi_menutable.c)3.将新增加的menu加入menutable中(mmi_menutable.def)4.为菜单项写处理函数2023年11月21日ProprietaryandConfidentialInformation33添加动态菜单1.调用GUIMENU_InsertNode2023年11月21日ProprietaryandConfidentialInformation34EditBox控件能正确编辑、录入数字号码、密码、字母及文字包括标题、软键盘；日期、时间、秒表、密码、数字号码、字母、非ascii码文字等正文的各种特殊显示显示编辑中的光标显示编辑中候选字的显示；自动分页支持滚动条支持的输入法：T92023年11月21日ProprietaryandConfidentialInformation35ListBox控件分为三类：单选，多选，文字支持上下滚动，连续滚动支持数据分批载入在标题上显示当前项和总项数（例如2/200）动态添加，删除，更改2023年11月21日ProprietaryandConfidentialInformation36TextBox控件显示一段文本包括标题、软键盘；文本内容文本内容超过屏幕大小自动换行支持滚动条响应向上键向上卷动或翻页响应向下键向下卷动或翻页2023年11月21日ProprietaryandConfidentialInformation37Animate控件显示图形、图象、动画。bmp,icon图像以及jpg,gif等流行的图像格式示，自定义动画以及gif等流行的动画格式的显示。2023年11月21日ProprietaryandConfidentialInformation38MessageBox控件显示弹出框支持图片，动画，文字，softkey，背景色的设定支持多种显示风格2023年11月21日ProprietaryandConfidentialInformation39Punctuation控件显示当前支持的所有标点符号和编辑框配合使用，将选中的标点符号插入到文本中2023年11月21日ProprietaryandConfidentialInformation40Calendar控件显示日历一页显示一个月的内容，12个月份有不同的背景图片，年月，周日~周六，日期，当前日与其他日有不一样的颜色响应上键向前移一月，响应下键向后移一月，响应左键向前移一天，响应右键向后移一天。2023年11月21日ProprietaryandConfidentialInformation41其他控件SoftKey控件：可设定文字，背景，iconProgressBox控件显示当前进度可设定最大值，最小值，当前值Label控件显示一行文字，过长则滚动显示可动态更改显示区域，文字2023年11月21日ProprietaryandConfidentialInformation42GUI_LCD直接在屏幕上画线，显示图片对底层lcd驱动进行包装LCD_DrawHLine,LCD_DrawVLine,LCD_DrawRect,LCD_FillRect,LCD_DisplayCompressedBmp,LCD_DrawLine….2023年11月21日ProprietaryandConfidentialInformation43GUI_Font直接在屏幕上显示字符串获得字体的高度，宽度GUI_GetFontWidth，GUI_GetFontHeight，LCD_DisplayStringInRect，LCD_DisplayString…..2023年11月21日ProprietaryandConfidentialInformation44Control风格每一类control和window的缺省显示风格定义在文件mmi_theme.c/h中用户可自定义各种不同的字体，背景色，前景色mmidisplay_data.c/h2023年11月21日ProprietaryandConfidentialInformation45GUI接口的参考详情参考GUI接口说明书及其相关头文件。2023年11月21日ProprietaryandConfidentialInformation46应用实例：（以SMS应用为例）开发实例一、Application的创建开发实例二、利用WindowTable设计窗口开发实例三、更改图片铃声资源2023年11月21日ProprietaryandConfidentialInformation47开发实例一、Application的创建Step1：创建工作目录和相应的文件。Step2：定义Application变量。Step3：在mmk_ext_app.h中增加sms全局应用变量。Step4：注册系统消息。Step5：初始化sms应用模块。Step6：编写应用消息处理函数。2023年11月21日ProprietaryandConfidentialInformation48Step1：创建工作目录和相应的文件。

建立以下三个目录：

..\MS_APP\BMMI\Source\App\SMS ..\MS_APP\BMMI\Source\App\SMS\c ..\MS_APP\BMMI\Source\App\SMS\h

增加以下C/H文件(根据模块需要而定)

mmismsapp_main.c mmismsapp_order.c mmismsapp_wintab.c mmisms_api.h mmisms_app.h mmismsapp_wintab.h2023年11月21日ProprietaryandConfidentialInformation49Step2：定义Application变量。

在mmisms_main.c中增加变量定义：

MMI_APPLICATION_Tg_mmisms_app;//SMS的实体2023年11月21日ProprietaryandConfidentialInformation50Step3：在mmk_ext_app.h中增加sms

全局应用变量#ifdef__cplusplusextern"C"{#endif . . .externMMI_APPLICATION_Tg_cc_app;

externMMI_APPLICATION_Tg_mmisms_app;//SMS的实体

externMMI_APPLICATION_Tg_mmipb_app; . . .#ifdef__cplusplus}#endif2023年11月21日ProprietaryandConfidentialInformation51Step4：注册系统消息在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年11月21日ProprietaryandConfidentialInformation52Step5：初始化sms应用模块。在MMIMAIN.C中增加对sms应用模块的初始化：voidAPP_Init(void){ . . . MMIPHONE_AppInit();

MMISMS_AppInit();//sms应用模块的初始化

MMIPB_InitApp(); . . .}2023年11月21日ProprietaryandConfidentialInformation53Step5：初始化sms应用模块(续)在sms模块的初始化函数中指定消息处理函数和component类型voidMMISMS_AppInit(){ . . .

g_mmisms_app.ProcessMsg=HandlePsMsg; g_mmisms_ponent_type=CT_APPLICATION; . . .}2023年11月21日ProprietaryandConfidentialInformation54Step6：编写应用消息处理函数LOCALMMI_RESULT_EHandlePsMsg( PWNDapp_ptr, uint16msg_id, DPARAMparam){ uint8result=MMI_RESULT_TRUE; switch(msg_id) { caseAPP_MN_SMS_READY_IND: break;

caseAPP_MN_READ_SMS_CNF: break;

2023年11月21日ProprietaryandConfidentialInformation55Step6：编写应用消息处理函数（续） caseAPP_MN_UPDATE_SMS_STATE_CNF: break; . . . default: result=MMI_RESULT_FALSE; break; }

return(result);}2023年11月21日ProprietaryandConfidentialInformation56开发实例二、利用WindowTable设计窗口请参考MMK_Window_Table开发说明书.docStep1：在win.def文件中声明窗口表。Step2：在mmk_type.h文件中声明窗口ID。Step3：在mmk_type.h文件中声明控件ID。Step4：在mmi_text.def文件中声明文本的ID。Step5：创建WindowTable表。Step6：使用WindowTable表打开窗口。Step7：实现窗口的消息处理函数。Step8：依次类似编写每个Window。2023年11月21日ProprietaryandConfidentialInformation57Step1：在win.def文件中声明窗口表。

. . .WIN_DEF(MMISMS_MENUWIN_TAB)WIN_DEF(MMISMS_EDIT_WIN_TAB)WIN_DEF(MMISMS_EDITOPTION_WIN_TAB) . . .2023年11月21日ProprietaryandConfidentialInformation58Step2：在mmk_type.h文件中声明窗口IDtypedefenum{BEGIN_WIN_ID, . . .MMISMS_MENU_WIN_ID,

MMISMS_EDIT_WIN_ID,

MMISMS_EDITOPTION_WIN_ID, . . .}MMI_WINDOW_ID_E;2023年11月21日ProprietaryandConfidentialInformation59Step3：在mmk_type.h文件中声明控件IDtypedefenum{BEGIN_CTRL_ID, . . . MMISMS_MENU_CTRL_ID,

MMISMS_EDITWIN_EDITCTRL_ID,

MMISMS_SENDNUMOPTION_LISTCTRL_ID, . . .}MMI_CONTROL_ID_E;2023年11月21日ProprietaryandConfidentialInformation60Step4：在mmi_text.def文件中声明文本的 ID。 . . .TEXT_DEF(TXT_SMS_WRITE,"Write", "\x06\x51\x99\x6d\x88\x60\x6f")//写消息

. . .2023年11月21日ProprietaryandConfidentialInformation61Step5：创建WindowTable表。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_PI