MMI軟件開發(fā)平臺

2023年11月21日ProprietaryandConfidentialInformation1Contents平臺介紹和計劃安排Kenel接口GUI接口開發(fā)和調(diào)試實例2023年11月21日ProprietaryandConfidentialInformation2平臺介紹和計劃 Spreadtrum提供了一套基于類似miniwidows機制的MMI開發(fā)平臺，并且提供了與網(wǎng)絡(luò)相關(guān)部分的MMI源碼。同時我們也提供了MMI開發(fā)的配套工具軟件包。客戶可以基于此方便的做二次開發(fā)?，F(xiàn)已有多款手機使用此平臺進行開發(fā)。2023年11月21日ProprietaryandConfidentialInformation3平臺結(jié)構(gòu)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開發(fā)平臺的三個重要概念A(yù)pplication

:描述了MMIKernel中處理PS消息非常重要的模塊，例如sms,cc…..WINDOW：窗口，用于處理focus消息（在此窗口下面才需要處理的消息）…Control：控件，也就是窗口要用到的公共的特性，比如編輯特性、Text顯示特性、動畫特性等等…2023年11月21日ProprietaryandConfidentialInformation6Application、Window和Control的關(guān)系A(chǔ)PPLICATIONWINDOWCONTROLCONTROLCONTROL2023年11月21日ProprietaryandConfidentialInformation72.Kernel接口MMIKernel主要提供完善的消息驅(qū)動流程和窗口管理機制。為各種上層應(yīng)用（CC、SMS、WAP、MMS等）提供良好的支持。2023年11月21日ProprietaryandConfidentialInformation8Kernel提供的功能1.對消息流程進行管理外部消息主要包括PS消息、key消息、Timer消息和一些由其它模塊發(fā)送過來的消息；內(nèi)部消息MMI模塊內(nèi)部發(fā)送、接收和處理的消息，不與其它模塊發(fā)生任何關(guān)系.(現(xiàn)在我們用到的就是focus消息，由窗口處理，這類消息使用最多最頻繁)2.提供窗口管理機制 了解Kernel對窗口的管理機制：通過維護一個全局變量：是MMIKernel中一個非常核心的數(shù)據(jù)結(jié)構(gòu)，它是整個窗口調(diào)度過程的核心，這個數(shù)據(jù)結(jié)構(gòu)由MMIKernel維護。2023年11月21日ProprietaryandConfidentialInformation9Application的概念A(yù)pplication：描述了MMIKernel中非常重要的應(yīng)用處理模塊?？梢苑譃閮深悾盒枰韵到y(tǒng)消息的（SMSApplication,CallApplication,StkApplication…）不需要注冊系統(tǒng)消息的（DC,Multimedia）2023年11月21日ProprietaryandConfidentialInformation10注冊消息APPLICATION舉例系統(tǒng)消息由Application處理。如果需要系統(tǒng)消息，Application在初始化時要注冊需處理的消息。Kernel只會根據(jù)注冊的Application來分發(fā)。一個PS消息可以被多個Application注冊，Kernel會依次分發(fā)消息給各個Application。我們現(xiàn)在需要注冊消息的應(yīng)用：

g_main_appg_cc_appg_sms_app

g_mmiphone_appg_stk_app…….靜態(tài)的，全局，一般在初始化時建立。2023年11月21日ProprietaryandConfidentialInformation11Window的概念Window：窗口是最終用戶可以直接看到的一個個實在的屏幕，是直接和用戶打交道的，專門處理用戶的按鍵輸入等操作，并且將最終用戶輸入后的處理結(jié)果顯示在屏幕上。窗口的消息處理函數(shù)，用來處理最終用戶的直接輸入。窗口還要管理其所屬的控件，將部分消息交給控件處理。2023年11月21日ProprietaryandConfidentialInformation12Control的概念Control：控件，也就是窗口要用到的公共的特性，比如編輯特性、Text顯示特性、動畫特性等等。使用控件可以使開發(fā)人員專注于應(yīng)用的功能開發(fā)，而不是過多限制在界面的開發(fā)。2023年11月21日ProprietaryandConfidentialInformation13Kernel中的窗口管理窗口管理是MMIKernel中非常重要的部分，直接決定了上層應(yīng)用的開發(fā)。窗口管理主要包括應(yīng)用窗口和控件之間的管理和通信、各個窗口間穩(wěn)定的切換。應(yīng)用窗口負責(zé)上層的應(yīng)用和顯示等。2023年11月21日ProprietaryandConfidentialInformation14Kernel中的窗口管理，舉例建立窗口的一些常量的屬性：建立窗口wintab:WINDOW_TABLE(MMISMS_EDIT_WIN_TAB

)=

