PLC 编程
本页说明当前 SCL/LAD 项目中的变量、扫描周期、定时、调试、启动、Watchdog、在线更新和备份。示例采用 Darra 当前公开的 C# 风格 SCL;未在 IDE 联想或项目库中出现的函数不能按公开 API 使用。
未定义变量怎么处理
常见原因:
- 变量没有在当前代码块、DB 或全局变量中声明。
- 局部变量被另一个代码块直接访问。
- 名称或层级路径拼写错误。
- 项目模型已修改,但当前段仍引用旧名称。
int motorSpeed = 0;
bool motorEnabled = true;
if (motorEnabled)
{
motorSpeed = 100;
}
变量声明和访问应以 IDE 的项目树、符号联想和编译诊断为准;新代码统一使用本页所示的 C# 风格 SCL。
常用数据类型
公开 SCL 示例使用 C# 风格类型和运算符:
| 用途 | 类型 | 示例 |
|---|---|---|
| 布尔状态 | bool | bool ready = false; |
| 整数 | int | int productCount = 0; |
| 文本 | string | string stateText = "Idle"; |
| 条件组合 | &&、` |
项目还可通过 DB、UDT、数组和已引用库定义更具体的数据结构。完整类型、范围和转换以当前 IDE 联想、属性面板和编译器诊断为准,不把历史 IEC 写法混入新代码。
扫描周期太长怎么优化
- 在固定输入和目标负载下记录最坏扫描时间与 Overrun。
- 避免在扫描路径中执行无界循环、大量数组遍历、字符串格式化和对象分配。
- 把 OPC UA、MQTT、数据库、日志和外部设备请求放在控制面异步路径,不在 SCL 中同步等待。数据库以读为主;不要在扫描逻辑里实现 MES/ERP 业务。
- 对大量计算分批处理,但先确认分批不会破坏控制时序。
- 合并外部协议的连续地址读取,并限制订阅和轮询量。
- 仍无余量时,延长项目周期或调整经验证的目标硬件。
新建项目的主循环周期默认是 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 联想为准,本文不提供虚构的固定调用签名。
使用时至少确认:
- 控制周期与控制器配置一致。
- 输入量已完成单位、量程和有效性检查。
- 输出具有限幅、变化率限制和失效安全值。
- 手动/自动切换采用无扰切换策略。
- 传感器故障、超温和执行器异常进入独立安全处理。
- 参数在真设备上分阶段整定并保留回退值。
无状态函数和有状态实例有什么区别
| 特性 | 无状态函数 | 有状态实例 |
|---|---|---|
| 跨扫描状态 | 不保留内部状态 | 保留实例状态 |
| 典型用途 | 数学、转换和纯计算 | 定时器、计数器和控制器 |
| 并行使用 | 相同输入应得到相同输出 | 每个设备或回路使用独立实例 |
| 持久化 | 由调用方保存需要的值 | 由项目模型决定实例状态的初始化与保持 |
不要在多个设备之间误用同一个有状态实例。
部署与运行问题
下载后不运行
按顺序检查:
| 检查项 | 预期 |
|---|---|
| Runtime | 现场状态页显示已启动,当前版本与 IDE/项目兼容 |
| 授权 | 界面显示授权有效,硬件和功能配额匹配 |
| Profile | 目标机角色正确,资源真伪满足项目要求 |
| 项目 | 正确的 .dplc 已部署并通过编译、校验和加载 |
| PLC 状态 | 处于允许启动的安全状态,没有 Watchdog 或致命诊断 |
| IO | 驱动、过程映像、设备和安全输出均已就绪 |
先在诊断页查看最早的错误,不要只看最后一条“启动失败”。授权、驱动或安全门未通过时,禁止通过跳过校验强制进入 RUN。
冷启动、暖启动和热启动
| 模式 | 适用条件 | 处理原则 |
|---|---|---|
| 冷启动 | 首次部署、无有效快照或不兼容变更 | 按项目初值完整初始化 |
| 暖启动 | 有可用运行快照且项目允许恢复 | 恢复项目批准的保持数据和运行状态 |
| 热启动 | 在线更新且新旧程序通过兼容性检查 | 在周期边界原子切换可兼容内容 |
实际模式由 Runtime 根据快照、程序版本、变更类型和安全策略决定。不能因为希望“不停机”就把变量类型、IO 或总线配置变更强行当作热更新。
保持变量断电后丢失
- 确认变量在当前项目模型中确实配置为保持数据,而不是只在注释中声明。
- 核对上次停机或掉电前是否成功生成有效运行快照。
- 检查 Runtime 日志中的快照保存、校验和恢复错误。
- 核对磁盘空间、健康状态和供电保持时间。
- 项目结构、变量类型或布局变化后,确认迁移兼容性;不兼容时按冷启动处理。
不要直接修改内部保持文件或缩短未公开的刷盘参数。累计量、标定值等关键数据还应通过项目批准的持久化与备份策略保护。
HMI 参数保存后丢失
先确认当前项目已经启用参数保存,并检查保存回执、诊断中的第一条错误、磁盘空间、账户权限和重新加载结果。没有明确成功回执时,不应告诉操作员参数已经持久化。
配方等控制参数应通过当前 IDE 与 Runtime 已提供的项目功能管理;未出现在 IDE 联想或文档中的对象和方法不能作为 SCL API 使用。
Watchdog 超时导致停机
Watchdog 发现扫描未在允许时间内完成时,PLC 应停止扫描、清零 Q 区并进入安全状态。排查时:
- 从报警和 Runtime 日志确认超时发生时间、任务和最坏执行时间。
- 检查无界循环、大数组处理、同步通讯、文件 IO 和异常重试。
- 对照同一时刻的 CPU、DPC/ISR、磁盘和温度记录。
- 修复根因后在固定负载下重新测量,确认无 Overrun。
- 由现场人员确认安全状态后再恢复运行。
周期与 Watchdog 通过项目配置设置,不能单纯放宽 Watchdog 来隐藏超时。
如何在线更新
在线更新按“下载、校验、切换、验证”执行。新程序必须先编译成功并通过运行时兼容性检查;切换失败时保留原程序并报告错误。
| 变化 | 处理原则 |
|---|---|
| 兼容的 SCL/LAD 逻辑修改 | 可申请在线更新,仍需现场审批和切换后验证 |
| 变量类型、布局或保持数据变化 | 通常需要停机迁移或冷启动 |
| PLC 周期、Watchdog 或资源 Profile | 按停机配置变更处理 |
| EtherCAT 拓扑、PDO、IO 映射或驱动 | 必须停机并重新完成硬件验证 |
| 安全逻辑 | 不因技术上可切换就跳过安全评审和人工确认 |
在线更新不等于“无扰生产保证”。操作前仍需备份 .dplc、确认输出安全、记录运行版本,并准备可验证的回退项目。
项目怎么备份
.dplc 是项目唯一权威文件。普通项目可备份和迁移;密码保护项目必须通过 IDE 输入正确密码后打开,不要用外部工具修改项目文件。
备份时:
- 在 IDE 中完成保存并确认没有保存错误。
- 复制
.dplc到受控备份位置,保留时间、项目版本和校验值。 - AI 模型、图像或其他项目外部制品按 IDE 导出/备份流程一并归档。
- 需要保存现场状态时,通过产品备份流程获取获准的运行数据,不直接复制内部快照。
- 定期在隔离环境执行恢复演练,确认项目能打开、编译且引用完整。
不要用包含删除命令的一次性脚本清理备份源,也不要把 Runtime 内部目录当作第二份项目工程。
项目如何做版本管理
Git 可以保存 .dplc 的二进制版本快照,但不能逐行合并项目文件冲突。团队应做到:
- 同一
.dplc同一时刻只由一名负责人保存。 - 每次提交记录功能、项目版本和验证结果。
- 需要评审时从 IDE 导出只读的 SCL/LAD 对比材料;导出物不是可部署项目。
- 冲突时分别在 IDE 中打开两个版本并人工合并,再保存为新的
.dplc。 - 忽略
bin/、日志和用户级临时文件等可重建产物,不忽略项目权威文件。
多人需要长期并行开发时,应按项目边界拆分,而不是让多个分支同时改同一个 .dplc 后依赖文本合并。