短信收发服务程序概要设计.doc

Software High level Design Specification软件概要设计说明书Doc ID:State:Draft Reviewed Initial RevisedDoc Type:SW Req SW Des SCM TEST SW Plan SQAProject: 短信收发服务Module: Current Version: v0.0.1Previous Version：Pages：Release Date：ComposerReviserReviewerRelatedSW TesterSCMSQAQASPMPMApproverSSMREVISION HISTORYNO.DateModify CauseDescriptionVersionComposerApproverReview ID12010-6-22短信服务程序通信协议0.0.2TABLE OF CONTENTS1 介绍 Introduction 1.1 目的 Purpose a. 开发 SmsServer 短信收发服务，用于基站监控收发短信1.2 范围 Scope TSTester 主要运行平台为Linux 和 Windows 。 系统开发语言为C+/C , 系统主要用到一些跨平台的库作为adapter层。1.3 术语、缩略语定义 Definitions, Acronyms, and Abbreviations SmsServer短信收发服务BoostBoost C+ LibrariesXMLExtensible Markup LanguageWBXMLWap Binary XMLWAPWireless Application ProtocolSTLC+ Standard LibrariesLUA轻量、可扩展的LuabindLua 的c+ 封装Logxx开源的日志组件 1.4 参考资料 References 1. 基站监控中心系统设计方案.doc1.5 文档路径 Document Location无2 分析 Analysis 2.1 设计选择 Design Alternatives None.2.2 运行环境 Running Environment Windows/Linux2.3 尚未解决的问题 To Be Resolved Issue 3 结构设计Architecture Decomposition 系统主要分为5个子模块，服务管理模块完成所有逻辑处理，短信收发模块用于收发短信，网络模块处理外部的网络通信，适配层主要是一些跨平台库，及公共库，单片机控制模块用于对模块进行开关机操作3.1 数据包结构及通信过程 说明:序号域说明1.包长数据包长度(不包括包长度域本身)2.包类型序号包类型标识1普通数据包0x002回应包0x013.源序列号根据通讯需要产生的序列号(标识号).4.目的序列号应答或确认的源包序列号(标识号).（非应答或非确认时目的序列号为0）5.数据数据包体(XML格式).组成：数据内容1数据内容格式如下： 139876656661111111111 2009-3-21 16:07:35.567 . 备注： 回应包为数据内容为空的数据包，用于表明对方已经收到此数据包3.1.1 短信服务和客户端的通信协议 01xxx3.1.1.1 客户端连上短信服务程序后定时发送心跳包01001类型：01001方向：客户端-短信服务程序应答：是确认：方式：TCP描述：当客户端连上短信服务程序后需要定时发送心跳包，数据内容为空数据： 序号字段名类型为空描述示例：3.1.1.2 客户端请求发送短信01002类型：01002方向：客户端-短信服务程序应答：是确认：01003方式：TCP描述：当客户端需要发送短信的时候，请求短信服务程序发送短信数据：序号字段名类型为空描述1OtherPhoneNostring否接收短信号码2SMSContentString是短信内容示例： 1398766566611111111113.1.1.3 短信服务程序确认发送结果01003类型：01003方向：短信服务程序-客户端应答：是确认：方式：TCP描述：短信服务程序执行完发送短信命令后，回复发送结果数据：序号字段名类型为空描述1.ResultCodeint否结果码；0：成功；0：异常代码；2.OtherPhoneNostring否接收短信号码3.SMSContentString是短信内容4.SendStartTimeString否发送开始时间 格式：2009-3-21 16:07:35.5675.SendEndTimeString否发送结束时间 格式：2009-3-21 16:07:35.567示例： 1398766566611111111113.1.1.4 短信服务程序收到短信后发送接收内容给客户端01004类型：01004方向：短信服务程序-客户端应答：是确认：方式：TCP描述：由省中心数据中心根据集团下发的测试点收集命令查询并返回给集团中心测试点结果数据：序号字段名类型为空描述1.LocalPhoneNostring否短信发送号码2.OtherPhoneNoString否短信接收号码3.RecvTimeString否接收到短信的时间 格式：2009-3-21 16:07:35.5674.SMSContentString否短信内容示例： 1398766566613987665666 2009-3-21 16:07:35.56711111111113.2 系统结构图 System Architecture Diagram 3.3 子模块设计 Sub-module1) 服务管理模块控制短信服务程序的所有逻辑，1 系统初始化，及配置读取与更新2 对短信模块收到的短信，通过网络模块进行转发到注册到本服务的客户端3 对网络包中的发送短信请求进行处理，并通过短信模块进行发送4 管理注册到本服务的所有客户端状态图：none时序图：none2) 短信收发模块 完成短信的编码解码工作，并通过串口进行短信发送状态图：none时序图: none3) Net模块 网络模块，短信服务与其他系统的网络通讯在此模块中实现。主要包括 接收数据包，发送数据包，解析数据包，打包数据包。网络模块是作为tcp服务起动的，监听2701 端口状态图：none时序图：none4) 单片机控制模块主要用于对模块的开关机操作状态图：none时序图：none5) adapter 层 Adapter 层是一个适配层，主要有类型的定义和c+库的封装和一些工具函数的封装。实现跨平台 状态图:none时序图: none3.4 模块工作机制 None4 接口设计 Interface Design 具体接口函数见SmsServer 工程代码 5 总体数据结构设计 /* Other Error base from 9000 . 9999 */输出信息输出形式含义处理方法5.1 系统维护设计 System Maintain Design说明为了系统维护的方便而在程序内部设计中增加的一些专门用于系统的检查与维护的检测点和专用模块。如debug 信息，错误记录，关机记录等模块。可从如下方面介绍：a, 内容描述； b, 资源需求；c, 设计流程This section describes the special designs, if any, for the purpose to make maintaining of the system easier or more convenient. These designs include some probes (trace/assert) and/or special modules (trace module), which is used to inspect and maintain the system.6 单元测试用例 Unit Test Case 根据需求文档，列出各个功能的单元测试用例，可以