跳到主要内容

HMI 概览

HMI 用于显示设备状态并向 PLC 提交操作请求。现场运行目录唯一权威是 C:\Darra\HMI\,不要使用 C:\DarraHMI\ 或 C:\HMI\。页面脚本入口是小写 window.darra,不要使用 window.Darra。

HMI 是 ISA-95 Level 1-2 操作界面,不是 MES / ERP。设备联锁、顺序和安全逻辑始终放在 PLC SCL 程序中。

部署与入口​

名称类别读写说明
C:\Darra\HMI\现场部署只读运行现场 HMI 包唯一落盘路径;enabled_features.hmi=false 时不启动
Darra.PLC.HMI本地壳读写(受控)工控机或专用 HMI 机上的 WinForms + WebView2 全屏壳
HmiWebServerWebHMI读写(受控)现场 Service 固定端口 18823,浏览器 / WebView2 加载页面与变量订阅
RemoteAccessServer远程管理读写(受控)固定 HTTPS 18443,工程师远程监控 / 维护 / 诊断,不开放 RDP / SSH
DarraLinkIDE 主通道读写固定 TCP 18821,IDE ↔ 现场 Service;不是页面脚本入口
.dplc项目文件读写HMI 页面、绑定、主题和写入白名单随 PLC 项目一并保存

IDE 装在工程师电脑,现场只装 Service + HMI + 驱动。离线预览检查布局;实时值和写入必须连接已部署的 Windows 运行时。

两种页面类型​

页面类型类别读写编辑方式
拖拽画面设计器设计读写 / 运行受控GrapesJS 画布 + 工具箱控件 + 属性面板
代码画面设计器设计读写 / 运行受控Monaco 编辑 index.html、page.css、page.js

页面类型在创建时确定,不能互转。需要两种表现时,建两个页面并共享项目变量、主题和导航。

标准页面​

路由类别读写说明
main监控页以读为主主监控
alarm报警页读 + 确认报警列表,Severity 降序 + Time 降序
trend趋势页只读趋势曲线
recipe配方页读写(受控)设备配方管理
users用户页读写(受控)用户与角色
settings设置页读写(受控)系统设置

以上 6 页通过 SPA 路由 + 鉴权门访问。自定义操作页另外新建。

数据流​

通道类别读写说明
PLC 命名变量过程数据读,或受控写显示控件单向读;输入 / 开关 / 按钮可请求写入
直接地址过程数据读,或受控写已在项目中确认的 I / Q / M / DB 地址
hmi.global.名称HMI 变量读写项目内跨页面共享的纯界面状态,PLC 扫描不读
hmi.page.页面.名称HMI 变量读写仅当前页面;不要当跨页状态
绑定表达式派生显示只读C# 风格 SCL,例如 DB1.Speed * 60.0
window.darra脚本 API读 + 受控写代码画面与事件脚本的唯一公开入口

能读到值不表示可以写回。写入还须满足:变量可写、控件未只读、角色足够、项目白名单允许,并且收到完整提交回执。

设计参数​

参数类别读写默认或范围
设计分辨率画布读写默认 1920×1080,可选 800×600 至 3840×2160
缩放模式画布读写完整显示、等比铺满、拉伸、固定像素
设计网格画布读写默认 8 px,显示并吸附
标尺画布读写默认关闭
数据更新周期运行读写默认 100 ms,可设 10–10000 ms
页面运行缩放运行读写10%–400%

HMI 更新周期不是 PLC 扫描周期。硬实时扫描在 Service / 内核,HMI 只刷新显示。

window.darra 入口​

API类别读写说明
darra.get(name)变量读同步读取已订阅缓存
darra.read(name)变量读主动读取当前值
darra.bind(name, callback)变量读按变化绑定单变量
darra.write(name, value)变量写单变量事务写入,须等回执
darra.writeGroup(values)变量写同一事务批量写入
darra.navigate(route)页面写页面跳转
darra.on(event, callback)事件读ready / offline / error 等

完整表见 HMI 脚本 API。darra.pulse() 当前拒绝:公开合同不提供扫描边界原子脉冲。

推荐流程​

  1. 在已打开的 .dplc 中创建 HMI,设置分辨率和主题。
  2. 新建拖拽画面或代码画面。
  3. 放置控件并绑定项目变量。
  4. 配置状态映射、动画和事件。
  5. 离线预览检查布局。
  6. 连接已部署运行时,验证实时值、断线和每项写入。
  7. 发布到现场 C:\Darra\HMI\。

继续阅读​