{ CLEAR_LCD,

//清屏

WIN_PRIO(WIN_ONE_LEVEL),

//窗口優(yōu)先級

WIN_TITLE_ID(TXT_SMS_WRITE),

/固定的title

WIN_FUNC((uint32)

HandleEditWinMsg),

//窗口消息處理函數(shù)

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};詳細的講解請見后面應(yīng)用實例2023年11月21日ProprietaryandConfidentialInformation15窗口Priority設(shè)置窗口優(yōu)先級的目的是為了保護那些重要的窗口在處于Focus狀態(tài)下不被打斷，比如Call窗口，在Call的過程中不應(yīng)該出現(xiàn)被SMS或者Alarm窗口打斷，否則會影響Call的過程。我們在這里暫時制定了4個優(yōu)先級：WIN_LOWEST_LEVEL,WIN_ONE_LEVEL，WIN_TWO_LEVEL，WIN_THREE_LEVEL。

我們提供了操作窗口優(yōu)先級的兩個函數(shù)：GetWinPriority，SetWinPriority。用戶可以根據(jù)應(yīng)用來調(diào)用這兩個操作窗口優(yōu)先級的函數(shù)。在窗口的初始化（針對靜態(tài)?？冢┖蛣?chuàng)建（針對動態(tài)窗口）過程中，需要對窗口優(yōu)先級進行設(shè)置。2023年11月21日ProprietaryandConfidentialInformation16窗口Priority（續(xù)）2023年11月21日ProprietaryandConfidentialInformation17虛擬窗口虛擬窗口主要是指那種已經(jīng)打開了但是無法得到Focus的應(yīng)用窗口。比如在打電話的過程中來了一條短信，因為Call的窗口的等級比較高，這個時候來短信的窗口無法得到Focus，也無法顯示出來。當(dāng)前應(yīng)用窗口結(jié)束后，系統(tǒng)會優(yōu)先使虛擬窗口鏈表中的應(yīng)用窗口得到Focus。等級越高的應(yīng)用窗口越先打開，當(dāng)應(yīng)用窗口處于同一等級時，按照先進先出方式（后打開的得到Focus）打開應(yīng)用窗口。2023年11月21日ProprietaryandConfidentialInformation18Kernel中的消息機制2023年11月21日ProprietaryandConfidentialInformation19消息分類從消息的接收情況，分為外部消息主要包括PS消息、key消息、Timer消息和一些由其它模塊發(fā)送過來的消息；內(nèi)部消息，MMI模塊內(nèi)部發(fā)送、接收和處理的消息，不與其它模塊發(fā)生任何關(guān)系.在App_Task的消息循環(huán)當(dāng)中總是處理完內(nèi)部消息之后再處理外部消息。2023年11月21日ProprietaryandConfidentialInformation20消息分類（續(xù)）根據(jù)不同的消息發(fā)送和處理流程來劃分，消息分為4個類別：第一類消息為系統(tǒng)消息（主要為PS消息和其它一些System消息），只有App在注冊后才能夠處理這條消息，對于沒有注冊的系統(tǒng)消息，將交給默認的MainApp處理。一條系統(tǒng)消息可以被多個App注冊和處理。第二類為Focus消息，系統(tǒng)直接將這種類型的消息直接發(fā)送給處于Focus狀態(tài)的APP，由APP對消息進行處理。第三類廣播消息，將根據(jù)Application的鏈表，調(diào)用每一個的消息處理過程，這屬于每一個App都要處理的過程，每個App只處理自己感興趣的消息，至于App的處理方式（是交給Window處理還是App本身處理），系統(tǒng)沒有任何限制。（這個暫時沒有用過）第四類定時器消息，由于定時器使用的比較廣泛，而且無法將其歸為系統(tǒng)消息或Focus消息，為了更好的處理，將其單獨的作為一類消息處理。

2023年11月21日ProprietaryandConfidentialInformation21外部消息處理外部消息由Application來處理；外部消息需要Application事先在mmk_regapp.def中定義應(yīng)用所關(guān)心的消息；外部消息隊列由嵌入式操作系統(tǒng)維護；2023年11月21日ProprietaryandConfidentialInformation22內(nèi)部消息處理內(nèi)部消息不需要應(yīng)用模塊進行注冊；內(nèi)部消息由Window，Control處理；內(nèi)部消息隊列由Kernel模塊維護；內(nèi)部消息定義在mmk_msg.h中；2023年11月21日ProprietaryandConfidentialInformation23消息處理流程MMIKERNELQueue(internal)Queue(external)ControlWINDOWAPPLICATION2023年11月21日ProprietaryandConfidentialInformation24窗口通信

