自控部编程规范文档.doc

自控部编程规范
一、 规范制定原则
1、 方便控制程序、画面组态的代码的交流和维护。
2、 不影响程序和画面的运行效率，不与标准习惯冲突。
3、 使程序代码美观，阅读更方便。
4、 使程序代码逻辑更清晰、更易于理解。
二、 系统程序编程规范要求
1、 工程项目命名规范：
（1） 命名规范：用项目名称中部分独特的汉语拼音的打头字母来命名，后面加上具体日期的阿拉伯数字，字母字符长度不得大于6，不得与部门以往其他项目重名。
（2） 备份命名规范：每次程序修改或者更新均要求备份存档，存档文件要求以压缩文件Rar或Zip格式保存，字母定义部分与工程项目相同，日期部分为修改或者更新日期。
（3） 注释规范：项目建立或者修改必须要求添加详细注释，注释包括：A：完整的工程项目中文注释。B：开发人员和日期C：开发软件的名称和版本号。
如：天业电石烘干窑PLC项目控制系统程序
工程项目命名：DSHGY20111010
注释：天业电石烘干窑PLC项目控制系统程序（许庆鸿20120101 SETP 7 V5.5）
2、 点位表命名规范：
点位信号名称由编号和后缀英文组成。两者中间用半角“-”(横杠)隔开。
如：2012-AB
（1） 编号命名规范：
（A） 要求以设计院或者其他设计方提供的电气和仪表图纸上的设备编号、仪表位号为依据，定义其编号。
（B） 如项目中没有相关第三方提供的图纸，要首先考虑依据甲方以往的控制程序或者设备、工艺上的结构来定义其编号。
（C） 如（A）（B）中的条件都不具备，我方可自行定义其编号，每个项目要以单体电气设备或单体仪表为单元，以现场工艺流程为顺序，从01开始定义其编号。
（2）后缀英文命名规范：
后缀英文用于区分各类数字量、模拟量信号，加强部门编程命名规范的一致性。构成主要以其信号名称的英文单词打头字母来表示，要求全部用大写字母，最长不要超过四个字符。DI、DO、AI、AO常规信号参照下面规范进行命名（如规范中未确定的信号出现，编程人员可定义名称（定义参考文档：被测变量和仪表功能的字母代号），纳入规范当中，切忌不可与其他信号后缀重名）：
（A） 常规数字量输入信号（DI）的定义规范（我方控制程序相关的资料中注释和缩写均按此规范）：
自动/本地：AL
备妥：PR
运行/停止：RS
运行：RU
停止：ST
打开/关闭：OC
打开：OP
关闭：CL
故障：FT
报警：AM
开运行：ORU
关运行：CRU
正运行：PRU
反运行：ERU
上运行：URU
下运行：DRU
左运行：LRU
右运行：RRU

开限位：OGS
关限位：CGS
正限位：PGS
反限位：EGS
上限位：UGS
下限位：DGS
左限位：LGS
右限位：RGS

开极限：OLT
关极限：CLT
正极限：PLT
反极限：ELT
上极限：ULT
下极限：DLT
左极限：LLT
右极限：RLT
左跑偏：LDN
右跑偏：RDN
流量低：FSL
流量高：FSH
温度低：TSL
温度高：TSH
压力低：PSL
压力高：PSH
压差低：PDSL
压差高：PDSH

（B） 常规数字量输出信号（DO）的定义规范（我方控制程序相关的资料中注释和缩写均按此规范）：
启停：DR
启动：STA
停止：STO
开关：GV
打开：GVO
关闭：GVC
正启动：PDR
反启动：EDR
（C） 常规模拟量输入信号（AI）的定义规范（我方控制程序相关的资料中注释和缩写均按此规范）：
温度：TE
压力：PT
压差：PD
流量：FE
料位：LE
频率：SE
转速：SP
开度：GI
重量：WE
含量：QE
时间：KE
电流：IE
电压：EE
功率：JE
累计：AQ

