跳到主要内容

库管理器

库用于跨项目复用 POU、UDT、变量表和相关工件。当前标准格式是 .darlib。导入的库必须先检查并批准,不会因为文件已下载就自动进入项目或 Runtime。

当前公开产品只有 Windows 硬实时版。库名、IEC 名称或 MC_* 前缀都不等于 PLCopen 认证、SIL / PL 认证或已安装对应库。

格式​

扩展名用途
.darlib当前标准库格式
.darralib旧格式,只能通过迁移入口读取

不要把旧文件改后缀冒充新库。迁移结果仍要重新检查、批准和测试。

创建库​

  1. 在真实 .dplc 项目中完成要复用的 FB、FC、UDT 或变量表;
  2. 明确公开接口、默认值、周期要求、错误和安全态;
  3. 编译并运行项目测试;
  4. 在库管理器中选择工件并导出 .darlib;
  5. 填写名称、版本、作者、说明和依赖;
  6. 重新导入生成的包,核对清单和摘要。

库包由 IDE 生成,不应手工拼装内部清单。不要把已归档的 CFC 或未接通的 IEC 61499 原型导出成生产库。

导入与批准​

导入时应检查:

  • 包格式和清单是否有效;
  • 工件大小和 SHA-256 摘要是否一致;
  • 依赖是否可解析;
  • 版本和兼容范围是否符合项目要求;
  • 许可证和发布者声明是否可接受;
  • FB 接口与 UDT 布局是否会破坏现有调用。

摘要只能证明文件未被意外改变,不能单独证明发布者身份。只导入来源可信并经过本机批准的库。当前没有可作为认证安全控制使用的公开安全功能块库。

依赖与版本锁定​

库使用语义化版本:

变化含义
主版本变化可能包含不兼容接口变化
次版本变化增加向后兼容功能
修订版本变化修复问题,不应改变公开接口

项目应锁定实际使用的库版本和包摘要。依赖声明只是选择条件,最终安装结果必须明确到具体版本。

出现依赖冲突时,应升级或降级上游库,或拆分为不同库 ID。不要通过复制类型、修改命名空间或跳过校验来掩盖冲突。

升级流程​

  1. 保留当前库和锁定记录;
  2. 导入新版本到待复核区;
  3. 阅读变更说明;
  4. 比较 FB 输入输出、UDT 布局、默认值和依赖;
  5. 在真实 .dplc 项目中重新编译;
  6. 验证正常流程、故障流程和安全态;
  7. 批准新版本并更新锁定记录。

即使是修订版本也不能未经测试自动替换生产项目。

回退​

回退时应同时恢复上一版 .darlib 和对应的锁定记录,再重新编译项目并验证。只替换文件而不检查项目兼容性,不能算完成回退。

IEC 与 PLCopen 名称​

TON、TOF、CTU、R_TRIG 和 MC_* 等名称常用于标准或迁移资料。名称相同不表示对应库已安装,也不表示接口完全相同,更不表示已通过 PLCopen 或功能安全认证。使用前必须查看当前库清单和 IDE 显示的实际接口。

测试要求​

发布库前至少验证:

  • 每个公开 POU 能在真实项目中编译和调用;
  • 每个实例的状态互不污染;
  • 输入边界、超时和复位行为明确;
  • 错误输出和安全态可观察;
  • 升级和回退路径可重复;
  • 依赖缺失时明确失败。

文件存在、示例代码或 C# 测试桩都不能代替真实 PLC 项目调用。库内的“安全态”字段是普通控制语义,不能替代独立认证安全回路。

排错​

现象检查项
库无法导入格式、清单、摘要和来源
旧库无法打开是否使用旧格式迁移入口
依赖冲突依赖范围、实际版本和库 ID
升级后编译失败FB 接口、UDT 布局和默认值变化
库未进入项目是否完成检查和本机批准
回退后仍异常库文件与锁定记录是否一起恢复

相关文档​