GB/T 26805.4-2011 工业控制计算机系统 软件 第4部分：工程化文档规范

ICS25．040．40

N18

囝园

中华人民共和国国家标准

26805．4—2011

GB／T

工业控制计算机系统软件

第4部分：工程化文档规范

Industrialcontrol

computersystem—Software—

Partdocument

4：Engineeringspecification

2011-07-29发布

丰瞀粥紫瓣訾幞瞥鐾发布中国国家标准化管理委员会徼1”

26805．4—2011

GB／T

目次

前言…………

I范围………………·……

2规范性引用文件………·

3术语和定义……………-

4文档规范………………·

附录A(规范性附录)可行性研究报告的编写格式……

附录B(规范性附录)软件项目开发计划书的编写提示

附录C(规范性附录)软件需求规格说明书的编写提示

附录D(规范性附录)数据需求说明书的编写提示……

附录E(规范性附录)软件概要设计说明书的编写提示

附录F(规范性附录)软件详细设计说明书的编写提示

附录G(规范性附录)数据库设计说明书的编写提示…

附录H(规范性附录)软件模块规格说明书的编写提示

附录I(规范性附录)软件质量保证计划的编写提示…

附录J(规范性附录)软件配置管理计划的编写提示…

附录K(规范性附录)用户手册的编写提示……………

附录I。(规范性附录)操作手册的编写提示……………

附录M(规范性附录)程序维护手册的编写提示………

附录N(规范性附录)测试计划的编写提示……………

附录O(规范性附录)测试分析报告的编写提示………

附录P(规范性附录)安装实施过程的编写提示………Ⅲ●●，●耵如北“媚鸲引碍踮船叭鸥％盯∞n

表1各阶段的质量记录………·

表2项目质量保证活动日程表一

表3配置项命名规则表………

表4配置项和配置基线列表…

表5项目配置管理活动的日程表毖毖孙孙盯

26805．4—2011

GB／T

刖昂

GB／T

26805(<工业控制计算机系统软件》分为以下几部分：

——第l部分：评价体系；

——第2部分：测试方法；

——第3部分：文档管理指南；

——第4部分：工程化文档规范；

——第5部分：用户软件文档。

本部分是GB／T26805的第4部分。

本部分的附录A、附录B、附录c、附录D、附录E、附录F、附录G、附录H、附录I、附录J、附录K、附

录L、附录M、附录N、附录0和附录P均为规范性附录。

本部分由中国机械工业联合会提出。

本部分由全国工业过程测量和控制标准化技术委员会(sAc／Tc124)归口。

本部分负责起草单位：深圳市研祥软件技术有限公司。

本部分参加起草单位：北京研华兴业电子科技有限公司、西南大学、中国计算机学会工业控制计算

机专业委员会。

本部分主要起草人：陈志列、刘志永。

本部分参加起草人：刘学东、刘永池、杨颂华、刘枫、张为群、吕静、杨盂飞。

Ⅲ

26805．4—2011

GB／T

工业控制计算机系统软件

第4部分：工程化文档规范

1范围

GB／T26805的本部分规定了工业控制软件项目，在其生命周期的各个阶段所产生的主要软件文

档的内容、格式及编制要求，以便作为软件项目的开发、评审、使用与维护的基准。

本部分适用于工业控制软件及其修订版本的技术文档的编制。

2规范性引用文件

下列文件中的条款通过GB／T26805的本部分的引用而成为本部分的条款。凡是注日期的引用文

件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分，然而，鼓励根据本部分达成

协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本

部分。

GB／T7714—2005文后参考文献著录规则(ISO690：1987，NEQ)

8567

GB／T2006计算机软件文档编制规范

1

GB／T1457--2006信息技术软件工程术语

26805．32011

GB／T工业控制计算机系统软件第3部分：文档管理指南

3术语和定义

l

GB／T1457--2006确立的以及下列术语和定义适用于GB／T26805的本部分。

3．1

系统system

除有特殊说明外，是指软件系统。

3．2

敏感部位sensitiveposition

系统或某一部分对某些因素易于感受的性能的部分或部位。

3．3

敏感度sensitiveness

系统或某一部分对某些因素易于感受的性能。

3．4

condition

敏感条件sensitive

系统或某一部分对某些因素易于感受的性能的条件。

3．5

document

工程化文档engineering

工业控制软件项目的生命周期中产生的文档。

4文档规范

4．1可行性研究报告

4．1．1总则

可行性研究报告要对工业控制对象作概要的描述．根据需求和实现环境把对软件开发项目在一定

26805．4—2011

GB／T

工业、技术、经济和社会条件下实现的可行性研究结果写成文档，为管理部门决定本开发项目的进行提

供依据。可行性研究报告见GB／T8567--2006中的7．1部分。

可行性研究报告的编写示例见附录A。

4．1．2可行性研究报告的内容

4．1．2．1概述

4．1．2．1．1编写目的

对工业控制对象作概要的描述，根据需求和实现环境把对软件开发项目在一定工业、技术、经济和

社会条件下实现的可行性研究结果写成文档．为管理部门决定本开发项目的进行提供依据。

4．1．2．1．2背景

包括：

a)待开发的软件系统的名称；

