跳到主要内容

标准功能块

共 10 个 API(10 个可执行)

本页列出 10 个跨扫描保留状态的定时、计数、边沿检测和锁存功能块。每次调用都按 SCL 语法直接返回主 BOOL 结果;不要调用不存在的 Execute(),也不要读取 .Q、.ET、.CV 或 .QD。

减计数器​

CTD 可执行

IEC 标准功能块 CTD;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL CTD(BOOL CD, INT PV, BOOL LD = FALSE)

参数​

CDBOOL
  • 输入
  • 必填
上升沿减一输入。
PVINT
  • 输入
  • 必填
装载预置值。
LDBOOL
  • 输入
  • 可选
  • 默认 FALSE
电平装载输入。

返回值​

returnBOOL
当前计数值小于等于 0 时返回 TRUE。

行为说明​

  • LD 为 TRUE 时把 PV 装入当前计数值。
  • CD 上升沿使当前计数值减一;持续为 TRUE 时不重复计数。
  • 调用直接返回主布尔结果,不提供 CV 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 CTD 实例。
CTD counter = new CTD();
BOOL countSignal = FALSE;
BOOL load = FALSE;
BOOL empty = counter(CD: countSignal, PV: 10, LD: load);

相关 API​

暂无已核实关系。

加计数器​

CTU 可执行

IEC 标准功能块 CTU;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL CTU(BOOL CU, INT PV, BOOL R = FALSE)

参数​

CUBOOL
  • 输入
  • 必填
上升沿加一输入。
PVINT
  • 输入
  • 必填
预置计数值。
RBOOL
  • 输入
  • 可选
  • 默认 FALSE
电平复位输入。

返回值​

returnBOOL
当前计数值达到 PV 后返回 TRUE。

行为说明​

  • CU 上升沿使当前计数值加一;持续为 TRUE 时不重复计数。
  • R 为 TRUE 时清零当前计数值。
  • 调用直接返回主布尔结果,不提供 CV 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 CTU 实例。
CTU counter = new CTU();
BOOL countSignal = FALSE;
BOOL reset = FALSE;
BOOL reached = counter(CU: countSignal, PV: 10, R: reset);

相关 API​

暂无已核实关系。

加减计数器​

CTUD 可执行

IEC 标准功能块 CTUD;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL CTUD(BOOL CU, BOOL CD, INT PV, BOOL LD = FALSE, BOOL R = FALSE)

参数​

CUBOOL
  • 输入
  • 必填
上升沿加一输入。
CDBOOL
  • 输入
  • 必填
上升沿减一输入。
PVINT
  • 输入
  • 必填
预置值。
LDBOOL
  • 输入
  • 可选
  • 默认 FALSE
电平装载输入。
RBOOL
  • 输入
  • 可选
  • 默认 FALSE
电平复位输入。

返回值​

returnBOOL
当前计数值达到 PV 后返回 TRUE。

行为说明​

  • CU 和 CD 各自按上升沿改变当前计数值。
  • LD 为 TRUE 时装入 PV;R 为 TRUE 时清零,同时为 TRUE 时清零生效。
  • 调用直接返回达到 PV 的主布尔结果,不提供 QD、CV 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 CTUD 实例。
CTUD counter = new CTUD();
BOOL countUp = FALSE;
BOOL countDown = FALSE;
BOOL load = FALSE;
BOOL reset = FALSE;
BOOL full = counter(CU: countUp, CD: countDown, PV: 10, LD: load, R: reset);

相关 API​

暂无已核实关系。

下降沿检测​

F_TRIG 可执行

IEC 标准功能块 F_TRIG;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL F_TRIG(BOOL CLK)

参数​

CLKBOOL
  • 输入
  • 必填
被检测信号。

返回值​

returnBOOL
仅在 CLK 从 TRUE 变为 FALSE 的扫描周期返回 TRUE。

行为说明​

  • 实例保存上一次调用的 CLK;持续为 FALSE 时不重复触发。
  • 调用直接返回边沿检测结果,不提供 Q 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 F_TRIG 实例。
F_TRIG edge = new F_TRIG();
BOOL signal = FALSE;
BOOL falling = edge(CLK: signal);

相关 API​

暂无已核实关系。

上升沿检测​

R_TRIG 可执行

IEC 标准功能块 R_TRIG;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL R_TRIG(BOOL CLK)

参数​

CLKBOOL
  • 输入
  • 必填
被检测信号。

返回值​

returnBOOL
仅在 CLK 从 FALSE 变为 TRUE 的扫描周期返回 TRUE。

行为说明​

  • 实例保存上一次调用的 CLK;持续为 TRUE 时不重复触发。
  • 调用直接返回边沿检测结果,不提供 Q 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 R_TRIG 实例。
