跳到主要内容

HMI 快速上手

第一次制作设备 HMI,且 PLC 项目已经包含可用变量时,按以下步骤完成一个可验证页面。本教程做的是单设备操作页,不是产线看板或 MES 页面。

1. 准备变量​

先在 PLC 项目中确认要显示和操作的变量。

用途示例变量类型
电机运行状态DB1.MotorRunningBOOL
电机故障状态DB1.MotorFaultBOOL
当前转速DB1.SpeedREAL
转速设定DB1.SpeedSetpointREAL
启动请求DB1.StartRequestBOOL

HMI 只显示状态并提交请求。启动条件、联锁、故障处理和输出控制必须由 PLC SCL 程序完成。

2. 新建 HMI 项目​

  1. 在已打开的 PLC 项目中创建 HMI。
  2. 选择本地界面或浏览器界面。
  3. 设置名称、默认分辨率和主题。
  4. 保留默认的 1920×1080,除非目标屏幕已有明确规格。

3. 新建页面​

填写页面名称、标题、路由和是否为首页,然后选择页面类型:

  • 拖拽画面:适合本教程。
  • 代码画面:适合 HTML、CSS 和页面 JavaScript。

页面类型创建后不可转换。不要先建拖拽页再切换成代码页。

4. 放置控件​

在拖拽画面中放置:

  1. 标签:标题“电机控制”。
  2. 两个指示灯:运行和故障。
  3. 标签或圆形仪表:当前转速。
  4. 输入框:目标转速。
  5. 自复位按钮:启动请求。

使用 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 运行时后检查:

  1. 变量值持续更新。
  2. 断线时页面明确显示离线状态并停止写入。
  3. 输入值经过范围限制。
  4. 自复位按钮松开后回到 0。
  5. 未授权或不可写变量被拒绝。
  6. PLC 程序独立完成联锁和状态转换。
  7. 写入只有完整提交回执后才显示成功。

10. 保存与发布​

保存 HMI 页面后再保存 .dplc 项目。重新打开项目,确认页面、控件、绑定、动画和事件均已恢复。现场运行前按 预览与发布 部署;远程通道为 18821 和 18443。

常见问题​

现象检查项
控件没有值变量是否存在、类型是否匹配、运行时是否在线
输入不能写变量是否可写、权限是否满足、范围是否允许
表达式显示空变量名、运算符、函数名和回退值
动画不触发来源变量、映射模式和输入范围
页面打开了错误编辑器页面类型在创建时是否选错;需要重建正确类型页面

下一步​