b)提出者和交办单位；

c)承办单位和承办人员；

d)用户。

4．1．2．1．3参考资料

771

按照GB／T4--2005格式要求，列出本文档中引用到的参考资料，包括资料的编号、作者、标题、

来源、出版单位、日期等。

4．1．2．1．4术语与缩略语

列出本文档中专用的术语、定义或缩略语。

4．1．2．2可行性研究的前提

4．1．2．2．1概述

说明开发项目进行可行性研究的前提，如需求、目标、假定、限制、进行方法和评价准则。

4．1．2．2．2需求

根据工业控制对象和用户的要求说明对软件开发的基本需求，如：

a)功能，如数据采集、调节控制、图形显示、组态功能等；

b)性能，如控制精度、响应时间、实时性要求、可靠性、灵活性等；

c)输出．如控制量、开关量、报告、文件或数据，对每项输出要说明其特征，如用途、产生频率、类型

以及接口；

d)输入，说明来自工业控制对象和操作者的各种输入，包括数据的来源、类型、数量、数据的组织

以及提供的频率；

e)用图表的方式表示出最基本的数据流程和处理流程，并扼要说明；

f)在安全与保密方面的要求；

g)同本系统相连接的其他系统；

h)完成期限。

4．1．2．2．3目标

说明建议开发软件的主要开发目标，如：

a)处理速度的提高；

b)控制精度的提高；

c)调节品质的改善；

d)提高工作效率和减轻劳动强度；

e)提高经济效益(提高产品质量．降低能源消耗等)；

f)提高生产自动化程度。

9

GB／T26805．4—2011

4．1．2．2．4条件、假定和限制

说明开发工作中作出的假定和所受到的限制，如：

a)整个系统的运行寿命；

b)经费、投资方面的来源和限制；

c)硬件、软件、运行环境和开发环境方面的条件和限制；

d)法律和政策方面的限制。

4．1．2．2．5可行性研究的方法

说明可行性研究的基本方法和评价准则，如调查、加权、确定模型、建立基准点或仿真等。

4．1．2．2．6评价尺度

说明对系统进行评价时的主要尺度，如费用多少、各项功能的优先次序、可靠性的地位、实时性的考

虑等。

4．1．2．3现有系统的分析

4．1．2．3．1定义

现有系统是指当前实际使用的系统，这个系统可能是计算机系统，也可能是一个机械系统甚至是一

个人工系统。

分析现有系统的目的是为了进一步阐明开发新系统或修改现有系统的必要性。

4．1．2．3．2处理流程和数据流程

说明现有系统的基本的处理流程和数据流程。

4．1．2．3．3工作负荷

列出现有系统所承担的工作及工作量。

4．1．2．3．4费用开支

列出由于运行现有系统所引起的费用支出，如人力、设备、空间、支持性服务、材料等项开支以及开

支总额。

4．1．2．3．5局限性

列出现存系统的各种主要局限性，如处理时间不能满足需要、响应时间不及时、数据存储能力不足、

处理功能不够等。

4．1．2．4建议的系统

4．1．2．4．1概述

说明建议系统的目标和要求将如何被满足。

4．1．2．4．2说明

概括地说明所建议系统，说明要求将如何得到满足，说明所使用的基本方法及理论根据。

4．1．2．4．3处理流程和数据流程

如用户的操作规程、源数据的处理、系统失效的后果及恢复的处理办法等。

4．1．2．4．4改进之处

根据主要开发目标，逐项说明所建议系统相对于现存系统具有的改进。

4．1．2．4．5影响

说明在建立所建议系统时，预期将带来的影响，包括：

a)设备的影响。说明新提出的设备要求，对现有设备的修改。

b)对软件的影响。说明对现有应用软件和支持软件所作的修改和补充。

c)对系统运行过程的影响。如用户的操作规范、源数据的处理、系统失效的后果及恢复的处理办

法等。

4．1．2．4．6局限性

说明建议的系统尚存在的局限性以及这些问题未能消除的原因。

3

26805．4—2011

GB／T

4．1．2．4．7其他可选择的系统

说明曾研究过的各种可选择的系统，包括需开发的和可从国内外直接购买的，若没有可供选择的系

