跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL SCALE_X — 缩放到范围

SCL SCALE_X — 缩放到范围

把 0.0~1.0 的浮点数映射到 MIN~MAX；模拟量标定常用。

转换 S7-1200/1500 TIA V19 别名：Scale / 缩放 / 模拟量标定 / SCALE_X_REAL

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案：用 #Result := SCALE_X(MIN := #Min, VALUE := #Value, MAX := #Max) 把 0.0~1.0 映射到 MIN~MAX；VALUE=0.5 时输出中点。

SCALE_X 把 0.01.0 的浮点数映射到 MINMAX：VALUE=0.0 输出 MIN，VALUE=1.0 输出 MAX。模拟量标定通常先 NORM_X 归一化，再 SCALE_X 映射到工程单位。

参数

参数方向类型存储区说明
MIN输入REAL / LREALI, Q, M, D, L, P目标范围的下限，对应 VALUE=0.0。
VALUE输入REAL / LREALI, Q, M, D, L, P要缩放的浮点数，通常先由 NORM_X 归一化到 0.0~1.0。
MAX输入REAL / LREALI, Q, M, D, L, P目标范围的上限，对应 VALUE=1.0。
Return返回值取决于模板（REAL/INT/...）—缩放结果。SCALE_X_REAL 返回 REAL；SCALE_X_INT 等模板返回对应整数类型。

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

最小示例

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

FB_ScaleX_Demo FB

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

查看 FB_ScaleX_Demo 的块接口
区块名称类型说明
输入ValueReal
输入MinReal
输入MaxReal
输出ResultReal
blocks/FB_ScaleX_Demo.scl
1FUNCTION_BLOCK "FB_ScaleX_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Value : Real := 0.5;       // 0.0 .. 1.0
6      Min : Real := 10.0;        // 工程量下限
7      Max : Real := 30.0;        // 工程量上限
8   END_VAR
9 
10   VAR_OUTPUT
11      Result : Real;             // 工程量
12   END_VAR
13 
14BEGIN
15   REGION 缩放到工程量
16      #Result := SCALE_X(MIN := #Min, VALUE := #Value, MAX := #Max);
17   END_REGION
18END_FUNCTION_BLOCK
19

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

SCL 写法

SCL
1#Result := SCALE_X(MIN := #Min, VALUE := #Value, MAX := #Max);

需要明确输出类型时用带后缀的模板：

SCL
1#ResultReal := SCALE_X_REAL(MIN := 0.0, VALUE := #Norm, MAX := 100.0);
2#ResultInt  := SCALE_X_INT(MIN := 0, VALUE := #Norm, MAX := 1000);

怎么工作

公式：

OUT = VALUE * (MAX - MIN) + MIN
VALUE 输出
0.0 MIN
0.5 (MIN + MAX) / 2
1.0 MAX
< 0.0 或 > 1.0 按公式外推；需要限幅就先用 LIMIT 或判断
  • MIN/MAX 可以是负数，也可以是工程量上下限。
  • 输出类型由模板决定；SCALE_X_REAL 返回 REAL，SCALE_X_INT 返回整数。
  • 如果 MIN > MAX，输出方向反转；工程上一般保持 MIN < MAX。

常用场景

1. 模拟量标定

420mA 对应 0100%，先用 NORM_X 把 0~27648 归一化到 0.01.0，再用 SCALE_X 映射到 0.0100.0。中间可以加限幅和滤波。

2. 速度/温度给定

HMI 上的 0~100% 给定，乘以设备最大速度或温度范围；SCALE_X 比手写乘加更直观。

3. PWM/阀门开度

把 PID 输出 0.01.0 映射到阀门 0100% 或 PWM 占空比；注意下游的类型和限幅。

常见坑

  • 把 SCALE_X 当 SCALE 用：SCALE_X 的 VALUE 是 0.01.0；老 SCALE 处理 027648 的整数，参数也不同。
  • VALUE 没有归一化：直接把 0~27648 的整数传给 SCALE_X，结果会大得离谱；先 NORM_X 或自己除以量程。
  • MIN/MAX 顺序反了：MIN > MAX 会得到反向输出；需要反向作用时明确写注释。
  • 输出类型不匹配：SCALE_X 的结果类型跟随模板；赋值给 Int 时用 SCALE_X_INT，否则可能编译报错或隐式转换。
  • 没有限幅：VALUE 超出 0.0~1.0 时按公式外推；传感器故障或超量程时要先限幅。
  • 量程和单位：MIN/MAX 用工程单位，不要混用百分比和实际值。

和 LAD 的区别

LAD 里 SCALE_X 是带 MIN/VALUE/MAX 的盒，输出在左侧；SCL 里是函数调用，结果直接赋给变量。老 SCALE/UNSCALE 在 LAD 里不是所有 CPU 都能导入，SCL 里也建议用 NORM_X + SCALE_X 的新组合。梯形图版本见 Learn-LAD 的 Scale_X 页。

云仿真验证

PLC 云仿真：PASS（3 次扫描）。场景：0.5 映射到 10..30 的中间。结果来自 PLC 云仿真 的 scl_run_scenario；页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  0.5 映射到 10..30 的中间 (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/Conversion_operations/SCALE_X__Scale.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

公式、参数和数据类型模板以 TIA Portal V19 帮助为事实核对；中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

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

常见问题

SCALE_X 和 SCALE 有什么区别？

SCALE_X 是新指令，输入 VALUE 是 0.0~1.0 的浮点数，用 MIN/MAX 指定目标范围；老 SCALE 直接处理 0~27648 的模拟量整数，还带 BIPOLAR 参数。

模拟量输入怎么标定？

先用 NORM_X 把模拟量整数归一化到 0.0~1.0，再用 SCALE_X 映射到工程单位；两步分开，量程和单位更清楚。

SCALE_X 输出是整数还是浮点数？

由模板决定：SCALE_X_REAL 返回 REAL；SCALE_X_INT 等返回对应整数。普通 SCALE_X 的结果类型跟随 VALUE/模板，写代码时尽量显式用 SCALE_X_REAL 或 SCALE_X_INT。

← 返回 SCL 指令手册