跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL WHILE — 条件循环

SCL WHILE — 条件循环

条件为真时循环;条件在循环前判断,可能一次都不执行。

控制流 S7-1200/1500 TIA V19 别名:WHILE 循环 / 当型循环

在 TIA 里试一下

通过 TiaLink 把本页示例(FB_While_Demo)作为“外部源”导入你当前打开的 TIA Portal 项目:预检、生成块、编译,并清理外部源。导入后不会自动保存;FB 导入后需要在 OB 里调用。

TiaLink 设置

默认 http://localhost:8080。也可以在本页地址后加 ?tialink= 临时指定。

TiaLink 启动时若设置了 --api-token,这里要填相同的值;只保存在本机浏览器 localStorage,不会上传。

一句话

答案:WHILE 条件 DO ... END_WHILE; 先判断条件再执行循环体;条件一开始为假时循环一次也不执行,条件必须在循环里被改变。

WHILE 先判断条件,条件为真时执行循环体:WHILE #Condition DO ... END_WHILE;。条件一开始为假时一次也不执行;条件必须在循环里被改变,否则会死循环。

最小示例

下面是一个完整块,页面展示的源码就是 TiaLink 导入的同一份源码。页面的场景已在 PLC 云仿真里跑过,输出见“云仿真验证”。

FB_While_Demo FB

最小示例 · 32 行 · 源文件 blocks/FB_While_Demo.scl

查看 FB_While_Demo 的块接口
区块名称类型说明
输入LimitInt
输出SumInt
输出CountInt
临时iInt
blocks/FB_While_Demo.scl
1FUNCTION_BLOCK "FB_While_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Limit : Int := 5;         // 循环上限
6   END_VAR
7 
8   VAR_OUTPUT
9      Sum : Int;                // 累加和
10      Count : Int;              // 实际循环次数
11   END_VAR
12 
13   VAR_TEMP
14      i : Int;                  // 循环变量
15   END_VAR
16 
17BEGIN
18   REGION 初始化
19      #Sum := 0;
20      #Count := 0;
21      #i := 0;
22   END_REGION
23 
24   REGION 条件循环
25      WHILE #i < #Limit DO
26         #i := #i + 1;
27         #Sum := #Sum + #i;
28         #Count := #Count + 1;
29      END_WHILE;
30   END_REGION
31END_FUNCTION_BLOCK
32 

块接口表由源码自动生成;# 前缀表示块内局部变量,实际工程里也可以是全局标签或 DB 变量。

SCL 写法

SCL
1WHILE #i < #Limit DO
2   #i := #i + 1;
3   #Sum := #Sum + #i;
4END_WHILE;

带退出条件:

SCL
1WHILE #Running DO
2   // ...
3   IF #Fault OR #Timeout THEN
4      EXIT;
5   END_IF;
6END_WHILE;

怎么工作

条件 行为
一开始为假 循环体一次也不执行
为真 执行循环体,再回到条件判断
循环体让条件变假 正常退出
条件一直为真 死循环,扫描周期超时
  • 条件在循环体之前判断,所以可能零次执行。
  • 循环体必须改变条件里的变量,或者用 EXIT 退出。
  • CONTINUE 跳过本次剩余语句,直接回到条件判断。
  • 循环次数不确定时用 WHILE;次数固定时优先 FOR。

常用场景

1. 等待某个状态

WHILE NOT #Done DO ... END_WHILE; 处理“直到完成”的逻辑;必须加超时或 EXIT,否则通信/设备异常时会卡死 PLC 扫描。

2. 未知长度的数组处理

数组长度或有效元素个数在运行时才知道,用 WHILE 配合下标和边界判断;注意下标越界。

3. 迭代计算

反复计算直到误差小于阈值;迭代次数要有上限,避免不收敛时死循环。

常见坑

  • 忘记改变条件:WHILE #i < 10 DO 但循环体不改变 #i,会死循环。
  • 条件一开始就假:一次也不执行;需要至少执行一次时用 REPEAT。
  • 没有超时/上限:等待外部状态时一定要有超时或最大次数,否则设备异常会卡死扫描。
  • 在循环里调用耗时指令:扫描周期会变长;大数据量考虑状态机分片。
  • 条件表达式有副作用:不要在条件里调用会改状态的函数;条件只做判断。
  • EXIT 和 CONTINUE 混用:EXIT 退出整个循环,CONTINUE 只跳过本次;确认你要的是哪一个。

和 LAD 的区别

LAD 没有 WHILE 文本循环,通常用跳转/标签或状态机实现;SCL 的 WHILE 更适合“条件满足就继续”的迭代逻辑。两者逻辑可以对应,但 SCL 更容易表达复杂条件。LAD 侧可参考 程序控制指令。

云仿真验证

PLC 云仿真:PASS(3 次扫描)。场景:上限 5 累加 1..5;上限 0 和负数时零次循环。结果来自 PLC 云仿真 的 scl_run_scenario;页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  上限 5 累加 1..5 (1 step(s), 1 scan(s))
PASS  上限 0 和负数时零次循环 (2 step(s), 2 scan(s))
RESULT: ALL PASS (3 scan(s))

云仿真验证语法、结构和逐扫描行为,不等同于 TIA 编译;TIA 状态见下方“验证状态”。

验证状态

项目结果日期证据
构建期语法/结构校验PASS2026-11-02parse + validate
PLC 云仿真PASS(3 scans)2026-11-02scl_run_scenario / scl_validate
TIA 导入编译待实测—TiaLink + TIA Portal(待实测)

“待实测”表示还没有在 TIA Portal 里导入编译,不代表代码有问题;上机前请先在测试项目编译。云仿真在 tia.hubwiz.com/sim 执行,不替代 TIA 编译。

来源与说明

参数、行为和数据类型的核对来源:TIA Portal V19 帮助的 Creating_SCL_programs/Entering_SCL_instructions/Surround_program_code_with_structure_elements.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

WHILE 的专用帮助页在抓取语料中损坏;语法以 TIA V19 的 SCL 结构元素页和实际编译为准。中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

Siemens 文档与截图的版权归 Siemens;本站只引用事实参数,不复制官方描述段落和图片。官方参考:Siemens TIA Portal。

常见问题

WHILE 和 REPEAT 有什么区别?

WHILE 先判断条件,可能一次都不执行;REPEAT 先执行一次,再判断 UNTIL 条件,至少执行一次。

WHILE 条件一开始就是假会怎样?

循环体一次也不执行,直接执行 END_WHILE 后面的代码。需要至少执行一次时用 REPEAT。

WHILE 为什么会死循环?

条件一直为真,或者循环体没有改变条件里的变量。确保循环体最终能让条件变假,必要时用 EXIT 设上限。

← 返回 SCL 指令手册