统方案，则要加以说明。

4．1．2．4．8技术条件方面的可行性

说明技术条件方面的可行性，如：

a)在当前的限制条件下．该系统的目标能否达到；

b)利用现有的技术．该系统的功能能否实现；

c)对开发人员的数量和质量的要求能否满足；

d)在规定的期限内本系统的开发能否完成。

4．1．2．5投资及效益分析

4．1．2．5．1支出

说明建议系统需要的费用。

4．1．2．5．2基本建设投资

包括采购、开发和安装下列各项所需费用，如：

a)计算机及外围设备；

b)数据通讯设备；

c)支持软件；

d)其他。

4．1．2．5．3经常性支出

经常性支出包括：

a)人员工资；

b)管理费用；

c)设备租金折旧费用；

d)其他。

4．1．2．5．4效益

说明所建议系统能带来的效益。

4．1．2．5．5技术效益

技术效益包括：

a)关键技术或新技术的使用与突破，技术的难度分析；

b)系统的技术水平与分析。

4．1．2．5．6经济效益

经济效益包括：

a)因生产能力的提高，使产量增加；

b)因系统精度的提高，使产品质量得到提高，消耗降低；

c)自动化程度的增强和工作效率的提高，使生产周期缩短，消耗减少；

d)可靠性安全性加强，减少或避免事故及其所带来的损失。

4．1．2．5．7社会效益

社会效益包括：

a)系统的灵活性(包括可扩展性和可移植性)分析；

b)推广价值．应用面及其所产生的效益。

4．1．2．6结论

根据上述分析，对所提出的软件开发项目必须作出是否可行的结论。结论可以是下列之一：

a)可以立即开始进行；

4

11

GB／T26805．4—20

b)需推迟至某些条件(如经费投资、人力技术等)具备之后才能开始进行；

c)须对开发目标进行某些修改后才能进行；

d)不能或没有必要进行(如没有实用价值、技术上不成熟、投资不合算)。

4．2软件项目开发计划书

4．2．1出处

85672006中的7．2。

软件项目开发计划书见GB／T

4．2．2总则

软件项目开发计划书是把项目开发过程中各项工作任务的负责人员、开发进度、经费预算、硬软件

资源条件等问题所作的安排用文档的方式记载下来，以便依本计划开展和检查项目开发工作，保证项目

开发正常进行。

软件项目开发计划书的编写示例见附录B。

4．2．3软件项目开发计划书的内容

4．2．3．1概述

4．2．3．1．1编写目的

编写本计划的目的是把在×X××(项目名称)项目开发过程中各项工作任务的负责人员、开发进

度、经费预算、硬软件资源条件等问题所作的安排用文档的方式记载下来，以便依本计划开展和检查项

目开发工作，保证项目开发正常进行。

4．2．3．1．2背景

包括：

a)提出者与交办单位；

b)提出经过；

c)承办单位与承办人员；

d)软件名称；

e)用户。

4．2．3．1．3参考资料

按照GB／T77142005格式要求．列出本文档中引用到的参考资料，包括资料的编号、作者、标题、

来源、出版单位、日期等。

4．2．3．1．4术语和缩写词

列出本文档所用的专业术语、定义和缩写词。

4．2．3．2项目任务概要

4．2．3．2．1前提

说明开发项目进行可行性研究的前提，如需求、目标、假定、限制、进行方法和评价准则。

4．2．3．2．2工作内容

简要说明在本项目开发过程中须进行的各项主要工作。合理划分阶段．说明各阶段的主要任务和

功能。

4．2．3．2．3主要人员

简要说明参加本项目工作的主要人员(开发人员、管理人员、测试人员、用户等)。包括人数和他们

的技术水平。

4．2．3．2．4产品

包括以下几个方面：

a)程序。列出向用户移交的程序清单和数据库文件清单及存储介质．并引用有关文档扼要说明

其作用和功能。

b)文档。列出需移交给用户的每种文档的名称及内容要点。

5

1

26805．4—201

GB／T

c)服务。列出需向用户提供的各项服务，如培训、安装、维护和运行支持，应逐项规定开始日期、

所提供支持的级别和服务的期限。

d)非移交的产品。列出开发集体应向本单位交出但不必向用户移交的产品(文件甚至某些程

序)。

4．2．3．2．5验收标准

对于上述这些应交出的产品和服务．逐项说明或引用资料说明验收标准。

4．2．3．2，6完成项目的最迟期限

指明项目完成的最迟期限。

4．2．3．2．7项目批准

指项目的批准者和批准日期。

4．2．3．3实施总计划

4．2．3．3．1工作任务分解

对项目开发中需要完成的各项工作，从需求分析、概要设计、详细设计、编码、测试、安装、验收及各

