跳到正文
CSV-DI-AI实践录· ZzzBin·· 9 天前AI 评分45

使用博图Test Suite样式指南对OB、FB、FC、Global DB、Instance DB五类PLC程序做代码审核

使用博图Test Suite完成5类PLC程序的代码审核

AI 导读

西门子TIA Portal Test Suite的样式指南模块可对OB、FB、FC、Global DB、Instance DB五类PLC程序对象建立规则集并批量静态审核,违规结果显示在“测试结果”标签页并自动生成日志至Common Data\Logs目录。

正文

药厂自动化系统里,PLC 代码是工艺控制的底座。一个命名混乱、缺版本标识、作用域不清的程序块,到了验证阶段就得反复返工,审计时还说不清楚谁改了什么。

西门子 TIA Portal Test Suite 的样式指南(Style guide)模块,说白了就是给 PLC 代码做静态审核。这篇拆解 OB、FB、FC、Global DB、Instance DB 五类程序对象怎么设计规则集(Rule Set),把编码规范从"靠人盯"变成自动跑。


一、Style guide 能审什么

样式指南让你创建规则集,每个规则集里放若干条规则,对项目中的 PLC 对象做批量校验。能审的对象:

函数块(FB)

函数(FC)

组织块(OB)

全局数据块 / 背景数据块的变量(Global DB / Instance DB)

PLC 变量

用户自定义数据类型(UDT)

跑完之后,违规结果在巡视窗口的"测试结果"标签页里显示同时自动生成日志到项目树的 Common Data\\Logs 目录。每条违规都能点"转至"直接跳到出错位置。

合规角度:GAMP 5 里命名规范属于"配置标准"文档。把 Style guide 规则集和配置标准挂上钩,变更控制和定期复审就有客观证据了。

二、规则集编辑器长什么样

打开规则集编辑器,工具栏上有这些按钮:

插入规则 / 添加规则

展开 / 折叠所有行

导出 / 导入所有规则

运行规则集

范围(Scope)下拉列表:以勾选树视图的形式显示要执行规则集的块

每一行规则可以配:名称、规则类型、对象类型、规则目标、类别、启用复选框、注释。


三、5种规则类型

规则类型

干什么用

典型场景

大小写格式(Casing)

大小写规范

FB/FC 用 PascalCase,常量用全大写

名称包含(Name Contains)

名称里有没有某字符

安全信号必须含 _Safe,临时变量禁止含空格

元数据(Metadata)

元数据检查

Author、Version、Comment 填没填

名称长度(Name Length)

名称长度限制

防止变量名太长 HMI 上显示不全

前缀后缀(Prefix Suffix)

前缀/后缀规范

DB 块以 DB_ 开,状态变量以 _Sts 结尾

大小写格式的三种模式

全大写格式:所有字符大写,首字符必须是字母

Camel 大小写:首字符小写。大写字符前至少得有一个小写字母,大写字母后面跟小写,非字母后面也跟小写

Pascal 大小写:首字符大写。大写字母后面跟小写,非字母后面跟大写

违规条件两个选项:"已设置"(Is set)和"未设置"(Is not set)。


四、对象选择器(Object Selector)

每种规则类型能选哪些对象,这是精确投放规则的关键。大小写格式、名称包含、名称长度、前缀后缀这四种规则适用的对象范围一致:

CodeBlock(FB/FC/OB)、CodeBlock.Function、CodeBlock.FunctionBlock、CodeBlock.Interface(In/Out/InOut/Static/Temp/Constant)、CodeBlock.OrganisationBlock、GlobalDataBlock、GlobalDataBlock.Static、InstanceDataBlock、PLCDataType、PLCDataType.Member、PLCTagTable、PLCTagTable.Tags、PLCTagTable.Constants

元数据规则的对象范围基本相同,但少了 PLCTagTable 和 PLCTagTable.Constants。

从 V18 起,组织块、函数和函数块各有单独的对象选择器。

五、5类对象的审核策略

1. OB 组织块

OB 是程序执行的入口,审核重点放在名前缀和元数据上:

前缀后缀 + 大小写格式:统一前缀,比如循环 OB 用 OB_Cycle_,启动 OB 用 OB_Startup_,中断 OB 用 OB_Interrupt_,统一 Pascal 大小写

名称长度:别太长,诊断缓冲区里显示不全就麻烦了

元数据:Author、Version、Comment 必须填,追溯修改人和版本时用得上

对象选择器选 CodeBlock.OrganisationBlock

示例规则:

规则1:OB 名称必须以 ”OB_” 开头(前缀后缀 / Is set)规则2:OB 名称长度 ≤ 30(名称长度)规则3:Author 不得为空(元数据)

2. FB 功能块

FB 带背景 DB,是代码复用的核心:

大小写格式:FB 名用 Pascal 大小写,比如 FbMotorControl

前缀后缀:FB 名以 Fb 开头,输入变量以 _Cmd 结尾,输出变量以 _Sts 结尾,内部状态以 _State 结尾

名称包含:安全相关 FB 名必须含 _Safe

对象选择器选 CodeBlock.FunctionBlock 和 CodeBlock.Interface.Input/Output/InOut/Static/Temp/Constant

附加属性可以限定只对 Array、Struct、Block instance 成员生效

