软件文档模板-软件概要设计.docx
(产品名称) 软件概要设计 玉海科技200年 月目次1范围1标识11.1 系统概述1文档概述22 引用文档2文档约定23 概要设计2CSCI 概述23.1.1 CSCI 结构3系统状态和模式33.1.2 容量和时间要求3CSCI设计说明33.1.3 <CSC名称和工程唯一标识号3CSCI 数据43.2 数据结构说明4全局变量说明44 CSCI数据文件4需求可追踪性5(产品名称)软件概要设计PAX. XXX. XXXGD1范围1.1 标识说明:列出本文档的:己批准的标识号;版本号;标题;缩略语;本文档适用的 系统和计算机软件配置项(CSCI),并标识派生该CSCI需求的更高层的规格说明。例 如:标识号:XX软件概要设计文档:XX;版本号:VI;标题:XX软件概要设计文档;缩略语:软件概要设计;本文档适用于XX的主控软件配置项。1.2 系统概述说明:概述本文档所适用的系统和CSCI的用途。非嵌入式软件还应在此说明运行 依赖的软件环境.如果涉及多个芯片或单机,应在此明确软件的驻留方式。例如:XX主要带直接印字报(NBDP)终端等构成,实现数字选呼、遇险呼叫、数字选 呼扫描值班等功能,也可作为备用设备用于常规报务通信。收发信机主控软件主要用于接收数字选呼(HF DSC)终端的频率切换信息,并控制收 发信机内部各单元在正确的频率上做好工作准备。玉海科技1.3 文档概述说明:概述本文档的用途和内容。例如:本文档是收发信机主控软件的概要设计,描述了本CSCI的各模块设计,模块接口和 主要数据。本文档用于指导软件设计师编制主控软件代码,也是软件测试工程师编制测 试说明的依据。2引用文档说明:列出编写本报告时参考的文件(如经核准的计划任务书或合同、上级机关的 批文等)、资料、技术标准。至少应包括软件需求规格说明,排列时按照GB/GJB/企业标准/一般文档的顺序 排列,例如:引用文档见表lo表1引用文档文档号标题武器系统软件开发文档XX需求规格说明文档约定列出本文档使用的其他缩略语、术语和概念等。如无可注明无特殊约定。例如: 无特殊文档约定。3 概要设计. 1 CSC I 概述说明:描述CSCI在系统中的作用。指出CSCI的每个外部接口的用途,可以使用系 统结构图指出该CSCI和系统中其它的CSCI的相互关系.即使和需求说明类似,在此也 必须做出说明。对于外部接口有一定复杂性,又不至于要增加外部接口设计文档的,可 在4.2里面放一个小节说明。如CSCI无外部接口,也可省略.2玉海科技软件提供哪些应用方式,例如:组网有几种形式,可应用到哪些场合和设备中,如 何与别的设备配合以满足用户的要求。>4. 1. 1 CSCI 结构V说明:描述CSCI的内部结构。应指明CSC和其下一级的CSC及其用途,并描述各CSC 之间的相互关系.该关系要指出各CSC到CSC接口的用途,并概述通过接口传送的 数据.本节还应指出所有被合并到CSCI的非开发软件.本节需要详细表达CSCI内部的功能模块划分.并推荐用图来说明.对于接口协议特别简单的,可以在此说明.对于接口协议复杂的,可以用单独文档说 明.一般接口协议,可以在后面以通信接口 CSC形式加以详细说明,通常可从用户接口, 硬件接口和软件接口三方面考虑系统状态和模式说明:指出每个CSCI操作的系统状态和模式以及在此状态和模式下执行的CSCo 通过流程图等形式说明CSCI内部各CSC之间的控制流程和数据流程或消息流.对于一般的单片机程序,对于内部状态和中断等可以在此说明.在VxWorks上工作的软件,建议在此节说明内部的任务划分和相互间的通信方式. 基于Windows工作的软件,建议在此节说明内部的进程/线程划分和相互间的交互>4. 1.3容量和时间要求说明:提供分配给CSC的内存和进程时间以及其它关键资源。即使和需求说明类似, 在此也必须做出说明。对于内存分配有限制,尤其是实时性有特殊要求的,以及一些特殊资源,例如某些特定的 寄存器,端口等资源的使用,需要在此节作出说明.另外如果对性能方面例如系统容量,响应时间等有需要,也可以在此说明。>4.2 CSCI设计说明4. 2. 1 <CSC名称和工程唯一标识号玉海科技3说明:应该分成以下局部描述CSC:1,主要功能;2, CSC设计描述.可使用流程框图等方式对内部流程处理进行描述.如果有下一级CSC,在此描述下一级CSC的划分,以及相互之间的接口关系。通常应考虑 以下内容:a,内部处理模块;b,接口处理。3, CSC设计需求和设计约束.(对有节容量和时间要求的资源限制和相关 性能要求局部作出说明.). 2.1.1 如果有必要划分下一级CSC ,从本小节开始做类似4. 2. 1节描述4 CSCI数据数据结构说明说明:主要的数据结构,类定义描述,用于指导后续编码测试维护等工作全局变量说明说明:主要的全局变量描述,用于指导后续编码测试维护等工作.CSCI数据文件说明:分节对所使用的数据库及使用数据库的方式作详细说明。对使用的配置文件等相关数据文件进行说明.如果物理存储有特殊要求,需要在 此说明。分小节对具体数据文件的用途,大小,访问方法,内部记录的结构和大小作出说明.建议以 图表的方式对涉及的数据项的数据类型,数据表示,大小,单位,值域,精确度等属性进 行说明.或以专门文件说明.玉海科技5 需求可追踪性说明:如果在软件需求和接口需求规格说明里面对CSC/CSU需求有详细描述,在此可以 用图表等方式提供一个全景浏览,将相关工程和CSU/CSC 一一对应,便于以后的需 求控制.如果需求规格说明里面没有作详细描述,可以省略.尽量直接引用需求规格说明的表格。例如:表X数据设计需求跟踪表需求名称标识号本文档章节号转手数据CAP103-A4.2. 1. 1拟制:审核:玉海科技