单板软件概要设计报告.docx
《单板软件概要设计报告.docx》由会员分享，可在线阅读，更多相关《单板软件概要设计报告.docx（14页珍藏版）》请在冰豆网上搜索。
单板软件概要设计报告
深圳市华为技术有限公司
研究管理部文档中心
文档编号
产品版本
密级
产品名称：
共14页
单板软件概要设计报告
（仅供内部使用）
拟制：
日期：
yyyy/mm/dd
审核：
日期：
yyyy/mm/dd
审核：
日期：
yyyy/mm/dd
批准：
日期：
yyyy/mm/dd
深圳市华为技术有限公司
版权所有不得复制
修订记录日期
修订版本
描述
作者
1999/01/30
1.00
初稿完成
作者名
目录
1概述
5
1.1本文档的目的
5
1.2单板软件概述
5
2需求描述
5
2.1系统应用功能需求
5
2.1.1系统应用功能需求1
5
2.1.2系统应用功能需求2
5
2.1.3系统应用功能需求3
5
2.2系统维护功能需求
6
2.2.1系统维护功能需求1
6
2.2.2系统维护功能需求2
6
2.2.3系统维护功能需求3
6
2.3性能需求
6
2.3.1性能需求1
6
2.3.2性能需求2
6
2.3.3性能需求3
6
3设计思想
6
3.1功能设计描述及框图
6
3.2功能实现流程图
6
3.3性能设计思想及实现性能参数的措施
6
4接口协议
6
4.1邮箱协议
6
4.2与主机通讯协议
6
4.3链路层通讯协议
7
4.4内部模块间接口协议
7
5操作系统
7
5.1外购操作系统的名称，厂家和版本号
7
5.2自编操作系统的来源及特点
7
5.3选定该操作系统的依据
7
5.4操作系统调度方法说明
7
6编程协定
7
6.1.CPU类型
7
6.2编程语言，编译器和调试环境的选择和依据
7
6.3.编程规范
7
6.4.物理结构
7
6.4.1ROM空间
7
6.4.2RAM空间
8
6.4.3内部存储区分配图
8
7数据结构
8
7.1常量定义
8
7.2变量定义
8
7.3结构定义
8
7.4全局定义
8
8测试计划
8
8.1单元测试计划
8
8.2集成测试计划
8
8.3静态代码审查计划
8
9其它
8
10附件
8
10.1单板软件概要设计评审表
8
单板软件概要设计报告
关键词：
摘要：
缩略语清单：
对本文所用缩略语进行说明，要求提供每个缩略语的英文全名和中文解释。
参考资料清单：
请在表格中罗列本文档所引用的有关参考文献名称、作者、标题、编号、发布日期和出版单位等基本信息。
参考资料清单
名称
作者
编号
发布日期
查阅地点或渠道
出版单位（若不为本公司发布的文献，请填写此列）
1概述
.1本文档的目的
说明本文档的编写的目的，包含的内容，适合的软件版本。
如为升级文档还要说明升级的原因，主要增加了哪些功能，解决了哪些问题。
.2单板软件概述
简要说明单板软件所属的产品名称，在整个产品中的位置、作用、和其它单板的关系。
说明该单板软件所属的成品板及能够兼容的制成板。
2需求描述
.3系统应用功能需求
逐一列出并说明系统对本软件在应用方面的功能需求。
.1系统应用功能需求1
.2系统应用功能需求2
.3系统应用功能需求3
。
。
。
。
。
。
.4系统维护功能需求
逐一列出并说明系统对本软件在维护方面的功能需求，如版本上报、上电自检、误码统计等，详细内容可参考后附的单板软件概要设计评审表。
.4系统维护功能需求1
.5系统维护功能需求2
.6系统维护功能需求3
。
。
。
。
。
。
.5性能需求
逐一列出并说明系统对本软件在性能方面的需求，所要达到的性能指标参数。
如CPU处理能力，链路的最高速率，误码对软件的影响以及从软件的角度恢复硬件错误的能力等。
.7性能需求1
.8性能需求2
.9性能需求3
。
。
。
。
。
。
3设计思想
.6功能设计描述及框图
详细说明单板软件为实现系统功能需求所采的取设计思想、功能结构。
.7功能实现流程图
画出软件为实现功能结构所做的信息处理、资源调配、进程或任务控制流程，并详细说明之。
.8性能设计思想及实现性能参数的措施
详细说明软件为达到系统的性能需求所采取的各项措施。
4接口协议
.9邮箱协议
如果单板需要通过邮箱与外部通讯，要在这里写清楚邮箱协议文档名称、时间、作者。
.10与主机通讯协议
如果单板要与主机的应用层（非操作系统）通讯，要在这里写清楚通讯协议文档名称、时间、作者。
.11链路层通讯协议
如果单板需要通过数据链路与外部通讯，数据链路如为标准协议要在这里写清楚标准协议的名称、制定组织及颁布时间，数据链路如为公司内部协议要在这里写清楚协议文档的名称、时间和作者。
.12内部模块间接口协议
如果单板软件有内部模块划分，请在这里写详细描述接口协议。
如有专门的协议文档，请写清楚协议文档的名称、时间和作者。
5操作系统
.13外购操作系统的名称，厂家和版本号
如选用外购操作系统，要写明外购操作系统的名称、厂家和版本号。
.14自编操作系统的来源及特点
如选用公司内部自编操作系统应说明操作系统出自哪里，在哪些系统上使用过，是否测试过该操作系统的性能指标。
.15选定该操作系统的依据
说明选择该操作系统的依据，本软件为满足系统的需求对操作系统的需求是什么，所选操作系统的各项性能指标是否能满足系统的要求。
.16操作系统调度方法说明
说明所选用操作系统的调度原理和调度方法并画出它实现调度的结构图或流程图。
6编程协定
.17CPU类型
说明单板的CPU类型，生产厂家和型号
.18编程语言，编译器和调试环境的选择和依据
说明软件采用何种编程语言。
选择哪种编译器和调试器以及选择它们的依据。
.19编程规范
说明软件编程是否依照编程规范，编程规范的名称是什么，出自哪里。
.20物理结构
.10ROM空间
说明内部ROM和外部ROM的地址分配情况。
.11RAM空间
说明外部RAM，内部设备、外部设备的地址分配情况，如果外部设备种存在间接寻址，应对间接寻址访问方法和分配情况进行说明。
.12内部存储区分配图
说明内部存储空间（包括ROM、RAM）的地址分配情况和相关使用特点。
7数据结构
.21常量定义
说明主要常量和常量表的定义，并说明这些常量取当前值的原因。
.22变量定义
说明主要全局变量的定义
.23结构定义
说明主要结构体的定义
.24全局定义
定义所有全局性的参量，如预编译开关，编译前可调的全局常量等。
8测试计划
.25单元测试计划
依据本软件的特点说明是否要做单元测试，如要做单元测试，请在这里说明单元测试计划。
.26集成测试计划
依据本软件的特点说明是否要做集成测试，如要做集成测试，请在这里说明集成测试计划。
.27静态代码审查计划
依据本软件的特点说明是否要做静态代码审查，如要做静态代码审查，请在这里说明静态代码审查计划和审查是依据的编程规范。
9其它
说明其它设计要点
10附件
.28单板软件概要设计评审表
请在概要设计完成前填写下表，在此文档归档前将单板软件概要设计评审报告作为附件一并归档，手签件应扫描成电子件后附在此。
单板软件概要设计评审报告（V1.0）
请软件设计人员和审查人员根据以下内容对提交的概要设计报告进行严格审查。
审查板名：
任务编号：
任务责任人：
任务名称：
[所有评审人签名]
[评审要点]（由开发人员填写，项目经理审核）
拟制：
审核：
单板软件概要设计评审表
（由评审人员或评审小组填写）
1.文档
1）是否做了项目开发的文档计划
是（）
否（）
2）是否完成单板软件设计文档的概要设计阶段的内容
是（）
否（）
3）是否确定了调试记录的格式
是（）
否（）
2.开发设计方面
1）功能方面
是否明确了系统对单板有那些方面的功能要求
是（）
否（）
是否有确定的功能结构来实现这些功能
是（）
否（）
2）性能方面
是否明确了系统对单板有那些方面的性能要求
是（）
否（）
各项性能是否都有明确的性能指标
是（）
否（）
这些性能指标是否采取了有效措施来达到这些性能指标
是（）
否（）
3）是否采用模块化设计
是（）
否（）
4）操作系统
是否采用（或设计）操作系统
是（）
否（）
是否考虑了操作系统的可靠性
是（）
否（）
操作系统的效率是否能满足单板的需求
是（）
否（）
5）协议
是否要完成标准协议功能
是（）
否（）
是否为保证协议的一致性采取了有效措施
是（）
否（）
6）接口方面
是否有外部接口
是（）
否（）
是否完成了外部接口协议的制定
是（）
否（）
是否有内部模块间接口
是（）
否（）
是否完成了模块间接口协议的制定
是（）
否（）
是否要与主机通讯
是（）
否（）
是否完成了与主机通讯协议的制定
是（）
否（）
7）是否完成了全局数据结构的制定
是（）
否（）
8）后续程序编码是否要遵守编程规范
是（）
否（）
9）兼容性方面
是否能兼容所有的硬件版本
是（）
否（）
是否能兼容各种机型
是（）
否（）
是否能兼容主流机型的各种版本
是（）
否（）
10）是否确定了使用的编译工具
是（）
否（）
11）是否确定了使用的调试工具
是（）
否（）
3.维护功能接口方面
1）是否有单板版本上报
是（）
否（）
2）是否有单板上电自检并向主机报自检结果
是（）
否（）
3）运行等是否按要求开工闪动
是（）
否（）
4）是否能及时上报物理链路上的误码、失步
是（）
否（）
5）是否能及时上报单板资源的过载和过载恢复情况
是（）
否（）
6）是否考虑了单板过载时的措施
是（）
否（）
7）是否具备向主机上报CPU占用率的能力
是（）
否（）
8）是否具备对单板处理的各种帧的统计能力
是（）
否（）
9）是否具备在线环回测试能力
是（）
否（）
10）是否具备在线向主机发送调试信息的能力
是（）
否（）
11）出现异常情况时是否能用指示灯来告警
是（）
否（）
12）是否为调试设计了信息打印口
是（）
否（）
4.测试计划方面
1）单元测试
是否准备做单元测试
是（）
否（）
是否要做白盒测试
是（）
否（）
是否要做黑盒测试
是（）
否（）
测试用例是否要包含输入的合理等价和不合理等价值
是（）
否（）
测试用例是否要有合法边缘值和非法边缘值
是（）
否（）
2）集成测试
是否准备做集成测试
是（）
否（）
是否要按功能需求逐项制定测试用例
是（）
否（）
是否要按性能指标逐项制定测试用例
是（）
否（）
3）可测性
是否在设计中为提高软件的可测性采取了有效措施
是（）
否（）
4）要完成标准协议功能的请填写下栏
公司是已有能满足要求的协议测试仪
是（）
否（）
如没有协议测试仪，是否为一致性测试做了充分考虑
是（）
否（）
5）代码审查
是否要做静态代码审查
是（）
否（）
是否为静态代码审查制定了人员计划
是（）
否（）
5.配置管理方面
1）是否考虑了文档和源程序的版本管理
是（）
否（）
2）是否已确定了版本管理工具
是（）
否（）
[评审意见]（由评审人员或评审小组填写）
评审人：
[项目组反馈意见]
任务责任人签字：
时间：
[评审结论]（评审组织人填写）
签字：
时间：
升级会员 