3. FC 函数

FC 没有记忆,是可复用的逻辑块:

大小写格式:Pascal 或 Camel,全项目统一就行

前缀后缀:FC 名以 Fc 开头,返回值量以 _Ret 结尾

名称长度:接口参数名简洁点,Temp 区变量别太长

对象选择器选 CodeBlock.Function 和 CodeBlock.Interface.Input/Output/InOut/Temp/Constant

FC 没有 Static 区,别选错成

4. Global DB 全局数据块

Global DB 跨块共享数据,是数据完整性高风险区:

前缀后缀:必须以 DB_ 开头,比如 DB_ProcessParams

大小写格式:DB 名用 Pascal 大小写,Static 成员用 Camel 或按项目标准

名称包含:工艺关键参数建议含 _PV(过程值)或 _SP(设定值)

对象选择器选 GlobalDataBlock 和 GlobalDataBlock.Static

元数据:Version 必须填,变更追踪靠它

5. Instance DB 背景数据块

Instance DB 和 FB 绑定,通常系统自动生成,但命名还是要管:

前缀后缀:Instance DB 名和对应 FB 名保持一致,以 _DB 结尾,比如 FbMotorControl_DB

名称包含:禁止含非法字符

对象选择器选 InstanceDataBlock

元数据:Author 和 Comment 填上,说明对应 FB 干什么用的


六、附加属性:按程序特征精细过滤

附加属性让你在规则上加条件,只有满足条件时才校验。三种条件:

成员类型(Member type):Array / Struct / Block instance / Array of Block instances。适用对象选择器是 CodeBlock.Interface(In/Out/InOut/Static/Temp)、GlobalDataBlock.Static、PLCDataType.Member。其他对象选择器的规则会被忽略。

举个例子,对 Array 类型,data、beltConveyors 是对的,datas、beltConveyor 是错的。对 Block Instance,Inst_data、inst_beltConveyors 是对的,dataInstance、beltConveyors_instance 是错的。

数据类型(Data type):二进制数、整数、浮点数等,可以设成任何数据类型值来识别超限错误。

块类型(Block type):只有块类型符合条件时规则才生效。设成"库类型"的话,只验证库块规则。比如附加属性设成"值为库类型的块类型",可以识别名称长度小于 8 个字母的错误,或者以 LExample 开头的名称。


七、用 Scope 把规则集绑定到具体程序

规则集编辑器工具栏上的范围(Scope)下拉框,用来选规则在哪个 PLC 和哪些块上跑。操作就四步:

打开 Rule Set 编辑器

点工具栏范围下拉框

在 Scope selector 窗口里勾选目标 PLC 和程序块

规则只对勾选的对象生效

这一步是"基于程序创建编码规范检查"的核心。不是全项目一刀切,而是程序、装置、单元精准投放。


八、测试结果与日志

执行规则集后,违规信息在巡视窗口的"测试结果"标签页显示。每条违规能点"转至"跳到出错位置。结果自动存成日志文件,放在 Common Data\\Logs 目录下。每个规则集一个单独日志文件,子文件夹和子组里的规则集也一样。

系统块文件夹下的系统生成对象和只读对象不会被执行,不用管它们。


九、附加功能

样式指南还支持三个功能:

模板副本——把规则集传到别的项目。存在项目库里只能项目内用,存在全局库里可以跨项目。

导入/导出——规则集可以批量导入导出。

Multiuser Engineering——多用户工程环境下可以修改和执行规则集。不同本地会话间复制/粘贴规则集时会标"红色"。所选范围在目标视图不可用时,"检入"或"刷新"会把范围设成默认(项目选择)。


十、实操清单

装好 STEP 7 Professional V20 + TIA Portal Test Suite Advanced V20

在项目树 项目 > Test Suite > 样式指南 下双击"添加规则集"

命名规则集,按装置/单元命名,比如 RuleSet_LineA_FB

设置范围,勾选目标 PLC 和程序块

为 OB/FB/FC/Global DB/Instance DB 分别添加规则

用对象选择器精确选对象类型,避免误报

必要时加附加属性(成员类型/数据类型/块类型)进一步过滤

点工具栏"运行"执行规则集

在测试结果里查看违规,点"转至"定位修改

把 Common Data\\Logs 里的日志归档,当验证证据


十一、踩坑记录

  1. 范围遗漏——只勾了 PLC 没勾具体块,规则没跑。逐层展开勾选。

  2. 对象选择器选错——比如对 FC 选了 CodeBlock.Interface.Static,规则直接被忽略。

  3. 命名冲突——不同装置命名标准不同,别一个 Rule Set 塞所有规则,按装置拆开。

  4. 名称特殊字符——规则集名最多 125 个 Unicode 字符,< > : " / \\ | ? * 和空格不能用。


十二、小结

Style guide 把团队约定的编码规范变成可重复执行的检查。对制药行业来说,这一步是 CSV 验证的前置活动,也是数据完整性 ALCOA+ 原则里"可追溯"的具体落地方式。

下一篇进应用测试(Application Test),看怎么对这 5 类对象写真正的单元测试用例,以及测试集(Test Set)功能怎么帮你管用例执行顺序。

来源:CSV-DI-AI实践录 · mp.weixin.qq.com