HMI 快速上手
第一次制作设备 HMI,且 PLC 项目已经包含可用变量时,按以下步骤完成一个可验证页面。本教程做的是单设备操作页,不是产线看板或 MES 页面。
1. 准备变量
先在 PLC 项目中确认要显示和操作的变量。
| 用途 | 示例变量 | 类型 |
|---|---|---|
| 电机运行状态 | DB1.MotorRunning | BOOL |
| 电机故障状态 | DB1.MotorFault | BOOL |
| 当前转速 | DB1.Speed | REAL |
| 转速设定 | DB1.SpeedSetpoint | REAL |
| 启动请求 | DB1.StartRequest | BOOL |
HMI 只显示状态并提交请求。启动条件、联锁、故障处理和输出控制必须由 PLC SCL 程序完成。
2. 新建 HMI 项目
- 在已打开的 PLC 项目中创建 HMI。
- 选择本地界面或浏览器界面。
- 设置名称、默认分辨率和主题。
- 保留默认的 1920×1080,除非目标屏幕已有明确规格。
3. 新建页面
填写页面名称、标题、路由和是否为首页,然后选择页面类型:
- 拖拽画面:适合本教程。
- 代码画面:适合 HTML、CSS 和页面 JavaScript。
页面类型创建后不可转换。不要先建拖拽页再切换成代码页。
4. 放置控件
在拖拽画面中放置:
- 标签:标题“电机控制”。
- 两个指示灯:运行和故障。
- 标签或圆形仪表:当前转速。
- 输入框:目标转速。
- 自复位按钮:启动请求。
使用 8 px 网格吸附完成初步布局,再用对齐、等间距和层级命令整理。顶栏保留设备名、连接状态、Profile 和资源真伪。
5. 绑定变量
选中控件后打开数据绑定:
| 控件 | 绑定 | 关键设置 |
|---|---|---|
| 运行指示灯 | DB1.MotorRunning | 真值绿色,假值灰色 |
| 故障指示灯 | DB1.MotorFault | 真值红色并闪烁 |
| 转速显示 | DB1.Speed | 格式 0.0,单位 r/min |
| 转速输入 | DB1.SpeedSetpoint | 数字,最小 0,最大 3000,步进 10 |
| 启动按钮 | DB1.StartRequest | 动作 momentary,按下值 1,松开值 0 |
变量树会显示名称、类型和注释。优先从树中选择,不要手输不确定的地址。字段类型不匹配时先改变量或控件,不要忽略警告。
自复位按钮只是边沿请求。当前公开脚本 API 不提供扫描边界原子脉冲;需要真正的脉冲时在 PLC SCL 中生成。
6. 添加派生显示
需要单位换算或组合状态时,使用只读绑定表达式:
DB1.Speed / 60.0
DB1.MotorRunning && !DB1.MotorFault
MAX(DB1.Speed, DB1.SpeedSetpoint)
表达式支持算术、比较、逻辑和少量数学函数;不支持赋值、循环或设备控制。表达式失败时应设置回退文本,例如 --。
7. 配置动画
故障灯示例:
- 类型:闪烁
- 来源:
DB1.MotorFault - 模式:直传
- 过渡时间:200 ms
转速条示例:
- 类型:宽度
- 来源:
DB1.Speed - 模式:区间
- 输入范围:0–3000
- 输出范围:0–100
动画只改变显示,不得承担控制判断。
8. 配置事件
优先使用控件内置动作。按钮支持自复位、置位、复位和取反。只有内置动作不能表达页面交互时才添加事件脚本。
代码画面中的 PLC 写入使用 window.darra:
await darra.write('DB1.ResetRequest', true);
安全联锁和状态转换不得写在 HMI 事件中。
9. 预览
离线预览
- 控件没有重叠或超出画布。
- 文本、单位和状态颜色清晰。
- 目标主题下具有足够对比度。
- 写控件有明确状态和必要确认。
- 页面缩放后仍保持正确比例。
实时验证
连接已部署的 Windows 运行时后检查:
- 变量值持续更新。
- 断线时页面明确显示离线状态并停止写入。
- 输入值经过范围限制。
- 自复位按钮松开后回到 0。
- 未授权或不可写变量被拒绝。
- PLC 程序独立完成联锁和状态转换。
- 写入只有完整提交回执后才显示成功。
10. 保存与发布
保存 HMI 页面后再保存 .dplc 项目。重新打开项目,确认页面、控件、绑定、动画和事件均已恢复。现场运行前按 预览与发布 部署;远程通道为 18821 和 18443。
常见问题
| 现象 | 检查项 |
|---|---|
| 控件没有值 | 变量是否存在、类型是否匹配、运行时是否在线 |
| 输入不能写 | 变量是否可写、权限是否满足、范围是否允许 |
| 表达式显示空 | 变量名、运算符、函数名和回退值 |
| 动画不触发 | 来源变量、映射模式和输入范围 |
| 页面打开了错误编辑器 | 页面类型在创建时是否选错;需要重建正确类型页面 |