自定义功能块
自定义功能块用于把已验证的 SCL 功能块、函数和数据类型复用到其他项目。当前公开路径是从 IDE 导出 .darlib v2,再在目标项目中检查、暂存和人工复核。
当前支持范围
| 方式 | 状态 | 说明 |
|---|---|---|
SCL 功能块/函数导出为 .darlib | 可用 | 通过 IDE 完成 |
| UDT 等依赖随包导出 | 可用 | 导出时按选择项处理 |
.darlib 导入检查 | 可用 | 检查后进入待复核状态 |
旧 .darralib | 只读迁移 | 迁移为 .darlib 后复核 |
当前公开复用方式是 .darlib,不提供第三方二进制插件接口,也不能把库包当成 MES / SPC 业务插件。
导入成功只表示包已检查并暂存,不表示已经安装、激活、部署或批准运行。
编写示例
下面示例使用当前文档要求的 C# 风格 SCL:
class FB_Limit : PlcFunctionBlock
{
public int Input = 0;
public int Minimum = 0;
public int Maximum = 100;
public int Output = 0;
public bool Limited = false;
public string Status = "Ready";
public void Execute()
{
Limited = false;
Output = Input;
if (Input < Minimum)
{
Output = Minimum;
Limited = true;
Status = "Below minimum";
}
else if (Input > Maximum)
{
Output = Maximum;
Limited = true;
Status = "Above maximum";
}
}
}
SCL 示例统一使用 csharp 围栏、花括号、=、bool/int/string、&&/||/! 和 // 注释。不要使用 IF/THEN/END_IF、:=、VAR、AND/OR/NOT。
导出流程
- 在真实项目中编译并测试要复用的功能块。
- 打开库管理入口,选择“添加到库”或导出库。
- 选择需要的 FB、FC 和相关 UDT。
- 填写短名称、版本和用途说明。
- 导出
.darlib,不要手工拼装包内清单。 - 保留原项目;导出操作不会删除项目节点。
导入流程
- 打开库浏览器,选择“检查并暂存”。
- 选择
.darlib;旧.darralib只能从迁移入口处理。 - 查看包名称、版本、内容摘要和许可证声明。
- 完成本机人工复核。
- 在项目中明确引用需要的块,并重新编译。
- 在目标硬件或测试台验证功能和扫描周期预算。
版本规则
- 修复内部逻辑但不改接口时递增修订版本;
- 输入、输出或 UDT 布局变化时视为破坏性变更;
- 升级前比较接口、依赖和安全态;
- 版本号不能替代编译和真实调用测试。
实时性边界
- 网络、数据库和文件等待不能写入 PLC 扫描逻辑。
- 长计算应拆成有界、可预测的跨周期状态机。
- 功能块必须明确错误输出和安全态。
- 不依赖未公开的原生或托管宿主接口。
- 只打包当前项目中可编译、可复核的 SCL 资产。
排错
| 现象 | 处理 |
|---|---|
| 包检查失败 | 查看清单、内容摘要和许可证检查结果,不绕过校验 |
| 旧库不能直接使用 | 走 .darralib 迁移并重新复核 |
| 引用后编译失败 | 检查接口、UDT 布局和依赖版本 |
| 扫描周期变长 | 测量功能块耗时并简化或拆分计算 |
| 导入后找不到块 | 确认已完成复核并在项目中建立引用 |