功能块使用
功能块在扫描周期之间保存状态。定时、计数、边沿、锁存应使用稳定实例;无状态运算直接使用标准函数。
选型方法见选择和调用。完整签名以生成 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;
}
- 为控制对象声明一个长期存在的实例。
- 每个扫描周期在固定位置调用一次,传入全部输入。
- 立即使用本次返回值。不要先读旧结果再调用。
函数参数按当前签名的顺序或命名参数绑定。标准功能块的引脚名属于公开合同,多输入时优先使用命名参数。一次调用不要混用位置参数和命名参数。
实例与数据
- 每台设备、每个计时任务和每个边沿通道使用独立实例。
- 跳过调用时,实例保留上一次调用后的状态;被跳过期间的边沿不会被记录。
- 同一扫描多次调用同一实例会按书写顺序多次推进状态。
- 到期点落在两次扫描之间时,主结果在下一次实际调用时更新。
- 普通实例只保证运行期间跨扫描保持。
- 需要断电保持时,在项目数据配置中明确设置,并验证冷启动、暖启动和重新下装后的结果。
- DB 用于结构化数据,I/Q/M 用于过程映像和内部位;参数必须绑定到类型兼容的变量。
- LAD 与 SCL 使用相同的参数和扫描语义。
- 参数类型不匹配或缺少必需输入时编译失败,错误码
COMPILE_ARGUMENT_ERROR。 - 同一编译单元最多 64 个标准功能块实例。超过时编译失败,错误码
FB_INSTANCE_LIMIT。
工具箱条目应同时具备完整参数和可执行状态。若 API 页没有发布合同,不应根据相似名称自行补参数。通讯、工艺、安全不在这 10 个标准功能块内,见通讯功能块、工艺功能块、安全功能块边界。