（D） 常规模拟量输出信号（AO）的定义规范（我方控制程序相关的资料中注释和缩写均按此规范）：
阀门、执行器给定：GC
频率给定：GE
转速给定：GP
（3）点位表注释规范：
点位表各类信号注释里要有信号说明，触点类型、信号电流、电压范围、ON/OFF状态等。详情见工程资料里点位表模板。
3、 程序组态开发规范：
（1）硬件组态规范：

（A） 硬件组态要严格按照订货信息及设计资料顺序组态，每个站点要和设计资料里的控制站定义同样的名称（如不能重命名，则在注释里添加）。
（B） 卡件的符号表定义要遵循点位表的设计原则，每个通道必须定义符号，添加注释。
（2） 程序组态规范：
（A） 建立并使用内部变量、时间块、数据块时，使用系统顺延的默认名称，但必须添加注释，数据块要根据程序结构、数据类型合理分类。
（B） 程序设计时要遵循模块化、结构化的设计思路，严格按照OB（组织块）FB（功能块）FC（功能）SFB（系统功能块）SFC（系统功能）之间的优先级关系和特性，尽量简化结构和代码，切忌程序流程和结构混乱。
（C） 每个程序块、程序段，都必须添加注释（包括创建标识、修改标识），程序如有修改，要及时更新注释当中的信息，确保最新。程序确定下装和备份之前，要检查移除所有临时或无关的注释，以避免在日后的维护工作中产生混乱。
功能块、程序块功能描述只需简述，具体详情在程序段的注释中描述。
创建标识和修改标识由创建或修改人员的姓名加日期组成。如：
    许庆鸿20120101
一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。

（D） C语言及其它高级语言编程时，注释要遵循以下规范，比较复杂的可以每句添加注释。
 在每个程序头必须包含以下注释说明
            /*--------
            // Copyright (C) 2012 汇业信息技术有限公司
            // 版权所有。
            // 程序功能描述：
            // 修改标识：
            // 修改描述：
//-------------------------------------------------------*/

功能块、程序块功能描述只需简述，具体详情在程序段的注释中描述。
创建标识和修改标识由创建或修改人员的姓名加日期组成。如
    许庆鸿20120101
一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。

三、 上位监控画面系统程序编程规范要求
1、 工程项目命名规范：
（1）命名规范：用项目名称中部分独特的汉语拼音的打头字母来命名，后面加上具体日期的阿拉伯数字，字母字符长度不得大于6，不得与部门以往其他项目重名。
（2）备份命名规范：每次程序修改或者更新均要求备份存档，存档文件要求以压缩文件Rar或Zip格式保存，字母定义部分与工程项目相同，日期部分为修改或者更新日期。
（3）注释规范：项目建立或者修改必须要求添加详细注释，注释包括：A：完整的工程项目中文注释。B：开发软件的名称和版本号。
如：天业电石烘干窑PLC项目控制系统程序
工程项目命名：DSHGY20111010
注释：天业电石烘干窑PLC项目上位监控系统（许庆鸿 WINCC6.2RC）
2、 变量表命名规范：
变量名称由编号和后缀英文组成。两者中间用半角“-”(横杠)隔开。
如：2012-AB
（1）编号命名规范：
（A）要求以设计院或者其他设计方提供的电气和仪表图纸上的设备编号、仪表位号为依据，定义其编号。
（B）如项目中没有相关第三方提供的图纸，要首先考虑依据甲方以往的控制程序或者设备、工艺上的结构来定义其编号。
（C）如（A）（B）中的条件都不具备，我方可自行定义其编号，每个项目要以单体电气设备或单体仪表为单元，以现场工艺流程为顺序，从01开始定义其编号。
（2）后缀英文命名规范：
后缀英文用于区分各类数字量、模拟量信号，加强部门编程命名规范的一致性。构成主要以其信号的热控专业要求或名称的英文单词打头字母来表示，要求全部用大写字母，最长不要超过四个字符。DI、DO、AI、AO常规信号参照下面规范进行命名（如规范中未确定的信号出现，编程人员可定义名称（参考文档：被测变量和仪表功能的字母代号），纳入规范当中，切忌不可与其他信号后缀重名）：
（A）常规数字量输入信号（DI）的定义规范（我方上位监控系统的相关的资料中注释和缩写均按此规范）：
自动/本地：AL
备妥：PR
运行/停止：RS
运行：RU
停止：ST
打开/关闭：OC
打开：OP
关闭：CL
故障：FT
报警：AM
开运行：ORU
关运行：CRU
正运行：PRU
反运行：ERU
上运行：URU
下运行：DRU
左运行：LRU
右运行：RRU
开限位：OGS
关限位：CGS
正限位：PGS
反限位：EGS
上限位：UGS
下限位：DGS
左限位：LGS
右限位：RGS
开极限：OLT
关极限：CLT
正极限：PLT
反极限：ELT
上极限：ULT
下极限：DLT
左极限：LLT
右极限：RLT
左跑偏：LDN
右跑偏：RDN
流量低：FSL
流量高：FSH
温度低：TSL
温度高：TSH
压力低：PSL
压力高：PSH
压差低：PDSL
压差高：PDSH

