展訊短信模塊接口介紹

1、Mocor MMI SMS Interface User GuideVersion: 1.0.0DocCode: SW-MOCOR-UG-0005Date: 2008-04-07MSPREADTRUM HYPERLINK 重要聲明版權聲明本文檔中的任何內容受中華人民共和國著作權法的保護，版權所有 2008, 展訊通信有限公司，保留所有權利，但注明引用其他方的內容除外。商標聲明展訊通信有限公司和展訊通信有限公司的產(chǎn)品是展訊通信有限公司專有。在提及 其他公司及其產(chǎn)品時將使用各自公司所擁有的商標，這種使用的目的僅限于引用。不作保證聲明展訊通信有限公司不對此文檔中的任何內容作任何明示或暗示的陳述或保證

2、，而 且不對特定目的的適銷性及適用性或者任何間接、特殊或連帶的損失承擔任何責 任。保密聲明本文檔（包括任何附件）包含的信息是保密信息。接收人了解其獲得的本文檔是 保密的，除用于規(guī)定的目的外不得用于任何目的，也不得將本文檔泄露給任何第 三方。文檔說明閱讀對象內容介紹文檔約定相關文檔本文檔描述了 SMS模塊為其他模塊提供的接口函數(shù)的設計及使用。本文檔適合SMS模塊的開發(fā)人員使用。本文檔包括三個章節(jié)，分別為：第一章：概述。簡單介紹了 SMS接口模塊的特點及軟件架構；第二章：數(shù)據(jù)類型。介紹7SMS接口所涉及到的各種數(shù)據(jù)類型，如枚舉、結 構等；第三章：API函數(shù)。詳細描述了 SMS接口包含的所有API函

3、數(shù)的定義及相關 說明。本文檔采用下面醒目標志來表示在操作過程中應該特別注意的地方。注意:提醒操作中應注意的事項。說明:說明比較重要的事項。 TOC o 1-5 h z HYPERLINK l bookmark67 o Current Document 第1章概述1-1 HYPERLINK l bookmark70 o Current Document 1.1系統(tǒng)概述1-1 HYPERLINK l bookmark73 o Current Document SMS模塊主要實現(xiàn)功能1-1 HYPERLINK l bookmark82 o Current Document SMS模塊在系統(tǒng)中的位置1

4、-1 HYPERLINK l bookmark86 o Current Document 第2章 數(shù)據(jù)類型2-1 HYPERLINK l bookmark89 o Current Document 2.1常量定義2-1 HYPERLINK l bookmark92 o Current Document 枚舉2-1 HYPERLINK l bookmark96 o Current Document MMISMS_BOX_TYPE_E2-1 HYPERLINK l bookmark99 o Current Document MMISMS_OPERATE_TYPE_E2-2MMISMS_MSG_TY

5、PE_E2-2MMISMS_MO_MT_TYPE_E2-3 HYPERLINK l bookmark102 o Current Document 結構2-4MMISMS_BCD_NUMBER_T2-4MMISMS_ORDER_INFO_T2-5 HYPERLINK l bookmark107 o Current Document 第3章API函數(shù)3-1 HYPERLINK l bookmark110 o Current Document MMIAPISMS_AppInit3-1 HYPERLINK l bookmark114 o Current Document MMIAPISMS_GetDe

6、lAllFlag3-1 HYPERLINK l bookmark118 o Current Document MMIAPISMS_WriteNewMessage3-2 HYPERLINK l bookmark122 o Current Document MMIAPISMS_AnswerMessage3-2MMIAPISMS_CheckMemHaveEnough3-3 HYPERLINK l bookmark126 o Current Document MMIAPISMS_IsOrderOk3-4 HYPERLINK l bookmark130 o Current Document MMIAPI

7、SMS_IsSMSReady3-4 HYPERLINK l bookmark134 o Current Document MMIAPISMS_SendInit3-5 HYPERLINK l bookmark138 o Current Document MMIAPISMS_CheckSMSState3-5 HYPERLINK l bookmark142 o Current Document MMIAPISMS_DelSMSByAT3-6 HYPERLINK l bookmark146 o Current Document MMIAPISMS_OpenSmsBox3-6 HYPERLINK l b

8、ookmark150 o Current Document MMIAPISMS_ShowNewMsgPrompt3-7 HYPERLINK l bookmark154 o Current Document MMIAPISMS_OpenMainMenuWin3-7 HYPERLINK l bookmark158 o Current Document MMIAPISMS_OpenFreqWordListForCc.3-8 HYPERLINK l bookmark162 o Current Document MMIAPISMS_AppSendSmsForMSD3-8MMIAPISMS_Restore

