简介在西门子WinCC人机界面系统中利用VBS脚本读取和操作变量是自动化项目开发中非常实用的技能。这份文档以docx格式系统讲解如何借助HMIRuntime.Tags对象读取变量当前值并配合可直接套用的代码示例演示变量自增、写回操作以及针对二进制变量的置位、复位、取反等方法。数学运算部分覆盖加法、减法和Power幂运算等常见需求同时针对大量变量场景给出批量读取、统一计算和整体写入的优化写法可有效提升脚本执行效率。内容兼顾经典WinCC与博途WinCC Professional V16环境便于不同版本用户参考也能作为理解变量对象、脚本动作触发机制的基础教程。资源共1个文件压缩包约489KB内容精炼、结构清晰适合组态工程师、PLC调试人员和自动化学习者作为日常开发与排错时的随身笔记。目前已有2413人学习下载较具人气值得收藏。1. 打开WinCC脚本这扇门从读变量到算数据之间还隔着一个函数调用做WinCC组态半年以上的工程师基本都会遇到同一个坎画面上变量已经建好、PLC通信也通了但现场需要的不是显示一个原始值而是把这个值换算成工程量、再做一次限幅判断、满足条件后输出给另一个变量。这时候最顺手的工具就是WinCC的脚本。WinCC脚本C脚本和VBS脚本能直接读取运行数据库里的变量也能做逻辑判断和数学计算然后把结果写回变量或触发一个画面动作。这篇笔记我按自己的使用习惯把读变量逻辑运算数学运算三个环节拆开讲每段都给可直接抄的代码和参数说明最后把我在现场踩过的几个坑一并列出来。适合刚接手WinCC项目、准备用全局脚本或C动作处理数据的工程师也适合被脚本写好了但运行没反应这类问题卡住的人。读完后你能自己写一段从读原始值、做工程换算、加互锁判断、写回目标变量的完整动作并知道在项目里怎么排查脚本不生效的问题。2. 读取变量的函数体系C脚本与VBS脚本的口径差别WinCC里读变量不是只有一种写法。常用的两条路一是全局脚本编辑器里的C脚本用GetTag开头的那一簇函数二是VBS脚本通过HMIRuntime.Tags访问变量。两条路都能读能写但参数类型、返回值、适用场景有明显差别选错路子会在后期维护时非常别扭。2.1 C脚本读变量GetTag函数族怎么选、怎么用C脚本读变量的核心函数是GetTag前缀的系列函数比如GetTagBit、GetTagByte、GetTagWord、GetTagDWord、GetTagFloat、GetTagDouble。函数名的后半段不是随便写的它决定了你从变量里拿出来的数据类型。WinCC里变量的数据类型如果和你用的GetTag函数不匹配脚本不会报编译错误但拿到的值可能被截断或变成一个很大的错误数这是最常见的脚本没写错但不正常的原因之一。下面是一段最基础的读取动作写在全局脚本编辑器的动作Action里触发器设置为10秒周期执行#include apdefap.h void OnTimer10s() { // 读取一个32位浮点型的外部变量变量类型对应WinCC里的浮点数32位IEEE 754 double rawValue GetTagDouble(PLC_DATA_TankLevel); // 读取一个二进制变量对应WinCC里的二进制变量 BOOL isAlarm GetTagBit(PLC_DATA_AlarmActive); // 如果液位超过80且没有报警标志则把一个内部变量置1 if (rawValue 80.0 !isAlarm) { SetTagBit(Tank_HighLevel_Flag, TRUE); } }这段代码里有两类函数GetTagDouble负责把变量值取出来SetTagBit负责把计算结果写回去。参数都是变量名字符串变量名要和WinCC变量管理里的一字不差建议直接从变量管理里复制不要手敲避免下划线或大小写不一致。需要注意WinCC的C脚本不是标准C它在ANSI-C基础上做了封装函数名大小写敏感TRUE/FALSE是大写的BOOL值不是小写的true/false。GetTagDouble和GetTagFloat的区别是精度。PLC里如果组态的是32位浮点REALGetTagFloat就够用如果你在WinCC里组态了浮点数64位IEEE 754那必须用GetTagDouble。混用的后果是用GetTagFloat去读64位变量高精度部分直接丢而且不报错。2.2 VBS脚本来读HMIRuntime.Tags的另一种写法C脚本功能强但对不常写代码的工程师来说VBS的语法更接近自然语言调试也更直观。VBS读变量用的是HMIRuntime.Tags(变量名).Read或者直接取.Value属性。写一段同样的逻辑Dim rawValue Dim isAlarm Dim tagRef 读取一个浮点变量Read方法返回的是Variant类型 Set tagRef HMIRuntime.Tags(PLC_DATA_TankLevel) rawValue tagRef.Read 读取二进制变量 Set tagRef HMIRuntime.Tags(PLC_DATA_AlarmActive) isAlarm tagRef.Read 逻辑判断并写回 If rawValue 80 And Not isAlarm Then HMIRuntime.Tags(Tank_HighLevel_Flag).Write True End IfVBS里Read方法返回的是Variant它可以自动容纳不同类型的值这一点比C脚本省心。但省心的另一面是Variant在比较运算时会做隐式类型转换如果变量值本身是字符串格式某些通信驱动会传字符串你拿它和80这个数字比较VBS会尝试转成数字转不了会抛类型不匹配的运行时错误。所以VBS读取后最好先明确转换一次CDbl(rawValue)或者CInt(rawValue)再参与运算。C脚本和VBS的选择原则我的经验是如果只是简单读写加一个条件判断VBS更快如果要做循环、数组操作、复杂数学计算C脚本更稳因为C脚本对类型控制更严格不容易出现线上隐性转换问题。一个项目里尽量不要混用两种脚本语言维护时看脚本要不停切换语法习惯非常痛苦。2.3 内部变量、外部变量和跨画面访问的读取差异WinCC的变量分内部变量和外部变量。外部变量连PLC或OPC服务器读的是过程值内部变量存在WinCC运行数据库里一般做中间计算或画面间传值。脚本读取两者的函数写法完全一样但有一个容易被忽略的差异外部变量在PLC没有建立连接时会读取失败C脚本GetTag系列函数返回0或一个无效值VBS的Read方法会抛异常。所以在读外部变量前最好先检查连接状态。用C脚本可以通过GetTagConnectState函数判断// 检查外部变量对应的连接是否建立返回TRUE才允许后续读取 if (GetTagConnectState(PLC_DATA_TankLevel) TRUE) { double rawValue GetTagDouble(PLC_DATA_TankLevel); SetTagDouble(MEMO_DisplayValue, rawValue); } else { // 连接断开时把显示值置为-9999方便画面上做故障显示 SetTagDouble(MEMO_DisplayValue, -9999.0); }跨画面访问变量的场景也值得提一下。WinCC的画面脚本里可以用画面窗口的ScreenItems来访问其他画面的对象属性但那是对象级访问不是变量级。如果只是想在画面A的脚本里读画面B关联的同一个变量直接用变量名读就行变量是全局的不需要经过画面。很多人不知道这点绕了一大圈去用ScreenItems反而增加了脚本和画面的耦合画面窗口一改名脚本就崩。我的习惯是画面之间传值一律通过内部变量画面脚本只操作自己画面里的对象属性变量读到后放内部变量里别的画面再读这个内部变量这样层次清楚。3. 逻辑运算怎么写才不翻车条件判断、互锁与触发器配合逻辑运算是WinCC脚本里用得最频繁的功能但也是最容易在看起来没问题的代码里藏雷的部分。C脚本里的逻辑运算符号是标准C的写法优先级、短路求值都要按C语言的规则来VBS则用And、Or、Not这些英文单词。两种语言混用的人经常会在这里栽跟头。3.1 C脚本里的逻辑运算优先级和返回值别猜C脚本支持的关系运算符有、!、、、、逻辑运算符有逻辑与、||逻辑或、!逻辑非。一段典型的多条件判断// 设备启动条件无急停 且 模式选择在自动 且 压力在允许范围 BOOL bEStop GetTagBit(SYS_EStop); BOOL bModeAuto GetTagBit(SYS_ModeAuto); double dPressure GetTagDouble(PLC_DATA_Pressure); if (!bEStop bModeAuto (dPressure 0.5 dPressure 6.5)) { SetTagBit(DEV_Start_Command, TRUE); }这里有三个容易踩的细节。第一个是和||的短路求值如果bEStop是TRUE!bEStop就是FALSE整个与运算结果直接是FALSE后面的GetTagDouble根本不会执行。这在性能上是好事但如果后面函数有副作用就得注意不过一般不建议在条件表达式里写有副作用的函数。第二个是括号的使用我习惯把每个独立条件都加上括号因为C语言的优先级里高于如果你写成dPressure 0.5 dPressure 6.5实际是先算dPressure 6.5再算0.5 (dPressure 6.5)0.5是非零值转为TRUE结果碰巧也对但可读性很差改条件时容易出错。第三个是逻辑运算的返回值C脚本里逻辑表达式返回int类型TRUE是1FALSE是0而GetTagBit返回的是BOOL类型赋值给int或比较时会有隐式转换一般不影响结果但如果你把一个int值直接SetTagBit写回非零值都会写成1这点和PLC里的BOOL不太一样。3.2 VBS脚本的False/True与C脚本的0/1一处常见混乱VBS里的逻辑运算返回值是True/False和C的1/0不一样。更麻烦的是VBS里任何非零值都被视为True脚本判断条件时按这个规则走但如果你把VBS的True写回WinCC的二进制变量WinCC内部存的可能是1也可能是-1取决于变量类型。看这段代码Dim result Dim valueA Dim valueB valueA HMIRuntime.Tags(PLC_DATA_ValueA).Read valueB HMIRuntime.Tags(PLC_DATA_ValueB).Read VBS的逻辑与运算返回True或False result (valueA 50) And (valueB 100) 直接写回二进制变量 HMIRuntime.Tags(MEMO_CompareResult).Write result如果MEMO_CompareResult是二进制变量Write True通常没问题。但如果这个变量被下游的C脚本读取并与1比较你要知道VBS的True在内核里存的确实是1False是0这一点C脚本里可以直接用 1去比较。另一个常见混乱是C脚本里写if (x 1)是把1赋值给x然后判断x是否非零永远为TRUE而VBS里if (x 1)才是比较。这个差异直接导致为什么我的C脚本条件永远成立这种排查半天最后发现少写一个的情况。我见过不止一个项目里把VBS的习惯带进C脚本条件直接从恒真开始画面上按钮按了没反应或者一直有输出。3.3 用逻辑运算实现设备互锁与报警优先级判断逻辑运算在项目里最有价值的场景是互锁和报警优先级。比如一个泵的前端有高位报警、后端有压力超高还要考虑手动自动模式的差异。用C脚本写一个完整动作// 设备互锁逻辑泵启动的充要条件 // 输入变量全部为外部变量输出为内部变量供画面指示灯引用 BOOL bManual GetTagBit(MODE_Manual); BOOL bAuto GetTagBit(MODE_Auto); BOOL bHighLevel GetTagBit(TANK_HighLevel); BOOL bPressureHigh GetTagBit(TANK_PressureHigh); BOOL bMotorFault GetTagBit(MOTOR_Fault); BOOL bLocalCtrl GetTagBit(MODE_LocalControl); // 互锁规则本地控制时脚本不干预远程自动或手动模式时检查安全条件 // 优先级急停 本地控制 安全联锁 操作指令 if (bLocalCtrl) { // 本地控制优先脚本只做监视不输出启停命令 SetTagBit(PUMP_StartCommand, FALSE); } else if (!bManual !bAuto) { // 既不在手动也不在自动视为模式未就绪禁止启动 SetTagBit(PUMP_StartCommand, FALSE); } else if (bHighLevel || bPressureHigh || bMotorFault) { // 任何联锁条件触发立即撤销启动命令 SetTagBit(PUMP_StartCommand, FALSE); } else { // 联锁无条件满足允许启动实际启停由操作员按钮或上位机指令控制 BOOL bStartButton GetTagBit(PB_StartPressed); SetTagBit(PUMP_StartCommand, bStartButton); }这段代码体现了几条重要原则。第一个是优先级结构用else if串起来越靠前的条件优先级越高急停和本地模式永远最先判断。第二个是输出赋值而不是输出动作脚本只在周期执行里根据输入状态刷新输出变量的值而不是在脚本里直接调用PLC的启动命令这样即使脚本崩溃输出的最终状态也是安全的。第三个是每个分支都显式赋值FALSE避免上一个周期置位了这个周期某个条件不满足但没走到else分支导致输出保持的锁存问题。这种组合逻辑刷新的写法比事件触发置位安全得多是PLC的SFC或者梯形图里常见的习惯移植到WinCC脚本里同样适用。4. 数学运算实战工程量换算、累加、均值与干扰过滤数学运算是WinCC脚本的另一大用途。现场传感器输出4-20mAPLC读回来的是一个0-27648或0-4095的整数要显示成0-100.0的液位百分比必须做一次线性换算。这类换算可以在PLC里做但在项目后期往往因为PLC程序冻结、不便下装而挪到WinCC脚本里来做这时候脚本的数学运算能力就非常关键。4.1 基础数学函数与类型转换先统一数据类型再动手C脚本支持标准C的大部分数学库函数比如pow、sqrt、fabs、ceil、floor、sin、cos等。用之前要确认包含了math.h头文件其实WinCC的C脚本默认环境里大部分常用函数已经可用但保险起见还是在脚本开头加上#include apdefap.h #include math.h void OnTimer10s() { // 原始值来自PLC0~27648对应4~20mA int iRaw GetTagWord(PLC_DATA_LevelRaw); // 显式转换为double再参与运算避免整数除法丢精度 double dRaw (double)iRaw; // 工程量线性换算量程0到100.0 double dPercent dRaw / 27648.0 * 100.0; // 保留一位小数用floor实现而不是直接强转int避免负数截断问题 dPercent floor(dPercent * 10.0 0.5) / 10.0; SetTagDouble(MEMO_LevelPercent, dPercent); }类型转换是这里最容易出问题的地方。iRaw / 27648结果是整数除法如果iRaw是10001000/27648是0再乘100还是0你的显示值会一直是0。所以必须先转成double再除。另一个坑是负数假设温度变送器量程是-40到150度原始值可能是负数直接(int)dPercent会把-12.6截断为-12而不是-13所以保留小数用floor(x 0.5)而不是强转int。这段代码的注释里我写了两条类型转换规则实际项目里这两条能帮你躲掉大半的数据异常。4.2 一个完整的工程量百分比换算示例把上面零散的函数串成一个完整动作顺便演示怎么用中间变量和比例参数。很多项目的量程是变化的换一台量程不同的传感器就要改脚本这非常麻烦。我一般把量程上限和下限做成WinCC内部变量在画面上留输入框给调试人员改脚本里直接引用变量值#include apdefap.h #include math.h void OnTimer10s() { // 量程参数从内部变量读取调试时可以直接在画面上修改不用改脚本 double dRangeMin GetTagDouble(P_LevelRangeMin); double dRangeMax GetTagDouble(P_LevelRangeMax); double dRawMax GetTagDouble(P_LevelRawMax); // 传感器满量程对应的原始值 // 读原始值 int iRaw GetTagWord(PLC_DATA_LevelRaw); double dRaw (double)iRaw; // 数值上限保护防止原始值超过量程导致百分比超过100 if (dRaw dRawMax) dRaw dRawMax; if (dRaw 0.0) dRaw 0.0; // 线性化百分比 (当前原始值 / 最大原始值) * (量程上限 - 量程下限) 量程下限 double dPercent (dRaw / dRawMax) * (dRangeMax - dRangeMin) dRangeMin; // 数据异常时输出-9999作为标记画面上用显示颜色区分 if (dRawMax 0.0) { SetTagDouble(MEMO_LevelPercent, -9999.0); } else { SetTagDouble(MEMO_LevelPercent, dPercent); } }参数说明dRangeMin、dRangeMax是仪表量程比如液位计是0和10米dRawMax是模拟量模块的满量程原始值S7-300系列常用27648S7-1200/1500常用27648或32767具体看硬件配置。我把dRawMax也做成变量而不是写死在代码里是因为换模块或者改硬件配置后只需要在画面上改一个值不需要打开全局脚本重新编译。这个习惯在维护期能省很多事现场调试的人不一定懂脚本但你给他留了可改的变量他就不用来找你。4.3 在循环动作里做累加和均值脚本别卡死CPU均值滤波是现场常用的做法比如对液位信号做10秒平均值防止波动造成显示跳动。实现思路是定时器触发动作每次把当前值累加到累加变量计数器加1达到N次后计算均值并输出然后清零重新累加。C脚本可以这么写#include apdefap.h // 全局静态变量动作被周期触发时保留上一次的值 static double dSum 0.0; static int iCount 0; void OnTimer1s() { double dValue GetTagDouble(PLC_DATA_Level); // 数值异常时跳过本次采样 if (dValue -9000.0 || dValue 100000.0) { return; } dSum dValue; iCount; if (iCount 10) { double dAvg dSum / iCount; SetTagDouble(MEMO_LevelAvg, dAvg); // 计算标准差判断信号稳定性超过阈值时置一个标志供画面报警 dSum 0.0; iCount 0; } }这段代码里的static变量是关键C脚本的动作之间执行是相互独立的进程调用static可以保证变量在多次触发之间保留值。但要注意static变量是进程级的如果在WinCC项目里跑多个相同动作副本每个副本的static是独立的。触发器在全局脚本里创建一个1秒周期的动作然后在动作里做10次采样平均等于10秒输出一个新均值。真正的性能坑在于如果你把这种累加逻辑放在画面上某个对象的事件动作里而这个画面对象被多个画面实例化每次打开画面都会起一个动作副本static会清零均值永远算不对而且事件触发的频率不受控可能1秒触发几十次CPU占用直接拉高。所以我强烈建议这类周期性计算逻辑放在全局脚本编辑器里不要放在画面里。放在全局脚本里还有一个好处是统一管理排查问题时打开一个地方就能看到所有后台计算不用一个画面一个画面翻。5. 避坑与常见问题排查脚本未结束、握手错误、变量找不到WinCC脚本的开发体验和VS Code写Python完全不一样报错提示简陋、运行期异常不会弹窗、变量类型不匹配不告诉你。下面几条是我在项目里反复遇到的坑写出来帮你少走弯路。5.1 WinCC脚本语句未结束多半是分号和引号的锅WinCC的C脚本编辑器对语句结束很敏感每条完整语句必须以分号结尾。但大多数人遇到语句未结束不是漏了分号而是字符串里的引号配对问题。比如你写GetTagDouble(PLC_DATA_Level)如果变量名里混入了全角引号或中文双引号编译器会认为字符串没有闭合报语句未结束。另一个隐蔽来源是长表达式换行时上一行末尾没有运算符直接回车换行。C语言允许在运算符处换行但不允许在变量名中间断行。WinCC的编辑器在某些情况下不会自动插入续行符导致编译器把两行当成两条语句第一条未结束。解决思路很简单写完后先用编辑器的语法检查按钮有编译脚本或检查功能它会定位到出错行然后逐段注释法——把代码块注释掉一半再编译能快速缩小问题范围。此外WinCC的C脚本编辑器对中文字符支持不友好注释里尽量用英文或不要在变量名字符串里混中文我见过因为变量名里一个全角空格导致的未结束报错肉眼根本看不出来。5.2 脚本读不到变量值先从连接和变量前缀查起运行期脚本不报错但读到的值永远是0这比编译错误更头疼。排查顺序我总结成一句话先查连接、再查变量名、最后查类型。连接状态通过变量管理的通道诊断可以看如果通道显示连接中断外部变量读出来是0是正常的不是脚本问题。变量名是这个阶段的高频雷区如果你的项目里存在多个相同名字的变量比如两个PLC各有一个DB1WinCC里变量名分别为PLC1_DB1_Level和PLC2_DB1_Level复制粘贴时极容易串。更隐蔽的是变量前缀问题——WinCC变量管理里可以给变量组加前缀脚本里引用时要不要带前缀要看版本。有一个笨但有效的办法在脚本里临时加一段调试代码把读到的值用SetTagDouble写到一个画面上的显示变量运行后看画面值以此判断是读取失败还是后续计算错误。5.3 画面里写了动作但看不到效果触发器的坑很多人在画面对象的鼠标点击事件里写了动作运行时点击没反应第一反应是脚本写错了其实很多时候是触发条件没满足。WinCC画面对象的触发器分几类事件触发器鼠标按下、鼠标释放、对象更新等和变量触发器变量值变化时触发。如果你在对象的全局动作里写脚本但设了变量触发器且变量从没变过动作永远不执行。另一种情况是对象的输入/输出域用I/O域类型你没勾选操作权限或者属性里勾了只读鼠标点击根本不会触发事件。排查方法先在对象事件里加一个SetTagBit(DBG_Test, !GetTagBit(DBG_Test))这种最简单的翻转如果翻转成功说明事件链路通问题在脚本逻辑如果翻转没反应检查对象属性是否允许操作、是否有别的画面元素盖在上面。WinCC的画面层级有时候会挡住鼠标事件比如你放了一个透明矩形在按钮上矩形拦截了鼠标点击按钮事件永远触发不了。这个我实际遇到过两次画面上看不出什么异样但点击就是没反应最后把透明矩形删掉就好。5.4 数据类型隐式转换整数除法和浮点除法差一截这个坑在4.1里提过一次但因为它太常见值得单独列出来。WinCC的C脚本里int/int结果是int小数点直接丢弃不会四舍五入。比如GetTagWord读出的27648除以100结果是276如果你以为能得到276.48后面再做什么计算都会偏差。解决方式很简单先把其中一个操作数转成浮点27648.0 / 100就可以得到276.48。但要注意不是所有情况下都要转浮点。CPU占用敏感的循环动作里浮点除法比整数除法慢如果只是做个计数或者时间戳换算整数运算就够了不要无脑全部转成double。我在项目里的习惯是参与显示的、参与比较的、参与PID计算的都用double单纯的计数器、标志位、时间戳用int既不丢精度也省CPU。还有一点WinCC的C脚本里GetTagWord返回的是unsigned short类型范围0-65535如果PLC传来的值超过这个范围比如32位计数器要换成GetTagDWord否则溢出后值会回绕表现是数据跳到负数或突然变成大数。6. 把常用脚本封装成动作和全局函数二次开发的正路脚本写多了以后你会发现很多逻辑是重复的比如工程量换算、报警延迟确认、均值滤波。每次新建画面都复制粘贴一遍一方面代码冗长另一方面改一个参数要好几个画面一起改漏改一个就出问题。我的做法是把这些逻辑封装成全局脚本里的函数动作和画面事件都只做参数传递和调用。WinCC的全局脚本编辑器里可以新建函数函数有入参和返回值。比如把工程量换算封装成函数#include apdefap.h #include math.h // 模拟量归一化函数把原始值换算成工程量百分比 double ConvertRawToPercent(int iRaw, int iRawMax, double dRangeMin, double dRangeMax) { if (iRawMax 0) return -9999.0; double dRaw (double)iRaw; if (dRaw iRawMax) dRaw iRawMax; if (dRaw 0) dRaw 0; return (dRaw / iRawMax) * (dRangeMax - dRangeMin) dRangeMin; }然后在C动作里直接调用#include apdefap.h void OnTimer10s() { int iRaw GetTagWord(PLC_DATA_LevelRaw); double dResult ConvertRawToPercent(iRaw, 27648, 0.0, 100.0); SetTagDouble(MEMO_LevelPercent, dResult); }函数的复用价值在项目中期开始体现。现场换了一批不同量程的传感器你只需要在调用处改量程参数或者在画面上把这些参数做成变量连脚本都不用动。另一个值得封装的是报警延迟确认逻辑信号超过阈值持续N秒才确认报警避免瞬时干扰误报。这个逻辑用状态机思想写维护两个static变量记录初值和计时开始时间每个周期调用函数刷新。做这类封装时注意函数内部不要直接读写画面对象函数只负责输入输出变量画面耦合全部留在动作里这样函数在任何画面、任何动作里都能复用。我最后的习惯是把项目里所有脚本的调用关系画成一张简陋的思维导图存在项目文件夹里类似Timer1s - ConvertRawToPercent - MEMO_LevelPercent。这不算什么先进方法但在接手维护两三年后的Old项目时这张图能让我十分钟找回所有脚本逻辑的脉络不至于面对十几段脚本发懵。上面这些代码在WinCC V7.x和V8.x的全局脚本环境里都能跑通版本差异主要出现在画面编辑器里VBS和C动作的创建入口位置函数名和语法是稳定的。希望这些从项目里滚出来的经验能帮到你少踩几个我当年踩过的坑。本文还有配套的精品资源点击获取
