库管理器
库用于跨项目复用 POU、UDT、变量表和相关工件。当前标准格式是 .darlib。导入的库必须先检查并批准,不会因为文件已下载就自动进入项目或 Runtime。
当前公开产品只有 Windows 硬实时版。库名、IEC 名称或 MC_* 前缀都不等于 PLCopen 认证、SIL / PL 认证或已安装对应库。
格式
| 扩展名 | 用途 |
|---|---|
.darlib | 当前标准库格式 |
.darralib | 旧格式,只能通过迁移入口读取 |
不要把旧文件改后缀冒充新库。迁移结果仍要重新检查、批准和测试。
创建库
- 在真实
.dplc项目中完成要复用的 FB、FC、UDT 或变量表; - 明确公开接口、默认值、周期要求、错误和安全态;
- 编译并运行项目测试;
- 在库管理器中选择工件并导出
.darlib; - 填写名称、版本、作者、说明和依赖;
- 重新导入生成的包,核对清单和摘要。
库包由 IDE 生成,不应手工拼装内部清单。不要把已归档的 CFC 或未接通的 IEC 61499 原型导出成生产库。
导入与批准
导入时应检查:
- 包格式和清单是否有效;
- 工件大小和 SHA-256 摘要是否一致;
- 依赖是否可解析;
- 版本和兼容范围是否符合项目要求;
- 许可证和发布者声明是否可接受;
- FB 接口与 UDT 布局是否会破坏现有调用。
摘要只能证明文件未被意外改变,不能单独证明发布者身份。只导入来源可信并经过本机批准的库。当前没有可作为认证安全控制使用的公开安全功能块库。
依赖与版本锁定
库使用语义化版本:
| 变化 | 含义 |
|---|---|
| 主版本变化 | 可能包含不兼容接口变化 |
| 次版本变化 | 增加向后兼容功能 |
| 修订版本变化 | 修复问题,不应改变公开接口 |
项目应锁定实际使用的库版本和包摘要。依赖声明只是选择条件,最终安装结果必须明确到具体版本。
出现依赖冲突时,应升级或降级上游库,或拆分为不同库 ID。不要通过复制类型、修改命名空间或跳过校验来掩盖冲突。
升级流程
- 保留当前库和锁定记录;
- 导入新版本到待复核区;
- 阅读变更说明;
- 比较 FB 输入输出、UDT 布局、默认值和依赖;
- 在真实
.dplc项目中重新编译; - 验证正常流程、故障流程和安全态;
- 批准新版本并更新锁定记录。
即使是修订版本也不能未经测试自动替换生产项目。
回退
回退时应同时恢复上一版 .darlib 和对应的锁定记录,再重新编译项目并验证。只替换文件而不检查项目兼容性,不能算完成回退。
IEC 与 PLCopen 名称
TON、TOF、CTU、R_TRIG 和 MC_* 等名称常用于标准或迁移资料。名称相同不表示对应库已安装,也不表示接口完全相同,更不表示已通过 PLCopen 或功能安全认证。使用前必须查看当前库清单和 IDE 显示的实际接口。
测试要求
发布库前至少验证:
- 每个公开 POU 能在真实项目中编译和调用;
- 每个实例的状态互不污染;
- 输入边界、超时和复位行为明确;
- 错误输出和安全态可观察;
- 升级和回退路径可重复;
- 依赖缺失时明确失败。
文件存在、示例代码或 C# 测试桩都不能代替真实 PLC 项目调用。库内的“安全态”字段是普通控制语义,不能替代独立认证安全回路。
排错
| 现象 | 检查项 |
|---|---|
| 库无法导入 | 格式、清单、摘要和来源 |
| 旧库无法打开 | 是否使用旧格式迁移入口 |
| 依赖冲突 | 依赖范围、实际版本和库 ID |
| 升级后编译失败 | FB 接口、UDT 布局和默认值变化 |
| 库未进入项目 | 是否完成检查和本机批准 |
| 回退后仍异常 | 库文件与锁定记录是否一起恢复 |