9、FactorySetting3-9 HYPERLINK l bookmark166 o Current Document MMIAPISMS_DeleteMsgInorder3-10 HYPERLINK l bookmark170 o Current Document MMIAPISMS_InsertOneMsgToOrder3-10 HYPERLINK l bookmark174 o Current Document MIAPISMS_UpdateMsgStatusInOrder3-11 HYPERLINK l bookmark178 o Current Document MMIAPISMS

10、_MMSOrderDone3-11附錄 A Revision History.A-1第1章概述1.1系統(tǒng)概述SMS模塊作為短消息的人機界面部分，負責獲取，處理由PS層轉發(fā)的有關短消 息的消息以及用戶的各種操作，執(zhí)行相應的動作，并將執(zhí)行結果反饋給PS或者 用戶，實現(xiàn)短消息的功能。SMS模塊主要實現(xiàn)功能SMS模塊的主要功能有：接收新短消息：能正確的接收和處理新短消息；寫短消息：用戶可以寫新短消息進行發(fā)送或保存；發(fā)送短消息：能夠向別的用戶發(fā)送短消息（支持群發(fā)）；處理小區(qū)廣播：接收用戶設置的信道和語言的新小區(qū)廣播；操作已保存的短消息：對于保存的短消息進行讀、編輯、刪除、發(fā)送、多種 方式排序、標記等操作

11、。SMS模塊在系統(tǒng)中的位置圖1-1描述了 SMS模塊在系統(tǒng)中的位置。User Interface / Menu圖1-1 SMS模塊在總體結構中的位置第2章數(shù)據(jù)類型2.1常量定義常量名取值說明MMIMESSAGE_DIAPLAY_LEN22短消息列表中每個item所顯示的最大長度2.2枚舉MMISMS_BOX_TYPE_E【含義】MMISMS_BOX_TYPE_E 定義了信箱類型?！径x】typedef enumMMISMS_BOX_NONE,MMISMS_BOX_MT,MMISMS_BOX_SENDSUCC,MMISMS_BOX_SENDFAIL,MMISMS_BOX_NOSEND MMISM

12、S_BOX_TYPE_E;【參數(shù)說明】參數(shù)名稱含義MMISMS_BOX_NONE沒有信箱類型MMISMS_BOX_MT收件箱MMISMS_BOX_SENDSUCC已發(fā)信箱MMISMS_BOX_SENDFAIL發(fā)件箱MMISMS_BOX_NOSEND草稿箱2.2.2 MMISMS_OPERATE_TYPE_E【含義】MMISMS_OPERATE_TYPE_E定義了當前的操作類型，當開機排序完畢后，根據(jù) 當前的操作類型進入相應的信箱或者菜單?！径x】typedef enumMMISMS_OPERATE_NONE,MMISMS_WRITE_NEW_SMS,MMISMS_OPEN_BOX,MMISMS

13、_VIEW_MEMORY MMISMS_OPERATE_TYPE_E;【參數(shù)說明】參數(shù)名稱含義MMISMS_OPERATE_NONE當前無操作MMISMS_WRITE_NEW_SMS寫新的短消息MMISMS_OPEN_BOX打開信箱MMISMS_VIEW_MEMORY查看信息空間2.2.3 MMISMS_MSG_TYPE_E【含義】MMISMS_MSG_TYPE_E定義了信息的類型，包括短消息，彩信、WAP Push消 息、WAP OTA消息、彩信OTA消息。【定義】typedef enumMMISMS_TYPE_SMS= 0,MMISMS_TYPE_MMS= 1,MMISMS_TYPE_WA

14、P_PUSH = 2,MMISMS_TYPE_MMS_OTA = 3,MMISMS_TYPE_WAP_OTA = 4,MMISMS_TYPE_MAX MMISMS_MSG_TYPE_E;【參數(shù)說明】參數(shù)名稱含義MMISMS_TYPE_SMS短消息MMISMS_TYPE_MMS彩信MMISMS_TYPE_WAP_PUSHWAP Push 消息MMISMS_TYPE_MMS_OTA彩信OTA消息MMISMS_TYPE_WAP_OTAWap OTA消息2.2.4 MMISMS_MO_MT_TYPE_E【含義】MMISMS_MO_MT_TYPE_E定義了信息的狀態(tài)，包括已讀短消息、未讀短消息、 已讀狀

15、態(tài)報告、未讀狀態(tài)報告、未下載彩信、未讀彩信、已讀彩信、發(fā)送失敗信 息、發(fā)送成功信息、未發(fā)送信息?！径x】typedef enum mmisms_mo_mt_type_tagMMISMS_MT_NOT_DOWNLOAD,MMISMS_MT_TO_BE_READ,MMISMS_MT_HAVE_READ,MMISMS_MT_SR_TO_BE_READ,MMISMS_MT_SR_HAVE_READ,MMISMS_MO_SEND_SUCC,MMISMS_MO_SEND_FAIL,MMISMS_MO_DRAFT, MMISMS_MO_MT_TYPE_E【參數(shù)說明】參數(shù)名稱含義MMISMS_MT_NOT_D

