跳到主要内容

自定义功能块

自定义功能块用于把已验证的 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。

导出流程​

  1. 在真实项目中编译并测试要复用的功能块。
  2. 打开库管理入口,选择“添加到库”或导出库。
  3. 选择需要的 FB、FC 和相关 UDT。
  4. 填写短名称、版本和用途说明。
  5. 导出 .darlib,不要手工拼装包内清单。
  6. 保留原项目;导出操作不会删除项目节点。

导入流程​

  1. 打开库浏览器,选择“检查并暂存”。
  2. 选择 .darlib;旧 .darralib 只能从迁移入口处理。
  3. 查看包名称、版本、内容摘要和许可证声明。
  4. 完成本机人工复核。
  5. 在项目中明确引用需要的块,并重新编译。
  6. 在目标硬件或测试台验证功能和扫描周期预算。

版本规则​

  • 修复内部逻辑但不改接口时递增修订版本;
  • 输入、输出或 UDT 布局变化时视为破坏性变更;
  • 升级前比较接口、依赖和安全态;
  • 版本号不能替代编译和真实调用测试。

实时性边界​

  • 网络、数据库和文件等待不能写入 PLC 扫描逻辑。
  • 长计算应拆成有界、可预测的跨周期状态机。
  • 功能块必须明确错误输出和安全态。
  • 不依赖未公开的原生或托管宿主接口。
  • 只打包当前项目中可编译、可复核的 SCL 资产。

排错​

现象处理
包检查失败查看清单、内容摘要和许可证检查结果,不绕过校验
旧库不能直接使用走 .darralib 迁移并重新复核
引用后编译失败检查接口、UDT 布局和依赖版本
扫描周期变长测量功能块耗时并简化或拆分计算
导入后找不到块确认已完成复核并在项目中建立引用

相关文档​