种文档编制等要按层次进行分解，并指明每项任务的负责人和主要参加人员。

4．2．3．3．2接口人员

说明负责接口工作的人员及他们的职责，包括：

a)负责本项目同用户的接口人员；

b)负责本项目同本单位各管理机构，如合同计划管理部门、财务部门、质量管理部门等的接口

人员；

c)负责本项目同各分合同负责单位的接口人员等。

4．2．3．3．3进度

对于需求分析、设计、编码实现、测试、移交、培训和安装等工作，给出每项工作任务的预定开始日

期，完成日期及所需资源，规定各项工作任务完成的先后顺序以及表征每项任务完成的进度表。

4．2．3．3．4预算

逐项列出本开发项目所需要的劳务(包括人员的数量和时间)以及经费的预算(包括工资、差旅费、

办公费、机时费、资料费、通讯设备和专用设备的租金等)和来源。

4．2．3．3．5关键问题

逐项列出能够影响整个项目成败的关键问题、技术难点和风险，指出这些问题对项目的影响。如：

技术难点、可靠性措施、现场维护等。

4．2．3．4支持条件

4．2．3．4．1概述

说明为支持项目的开发所需要的各种条件和设施。

4．2，3．4．2计算机系统支持

逐项列出所需计算机系统支持，包括计算机、输入输出设备、模拟器、编译、汇编、操作系统、数据管

理程序包、数据存储能力及测试支持能力等。逐项给出有关到货El期、使用时间的要求。

4．2．3．4．3用户支持

应该逐项列出由用户承担的工作和完成日期，包括由用户提供的条件及日期。

4．2．3．4．4其他单位的支持

应该逐项列出由其他分合同承包者承担的工作和完成的时间，包括由他们提供的条件和日期。

4．2．3．5专题计划要点

说明本项目开发中需制订的各个专题计划要点，如：

a)分合同计划；

b)培训计划；

6

26805．4—2011

GB／T

c)质量保证计划；

d)配置管理计划；

e)系统安装计划。

4．3软件需求规格说明书

4．3．1出处

8567

软件需求规格说明书见GB／T2006中的7．1l。

4．3．2总则

软件需求规格说明书是为项目的开发提供如下基础和依据：

a)软件总体要求，作为用户和软件开发人员之间相互了解的基础；

h)功能和性能要求，作为软件人员进行软件总体设计和编码的信息和基础；

c)软件综合测试的依据。

软件需求规格说明书的编写示例见附录c。

4．3．3软件需求规格说明书的内容

4．3．3．1概述

4．3．3．1．1编写目的

编写本说明书的目的在于为××××(项目名称)项目的开发提供如下基础和依据：

a)软件总体要求，作为用户和软件开发人员之间相互了解的基础；

b)功能和性能要求，作为软件人员进行软件总体设计和编码的信息和基础；

c)软件综合测试的依据。

4．3．3．1．2参考资料

按照GB／T7714—2005格式要求，列出本文档中引用到的下述参考资料．包括资料的编号、作者、

标题、来源、出版单位、日期：

a)项目申请书；

b)本项目的重要文件，如正式协议等；

c)本文档中引用的技术文档；

d)要用到的标准和规范，如文档编制规范、程序设计约定、其他标准规范(程序编制语言)，必要

时可列出硬件手册及支持软件的文档等。

4．3．3．1．3术语及缩写词

把文档中专用的名词术语、定义、缩写词列成清单。

4．3．3．2软件概要

4．3．3．2．1概要说明

简要说明软件开发的目的，范围及其与外界环境的相互联系，定性和定量地简述待开发软件的主要

性能要求和应用目标。

4．3．3．2．2系统组成

可以用方框图来表示软件系统的主要组成，相互联系和外部接口。

4．3．3．2．3用户特点

简要说明生产过程的工艺流程、控制操作方法、现场条件．还有操作人员的技术水平及本系统的使

用频度。

4．3．3．2．4假设和约束

说明影响软件开发和运行的约束．描述影响系统能力的限制。如操作环境、运行环境、经费限制、开

发期限等。

26805．4—201

GB／T

4．3．3．3功能要求

4．3．3．3．1概述

分项详细描述软件系统的功能要求．主要包含以下部分。

4．3．3．3．2数据采集

说明采样信号的类型(模拟量、数字量)、采集对象数量、输入处理要求、上下限极限值、报警要求、存

储要求、采样周期、量程范围、单位换算及输入处理方法(平均、滤波、解码等)等。

4．3．3．3．3调节控制

说明控制类型(连续控制、顺序控制等)、控制回路数、控制方式(P1D控制、串级控制等)、参数整定

及失控处理等。

4．3．3．3．4画面显示