（B）常规数字量输出信号（DO）的定义规范（我方上位监控系统的相关的资料中注释和缩写均按此规范）：
启停：DR
启动：STA
停止：STO
开关：GV
打开：GVO
关闭：GVC
正启动：PDR
反启动：EDR
（C）常规模拟量输入信号（AI）的定义规范（我方上位监控系统的相关的资料中注释和缩写均按此规范）：
温度：TE
压力：PT
压差：PD
流量：FE
料位：LE
频率：SE
转速：SP
开度：GI
重量WE
含量：QE
时间：KE
电流：IE
电压：EE
功率：JE
累计：AQ

（D）常规模拟量输出信号（AO）的定义规范（我方上位监控系统的相关的资料中注释和缩写均按此规范）：
阀门、执行器给定：GC
频率给定：GE
转速给定：GP
3、 上位组态开发规范：
（1） 程序组态规范：
每个程序块、程序段，都必须添加注释（包括创建标识、修改标识），程序如有修改，要及时更新注释当中的信息，确保最新。程序确定下装和备份之前，要检查移除所有临时或无关的注释，以避免在日后的维护工作中产生混乱。
功能块、程序块功能描述只需简述，具体详情在程序段的注释中描述。
创建标识和修改标识由创建或修改人员的姓名加日期组成。如：
    许庆鸿20120101
一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。

C语言及其它高级语言编程时，注释要遵循以下规范，比较复杂的可以每句添加注释。
 在每个程序头必须包含以下注释说明
            /*---------------------------------------------
            // Copyright (C) 2012 汇业信息技术有限公司
            // 版权所有。
            // 程序功能描述：
            // 修改标识：
            // 修改描述：
//-------------------------------------------------------*/

功能块、程序块功能描述只需简述，具体详情在程序段的注释中描述。
创建标识和修改标识由创建或修改人员的姓名加日期组成。如：
    许庆鸿20120101
一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。
（2） 监控画面变色、配色规范要求：
客户有特殊要求的，色彩方案根据客户要求做更改，如无特殊要求的，根据以下配色方案执行：
主画面背景色：灰色（R:129 G:129 B:129）
图案主线条颜色：黑色（R:0 G:0 B:0）
报警状态：红色（R:255 G:0 B:0）
运行状态：绿色（R:0 G:255 B:0）
停止状态：不变色或者白色（R:255 G:255 B:255）
自动、备妥状态：黄色（R:255 G:255 B:0）
手动、本地状态：不变色或白色（R:255 G:255 B:255）

汇业公司自控部
2012-1-5