16、OWNLOAD未下載彩信MMISMS_MT_TO_BE_READ未讀彩信MMISMS_MT_HAVE_READ已讀彩信MMISMS_MT_SR_TO_BE_READ未讀狀態(tài)報告MMISMS_MT_SR_HAVE_READ已讀狀態(tài)報告MMISMS_MO_SEND_SUCC已發(fā)信息MMISMS_MO_SEND_FAIL發(fā)送失敗信息MMISMS_MO_DRAFT未發(fā)送信息【注意事項】當前的消息類型剛好占3位，如果需要添加類型則需要增加位數(shù)。2.3結構MMISMS_BCD_NUMBER_T【含義】MMISMS_BCD_NUMBER_T定義了短消息的號碼類型【定義】typedef struct tag_

17、MMISMS_BCD_NUMBER_Tuint8 number_len;uint8 npi_ton;uint8 numberMMISMS_BCD_NUMBER_MAX_LEN; MMISMS_BCD_NUMBER_T;參數(shù)名稱含義number_lennumber數(shù)組的BYTE個數(shù)npi_ton具體意義請查看GSM 04.08number用于存放當前號碼數(shù)組的bufferMMISMS_ORDER_INFO_T【含義】MMISMS_ORDER_INFO_T定義了信息的狀態(tài)、號碼等信息，用于開機排序和列 表顯示等?！径x】typedef struct _MMISMS_ORDER_INFO_Tuint

18、32time;int32record_id;MMISMS_MO_MT_TYPE_E mo_mt_type;MMISMS_MSG_TYPE_Emsg_type;MN_DUAL_SYS_Edual_sys;MMISMS_DISPLAY_CONTENT_T display_content;uint8*sender; MMISMS_ORDER_INFO_T;【參數(shù)說明】參數(shù)名稱含義time時間，單位：秒record_id信息的唯一標識mo_mt_type當前信息的狀態(tài)msg_type信息的類型dual_sy雙卡參數(shù)display_content在列表中顯示的內容senderWAP Push、OTA消息

19、的發(fā)件人號碼或者電子郵件地址第3章API函數(shù)MMIAPISMS_AppInit【函數(shù)原型】void MMIAPISMS_AppInit (void);【函數(shù)功能】短消息模塊初始化?！緟?shù)說明】無?！痉祷刂怠繜o?！咀⒁馐马棥繜o。MMIAPISMS_GetDelAllFlag【函數(shù)原型】BOOLEAN MMISMS_GetDelAllFlag (void);【函數(shù)功能】判斷當前是否正在刪除信息，如果正在刪除信息，定時關機等操作將延 遲到信息刪除完畢后執(zhí)行。【參數(shù)說明】無。【返回值】TRUE:當前正在刪除信息；FALSE：當前沒有刪除信息操作?！咀⒁馐马棥繜o。MMIAPISMS_WriteNewMe

20、ssage【函數(shù)原型】void MMIAPISMS_WriteNewMessage (MN_DUAL_SYS_Edual_sys,MMI_STRING_T*sms_init_ptr,uint8*dest_addr_ptr,uint8dest_addr_len);【函數(shù)功能】根據(jù)雙卡參數(shù)、信息內容、目的號碼等參數(shù)信息編寫新的短消息。【參數(shù)說明】dual_sys：雙卡參數(shù)；sms_init_ptr:信息的初始內容；dest_addr_ptr ：目的號碼；dest_addr_len ：目的號碼長度?！痉祷刂怠繜o?！咀⒁馐马棥繜o。MMIAPISMS_AnswerMessage【函數(shù)原型】void MM

21、IAPISMS_AnswerMessage (MN_DUAL_SYS_E dual_sys,MMI_STRING_T *sms_init_ptr,uint8*dest_addr_ptr,uint8dest_addr_len)；【函數(shù)功能】根據(jù)雙卡參數(shù)、信息內容、目的號碼等參數(shù)回復短消息?！緟?shù)說明】dual_sys：雙卡參數(shù)；sms_init_ptr:信息的初始內容；dest_addr_ptr ：目的號碼；dest_addr_len ：目的號碼長度?！痉祷刂怠繜o。【注意事項】無。3.5 MMIAPISMS_CheckMemHaveEnough【函數(shù)原型】BOOLEAN MMIAPISMS_Ch