R_TRIG edge = new R_TRIG();
BOOL signal = FALSE;
BOOL rising = edge(CLK: signal);

相关 API​

暂无已核实关系。

复位优先双稳态​

RS 可执行

IEC 标准功能块 RS;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL RS(BOOL S, BOOL R1)

参数​

SBOOL
  • 输入
  • 必填
置位输入。
R1BOOL
  • 输入
  • 必填
复位输入。

返回值​

returnBOOL
复位优先的保持状态。

行为说明​

  • S 为 TRUE 时置位,R1 为 TRUE 时复位;两者同时为 TRUE 时复位优先。
  • 调用直接返回保持状态,不提供 Q 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 RS 实例。
RS latch = new RS();
BOOL setSignal = FALSE;
BOOL resetSignal = FALSE;
BOOL output = latch(S: setSignal, R1: resetSignal);

相关 API​

暂无已核实关系。

置位优先双稳态​

SR 可执行

IEC 标准功能块 SR;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL SR(BOOL S1, BOOL R)

参数​

S1BOOL
  • 输入
  • 必填
置位输入。
RBOOL
  • 输入
  • 必填
复位输入。

返回值​

returnBOOL
置位优先的保持状态。

行为说明​

  • S1 为 TRUE 时置位,R 为 TRUE 时复位;两者同时为 TRUE 时置位优先。
  • 调用直接返回保持状态,不提供 Q 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 SR 实例。
SR latch = new SR();
BOOL setSignal = FALSE;
BOOL resetSignal = FALSE;
BOOL output = latch(S1: setSignal, R: resetSignal);

相关 API​

暂无已核实关系。

断开延时定时器​

TOF 可执行

IEC 标准功能块 TOF;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL TOF(BOOL IN, INT PT)

参数​

INBOOL
  • 输入
  • 必填
输入信号。
PTINT
  • 输入
  • 必填
断开延时,单位毫秒。

返回值​

returnBOOL
IN 变为 FALSE 后保持 TRUE,达到 PT 后返回 FALSE。

行为说明​

  • IN 为 TRUE 时立即返回 TRUE;下降沿启动断开延时。
  • 调用直接返回主布尔结果,不提供 ET 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 TOF 实例。
TOF timer = new TOF();
BOOL signal = FALSE;
BOOL output = timer(IN: signal, PT: 100);

相关 API​

暂无已核实关系。

接通延时定时器​

TON 可执行

IEC 标准功能块 TON;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL TON(BOOL IN, INT PT)

参数​

INBOOL
  • 输入
  • 必填
计时使能。
PTINT
  • 输入
  • 必填
预置时间,单位毫秒。

返回值​

returnBOOL
IN 连续为 TRUE 达到 PT 后返回 TRUE。

行为说明​

  • IN 为 FALSE 时返回 FALSE,并清除计时状态。
  • 调用直接返回主布尔结果,不提供 ET 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 TON 实例。
TON timer = new TON();
BOOL signal = FALSE;
BOOL output = timer(IN: signal, PT: 100);

相关 API​

暂无已核实关系。

脉冲定时器​

TP 可执行

IEC 标准功能块 TP;实例状态跨扫描保留。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL TP(BOOL IN, INT PT)

参数​

INBOOL
  • 输入
  • 必填
脉冲触发输入。
PTINT
  • 输入
  • 必填
脉冲宽度,单位毫秒。

返回值​

returnBOOL
IN 上升沿后在 PT 毫秒内返回 TRUE。

行为说明​

  • 只在 IN 上升沿启动脉冲。
  • 调用直接返回主布尔结果,不提供 ET 或其它成员输出。
  • 同一编译单元最多使用 64 个标准功能块实例。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、FB_INSTANCE_LIMIT。

示例​

声明并调用 TP 实例。
TP timer = new TP();
BOOL trigger = FALSE;
BOOL pulse = timer(IN: trigger, PT: 100);

相关 API​

暂无已核实关系。


共享错误码​

以下错误码在本分类的多个 API 条目中重复出现,统一在此说明以避免冗余。各条目的"错误与限制"小节仅列出该 API 专属的错误码。

错误码前缀对照​

前缀含义示例
COMPILE_编译参数:SCL 参数类型/范围/枚举校验COMPILE_ARGUMENT_ERROR
FB_INSTANCE_功能块实例FB_INSTANCE_LIMIT

COMPILE_ARGUMENT_ERROR​

COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验

出现在 10 个 API 条目中。

  • 缺少必需输入或参数类型不匹配时编译失败。

FB_INSTANCE_LIMIT​

FB_INSTANCE_ 功能块实例

出现在 10 个 API 条目中。

  • 同一编译单元的标准功能块实例超过 64 个时编译失败。