1077@52RD_0934@52RD_详细设计说明书(短消息)

目录修改历史 ................................................................. 错误！未定义书签。

1整体结构及功能描述 .. (2)2关键数据结构说明 (3)3主要存储分配 (6)4各子模块实现及主要算法说明 (6)4.1初始化 (6)4.2短消息常见功能实现 (8)4．2．1 短消息的发送 (8)4.2.2短消息的接收 (10)4.2.3短消息的保存 (11)4.2.4短消息的删除 (12)4.2.5编辑短消息 (13)4.3附加的一些SMS功能 (13)4.4短消息设定 (15)5内部调用的主要函数说明 (15)6模块提供的外部接口函数说明 (17)7主要信号说明 (17)8相关文档文件 (18)1整体结构及功能描述说明该程序应具有的功能，可采用IPO图（即输入一处理一输出图）的形式或文字描述。

短消息部分的整体结构如下图所示：SMS大体分为以下几层：UI层,PS层以及架构在这两层之上的一些模块(Setting,Ems,CB,Miscell等)。

其中UI层其实是mmi层，是用户和ms交互的接口层，而Ps层则是与底层PS进行交互的接口层，其它的模块都是在这两层的基础上建立起来的。

SMS上下层之间的协作通过上层调用下层的ps层接口函数来通信，比如说上层要实现一个发送一个消息的操作，它就要调用底层对应的提供的封装好的相应的发送消息的函数接口。

在这些封装好的接口函数中，通过发送消息来实现最终的消息发送等操作。

SMS部分的功能包括以下这些方面：1，初始化过程。

当从L4收到SMS准备就绪的ind后，开始进行更新CB 频道信息，取得当前有效的SC号码，以及取得当前信箱的状态信息等。

当这些动作做完之后，MMI SMS才算是达到一个稳定状态，并且用户可以进入信箱列表，信息设定，CB菜单，以及发送message等。

2，短消息的一些常见功能，例如短消息的发送，接收，删除，保存等等。

另外就是短消息的这些常见的操作的组合操作了，如删除全部，就是不停的循环直至所有的消息都被删除掉；以及群组发送等功能，就是循环发送给一个数组中的所有的号码。

3，短消息一些附加的功能，比如：输入法，文本格式，插入一些图片，铃声，以及一些预定义的信息等。

这些附加的功能信息在SMS部分的功能也是非常重要的，MT6219支持EMS等。

4，短消息的设定模块，这个模块中包括Profile设定(包括SC号设定等)，以及common变量设定，存储介质设定以及偏爱的传输网络设定等。

从下层的角度看，大致可以分成一下这些模块：对短信的编辑；对短信的保存，以及对短信的各种操作等。

其中的编辑指的就是对短信息的各种加工操作，包括修改文本格式，插入object对象，图片，铃声等等；短信息的保存操作主要是指收件箱和发件箱，收件箱主要是接收外部发来的消息，而发件箱则主要是保存从本机上发送出去的消息，这些消息可以是由于ms用户选择得在发送同时保存或者是由于消息没有成功发送而强制进行保存；对短信的各种操作例如有对短信的删除，全部删除，取出其中的号码等。

2关键数据结构说明说明与本模块相直接关联的主要数据类型、主要常量、主要全局变量等。