说明画面种类(总体画面、回路画面、趋势显示等)、数据项目和数据数量、存储介质、数据保留时间

及显示方式要求等。

4．3．3．3．5组态功能

说明组态的目的和内容、组态工作方法、输入要求及输出画面要求等。

4．3．3．4性能要求

4．3．3．4．1概述

详细描述软件系统的性能要求。

4．3．3．4．2具体性能要求

a)定量地描述软件的具体性能要求，主要的具体性能要求如下：精度。详细描述系统的精度要

求，如：

1)数据的精度要求，如数据的输入精度(A／D)12位；

2)数字计算的精度要求，如尾数有效位l5位，阶码有效位7位。

b)时间特性。详细说明系统时间特性要求，如：

1)实时性要求。执行计算机系统基本负载的时间。如要求“软件系统在Is之内采集并处

理完接人系统的所有信号，至少包括546个参数，每个参数长度为2个字节”。

2)数据处理时间。

3)输入到输出的响应时间。

4)事件的数量和优先级别。

c)可靠性要求。说明软件系统的可靠性要求及所要求的保证措施。如要求对输入参数的可靠性

判别提供出错测点等。

d)灵活性。说明当需求发生某些变化时系统的适应能力，指出为适应这些变化而要设计的软件

成分或过程。可能的变化有：

1)操作方式上的变化；

2)运行环境的变化；

3)同其他软件接口的变化；

4)精确和实时性要求的变化。

e)人机接口。必须描述操作者与软件系统接1：3的特点。例如．如果系统的用户是由显示终端操

作时．就必须指定以下需求：

1)需求的各种屏幕格式；

2)菜单的格式和内容；

3)功能键的使用规定。

4．3．3．4．3输入一输出

描述输入输出的每个数据元素。对每个数据元素要列出数据类型、格式、度量单位、数值范围和精

8

26805．4—2011

GB／T

度要求。对于输入数据．必须说明时间要求，优先顺序和输入来源。对于输出数据，必须说明时间要求．

优先级别和输出去向。

4．3．3．4．4故障处理要求

列出可能出现的故障。并提出为保证系统性能而要求采取的技术措施。

4．3．3．5环境

4．3．3．5．1设备环境

列出硬件系统所需的设备种类(处理器、存储介质I／o设备，通信网络)、设备数量、型号、特性及连

接方法。

4．3．3．5．2支持软件

列出与开发软件相配合的、运行时的支持软件。对每个支持软件系统和子系统，程序都应提供正确

的名称、版本和文档资料，以及该软件使用的语言、操作系统和数据管理系统。

4．3．3．5．3接口

若软件系统包含若干子系统或与其他系统发生关系，要对其接口进行如下说明：

a)数据传递方式；

b)数据传送的通信介质；

c)数据量格式，度量单位和数据代码；

d)接口类型，如人工的或自动的；

e)接口规程，如通信协议。

4．3．3．6测试纲要

4．3．3．6．1概述

明确软件系统的测试范围．测试要求及测试环境，为制定软件测试计划和审查软件测试报告提供

依据。

4．3．3．6．2测试环境

说明软件系统进行测试运行环境，包括：

a)应交付用户的工业控制计算机硬件配置，如机箱、电源、处理器模板、显示器、键盘／鼠标、通信

接口、存储器的规格和数量等；

b)应交付用户的软件配置，包括操作系统或管理程序、应用程序、诊断程序等及使用方法；

c)满足用户需求的输入／输出配置；

d)系统仿真手段，包括工程系统仿真、工况仿真和工程环境仿真。

4．3．3．6．3软件系统的测试范围和要求

在模拟(仿真)环境中用黑盒法、白盒法对软件系统进行测试．测试项目应覆盖软件需求并分类

列出：

a)需测试的软件系统的功能，如数据采集，调节控制等；

b)需测试的软件系统的性能，如实时性．精度等；

c)需测试的系统逻辑关系，如调用关系，控制关系，制约关系等；

d)需测试的敏感度．包括敏感部位、敏感条件和敏感程度，以及对软件系统以至整个工程系统的

影响；

e)需测试的软件系统的可靠性措施，包括自诊断、自恢复、联锁保护等；

f)需测试的软件系统的健壮性目标，如系统负荷能力的考核、故障承受能力的考核等。

4．4数据需求说明书

4．4．1出处

8567

数据需求说明书见GB／T2006中的7．12。

9

26805．4—2011

GB／T

4．4．2总则

数据需求说明书是提供并定义软件系统必须处理的各种数据元素，并向用户传达数据采集要求。

数据需求说明书的编写示例见附录D。

4．4．3数据需求说明书的内容

4．4．3．1概述

4．4．3．1．1编写目的