一般的窗口（包括應(yīng)用窗口和控件）都需要彼此之間能夠傳送消息，比如應(yīng)用窗口需要將消息傳給控件（一個刷新的消息）或者一個控件需要另一個控件處理消息等，這些都會涉及到窗口間的通信，一般有兩種通信方式：異步通信方式，用MMK_PostMsg()函數(shù)來實現(xiàn)。 異步通信方式主要將消息發(fā)送到內(nèi)部消息隊列中，即當(dāng)發(fā)送消息的窗口返回后，這條消息才會被處理。因為這是一種Focus消息，所以接收的窗口必須是應(yīng)用窗口，只有應(yīng)用窗口才可以得到Focus。同步通信方式，用MMK_SendMsg()函數(shù)來實現(xiàn)。

2023年11月21日ProprietaryandConfidentialInformation253GUI接口GUI模塊的主要功能就是給應(yīng)用開發(fā)提供最基本的圖形控件接口，并跟窗口系統(tǒng)、消息機制結(jié)合，處理基本的人機操作。2023年11月21日ProprietaryandConfidentialInformation26Control的基本屬性圖形化，和用戶交互可以Active可接受消息，有消息處理函數(shù)依賴于窗口存在每個具體的control有唯一ID2023年11月21日ProprietaryandConfidentialInformation27控件的使用有2種形式1.在wintable中加入一個控件2.動態(tài)創(chuàng)建2023年11月21日ProprietaryandConfidentialInformation28控件的使用--wintableCREATE_MENU_CTRLCREATE_LISTBOX_CTRLCREATE_TEXTEDITBOX_CTRLCREATE_ANIMATION……….2023年11月21日ProprietaryandConfidentialInformation29控件的使用—動態(tài)創(chuàng)建創(chuàng)建控件:GUIANIMATE_Init()將該控件加入到window中

MMK_CreateDynaCtrl()設(shè)定控件的參數(shù):GUIANIMATE_SetParam2023年11月21日ProprietaryandConfidentialInformation30GUI提供的控件Menu控件：菜單控件EditBox控件：編輯框控件ListBox控件：列表框控件TextBox控件：文本框控件Animate控件：圖形控件MessageBox控件：消息框控件ProgressBox控件：進度條控件Punctuation控件：標(biāo)點符號控件SoftKey控件：軟鍵盤控件Calendar控件：日歷控件字庫：字體LCD：顯示屏T9：輸入法2023年11月21日ProprietaryandConfidentialInformation31Menu控件介紹樹狀結(jié)構(gòu)，顯示多級菜單實現(xiàn)菜單項的設(shè)定，顯示，上下左右按鍵選擇，選中后自動進入下級子菜單，或者執(zhí)行相應(yīng)的操作菜單項文字過長滾動顯示分為兩類：靜態(tài)菜單，動態(tài)菜單目前已實現(xiàn)的風(fēng)格：文字菜單，旋轉(zhuǎn)圖，九宮格2023年11月21日ProprietaryandConfidentialInformation32添加靜態(tài)菜單1.添加menuid(mmi_menutable.h)2.添加menuandmenuitem(mmi_menutable.c)3.將新增加的menu加入menutable中(mmi_menutable.def)4.為菜單項寫處理函數(shù)2023年11月21日ProprietaryandConfidentialInformation33添加動態(tài)菜單1.調(diào)用GUIMENU_InsertNode2023年11月21日ProprietaryandConfidentialInformation34EditBox控件能正確編輯、錄入數(shù)字號碼、密碼、字母及文字包括標(biāo)題、軟鍵盤；日期、時間、秒表、密碼、數(shù)字號碼、字母、非ascii碼文字等正文的各種特殊顯示顯示編輯中的光標(biāo)顯示編輯中候選字的顯示；自動分頁支持滾動條支持的輸入法：T92023年11月21日ProprietaryandConfidentialInformation35ListBox控件分為三類：單選，多選，文字支持上下滾動，連續(xù)滾動支持數(shù)據(jù)分批載入在標(biāo)題上顯示當(dāng)前項和總項數(shù)（例如2/200）動態(tài)添加，刪除，更改2023年11月21日ProprietaryandConfidentialInformation36TextBox控件顯示一段文本包括標(biāo)題、軟鍵盤；文本內(nèi)容文本內(nèi)容超過屏幕大小自動換行支持滾動條響應(yīng)向上鍵向上卷動或翻頁響應(yīng)向下鍵向下卷動或翻頁2023年11月21日ProprietaryandConfidentialInformation37Animate控件顯示圖形、圖象、動畫。bmp,icon圖像以及jpg,gif等流行的圖像格式示，自定義動畫以及gif等流行的動畫格式的顯示。2023年11月21日ProprietaryandConfidentialInformation38MessageBox控件顯示彈出框支持圖片，動畫，文字，softkey，背景色的設(shè)定支持多種顯示風(fēng)格2023年11月21日ProprietaryandConfidentialInformation39Punctuation控件顯示當(dāng)前支持的所有標(biāo)點符號和編輯框配合使用，將選中的標(biāo)點符號插入到文本中2023年11月21日ProprietaryandConfidentialInformation40Calendar控件顯示日歷一頁顯示一個月的內(nèi)容，12個月份有不同的背景圖片，年月，周日~周六，日期，當(dāng)前日與其他日有不一樣的顏色響應(yīng)上鍵向前移一月，響應(yīng)下鍵向后移一月，響應(yīng)左鍵向前移一天，響應(yīng)右鍵向后移一天。2023年11月21日ProprietaryandConfidentialInformation41其他控件SoftKey控件：可設(shè)定文字，背景，iconProgressBox控件顯示當(dāng)前進度可設(shè)定最大值，最小值，當(dāng)前值Label控件顯示一行文字，過長則滾動顯示可動態(tài)更改顯示區(qū)域，文字2023年11月21日ProprietaryandConfidentialInformation42GUI_LCD直接在屏幕上畫線，顯示圖片對底層lcd驅(qū)動進行包裝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風(fēng)格每一類control和window的缺省顯示風(fēng)格定義在文件mmi_theme.c/h中用戶可自定義各種不同的字體，背景色，前景色mmidisplay_data.c/h2023年11月21日ProprietaryandConfidentialInformation45GUI接口的參考詳情參考GUI接口說明書及其相關(guān)頭文件。2023年11月21日ProprietaryandConfidentialInformation46應(yīng)用實例：（以SMS應(yīng)用為例）開發(fā)實例一、Application的創(chuàng)建開發(fā)實例二、利用WindowTable設(shè)計窗口開發(fā)實例三、更改圖片鈴聲資源2023年11月21日ProprietaryandConfidentialInformation47開發(fā)實例一、Application的創(chuàng)建Step1：創(chuàng)建工作目錄和相應(yīng)的文件。Step2：定義Application變量。Step3：在mmk_ext_app.h中增加sms全局應(yīng)用變量。Step4：注冊系統(tǒng)消息。Step5：初始化sms應(yīng)用模塊。Step6：編寫應(yīng)用消息處理函數(shù)。2023年11月21日ProprietaryandConfidentialInformation48Step1：創(chuàng)建工作目錄和相應(yīng)的文件。

