展訊短信模塊接口介紹_第1頁(yè)
展訊短信模塊接口介紹_第2頁(yè)
展訊短信模塊接口介紹_第3頁(yè)
展訊短信模塊接口介紹_第4頁(yè)
展訊短信模塊接口介紹_第5頁(yè)
已閱讀5頁(yè),還剩18頁(yè)未讀, 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說(shuō)明:本文檔由用戶(hù)提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡(jiǎn)介

TITLEMocorMMISMSInterfaceUserGuideVersion:1.0.DocCode:SW-MOCOR-UG-0005Date:200重要聲明版權(quán)聲明本文檔中的任何內(nèi)容受《中華人民共和國(guó)著作權(quán)法》的保護(hù),版權(quán)所有?2023,展訊通信,保存所有權(quán)利,但注明引用其他方的內(nèi)容除外。商標(biāo)聲明展訊通信和展訊通信的產(chǎn)品是展訊通信專(zhuān)有。在提及其他公司及其產(chǎn)品時(shí)將使用各自公司所擁有的商標(biāo),這種使用的目的僅限于引用。不作保證聲明展訊通信不對(duì)此文檔中的任何內(nèi)容作任何明示或暗示的陳述或保證,而且不對(duì)特定目的的適銷(xiāo)性及適用性或者任何間接、特殊或連帶的損失承當(dāng)任何責(zé)任。保密聲明本文檔〔包括任何附件〕包含的信息是保密信息。接收人了解其獲得的本文檔是保密的,除用于規(guī)定的目的外不得用于任何目的,也不得將本文檔泄露給任何第三方。前言文檔說(shuō)明本文檔描述了SMS模塊為其他模塊提供的接口函數(shù)的設(shè)計(jì)及使用。閱讀對(duì)象本文檔適合SMS模塊的開(kāi)發(fā)人員使用。內(nèi)容介紹本文檔包括三個(gè)章節(jié),分別為:第一章:概述。簡(jiǎn)單介紹了SMS接口模塊的特點(diǎn)及軟件架構(gòu);第二章:數(shù)據(jù)類(lèi)型。介紹了SMS接口所涉及到的各種數(shù)據(jù)類(lèi)型,如枚舉、結(jié)構(gòu)等;第三章:API函數(shù)。詳細(xì)描述了SMS接口包含的所有API函數(shù)的定義及相關(guān)說(shuō)明。文檔約定本文檔采用下面醒目標(biāo)志來(lái)表示在操作過(guò)程中應(yīng)該特別注意的地方。注意:提醒操作中應(yīng)注意的事項(xiàng)。說(shuō)明:說(shuō)明比擬重要的事項(xiàng)。相關(guān)文檔目錄TOC\o"1-3"\h\z\t"標(biāo)題6,1,標(biāo)題7,2,標(biāo)題8,3"第1章概述1-11.1系統(tǒng)概述1-11.2SMS模塊主要實(shí)現(xiàn)功能1-11.3SMS模塊在系統(tǒng)中的位置1-1第2章數(shù)據(jù)類(lèi)型2-12.1常量定義2-12.2枚舉2-12.2.1MMISMS_BOX_TYPE_E2-12.2.2MMISMS_OPERATE_TYPE_E2-22.2.3MMISMS_MSG_TYPE_E2-22.2.4MMISMS_MO_MT_TYPE_E2-32.3結(jié)構(gòu)2-42.3.1MMISMS_BCD_NUMBER_T2-42.3.2MMISMS_ORDER_INFO_T2-5第3章API函數(shù)3-13.1MMIAPISMS_AppInit3-13.2MMIAPISMS_GetDelAllFlag3-13.3MMIAPISMS_WriteNewMessage3-23.4MMIAPISMS_AnswerMessage3-23.5MMIAPISMS_CheckMemHaveEnough3-33.6MMIAPISMS_IsOrderOk3-43.7MMIAPISMS_IsSMSReady3-43.8MMIAPISMS_SendInit3-53.9MMIAPISMS_CheckSMSState3-53.10MMIAPISMS_DelSMSByAT3-63.11MMIAPISMS_OpenSmsBox3-63.12MMIAPISMS_ShowNewMsgPrompt3-73.13MMIAPISMS_OpenMainMenuWin3-73.14MMIAPISMS_OpenFreqWordListForCc3-83.15MMIAPISMS_AppSendSmsForMSD3-83.16MMIAPISMS_RestoreFactorySetting3-93.17MMIAPISMS_DeleteMsgInorder3-103.18MMIAPISMS_InsertOneMsgToOrder3-103.19MIAPISMS_UpdateMsgStatusInOrder3-113.20MMIAPISMS_MMSOrderDone3-11附錄ARevisionHistoryA-1概述系統(tǒng)概述SMS模塊作為短消息的人機(jī)界面局部,負(fù)責(zé)獲取,處理由PS層轉(zhuǎn)發(fā)的有關(guān)短消息的消息以及用戶(hù)的各種操作,執(zhí)行相應(yīng)的動(dòng)作,并將執(zhí)行結(jié)果反應(yīng)給PS或者用戶(hù),實(shí)現(xiàn)短消息的功能。SMS模塊主要實(shí)現(xiàn)功能SMS模塊的主要功能有:接收新短消息:能正確的接收和處理新短消息;寫(xiě)短消息:用戶(hù)可以寫(xiě)新短消息進(jìn)行發(fā)送或保存;發(fā)送短消息: 能夠向別的用戶(hù)發(fā)送短消息〔支持群發(fā)〕;處理小區(qū)播送:接收用戶(hù)設(shè)置的信道和語(yǔ)言的新小區(qū)播送;操作已保存的短消息: 對(duì)于保存的短消息進(jìn)行讀、編輯、刪除、發(fā)送、多種方式排序、標(biāo)記等操作。SMS模塊在系統(tǒng)中的位置REF_Ref187652165\h圖11描述了SMS模塊在系統(tǒng)中的位置。圖STYLEREF1\s1SEQ圖\*ARABIC\s11SMS模塊在總體結(jié)構(gòu)中的位置數(shù)據(jù)類(lèi)型常量定義常量名取值說(shuō)明MMIMESSAGE_DIAPLAY_LEN22短消息列表中每個(gè)item所顯示的最大長(zhǎng)度枚舉MMISMS_BOX_TYPE_E【含義】MMISMS_BOX_TYPE_E定義了信箱類(lèi)型。【定義】typedefenum{MMISMS_BOX_NONE,MMISMS_BOX_MT,MMISMS_BOX_SENDSUCC,MMISMS_BOX_SENDFAIL,MMISMS_BOX_NOSEND}MMISMS_BOX_TYPE_E;【參數(shù)說(shuō)明】參數(shù)名稱(chēng)含義MMISMS_BOX_NONE沒(méi)有信箱類(lèi)型MMISMS_BOX_MT收件箱MMISMS_BOX_SENDSUCC已發(fā)信箱MMISMS_BOX_SENDFAIL發(fā)件箱MMISMS_BOX_NOSEND草稿箱MMISMS_OPERATE_TYPE_E【含義】MMISMS_OPERATE_TYPE_E定義了當(dāng)前的操作類(lèi)型,當(dāng)開(kāi)機(jī)排序完畢后,根據(jù)當(dāng)前的操作類(lèi)型進(jìn)入相應(yīng)的信箱或者菜單?!径x】typedefenum{MMISMS_OPERATE_NONE,MMISMS_WRITE_NEW_SMS,MMISMS_OPEN_BOX,MMISMS_VIEW_MEMORY}MMISMS_OPERATE_TYPE_E;【參數(shù)說(shuō)明】參數(shù)名稱(chēng)含義MMISMS_OPERATE_NONE當(dāng)前無(wú)操作MMISMS_WRITE_NEW_SMS寫(xiě)新的短消息MMISMS_OPEN_BOX翻開(kāi)信箱MMISMS_VIEW_MEMORY查看信息空間MMISMS_MSG_TYPE_E【含義】MMISMS_MSG_TYPE_E定義了信息的類(lèi)型,包括短消息,彩信、WAPPush消息、WAPOTA消息、彩信OTA消息。【定義】typedefenum{MMISMS_TYPE_SMS=0,MMISMS_TYPE_MMS=1,MMISMS_TYPE_WAP_PUSH=2,MMISMS_TYPE_MMS_OTA=3,MMISMS_TYPE_WAP_OTA=4,MMISMS_TYPE_MAX}MMISMS_MSG_TYPE_E;【參數(shù)說(shuō)明】參數(shù)名稱(chēng)含義MMISMS_TYPE_SMS短消息MMISMS_TYPE_MMS彩信MMISMS_TYPE_WAP_PUSHWAPPush消息MMISMS_TYPE_MMS_OTA彩信OTA消息MMISMS_TYPE_WAP_OTAWapOTA消息MMISMS_MO_MT_TYPE_E【含義】MMISMS_MO_MT_TYPE_E定義了信息的狀態(tài),包括已讀短消息、未讀短消息、已讀狀態(tài)報(bào)告、未讀狀態(tài)報(bào)告、未下載彩信、未讀彩信、已讀彩信、發(fā)送失敗信息、發(fā)送成功信息、未發(fā)送信息。【定義】typedefenummmisms_mo_mt_type_tag{MMISMS_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ù)說(shuō)明】參數(shù)名稱(chēng)含義MMISMS_MT_NOT_DOWNLOAD未下載彩信MMISMS_MT_TO_BE_READ未讀彩信MMISMS_MT_HAVE_READ已讀彩信MMISMS_MT_SR_TO_BE_READ未讀狀態(tài)報(bào)告MMISMS_MT_SR_HAVE_READ已讀狀態(tài)報(bào)告MMISMS_MO_SEND_SUCC已發(fā)信息MMISMS_MO_SEND_FAIL發(fā)送失敗信息MMISMS_MO_DRAFT未發(fā)送信息【考前須知】當(dāng)前的消息類(lèi)型剛好占3位,如果需要添加類(lèi)型那么需要增加位數(shù)。結(jié)構(gòu)MMISMS_BCD_NUMBER_T【含義】MMISMS_BCD_NUMBER_T定義了短消息的號(hào)碼類(lèi)型【定義】typedefstructtag_MMISMS_BCD_NUMBER_T{uint8number_len;uint8npi_ton;uint8 number[MMISMS_BCD_NUMBER_MAX_LEN];}MMISMS_BCD_NUMBER_T;參數(shù)名稱(chēng)含義number_lennumber數(shù)組的BYTE個(gè)數(shù)npi_ton具體意義請(qǐng)查看GSM04.08number用于存放當(dāng)前號(hào)碼數(shù)組的bufferMMISMS_ORDER_INFO_T【含義】MMISMS_ORDER_INFO_T定義了信息的狀態(tài)、號(hào)碼等信息,用于開(kāi)機(jī)排序和列表顯示等?!径x】typedefstruct_MMISMS_ORDER_INFO_T{uint32 time;int32 record_id;MMISMS_MO_MT_TYPE_E mo_mt_type;MMISMS_MSG_TYPE_Emsg_type;MN_DUAL_SYS_E dual_sys;MMISMS_DISPLAY_CONTENT_T display_content;uint8*sender;}MMISMS_ORDER_INFO_T;【參數(shù)說(shuō)明】參數(shù)名稱(chēng)含義time時(shí)間,單位:秒record_id信息的唯一標(biāo)識(shí)mo_mt_type當(dāng)前信息的狀態(tài)msg_type信息的類(lèi)型dual_sy雙卡參數(shù)display_content在列表中顯示的內(nèi)容senderWAPPush、OTA消息的發(fā)件人號(hào)碼或者電子郵件地址API函數(shù)MMIAPISMS_AppInit【函數(shù)原型】voidMMIAPISMS_AppInit(void);【函數(shù)功能】短消息模塊初始化?!緟?shù)說(shuō)明】無(wú)?!痉祷刂怠繜o(wú)?!究记绊氈繜o(wú)。MMIAPISMS_GetDelAllFlag【函數(shù)原型】BOOLEANMMISMS_GetDelAllFlag(void);【函數(shù)功能】判斷當(dāng)前是否正在刪除信息,如果正在刪除信息,定時(shí)關(guān)機(jī)等操作將延遲到信息刪除完畢后執(zhí)行?!緟?shù)說(shuō)明】無(wú)?!痉祷刂怠縏RUE:當(dāng)前正在刪除信息;FALSE:當(dāng)前沒(méi)有刪除信息操作?!究记绊氈繜o(wú)。MMIAPISMS_WriteNewMessage【函數(shù)原型】voidMMIAPISMS_WriteNewMessage(MN_DUAL_SYS_Edual_sys,MMI_STRING_T*sms_init_ptr,uint8*dest_addr_ptr,uint8dest_addr_len);【函數(shù)功能】根據(jù)雙卡參數(shù)、信息內(nèi)容、目的號(hào)碼等參數(shù)信息編寫(xiě)新的短消息?!緟?shù)說(shuō)明】dual_sys:雙卡參數(shù);sms_init_ptr :信息的初始內(nèi)容;dest_addr_ptr:目的號(hào)碼;dest_addr_len:目的號(hào)碼長(zhǎng)度?!痉祷刂怠繜o(wú)?!究记绊氈繜o(wú)。MMIAPISMS_AnswerMessage【函數(shù)原型】voidMMIAPISMS_AnswerMessage(MN_DUAL_SYS_Edual_sys,MMI_STRING_T*sms_init_ptr,uint8*dest_addr_ptr,uint8 dest_addr_len);【函數(shù)功能】根據(jù)雙卡參數(shù)、信息內(nèi)容、目的號(hào)碼等參數(shù)回復(fù)短消息?!緟?shù)說(shuō)明】dual_sys:雙卡參數(shù);sms_init_ptr :信息的初始內(nèi)容;dest_addr_ptr:目的號(hào)碼;dest_addr_len:目的號(hào)碼長(zhǎng)度。【返回值】無(wú)?!究记绊氈繜o(wú)。MMIAPISMS_CheckMemHaveEnough【函數(shù)原型】BOOLEANMMIAPISMS_CheckMemHaveEnough(void);【函數(shù)功能】檢查當(dāng)前的SIM卡和上是否有空間?!緟?shù)說(shuō)明】無(wú)。【返回值】TRUE:當(dāng)前的SIM卡和上有空間;FALSE:無(wú)空間。【考前須知】無(wú)。MMIAPISMS_IsOrderOk【函數(shù)原型】BOOLEANMMIAPISMS_IsOrderOk(void);【函數(shù)功能】開(kāi)機(jī)后判斷短消息是否已經(jīng)排好順序?!緟?shù)說(shuō)明】無(wú)。【返回值】TRUE:短消息已經(jīng)排好順序;FALSE:短消息未排好順序。【考前須知】無(wú)。MMIAPISMS_IsSMSReady【函數(shù)原型】BOOLEANMMIAPISMS_IsSMSReady(void);【函數(shù)功能】根據(jù)當(dāng)前的雙卡設(shè)置情況,判斷當(dāng)前是否可以開(kāi)始短消息的開(kāi)機(jī)排序過(guò)程?!緟?shù)說(shuō)明】無(wú)?!痉祷刂怠繜o(wú)?!究记绊氈繜o(wú)。MMIAPISMS_SendInit【函數(shù)原型】voidMMIAPISMS_SendInit(void);【函數(shù)功能】當(dāng)雙卡設(shè)置變化時(shí),調(diào)用該函數(shù)來(lái)對(duì)全局變量g_mmisms_deliver進(jìn)行初始化操作?!緟?shù)說(shuō)明】無(wú)?!痉祷刂怠繜o(wú)。【依賴(lài)關(guān)系】g_mmisms_deliver?!究记绊氈繜o(wú)。MMIAPISMS_CheckSMSState【函數(shù)原型】voidMMIAPISMS_CheckSMSState(void);【函數(shù)功能】根據(jù)當(dāng)前的待機(jī)模式,獲得是否有未讀短信、當(dāng)前的空間是否已滿等信息,通過(guò)該函數(shù)來(lái)刷新ilde界面信息的狀態(tài)圖標(biāo)?!緟?shù)說(shuō)明】無(wú)?!痉祷刂怠繜o(wú)?!究记绊氈繜o(wú)。MMIAPISMS_DelSMSByAT【函數(shù)原型】BOOLEANMMIAPISMS_DelSMSByAT(BOOLEAN is_mt_sms,BOOLEAN is_saved_in_sim,MN_SMS_RECORD_ID_Trecord_id);【函數(shù)功能】同步工具根據(jù)存儲(chǔ)位置刪除短信息。【參數(shù)說(shuō)明】is_mt_sms:是否是接收到的短消息;is_saved_in_sim:是否是保存在SIM上的短消息record_id:標(biāo)志短消息存儲(chǔ)位置的ID號(hào)?!痉祷刂怠縏RUE:成功;FALSE:失敗?!究记绊氈繜o(wú)。MMIAPISMS_OpenSmsBox【函數(shù)原型】voidMMIAPISMS_OpenSmsBox(MMISMS_BOX_TYPE_E box_type);【函數(shù)功能】根據(jù)信箱類(lèi)型參數(shù)翻開(kāi)信箱窗口?!緟?shù)說(shuō)明】box_type:信箱類(lèi)型〔收件箱、發(fā)件箱、草稿箱、已發(fā)信箱〕?!痉祷刂怠繜o(wú)?!究记绊氈繜o(wú)。MMIAPISMS_ShowNewMsgPrompt【函數(shù)原型】voidMMIAPISMS_ShowNewMsgPrompt(void);【函數(shù)功能】翻開(kāi)新短信提示窗口。【參數(shù)說(shuō)明】無(wú)?!痉祷刂怠繜o(wú)?!究记绊氈繜o(wú)。MMIAPISMS_OpenMainMenuWin【函數(shù)原型】voidMMIAPISMS_OpenMainMenuWin(void);【函數(shù)功能】翻開(kāi)信息主菜單窗口?!緟?shù)說(shuō)明】無(wú)。【返回值】無(wú)。【考前須知】無(wú)。MMIAPISMS_OpenFreqWordListForCc【函數(shù)原型】voidMMIAPISMS_OpenFreqWordListForCc(MN_DUAL_SYS_Edual_sys,uint8number_len,uint8*number_str);【函數(shù)功能】翻開(kāi)信息主菜單窗口。【參數(shù)說(shuō)明】dual_sys:雙卡參數(shù);number_len:號(hào)碼長(zhǎng)度;number_str:號(hào)碼信息。【返回值】無(wú)。【考前須知】無(wú)。MMIAPISMS_AppSendSmsForMSD【函數(shù)原型】BOOLEANMMIAPISMS_AppSendSmsForMSD(MN_DUAL_SYS_Edual_sys,MMI_STRING_T*sms_init_ptr,uint8 *dest_addr_ptr,uint8 dest_addr_len);【函數(shù)功能】為MSD模塊發(fā)送短消息?!緟?shù)說(shuō)明】dual_sys:雙卡參數(shù);sms_init_pt:信息內(nèi)容;dest_addr_ptr:目的號(hào)碼信息;dest_addr_len:目的號(hào)碼長(zhǎng)度。【返回值】無(wú)?!究记绊氈繜o(wú)。MMIAPISMS_RestoreFactorySetting【函數(shù)原型】voidMMIAPISMS_RestoreFactorySetting(void);【函數(shù)功能】恢復(fù)短信模塊出廠設(shè)置,將短信的存儲(chǔ)位置、是否保存發(fā)送信息等設(shè)置信息恢復(fù)為默認(rèn)的出廠設(shè)置。【參數(shù)說(shuō)明】無(wú)?!痉祷刂怠繜o(wú)。【考前須知】無(wú)。MMIAPISMS_DeleteMsgInorder【函數(shù)原型】BOOLEANMM

溫馨提示

  • 1. 本站所有資源如無(wú)特殊說(shuō)明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶(hù)所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁(yè)內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒(méi)有圖紙預(yù)覽就沒(méi)有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶(hù)上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶(hù)上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶(hù)因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。

最新文檔

評(píng)論

0/150

提交評(píng)論