保存sms环境变量的数据结构类型：typedef struct{S32 currHiliteIndex;//当前高亮的消息indexS32 currBoxIndex;//当前的BoxU16 MessagesScrnIdToDelHistoryNodes;//从那个screenId开始删除HistoryU16 MessagesScrnIdDelUptoHistoryNodes;//删除到那个HistoryNodeU16 msg_ind_index;//消息索引U16 msg_ind_chat_index;//chat中的消息索引U8 msg_ind_in_idle;//是否处于idle状态U8 msg_ind_after_call;//是否要处在call后处理U8 msg_class0_ind;//是否属于class0 类的消息U8 msg_full_ind;//msg空间是否已满U8 msg_exceed_ind;//msg空间是否已超出U8 msg_deliver_ind;//msg已经传输U8 msg_waiting_ind;//是否有等待处理的消息U8 msg_init; //init to be falseU8 number_from_phb; //init to be 0S8 smsPhoneNumber [(MAX_DIGITS+1)*ENCODING_LENGTH];//sms的目的号码#ifdef __MMI_MESSAGES_TEMPLATE__S8* templates [NUM_TEMPLATES] ;//存放所有的templates的起始地址S8 scratchTemplRec[NVRAM_SMS_TEMPL_RECORD_SIZE+ENCODING_LENGTH] ;//每次暂存的一条Templ#endifS8* numbersList [MAX_USE_NUMBERS] ;//存放从msg 中取得的号码U8 PhbSmsInterfaceState; //MMI_PHB_SMS_INTERFACE//sms中用到phb时状态MMI_SEND_ONLY...msg_display_list_enum toDisplayMessageList;//显示MsgList 的情况: 可以为TO_DISPLAY_MESSAGE_LIST_NONE//TO_DISPLAY_MESSAGE_LIST_INBOX等...msg_send_case_enum sendMessageCase;//发送消息的方式: 可以是SEND_CASE_SEND_ONLY...等msg_send_save_status_enum sendSaveStatus;//发送保存状态，已发送成功? 保存成功?msg_status_enum msg_status; //init to be MSG_STATUS_NOT_READY//消息当前状态msg_waiting_ind_struct msg_waiting_info[MAX_W AITING_LINE_NUM]; //init to zero//等待处理的消息信息msg_class0_msg_struct* msg_class0_p; //init to NULL//class0 类消息指针msg_deliver_report_struct* msg_deliver_report[MAX_STATUS_REPORT_NUM]; //init to NULL//msg的发送报告_ _ _ 信息#if defined(__MMI_MESSAGES_SEND_BY_GROUP__) || defined(__MMI_MESSAGES_SEND_TO_MANY__)msg_send_many_struct msg_send_info;//Send By Group 和Send To Many情况下的消息发送的纪录信息#endif#if defined(__MMI_SMART_MESSAGE_MT__) || (defined(__MMI_SMART_MESSAGE_MO__)&&!defined(__MMI_MESSAGES_EMS__)) U16 dest_port;#endif}msg_context_struct;msg_context_struct g_msg_cntx;//上面这个全局变量g_msg_cntx是用来保存纪录sms的上下文环境变量的关键结构变量；//在整个sms的运行期间其着非常重要的作用另外一个比较重要的全局变量就是msg_msgbox_info_struct msgbox_info;这个全局变量是纪录所有的inbox和outbox的相关信息的，并且要注意的是：inbox,outbox 以及awaitlist都是在同一个队列中，这个msgbox_info全剧变量是纪录所有的消息的一个结构数组。

下面这个数据结构是暂存发送的数据的：在sms中一个信息可能比较长，由几个子片段信息组成(一个子信息长度固定)，在一个消息发送出去之前，暂存在这个变量中。

typedef struct{unsigned char totalSegments ;//总共有多少个子片段unsigned char presentSegments ; //当前的片段unsigned char nextSegment ;//一个一个发送时下一个发送的片段unsigned char dcs;//编码方法__有gsm_7bit,8_bit,ucs2等unsigned char udhi;//User Data Header Indicator用户信息头标记unsigned char mti;// Message Type Identifier消息类型标记unsigned char st;//Status消息处理状态报告；详细的取值范围见—smsal_st_enum//枚举类型中的定义// Params for Sending onlychar* phNumber ;//发送的目的号码unsigned char number[(20+2)*2];//unsigned char status ;//状态信息unsigned char timestamp[6];//时间戳//prepare for new interface, 0416unsigned short msgboxindex;//msgBox中的纪录索引// Take a contiguous buffer so that we can re-use!//下边这几个域是用来保存用户的msg中的信息的unsigned char TPUD[MMI_SMS_MAX_MSG_SEG * 160];//最长保存信息unsigned char* TPUD_p[MMI_SMS_MAX_MSG_SEG];//每个seg信息的指真unsigned char TPUDLen[MMI_SMS_MAX_MSG_SEG];//每一个seg中信息的长度//MTK Joy added for error SIM handler, 10/07unsigned char TPUD_udhi[MMI_SMS_MAX_MSG_SEG];//对每一个seg保存一个用户信息的头标记unsigned short l4index[MMI_SMS_MAX_MSG_SEG];//l4层中的每一个msg_seg 对应的索引}PendingSaveSendDataStruct;对应这个数据结构，定义的一个全局变量：PendingSaveSendDataStruct PendingSaveSendData;这个也是一个非常重要的全局变量，它里边暂保存了当前正要待发送的数据信息的相关信息，为下面调用底层的发送消息的命令提供了一个数据暂存空间，当L4层向协议栈发送出消息时，就从这个结构中取相应的数据，然后发送消息。