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 全屏壳 |
HmiWebServer | WebHMI | 读写(受控) | 现场 Service 固定端口 18823,浏览器 / WebView2 加载页面与变量订阅 |
RemoteAccessServer | 远程管理 | 读写(受控) | 固定 HTTPS 18443,工程师远程监控 / 维护 / 诊断,不开放 RDP / SSH |
DarraLink | IDE 主通道 | 读写 | 固定 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() 当前拒绝:公开合同不提供扫描边界原子脉冲。
推荐流程
- 在已打开的
.dplc中创建 HMI,设置分辨率和主题。 - 新建拖拽画面或代码画面。
- 放置控件并绑定项目变量。
- 配置状态映射、动画和事件。
- 离线预览检查布局。
- 连接已部署运行时,验证实时值、断线和每项写入。
- 发布到现场
C:\Darra\HMI\。