编写数据需求说明书的目的是提供并定义××××(系统名称)系统必须处理的各种数据元素，并

向用户传达数据采集要求。

4．4．3．1．2参考资料

按照GlUT7714—2005格式要求，列出本文档中引用到的下述参考资料，包括资料的编号、作者、

标题、来源、出版单位、日期和保密级别：

a)项目申请书；

b)其他技术文档；

c)软件需求说明。

4．4．3．1．3术语和缩写词

把本文档专用的名词术语、定义和缩写词列成一份清单或一个附录。

4．4．3．2数据描述

4．4，3．2．1概述

数据可分为静态数据和动态数据。静态数据称为参数数据，动态数据称为非参数数据，它们都由若

干个数据元素组成。要给出每一数据元素的名称(包括缩写和代码)、定义、度量单位、值域、格式和类型

等有关信息。

4．4．3．2．2静态数据

列出所有作为控制或参考用的静态数据元素。

4．4．3．2．3动态输入数据

列出动态输人数据元素(包括在常规运行中或联机操作中要改变的数据)。

4．4．3．2．4动态输出数据

列出动态输出数据元素(包括在常规运行中或联机操作中要改变的数据)。

4．4．3．2．5内部生成数据

列出用户关心的内部生成的数据，只列出对用户有信息价值的那些数据元素。

4．4．3．2．6数据约束

说明对数据要求的制约。逐条列出对进一步扩大或使用方面的考虑而提出的数据要求的限制(容

量、文卷、记录和数据元的个数的最大值)。必须强调在系统进一步开发中将成为关键性的那些限制。

4．4．3．3数据的采集

4．4．3．3．1概述

描述用户必要的数据采集活动，以便采集该系统使用的数据值。

4．4．3．3．2要求和范围

按数据元的逻辑分组来说明数据采集的要求和范围，指明数据的采集方法，说明数据采集工作的承

担者(用户、开发者)。具体内容包括：

a)数据元素的输人源。说明输入数据元素的来源是操作员，输入站还是某个专门的输入系统；

b)数据输入所用的媒体和硬设备；

c)说明输出数据的接受者；

d)列出输出数据的形式和硬设备。形式如打印输出．显示设备上的字符或图形，均应具体说明；

e)数据值的范围，要给出一个数据元素的合法值的范围；

】O

26805．4—201

GB／T

f)数据值的量纲，数据元素所使用的单位，如在工业控制现场流量所使用的单位常使用t／s和

ITl3／s；

g)测量单位的零点(如压力测量是相对于绝对零压还是大气压力)；

h)换算因子，对必须经模拟转换和数字转换处理的实测量要规定换算因子；

i)扩充因子，指出系统进行扩充时．数据元素项能增加到最大数目的扩充因子。

4．4．3．3．3预处理

对数据的采集和预处理过程提出专门的规定．包括适合应用的数据格式、预定的数据通信媒体和对

输入的时间要求等。对于需经模拟转换或数字转换处理的数据量．要给出转换方法和转换因子等有关

信息。以便软件系统使用这些数据。

4．4．3．3．4数据采集方式和数据传递方式

具体说明数据获取的方式和详细约定，还应包括其时间特性。主要包括：

a)输入方式。说明所有的输入方式，如数据采集卡、串口、网络、光盘、软件模块等。

b)输出方式。说明所有的输出方式，如打印机、显示器、网络、串口、软件模块等。

c)数据库影响。说明数据库的采集和维护对设备、软件、机构、运行和开发环境的影响。还应给

出由于数据库的故障而导致对系统的影响。

4．5软件概要设计说明书

4．5．1总则

软件概要设计说明书要详细定义软件项目的总体功能；交换用户和开发人员之间当前分析的细节；

定义系统的接口及实现这些接口要使用的设备。

软件概要设计说明书的编写示例见附录E。

4．5．2软件概要设计说明书的内容

4．5．2．1概要

4．5．2．1．1编写目的

编写本说明书的目的是：详细定义××××(项目名称)软件的总体功能；交换用户和开发人员之间

当前分析的细节；定义系统的接El及实现这些接口要使用的设备。

4．5．2．1．2参考资料

按照GB／T7714—2005格式要求，列出本文档中引用到的下述参考资料，包括资料的编号、作者、

标题、来源、出版单位、日期：

a)软件需求规格说明书；

b)与概要设计有关的文档资料；

c)其他引用到的文档资料。

4．5．2．1．3术语和缩写词

列出本文档中专用的术语、定义和缩写词。

4．5．2．2需求

4．5．2．2．1概述

本章概述系统的特性和需求，扩充软件需求规格说明书中的信息，给出增加的细节，详尽地指出对

