跳到主要内容

PLC 编程

本页说明当前 SCL/LAD 项目中的变量、扫描周期、定时、调试、启动、Watchdog、在线更新和备份。示例采用 Darra 当前公开的 C# 风格 SCL;未在 IDE 联想或项目库中出现的函数不能按公开 API 使用。

未定义变量怎么处理​

常见原因:

  1. 变量没有在当前代码块、DB 或全局变量中声明。
  2. 局部变量被另一个代码块直接访问。
  3. 名称或层级路径拼写错误。
  4. 项目模型已修改,但当前段仍引用旧名称。
int motorSpeed = 0;
bool motorEnabled = true;

if (motorEnabled)
{
motorSpeed = 100;
}

变量声明和访问应以 IDE 的项目树、符号联想和编译诊断为准;新代码统一使用本页所示的 C# 风格 SCL。

常用数据类型​

公开 SCL 示例使用 C# 风格类型和运算符:

用途类型示例
布尔状态boolbool ready = false;
整数intint productCount = 0;
文本stringstring stateText = "Idle";
条件组合&&、`

项目还可通过 DB、UDT、数组和已引用库定义更具体的数据结构。完整类型、范围和转换以当前 IDE 联想、属性面板和编译器诊断为准,不把历史 IEC 写法混入新代码。

扫描周期太长怎么优化​

  1. 在固定输入和目标负载下记录最坏扫描时间与 Overrun。
  2. 避免在扫描路径中执行无界循环、大量数组遍历、字符串格式化和对象分配。
  3. 把 OPC UA、MQTT、数据库、日志和外部设备请求放在控制面异步路径,不在 SCL 中同步等待。数据库以读为主;不要在扫描逻辑里实现 MES/ERP 业务。
  4. 对大量计算分批处理,但先确认分批不会破坏控制时序。
  5. 合并外部协议的连续地址读取,并限制订阅和轮询量。
  6. 仍无余量时,延长项目周期或调整经验证的目标硬件。

新建项目的主循环周期默认是 10 ms。缩短周期后必须重新核对最坏执行时间、Overrun、Watchdog 和目标硬件余量,不能仅为追求更小数字而削弱安全检查。

int batchIndex = 0;
int batchSize = 1000;
int gain = 2;

result[batchIndex] = angle[batchIndex] * gain;
batchIndex = (batchIndex + 1) % batchSize;

如何使用定时器​

LAD 可直接放置项目库提供的 TON、TOF 和 TP 元件;SCL 使用前应从 IDE 联想或库管理器确认当前项目实际引用的定时器类型、输入、预置时间和输出。

定时器行为
TON输入持续有效达到预置时间后输出有效
TOF输入失效后,输出继续保持预置时间
TP触发后输出一个预置时长的脉冲

定时器实例需要保留跨扫描状态。SCL 的类型、输入、预置时间和输出都以 IDE 联想、项目库与编译器诊断为准。

如何调试 PLC 程序​

PLC 不提供断点或单步。暂停执行会破坏扫描周期和输出时序,现场调试使用不停止程序的可观测手段:

  • 变量监视:连接 Runtime 后添加项目符号,观察值、质量和更新时间。
  • Force:仅工程师权限并完成确认后使用;记录变量、值、操作者和原因,结束后立即取消。
  • 趋势:按信号变化速度设置采样和保存范围,不假定固定 100 Hz 或固定保留期。
  • 报警:查看严重度、时间、来源和确认状态,Critical/Fatal 不应被普通去重静默合并。
  • 日志:从第一条错误和完整上下文定位,不在扫描代码中调用未公开的日志函数。
  • 内存模型检查:加载真实 .dplc 后核对 OB/FB/DB 与运行状态,不只看孤立演示画面。

Force 不能替代安全回路。调试结束前应检查所有 Force 已释放、Q 区恢复由程序控制,并由现场人员确认设备可安全运行。

如何使用 PID​

当前产品范围包含标准 PID/PI/PD 与前馈路径;自动整定和模糊 PID 不按已交付能力使用。控制器的实际类型、参数名、限幅、采样周期和状态字段以项目引用库与 IDE 联想为准,本文不提供虚构的固定调用签名。

使用时至少确认:

  1. 控制周期与控制器配置一致。
  2. 输入量已完成单位、量程和有效性检查。
  3. 输出具有限幅、变化率限制和失效安全值。
  4. 手动/自动切换采用无扰切换策略。
  5. 传感器故障、超温和执行器异常进入独立安全处理。
  6. 参数在真设备上分阶段整定并保留回退值。

无状态函数和有状态实例有什么区别​

特性无状态函数有状态实例
跨扫描状态不保留内部状态保留实例状态
典型用途数学、转换和纯计算定时器、计数器和控制器
并行使用相同输入应得到相同输出每个设备或回路使用独立实例
持久化由调用方保存需要的值由项目模型决定实例状态的初始化与保持

不要在多个设备之间误用同一个有状态实例。


部署与运行问题​

下载后不运行​

按顺序检查:

检查项预期
Runtime现场状态页显示已启动,当前版本与 IDE/项目兼容
授权界面显示授权有效,硬件和功能配额匹配
Profile目标机角色正确,资源真伪满足项目要求
项目正确的 .dplc 已部署并通过编译、校验和加载
PLC 状态处于允许启动的安全状态,没有 Watchdog 或致命诊断
IO驱动、过程映像、设备和安全输出均已就绪

先在诊断页查看最早的错误,不要只看最后一条“启动失败”。授权、驱动或安全门未通过时,禁止通过跳过校验强制进入 RUN。

冷启动、暖启动和热启动​

模式适用条件处理原则
冷启动首次部署、无有效快照或不兼容变更按项目初值完整初始化
暖启动有可用运行快照且项目允许恢复恢复项目批准的保持数据和运行状态
热启动在线更新且新旧程序通过兼容性检查在周期边界原子切换可兼容内容

实际模式由 Runtime 根据快照、程序版本、变更类型和安全策略决定。不能因为希望“不停机”就把变量类型、IO 或总线配置变更强行当作热更新。

保持变量断电后丢失​

  1. 确认变量在当前项目模型中确实配置为保持数据,而不是只在注释中声明。
  2. 核对上次停机或掉电前是否成功生成有效运行快照。
  3. 检查 Runtime 日志中的快照保存、校验和恢复错误。
  4. 核对磁盘空间、健康状态和供电保持时间。
  5. 项目结构、变量类型或布局变化后,确认迁移兼容性;不兼容时按冷启动处理。

不要直接修改内部保持文件或缩短未公开的刷盘参数。累计量、标定值等关键数据还应通过项目批准的持久化与备份策略保护。

HMI 参数保存后丢失​

先确认当前项目已经启用参数保存,并检查保存回执、诊断中的第一条错误、磁盘空间、账户权限和重新加载结果。没有明确成功回执时,不应告诉操作员参数已经持久化。

配方等控制参数应通过当前 IDE 与 Runtime 已提供的项目功能管理;未出现在 IDE 联想或文档中的对象和方法不能作为 SCL API 使用。

Watchdog 超时导致停机​

Watchdog 发现扫描未在允许时间内完成时,PLC 应停止扫描、清零 Q 区并进入安全状态。排查时:

  1. 从报警和 Runtime 日志确认超时发生时间、任务和最坏执行时间。
  2. 检查无界循环、大数组处理、同步通讯、文件 IO 和异常重试。
  3. 对照同一时刻的 CPU、DPC/ISR、磁盘和温度记录。
  4. 修复根因后在固定负载下重新测量,确认无 Overrun。
  5. 由现场人员确认安全状态后再恢复运行。

周期与 Watchdog 通过项目配置设置,不能单纯放宽 Watchdog 来隐藏超时。

如何在线更新​

在线更新按“下载、校验、切换、验证”执行。新程序必须先编译成功并通过运行时兼容性检查;切换失败时保留原程序并报告错误。

变化处理原则
兼容的 SCL/LAD 逻辑修改可申请在线更新,仍需现场审批和切换后验证
变量类型、布局或保持数据变化通常需要停机迁移或冷启动
PLC 周期、Watchdog 或资源 Profile按停机配置变更处理
EtherCAT 拓扑、PDO、IO 映射或驱动必须停机并重新完成硬件验证
安全逻辑不因技术上可切换就跳过安全评审和人工确认

在线更新不等于“无扰生产保证”。操作前仍需备份 .dplc、确认输出安全、记录运行版本,并准备可验证的回退项目。

项目怎么备份​

.dplc 是项目唯一权威文件。普通项目可备份和迁移;密码保护项目必须通过 IDE 输入正确密码后打开,不要用外部工具修改项目文件。

备份时:

  1. 在 IDE 中完成保存并确认没有保存错误。
  2. 复制 .dplc 到受控备份位置,保留时间、项目版本和校验值。
  3. AI 模型、图像或其他项目外部制品按 IDE 导出/备份流程一并归档。
  4. 需要保存现场状态时,通过产品备份流程获取获准的运行数据,不直接复制内部快照。
  5. 定期在隔离环境执行恢复演练,确认项目能打开、编译且引用完整。

不要用包含删除命令的一次性脚本清理备份源,也不要把 Runtime 内部目录当作第二份项目工程。

项目如何做版本管理​

Git 可以保存 .dplc 的二进制版本快照,但不能逐行合并项目文件冲突。团队应做到:

  • 同一 .dplc 同一时刻只由一名负责人保存。
  • 每次提交记录功能、项目版本和验证结果。
  • 需要评审时从 IDE 导出只读的 SCL/LAD 对比材料;导出物不是可部署项目。
  • 冲突时分别在 IDE 中打开两个版本并人工合并,再保存为新的 .dplc。
  • 忽略 bin/、日志和用户级临时文件等可重建产物,不忽略项目权威文件。

多人需要长期并行开发时,应按项目边界拆分,而不是让多个分支同时改同一个 .dplc 后依赖文本合并。