详细设计说明书（短消息）.docVIP

[短消息] 详细设计说明书 [MTK-M3项目组] 康佳通信科技开发中心软件所 2005年5月8日  目录 修改历史 3 1整体结构及功能描述 4 2关键数据结构说明 5 3主要存储分配 8 4各子模块实现及主要算法说明 8 4.1 初始化 8 4.2 短消息常见功能实现 10 4．2．1 短消息的发送 10 4.2.2短消息的接收 12 4.2.3短消息的保存 13 4.2.4短消息的删除 14 4.2.5编辑短消息 15 4.3附加的一些SMS功能 15 4.4短消息设定 17 5内部调用的主要函数说明 17 6模块提供的外部接口函数说明 19 7主要信号说明 19 8相关文档文件 20 修改历史 时间 修改人 版本 修改内容 2005-4-22 张成卫 1.0 创建初始版本 1整体结构及功能描述 说明该程序应具有的功能，可采用IPO图（即输入一处理一输出图）的形式或文字描述。 短消息部分的整体结构如下图所示： SMS大体分为以下几层：UI层,PS层以及架构在这两层之上的一些模块(Setting,Ems,CB,Miscell等)。其中UI层其实是mmi层，是用户和ms交互的接口层，而Ps层则是与底层PS进行交互的接口层，其它的模块都是在这两层的基础上建立起来的。 SMS上下层之间的协作通过上层调用下层的ps层接口函数来通信，比如说上层要实现一个发送一个消息的操作，它就要调用底层对应的提供的封装好的相应的发送消息的函数接口。 在这些封装好的接口函数中，通过发送消息来实现最终的消息发送等操作。 SMS部分的功能包括以下这些方面： 初始化过程。当从L4收到SMS准备就绪的ind后，开始进行更新CB 频道信息，取得当前有效的SC号码，以及取得当前信箱的状态信息等。当这些动作做完之后，MMI SMS才算是达到一个稳定状态，并且用户可以进入信箱列表，信息设定，CB菜单，以及发送message等。 短消息的一些常见功能，例如短消息的发送，接收，删除，保存等等。另外就是短消息的这些常见的操作的组合操作了，如删除全部，就是不停的循环直至所有的消息都被删除掉；以及群组发送等功能，就是循环发送给一个数组中的所有的号码。 短消息一些附加的功能，比如：输入法，文本格式，插入一些图片，铃声，以及一些预定义的信息等。这些附加的功能信息在SMS部分的功能也是非常重要的，MT6219支持EMS等。 短消息的设定模块，这个模块中包括Profile设定(包括SC号设定等)，以及common变量设定，存储介质设定以及偏爱的传输网络设定等。 从下层的角度看，大致可以分成一下这些模块： 对短信的编辑；对短信的保存，以及对短信的各种操作等。 其中的编辑指的就是对短信息的各种加工操作，包括修改文本格式，插入object对象，图片，铃声等等；短信息的保存操作主要是指收件箱和发件箱，收件箱主要是接收外部发来的消息，而发件箱则主要是保存从本机上发送出去的消息，这些消息可以是由于ms用户选择得在发送同时保存或者是由于消息没有成功发送而强制进行保存；对短信的各种操作例如有对短信的删除，全部删除，取出其中的号码等。 2关键数据结构说明 说明与本模块相直接关联的主要数据类型、主要常量、主要全局变量等。 保存sms环境变量的数据结构类型： typedef struct { S32 currHiliteIndex;//当前高亮的消息index S32 currBoxIndex;//当前的Box U16 MessagesScrnIdToDelHistoryNodes;//从那个screenId开始删除History U16 MessagesScrnIdDelUptoHistoryNodes;//删除到那个HistoryNode U16 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 false U8 number_from_phb; //init to be 0 S8 smsPhoneNumber [(MAX_DIGITS+1