标准功能块
本页列出 10 个跨扫描保留状态的定时、计数、边沿检测和锁存功能块。每次调用都按 SCL 语法直接返回主 BOOL 结果;不要调用不存在的 Execute(),也不要读取 .Q、.ET、.CV 或 .QD。
减计数器
CTD
可执行
IEC 标准功能块 CTD;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL CTD(BOOL CD, INT PV, BOOL LD = FALSE)
参数
CDBOOL- 上升沿减一输入。
PVINT- 装载预置值。
LDBOOL- 电平装载输入。
返回值
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL CTU(BOOL CU, INT PV, BOOL R = FALSE)
参数
CUBOOL- 上升沿加一输入。
PVINT- 预置计数值。
RBOOL- 电平复位输入。
返回值
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL CTUD(BOOL CU, BOOL CD, INT PV, BOOL LD = FALSE, BOOL R = FALSE)
参数
CUBOOL- 上升沿加一输入。
CDBOOL- 上升沿减一输入。
PVINT- 预置值。
LDBOOL- 电平装载输入。
RBOOL- 电平复位输入。
返回值
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
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;实例状态跨扫描保留。
声明层
已声明验证层
已验证执行层
可执行
签名
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 个时编译失败。