展讯短信模块接口介绍

1、Mocor MMI SMS Interface User GuideVersion: 1.0.0DocCode: SW-MOCOR-UG-0005Date: 2008-04-07MSPREADTRUM HYPERLINK 重要声明版权声明本文档中的任何内容受中华人民共和国著作权法的保护，版权所有 2008, 展讯通信有限公司，保留所有权利，但注明引用其他方的内容除外。商标声明展讯通信有限公司和展讯通信有限公司的产品是展讯通信有限公司专有。在提及 其他公司及其产品时将使用各自公司所拥有的商标，这种使用的目的仅限于引用。不作保证声明展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证

2、，而 且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责 任。保密声明本文档（包括任何附件）包含的信息是保密信息。接收人了解其获得的本文档是 保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第 三方。文档说明阅读对象内容介绍文档约定相关文档本文档描述了 SMS模块为其他模块提供的接口函数的设计及使用。本文档适合SMS模块的开发人员使用。本文档包括三个章节，分别为：第一章：概述。简单介绍了 SMS接口模块的特点及软件架构；第二章：数据类型。介绍7SMS接口所涉及到的各种数据类型，如枚举、结 构等；第三章：API函数。详细描述了 SMS接口包含的所有API函

3、数的定义及相关 说明。本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。注意:提醒操作中应注意的事项。说明:说明比较重要的事项。 TOC o 1-5 h z HYPERLINK l bookmark67 o Current Document 第1章概述1-1 HYPERLINK l bookmark70 o Current Document 1.1系统概述1-1 HYPERLINK l bookmark73 o Current Document SMS模块主要实现功能1-1 HYPERLINK l bookmark82 o Current Document SMS模块在系统中的位置1

4、-1 HYPERLINK l bookmark86 o Current Document 第2章 数据类型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函数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系统概述SMS模块作为短消息的人机界面部分，负责获取，处理由PS层转发的有关短消 息的消息以及用户的各种操作，执行相应的动作，并将执行结果反馈给PS或者 用户，实现短消息的功能。SMS模块主要实现功能SMS模块的主要功能有：接收新短消息：能正确的接收和处理新短消息；写短消息：用户可以写新短消息进行发送或保存；发送短消息：能够向别的用户发送短消息（支持群发）；处理小区广播：接收用户设置的信道和语言的新小区广播；操作已保存的短消息：对于保存的短消息进行读、编辑、删除、发送、多种 方式排序、标记等操作

11、。SMS模块在系统中的位置图1-1描述了 SMS模块在系统中的位置。User Interface / Menu图1-1 SMS模块在总体结构中的位置第2章数据类型2.1常量定义常量名取值说明MMIMESSAGE_DIAPLAY_LEN22短消息列表中每个item所显示的最大长度2.2枚举MMISMS_BOX_TYPE_E【含义】MMISMS_BOX_TYPE_E 定义了信箱类型。【定义】typedef enumMMISMS_BOX_NONE,MMISMS_BOX_MT,MMISMS_BOX_SENDSUCC,MMISMS_BOX_SENDFAIL,MMISMS_BOX_NOSEND MMISM

12、S_BOX_TYPE_E;【参数说明】参数名称含义MMISMS_BOX_NONE没有信箱类型MMISMS_BOX_MT收件箱MMISMS_BOX_SENDSUCC已发信箱MMISMS_BOX_SENDFAIL发件箱MMISMS_BOX_NOSEND草稿箱2.2.2 MMISMS_OPERATE_TYPE_E【含义】MMISMS_OPERATE_TYPE_E定义了当前的操作类型，当开机排序完毕后，根据 当前的操作类型进入相应的信箱或者菜单。【定义】typedef enumMMISMS_OPERATE_NONE,MMISMS_WRITE_NEW_SMS,MMISMS_OPEN_BOX,MMISMS

13、_VIEW_MEMORY MMISMS_OPERATE_TYPE_E;【参数说明】参数名称含义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;【参数说明】参数名称含义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定义了信息的状态，包括已读短消息、未读短消息、 已读状

15、态报告、未读状态报告、未下载彩信、未读彩信、已读彩信、发送失败信 息、发送成功信息、未发送信息。【定义】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【参数说明】参数名称含义MMISMS_MT_NOT_D

16、OWNLOAD未下载彩信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未发送信息【注意事项】当前的消息类型刚好占3位，如果需要添加类型则需要增加位数。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;参数名称含义number_lennumber数组的BYTE个数npi_ton具体意义请查看GSM 04.08number用于存放当前号码数组的bufferMMISMS_ORDER_INFO_T【含义】MMISMS_ORDER_INFO_T定义了信息的状态、号码等信息，用于开机排序和列 表显示等。【定义】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;【参数说明】参数名称含义time时间，单位：秒record_id信息的唯一标识mo_mt_type当前信息的状态msg_type信息的类型dual_sy双卡参数display_content在列表中显示的内容senderWAP Push、OTA消息

19、的发件人号码或者电子邮件地址第3章API函数MMIAPISMS_AppInit【函数原型】void MMIAPISMS_AppInit (void);【函数功能】短消息模块初始化。【参数说明】无。【返回值】无。【注意事项】无。MMIAPISMS_GetDelAllFlag【函数原型】BOOLEAN MMISMS_GetDelAllFlag (void);【函数功能】判断当前是否正在删除信息，如果正在删除信息，定时关机等操作将延 迟到信息删除完毕后执行。【参数说明】无。【返回值】TRUE:当前正在删除信息；FALSE：当前没有删除信息操作。【注意事项】无。MMIAPISMS_WriteNewMe