22、eckMemHaveEnough (void);【函數(shù)功能】檢查當前的SIM卡和手機上是否有空間?！緟?shù)說明】無?！痉祷刂怠縏RUE:當前的SIM卡和手機上有空間；FALSE：無空間?！咀⒁馐马棥繜o。MMIAPISMS_IsOrderOk【函數(shù)原型】BOOLEAN MMIAPISMS_IsOrderOk (void);【函數(shù)功能】開機后判斷短消息是否已經(jīng)排好順序?！緟?shù)說明】無?！痉祷刂怠縏RUE :短消息已經(jīng)排好順序；FALSE：短消息未排好順序。【注意事項】無。MMIAPISMS_IsSMSReady【函數(shù)原型】BOOLEAN MMIAPISMS_IsSMSReady (void);【函數(shù)

23、功能】根據(jù)當前的雙卡設置情況，判斷當前是否可以開始短消息的開機排序 過程?！緟?shù)說明】無?！痉祷刂怠繜o。【注意事項】無。MMIAPISMS_SendInit【函數(shù)原型】void MMIAPISMS_SendInit (void);【函數(shù)功能】當雙卡設置變化時，調用該函數(shù)來對全局變量g_mmisms_deliver進行 初始化操作?！緟?shù)說明】無?！痉祷刂怠繜o?！疽蕾囮P系】g_mmisms_deliver?！咀⒁馐马棥繜o。MMIAPISMS_CheckSMSState【函數(shù)原型】void MMIAPISMS_CheckSMSState (void );【函數(shù)功能】根據(jù)當前的待機模式，獲得是否有未

24、讀短信、當前的空間是否已滿等 信息，通過該函數(shù)來刷新ilde界面信息的狀態(tài)圖標?！緟?shù)說明】無?！痉祷刂怠繜o?！咀⒁馐马棥繜o。MMIAPISMS_DelSMSByAT【函數(shù)原型】BOOLEAN MMIAPISMS_DelSMSByAT(BOOLEANis_mt_sms,BOOLEANis_saved_in_sim,MN_SMS_RECORD_ID_T record_id);【函數(shù)功能】同步工具根據(jù)存儲位置刪除短信息?！緟?shù)說明】is_mt_sms :是否是接收到的短消息； is_saved_in_sim：是否是保存在SIM上的短消息 record_id：標志短消息存儲位置的ID號?！痉祷刂怠縏

25、RUE:成功；FALSE：失敗。【注意事項】無。MMIAPISMS_OpenSmsBox【函數(shù)原型】void MMIAPISMS_OpenSmsBox (MMISMS_BOX_TYPE_E box_type);【函數(shù)功能】根據(jù)信箱類型參數(shù)打開信箱窗口?！緟?shù)說明】box_type：信箱類型(收件箱、發(fā)件箱、草稿箱、已發(fā)信箱)。【返回值】無?！咀⒁馐马棥繜o。MMIAPISMS_ShowNewMsgPrompt【函數(shù)原型】void MMIAPISMS_ShowNewMsgPrompt (void );【函數(shù)功能】打開新短信提示窗口。【參數(shù)說明】無?！痉祷刂怠繜o?！咀⒁馐马棥繜o。MMIAPISMS_

26、OpenMainMenuWin【函數(shù)原型】void MMIAPISMS_OpenMainMenuWin (void);【函數(shù)功能】打開信息主菜單窗口?！緟?shù)說明】無?！痉祷刂怠繜o。【注意事項】無。MMIAPISMS_OpenFreqWordListForCc【函數(shù)原型】void MMIAPISMS_OpenFreqWordListForCc (MN_DUAL_SYS_E dual_sys,uint8number_len,uint8*number_str);【函數(shù)功能】打開信息主菜單窗口。【參數(shù)說明】dual_sys：雙卡參數(shù)；number_len :號碼長度；number_str :號碼信息。

27、【返回值】無?！咀⒁馐马棥繜o。MMIAPISMS_AppSendSmsForMSD【函數(shù)原型】BOOLEAN MMIAPISMS_AppSendSmsForMSD (MN_DUAL_SYS_E dual_sys,MMI_STRING_T *sms_init_ptr,uint8*dest_addr_ptr,uint8dest_addr_len)；【函數(shù)功能】為MSD模塊發(fā)送短消息?！緟?shù)說明】dual_sys：雙卡參數(shù)；sms_init_pt :信息內容；dest_addr_ptr ：目的號碼信息；dest_addr_len ：目的號碼長度。【返回值】無。【注意事項】無。3.16 MMIAPISMS_RestoreFactorySetting【函數(shù)原型】void MMIAPISMS_RestoreFactorySetting (void);【函數(shù)功能】恢復短信模塊出廠設置，將短信的存儲位置、是否保存發(fā)送信