软件需求说明中有关特性和需求作出的变更。

4．5．2．2．2总体描述

对软件系统进行总体描述，用图表示出软件系统的组成，相互联系和外部接口。

4．5．2．2．3功能

定性地描述软件的功能需求。如数据采集、调节控制、画面显示及在线组态等。

4．5．2．2．4性能

定量地描述系统的性能需求。如精度、时间特性、可靠性要求、灵活性及人机接口等。

11

26805．4—20

GB／T

4．5．2．2．5环境

本章对软件需求规格说明书中规定的环境提供补充，反应环境的变化，并对环境作补充分析。如设

备环境、支持软件及接口等。

4．5．2．3总体设计

4．5．2．3．1系统逻辑流程

用图的形式描述系统从输入经处理到输出的逻辑流程，并加以必要的解释。各图表将集中反映出

系统的动态特性、人口和出口，与其他系统或程序的接口，进程的优先级别等。

4．5．2．3．2并发性

如果被控对象是一个并发活动的有机实体，在若干事件同时驱动系统并要求同时响应时，系统是如

何满足并发要求的，必须给予详细描述。

4．5．2．3．3在线性

当系统要求在线组装或在线维护时。系统是如何满足的．必须给予描述。

4．5．2．3．4系统结构

用图表形式说明本系统的结构组成，并说明组成系统的系统元素(子系统、模块、子程序、公用程序

等)的划分和名称。扼要说明每个系统元素的标识符和功能，分层次地给出各元素之间的控制关系。

4．5．2．4系统设计

4．5．2．4．1数据结构设计

数据结构设计主要包括：

a)输入输出数据。描述输入输出的每个数据元素，对每个数据元素要列出名称和标识符、数据类

型、格式、量纲、数值范围和精度要求等。对于输入数据，必须说明时间特性、优先顺序和输入

方式(数据采集卡、串口、网络、光盘、软件模块、键盘、其他]／O设备等)。对于输出数据．必须

说明时间特性、优先级别和输出方式(打印机、显示器、网络、串口、软件模块等)。

b)数据结构。主要包括：

1)系统状态数据结构；

2)系统生成(组态)数据结构；

3)采样数据数据结构；

4)回路参数数据结构；

5)控制数据数据结构；

6)报警数据数据结构；

7)显示数据数据结构；

8)打印数据数据结构；

9)操作台功能键数据数据结构；

10)通信数据数据结构；

11)诊断维护数据数据结构。

4．5．2．4．2流程设计

使用图、表、文的形式描述软件系统的处理流程。说明为实现功能需求，处理流程的设计方法与过

程。主要包括：

a)实时控制管理程序流程设计；

b)数据输人处理流程；

C)控制调节处理流程；

d)数据输出处理流程；

e)时钟中断处理流程；

f)操作台(键盘)输入处理流程；

】2

1

26805．4—201

GB／T

g)画面(总貌画面、模拟表头、回路画面、趋势画面等)处理流程方案；

h)表格生成处理流程；

i)系统生成(在线组态)处理流程；

j)系统维护处理流程，包括诊断、出错处理、恢复等。

4．5．2．4．3算法子程序库(包)

算法子程序库一般包括：模拟量输入、模拟量输出、数据采集、基本P1D、配比PID、算术运算、函数

发生、高低选择、逻辑运算、线性化、补偿等模块。

要说明算法子程序库的功能、种类、数量及数学模型等。

4．5．2．4．4数据库设计

如果软件需求要求采用数据库技术，必须对数据库作如下的说明：

a)概要。包括：

1)标题和标识符；

2)内容摘要；

3)数据结构；

4)存储介质和容量；

5)数据字典及算法；

6)数据库管理系统的基本功能；

7)敏感程度；

8)文件组织，包括文件的名称和标识符，文件性质及备份。

b)数据库的数据元素。包括：

1)名称和标识符，同义名；

2)数据库中的位置；

3)定义；

4)量纲；

5)格式和值域；

6)数据项名、缩写调整和代码，包括用于数据库的规格说明；

7)敏感程度。

4．5．2．5集成测试纲要

4．5．2．5．1概述

对本系统中各程序(子系统)逐个明确集成测试纲要，说明集成测试环境、测试范围和要求，为制定

集成测试计划和审查测试报告提供依据。

4．5．2．5．2子系统1的集成测试纲要

主要包括：

a)集成测试环境。包括：

1)子系统名称；

2)子系统进行集成测试所需的硬件环境；

3)子系统进行集成测试所需的系统软件及接口；

4)与子系统相关的软件子系统或模块。

b)测试范围和要求。包括：

1)需测试的功能和性能指标；

2)需测试的逻辑关系，如调用关系、控制关系、制约关系等；