20、ssage【函数原型】void MMIAPISMS_WriteNewMessage (MN_DUAL_SYS_Edual_sys,MMI_STRING_T*sms_init_ptr,uint8*dest_addr_ptr,uint8dest_addr_len);【函数功能】根据双卡参数、信息内容、目的号码等参数信息编写新的短消息。【参数说明】dual_sys：双卡参数；sms_init_ptr:信息的初始内容；dest_addr_ptr ：目的号码；dest_addr_len ：目的号码长度。【返回值】无。【注意事项】无。MMIAPISMS_AnswerMessage【函数原型】void MM

21、IAPISMS_AnswerMessage (MN_DUAL_SYS_E dual_sys,MMI_STRING_T *sms_init_ptr,uint8*dest_addr_ptr,uint8dest_addr_len)；【函数功能】根据双卡参数、信息内容、目的号码等参数回复短消息。【参数说明】dual_sys：双卡参数；sms_init_ptr:信息的初始内容；dest_addr_ptr ：目的号码；dest_addr_len ：目的号码长度。【返回值】无。【注意事项】无。3.5 MMIAPISMS_CheckMemHaveEnough【函数原型】BOOLEAN MMIAPISMS_Ch

22、eckMemHaveEnough (void);【函数功能】检查当前的SIM卡和手机上是否有空间。【参数说明】无。【返回值】TRUE:当前的SIM卡和手机上有空间；FALSE：无空间。【注意事项】无。MMIAPISMS_IsOrderOk【函数原型】BOOLEAN MMIAPISMS_IsOrderOk (void);【函数功能】开机后判断短消息是否已经排好顺序。【参数说明】无。【返回值】TRUE :短消息已经排好顺序；FALSE：短消息未排好顺序。【注意事项】无。MMIAPISMS_IsSMSReady【函数原型】BOOLEAN MMIAPISMS_IsSMSReady (void);【函数

23、功能】根据当前的双卡设置情况，判断当前是否可以开始短消息的开机排序 过程。【参数说明】无。【返回值】无。【注意事项】无。MMIAPISMS_SendInit【函数原型】void MMIAPISMS_SendInit (void);【函数功能】当双卡设置变化时，调用该函数来对全局变量g_mmisms_deliver进行 初始化操作。【参数说明】无。【返回值】无。【依赖关系】g_mmisms_deliver。【注意事项】无。MMIAPISMS_CheckSMSState【函数原型】void MMIAPISMS_CheckSMSState (void );【函数功能】根据当前的待机模式，获得是否有未

24、读短信、当前的空间是否已满等 信息，通过该函数来刷新ilde界面信息的状态图标。【参数说明】无。【返回值】无。【注意事项】无。MMIAPISMS_DelSMSByAT【函数原型】BOOLEAN MMIAPISMS_DelSMSByAT(BOOLEANis_mt_sms,BOOLEANis_saved_in_sim,MN_SMS_RECORD_ID_T record_id);【函数功能】同步工具根据存储位置删除短信息。【参数说明】is_mt_sms :是否是接收到的短消息； is_saved_in_sim：是否是保存在SIM上的短消息 record_id：标志短消息存储位置的ID号。【返回值】T

25、RUE:成功；FALSE：失败。【注意事项】无。MMIAPISMS_OpenSmsBox【函数原型】void MMIAPISMS_OpenSmsBox (MMISMS_BOX_TYPE_E box_type);【函数功能】根据信箱类型参数打开信箱窗口。【参数说明】box_type：信箱类型(收件箱、发件箱、草稿箱、已发信箱)。【返回值】无。【注意事项】无。MMIAPISMS_ShowNewMsgPrompt【函数原型】void MMIAPISMS_ShowNewMsgPrompt (void );【函数功能】打开新短信提示窗口。【参数说明】无。【返回值】无。【注意事项】无。MMIAPISMS_

26、OpenMainMenuWin【函数原型】void MMIAPISMS_OpenMainMenuWin (void);【函数功能】打开信息主菜单窗口。【参数说明】无。【返回值】无。【注意事项】无。MMIAPISMS_OpenFreqWordListForCc【函数原型】void MMIAPISMS_OpenFreqWordListForCc (MN_DUAL_SYS_E dual_sys,uint8number_len,uint8*number_str);【函数功能】打开信息主菜单窗口。【参数说明】dual_sys：双卡参数；number_len :号码长度；number_str :号码信息。

27、【返回值】无。【注意事项】无。MMIAPISMS_AppSendSmsForMSD【函数原型】BOOLEAN MMIAPISMS_AppSendSmsForMSD (MN_DUAL_SYS_E dual_sys,MMI_STRING_T *sms_init_ptr,uint8*dest_addr_ptr,uint8dest_addr_len)；【函数功能】为MSD模块发送短消息。【参数说明】dual_sys：双卡参数；sms_init_pt :信息内容；dest_addr_ptr ：目的号码信息；dest_addr_len ：目的号码长度。【返回值】无。【注意事项】无。3.16 MMIAPISMS_RestoreFactorySetting【函数原型】void MMIAPISMS_RestoreFactorySetting (void);【函数功能】恢复短信模块出厂设置，将短信的存储位置、是否保存发送信