跳到主要内容

HMI 与 SCL 数据交互

PLC 控制逻辑使用 SCL 或 LAD,在 IDE 编译并经 DarraLink 18821 下装到现场 Runtime。HMI 事件代码使用 JavaScript,在现场 HMI 壳的 WebView2 沙箱中运行。HMI 不直接执行 SCL,也不能绕过 PLC 的联锁和权限。

DarraRT 当前公开产品只有 Windows 硬实时版。IDE 装在工程师电脑;现场只装 Service、HMI 和驱动。HMI 部署路径为 C:\Darra\HMI\。端口全部固定,界面不可改。

数据流​

HMI 控件或 JavaScript
│ 读写已授权的项目变量
▼
现场 HMI 服务(固定端口 18823)
│
▼
PLC 符号表与 DB
│
▼
SCL / LAD 控制逻辑
通道端口职责
HMI WebHTTP + WebSocket 18823页面、变量订阅和已授权写请求
DarraLinkTCP 18821IDE 下装、句柄读写;Force / Unforce 唯一入口
DarraIPCUDP 18850IDE 高频监视。不得强制,HMI 也不走此口
RemoteAccessHTTPS 18443远程状态、报警和诊断

HMI 只提交操作请求和显示反馈。设备状态、联锁、超时和安全态应由 PLC 程序维护。不要把 HMI 写成可以强制变量;强制是 IDE 经 18821 ForceSafetyGate 的调试操作。

PLC 侧 SCL​

公开 SCL 使用 C# 风格语法。下面的程序根据 HMI 请求和现场联锁控制电机:

class Main : PlcProgram
{
void Execute()
{
if (DB_Control.StartRequest &&
DB_Status.DriveReady &&
!DB_Status.SafetyFault)
{
DB_Control.MotorRun = true;
}

if (DB_Control.StopRequest || DB_Status.SafetyFault)
{
DB_Control.MotorRun = false;
}
}
}

HMI 应写入 StartRequest 或 StopRequest,再读取 MotorRun、DriveReady 和故障状态。不要让 HMI 直接写最终输出。

HMI 侧 JavaScript​

HMI 运行时脚本在 WebView2 / V8 沙箱中执行,不允许 eval 或任意操作系统调用。长时间运行由脚本看门狗兜底。事件处理器通过运行时上下文访问 PLC 变量:

export async function onClick(event, context) {
const receipt = await context.plc.write(
"DB_Control.StartRequest",
true
);

if (!receipt.ok) {
await context.log.error("启动请求写入失败");
}
}

读取状态:

export async function refreshStatus(event, context) {
const running = await context.plc.read("DB_Control.MotorRun");
const fault = await context.plc.read("DB_Status.SafetyFault");
return { running, fault };
}

变量路径必须来自当前项目符号表。写操作还要满足页面权限、用户角色、变量写权限和数值范围。公开 API 以 HMI .d.ts 为准,不要自造第二套绑定协议。

设计原则​

  • 机器控制、联锁和故障处理放在 PLC 程序中;
  • HMI 只负责显示、输入和已授权命令;
  • 高频变化使用订阅或数据绑定,不在短周期定时器里反复逐项读取;
  • 写入后读取设备反馈,不能把命令值当作执行结果;
  • 急停、安全门、限位和 STO 由独立安全链处理;
  • HMI 脚本失败时记录错误,并保持可恢复的界面状态;
  • 报警来自现场 Service,HMI 不自建第二套报警缓存;
  • 标准页面为 main / alarm / trend / recipe / users / settings,配方页不是 MES 工单系统。

编译和下装​

修改 SCL 后,需要重新编译并经 18821 下装项目。修改 HMI 页面或 JavaScript 时,按 HMI 发布流程更新 C:\Darra\HMI\ 下的页面。两者生命周期不同,不应把 HMI 的即时脚本更新写成 PLC 在线修改,也不应把 HMI 写请求当成 Force。

PLC 不提供断点或单步。核对 HMI 与程序交互时,使用监视、趋势、报警和日志。

相关文档​