3)需测试的敏感度，包括敏感部位、敏感条件、敏感程度，以及对被测子系统及其他子系统的

影响；

13

11

GB／I"26805．4—20

4)可靠性、健壮性有关的成分，如诊断措施和诊断信息、联锁保护及其状态、负荷分析和统

计等。

4．5．2．5．3子系统2的集成测试纲要

按照4．5．2．5．2同样格式，说明子系统2到子系统N的集成测试纲要。

4．6软件详细设计说明书

4．6．1总则

软件详细设计说明书要尽可能详细地说明每个程序的设计思想，以利于制作软件模块规格说明书

和编码。

软件详细设计说明书的编写示例见附录F。

4．6．2软件详细设计说明书的内容

4．6．2．1概述

4．6．2．1．1编写目的

编写本说明书的目的是尽可能详细地说明程序的设计思想，以利于制作软件模块规格说明书和

编码。

4．6．2．1．2参考资料

7714

按照GB／T2005格式要求．列出本文档中引用到的下述参考资料，包括资料的编号、作者、

标题、来源、出版单位、日期：

a)软件需求规格说明书；

b)软件概要设计说明书；

c)有关软件详细设计说明书}

d)其他有关文档。

4．6．2．1．3术语和缩写词

列出本文档中的专业术语和缩写词。

4．6．2．2需求

4．6．2．2．1总体描述

对软件系统进行总体描述，用图表示出软件系统的组成、相互联系和外部接El。

4．6．2．2．2功能

定性地描述软件的功能需求。如数据采集、调节控制、画面显示和在线组态等。

4．6．2．2．3性能

定量地描述系统的性能需求。如精度、时间特性、可靠性要求、灵活性和人机接口等。

4．6．2．2．4环境

详细说明系统运行所需的环境。如设备环境、支持软件和接13等。

4．6．2．3程序系统结构

4．6．2．3．1系统逻辑流程

用图的形式描述系统从输人经处理到输出的逻辑流程，并加以必要的解释。各图表将集中反映出

系统的动态特性、人口和出1：3、与其他系统或程序的接I：I、进程的优先级别等。

4．6．2．3．2组织结构

用图表的形式列出软件系统各层模块和程序单元的名称、标识符和它们之间的层次结构、调用关

系、通信方式等。

4．6．2．3．3程序运行过程

说明该程序的装载、启动、停止、恢复和再启动的过程，并说明该程序和操作人员之问的“交互”。

14

26805．4--2011

GB／T

4．6．2．4程序1(名称)设计说明

4．6．2．4．1概述

从本节开始，逐个地描述各个层次中每个程序的设计考虑。

4．6．2．4．2程序描述

对该程序进行简要描述，说明设计本程序的目的、意义，还要说明本程序的特点，如：

a)常驻内存；

b)可重入运行；

c)并发处理。

4．6．2．4．3功能

详细说明该程序具有的功能(可采用IPO图形式)。如：实时管理程序包括任务调度，设备管理．内

存管理，通讯管理等。

4．6．2．4．4性能

详细说明该程序的全部性能要求。如：精度包括转换精度12位．内部运算精度浮点4字节，数据计

算精度0．05％等。

4．6．2．4．5输入

详细描述每个输人的特性。包括名称、标识、数据的类型、格式、量程范围、数值的有效范围、输入的

方式和媒体等。

4．6．2．4．6输出

详细描述每个输出的特性。包括名称、标识、数据的类型、格式、量纲变换、数值的有效范围、输出媒

体、输出图形及符号的说明等。

4．6．2．4．7算法

详细说明本程序所选用的算法、具体的计算公式和计算步骤。

4．6．2．4．8流程

用图表(例如流程图、判定表等)辅以必要的说明来表示本程序的逻辑流程。逻辑流程详细描述程

序的一切处理过程，详细解释程序间转移的测试条件，并注明出错条件及出错处理方法。

4．6．2．4．9接口

说明该程序同其他程序的接口．对每个接1：3都必须说明：

a)接口类型；

b)数据传送说明；

c)数据的输入、输出要求(包括数据内容、顺序、时间性等)；

d)接口规程，包括远程通信的考虑。

4．6．2．4．10存储分配

说明该程序的存储要求和所有限制条件．即：

a)说明并图示内存分配；

b)说明程序所要求的外存类型及限制条件，并指明是永久性的还是暂时性的存储。

4．6．2．4．11注释

说明准备在本程序中安排的注释，如：

a)加在程序首部的注释；

b)加在程序各分枝点的注释；

c)对各变量的功能、范围、缺省条件等所加的注释。

4．6．2．4．12限制

说明本程序运行中所受到的限制条件。

】5

26805．4—2011

GB