跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL LIMIT — 限幅

SCL LIMIT — 限幅

把值限制在 MIN/MAX 之间;超出范围时输出边界值。

数学 S7-1200/1500 TIA V19 别名:限幅 / LIMIT / 上下限

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案:#Result := LIMIT(MN := #Min, IN := #Value, MX := #Max) 把值限制在 [MN, MX];低于下限返回下限,高于上限返回上限。

LIMIT 把输入限制在 [MN, MX]:#Result := LIMIT(MN := #Min, IN := #Value, MX := #Max);。低于下限返回下限,高于上限返回上限,区间内原样返回。

参数

参数方向类型存储区说明
MN输入整数 / 浮点 / TIME / DATE / DTI, Q, M, D, L, P下限。
IN输入整数 / 浮点 / TIME / DATE / DTI, Q, M, D, L, P要限幅的输入值。
MX输入整数 / 浮点 / TIME / DATE / DTI, Q, M, D, L, P上限。
Return返回值与 IN 相同的类型—限幅结果:IN < MN 返回 MN,IN > MX 返回 MX,否则返回 IN。

参数表以 TIA Portal V19 帮助为事实核对;S7-1200/1500 有差异时在类型列并列显示。存储区是 TIA 允许的范围,实际可用范围还受块接口和优化属性影响。

最小示例

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

FB_Limit_Demo FB

最小示例 · 19 行 · 源文件 blocks/FB_Limit_Demo.scl

查看 FB_Limit_Demo 的块接口
区块名称类型说明
输入ValueInt
输入MinInt
输入MaxInt
输出ResultInt
blocks/FB_Limit_Demo.scl
1FUNCTION_BLOCK "FB_Limit_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Value : Int := 15;        // 输入值
6      Min : Int := 0;           // 下限
7      Max : Int := 10;          // 上限
8   END_VAR
9 
10   VAR_OUTPUT
11      Result : Int;             // 限幅结果
12   END_VAR
13 
14BEGIN
15   REGION 限幅
16      #Result := LIMIT(MN := #Min, IN := #Value, MX := #Max);
17   END_REGION
18END_FUNCTION_BLOCK
19 

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

SCL 写法

SCL
1#Result := LIMIT(MN := #Min, IN := #Value, MX := #Max);

参数按名字写最稳,顺序是 MN、IN、MX,不是 MIN/MAX/IN。

怎么工作

IN 结果
IN < MN MN
MN ≤ IN ≤ MX IN
IN > MX MX
  • 结果类型跟随 IN;整数、浮点、TIME、DATE、DT 都可以。
  • MN 必须 ≤ MX;区间反了结果不可靠。
  • 限幅不是取整:小数仍然保留;要取整用 ROUND/TRUNC。
  • 限幅不是绝对值:负数不会变正;要用 ABS。

常用场景

1. 模拟量/给定限幅

操作员给定或 PID 输出限制在设备允许范围内;防止超调或非法设定。

2. 传感器范围保护

传感器值可能超量程;先 LIMIT 再做标定/显示,避免下游计算溢出。

3. 数组下标保护

把计算出的下标限制在 0..N-1,再做数组访问;比事后判断更简单。

常见坑

  • 参数顺序写错:是 MN, IN, MX;把上下限写反会导致结果异常。
  • MN > MX:非法区间,结果不可靠;用之前检查。
  • 把 LIMIT 当取整:LIMIT(0, 1.7, 10) 仍是 1.7;取整用 ROUND/TRUNC。
  • 类型不一致:MN/IN/MX 要兼容;混用 Int/Real 可能编译报错。
  • 只限上限不限下限:LIMIT 两端都限;只限一端可以自己写 MIN/MAX。
  • 忽略 NaN:浮点 NaN 比较特殊;传感器故障时要单独处理。

和 LAD 的区别

LAD 的 LIMIT 盒有 MN/IN/MX 和返回值;SCL 里直接写 LIMIT(MN := ..., IN := ..., MX := ...)。语义一样,SCL 更容易和计算式连写。梯形图版本见 Learn-LAD 的 LIMIT 页。

云仿真验证

PLC 云仿真:PASS(3 次扫描)。场景:高于上限、低于下限、区间内。结果来自 PLC 云仿真 的 scl_run_scenario;页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  高于上限、低于下限、区间内 (3 step(s), 3 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 帮助的 Instructions/Instructions/Basic_instructions/SCL/Math_functions/LIMIT__Set_limit_value.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

MN/IN/MX 参数和限幅语义以 TIA Portal V19 帮助为事实核对;中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

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

常见问题

LIMIT 的参数顺序是什么?

MN 是下限,IN 是输入,MX 是上限;不是 MIN/MAX/IN。按名字传参最稳。

MN 大于 MX 会怎样?

区间非法,结果不可靠;TIA 可能报错或返回异常值。用之前确认 MN ≤ MX。

LIMIT 能处理 REAL 吗?

可以,整数、浮点、TIME、DATE、DT 都支持;结果类型跟随 IN。

← 返回 SCL 指令手册