跳到主要内容

功能块使用

功能块在扫描周期之间保存状态。定时、计数、边沿、锁存应使用稳定实例;无状态运算直接使用标准函数。

选型方法见选择和调用。完整签名以生成 API 页为准,本页不复制全部参数。

参数入口​

公开参数以生成 API 页为准。分类名称与公开导航一致,每个分类只保留一个入口。

分类内容
标准功能块TON, TOF, TP, CTU, CTD, CTUD, R_TRIG, F_TRIG, SR, RS
位逻辑运算布尔与位操作
比较器操作比较、选择和范围判断
数学函数算术、数学、限幅和缩放
移动操作数据移动和队列操作
转换操作数值、位串和字符串转换
字符串+字符字符串处理
日期和时间时间读取与计算

标准功能块的分类页:定时器、计数器、边沿检测、双稳态。参数总表见实例与扫描。

访问​

公开合同按 C# 风格调用实例,主结果是调用表达式的 bool 返回值。

访问当前合同不要使用
输入调用实参,优先命名参数先写 .IN / .CU 再 Execute()
主结果调用返回的 bool.Q、.Q1、.QU、.QD
附加输出不提供.ET、.CV
执行入口直接调用实例Execute()
CTU partCounter = new CTU();

bool Scan()
{
bool targetReached = partCounter(CU: partPulse, PV: 20, R: resetRequest);
return targetReached && !fault;
}
  1. 为控制对象声明一个长期存在的实例。
  2. 每个扫描周期在固定位置调用一次,传入全部输入。
  3. 立即使用本次返回值。不要先读旧结果再调用。

函数参数按当前签名的顺序或命名参数绑定。标准功能块的引脚名属于公开合同,多输入时优先使用命名参数。一次调用不要混用位置参数和命名参数。

实例与数据​

  • 每台设备、每个计时任务和每个边沿通道使用独立实例。
  • 跳过调用时,实例保留上一次调用后的状态;被跳过期间的边沿不会被记录。
  • 同一扫描多次调用同一实例会按书写顺序多次推进状态。
  • 到期点落在两次扫描之间时,主结果在下一次实际调用时更新。
  • 普通实例只保证运行期间跨扫描保持。
  • 需要断电保持时,在项目数据配置中明确设置,并验证冷启动、暖启动和重新下装后的结果。
  • DB 用于结构化数据,I/Q/M 用于过程映像和内部位;参数必须绑定到类型兼容的变量。
  • LAD 与 SCL 使用相同的参数和扫描语义。
  • 参数类型不匹配或缺少必需输入时编译失败,错误码 COMPILE_ARGUMENT_ERROR。
  • 同一编译单元最多 64 个标准功能块实例。超过时编译失败,错误码 FB_INSTANCE_LIMIT。

工具箱条目应同时具备完整参数和可执行状态。若 API 页没有发布合同,不应根据相似名称自行补参数。通讯、工艺、安全不在这 10 个标准功能块内,见通讯功能块、工艺功能块、安全功能块边界。

相关文档​