在线调试
在线调试用于在 PLC 持续扫描时观察变量、写入测试值、记录趋势并检查报警和日志。PLC 不提供断点或单步(包括 F9 / F10);暂停扫描会破坏输出时序。需要停止执行时,应按停机流程让输出进入设备定义的安全态。
调试手段只有:监视 + 强制 + 趋势 + 日志 + 报警。
通道分工
端口全部固定,界面不提供修改入口。
| 通道 | 端口 | 用途 |
|---|---|---|
| DarraLink | TCP 18821 | IDE 主会话、部署、运行控制;Force / Unforce 唯一入口(IoLive RPC,统一进入 ForceSafetyGate,含 Force RBAC / nonce) |
| DarraIPC | UDP 18850 | 高频监视数据面(Value / Quality / Age / Epoch / ForceState)。不得发强制 |
| RemoteAccess | HTTPS 18443 | 远程状态、报警、诊断和日志 |
| HMI Web | HTTP + WebSocket 18823 | HMI 页面与变量订阅 |
强制不得走 18850
历史 DarraIPC ForceWrite 帧必须禁用;Service 端若仍收到该类帧,应 fail-closed 转入同一 ForceSafetyGate,禁止旁路 18821 安全门。
调试工具
| 工具 | 用途 |
|---|---|
| 在线监控 | 查看当前变量值、质量、时间和强制状态 |
| 一次写入 | 临时改变一个可写变量,后续可被程序覆盖 |
| 强制 | 经 18821 安全门持续覆盖变量值 |
| 趋势 | 查看数值随时间的变化和故障前后关系 |
| 报警 | 查看异常严重度、状态、时间和确认情况 |
| PLC 诊断 | 查看 Runtime、任务、IO、服务和资源状态 |
| 日志 | 回溯编译、连接、运行和故障证据 |
标准定位流程
- 先看报警:按严重度和时间确认是否已有明确故障;
- 从输出反查输入:把输出、联锁、命令和反馈加入监控表;
- 查写入者:使用符号引用定位所有写点,避免只看一个分支;
- 必要时一次写入:先用短时激励区分输入链路和程序逻辑(写操作走 18821);
- 谨慎强制:只有工程师或更高角色可执行,经 18821
ForceSafetyGate,并记录原因; - 用趋势看时序:复现瞬态问题,比较谁先变化;
- 检查诊断和日志:区分 PLC Runtime、IDE 本机和 IO/通讯故障。
写入与强制
一次写入和强制是不同操作,都走 18821,不走 18850。优先使用一次写入;只有程序持续覆盖导致无法验证时才考虑强制。急停、安全门、限位和 STO 等信号不得依赖普通软件强制作为安全措施。
强制结束后应逐项释放并再次确认当前强制列表。非持久强制会在启动恢复路径清除,但不能把重启当作代替人工核对的唯一方法。
监控表
监控表当前固定以 200 ms 刷新,监视样本由 18850 数据面推送。列表保存到:
%AppData%\DarraPLC\watch.json
监控列表按用户环境保存,不属于 .dplc 项目中的 PLC 逻辑。
日志位置
| 日志 | 位置 |
|---|---|
| IDE | %AppData%\DarraPLC\logs\ide_*.log |
| Service | <Service.exe 同目录>\logs\service_*.log |
运行时异常应先看堆栈最前面的业务位置和异常类型,再结合变量值和最近报警判断根因。不要只依据最终提示文字。
生产故障原则
编译成功的程序仍需处理运行期 IO、通讯和资源故障。严重异常时,Runtime 按项目安全策略停止 PLC、清理 Q 区并记录日志与报警;不得用空异常处理、静默重试或断点挂起掩盖故障。
if (Index >= 0 && Index < Values.Length)
{
Result = Values[Index];
}
else
{
Fault = true;
Result = 0;
}