建立以下三個目錄：

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

增加以下C/H文件(根據(jù)模塊需要而定)

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

全局應(yīng)用變量#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：注冊系統(tǒng)消息在mmk_regapp.def文件中增加此應(yīng)用模塊希望處理的系統(tǒng)消息。例如，SMS應(yīng)用可以接收消息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應(yīng)用模塊。在MMIMAIN.C中增加對sms應(yīng)用模塊的初始化：voidAPP_Init(void){ . . . MMIPHONE_AppInit();

MMISMS_AppInit();//sms應(yīng)用模塊的初始化

MMIPB_InitApp(); . . .}2023年11月21日ProprietaryandConfidentialInformation53Step5：初始化sms應(yīng)用模塊(續(xù))在sms模塊的初始化函數(shù)中指定消息處理函數(shù)和component類型voidMMISMS_AppInit(){ . . .

g_mmisms_app.ProcessMsg=HandlePsMsg; g_mmisms_ponent_type=CT_APPLICATION; . . .}2023年11月21日ProprietaryandConfidentialInformation54Step6：編寫應(yīng)用消息處理函數(shù)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：編寫應(yīng)用消息處理函數(shù)（續(xù)） caseAPP_MN_UPDATE_SMS_STATE_CNF: break; . . . default: result=MMI_RESULT_FALSE; break; }

return(result);}2023年11月21日ProprietaryandConfidentialInformation56開發(fā)實例二、利用WindowTable設(shè)計窗口請參考MMK_Window_Table開發(fā)說明書.docStep1：在win.def文件中聲明窗口表。Step2：在mmk_type.h文件中聲明窗口ID。Step3：在mmk_type.h文件中聲明控件ID。Step4：在mmi_text.def文件中聲明文本的ID。Step5：創(chuàng)建WindowTable表。Step6：使用WindowTable表打開窗口。Step7：實現(xiàn)窗口的消息處理函數(shù)。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：創(chuàng)建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