HMI 数据源
HMI 数据源用于给控件提供实时值和页面状态。配置显示、输入、趋势或动画时,优先从当前 PLC 项目和 HMI 自有变量中选择。
现场运行目录唯一权威是 C:\Darra\HMI\。页面脚本经小写 window.darra 读订阅缓存或受控写入,不要直接操作 WebSocket。
数据源类型
| 数据源 | 类别 | 读写 | 典型用途 |
|---|---|---|---|
| PLC 命名变量 | 过程数据 | 读,或受控写 | 状态、测量值、设定值和请求 |
| PLC 直接地址 | 过程数据 | 读,或受控写 | 兼容既有 I / Q / M / DB 地址表 |
| HMI 全局变量 | HMI 变量 | 读写 | 当前界面模式、筛选条件、选中项 |
| HMI 页级变量 | HMI 变量 | 读写 | 标签页、弹窗和临时输入状态 |
| 绑定表达式 | 派生显示 | 只读 | 单位换算、组合状态和偏差 |
PLC 项目变量
变量树按项目符号组织,并显示名称、类型和注释。绑定时优先选择命名变量:
DB1.Temperature
DB1.Motor.Speed
DB1.MotorRunning
| 控件角色 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 显示控件 | 过程数据 | 只读 | 标签、指示灯、仪表、液位、趋势 |
| 输入 / 滑块 / 旋钮 / 开关 | 设定值 | 读写 | 回显并提交 |
| 按钮 | 请求 | 只写 | 绑定请求变量,不直接驱动设备输出 |
写入目标应是设定值或请求变量。设备输出和联锁由 PLC SCL 管理。
直接地址
已在项目中确认的地址可以绑定:
M0.0
MB10
MW100
MD200
I0.0
Q0.0
| 区 | 类别 | 读写 | 说明 |
|---|---|---|---|
I | 过程映像 | 只读 | 数字 / 模拟输入 |
Q | 过程映像 | 只写(经 PLC) | 输出由 SCL 写;HMI 不要直接当联锁 |
M | 内部 | 读,或受控写 | 已确认含义的标志 |
DB | 数据块 | 读,或受控写 | 优先用命名成员 |
直接地址缺少业务含义,维护性低。新页面优先使用命名变量。
HMI 全局变量
hmi.global.SelectedUnit
| 参数 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 名称 | 标识 | 读写 | hmi.global. 前缀 |
| 类型 | 数据 | 读写 | double、int、bool 或 string |
| 初值 | 数据 | 读写 | 启动时的界面初值 |
| 是否持久化 | 数据 | 读写 | 仅 HMI 侧,不进 PLC 扫描 |
| 注释 | 文档 | 读写 | 说明用途 |
全局变量只属于 HMI,不会被 PLC 扫描程序读取。需要 PLC 参与的状态必须使用 PLC 变量。
HMI 页级变量
hmi.page.main.SelectedTab
| 参数 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 名称 | 标识 | 读写 | hmi.page.<页面>. 前缀 |
| 作用域 | 数据 | 读写 | 仅当前页面 |
| 同名隔离 | 数据 | 读写 | 不同页面中的同名页级变量彼此独立 |
需要跨页共享时改用 HMI 全局变量。
绑定表达式
只读派生数据使用 C# 风格 SCL 表达式:
DB1.Speed / 60.0
DB1.Run && !DB1.Fault
ABS(DB1.Actual - DB1.Setpoint)
| 能力 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 计算显示值 | 表达式 | 只读 | 不写变量 |
| 设备逻辑 | 表达式 | 无 | 不执行 |
| 空结果 | 显示 | 只读 | 由控件回退值处理 |
运行通道
| 通道 | 类别 | 读写 | 端口 / 路径 | 说明 |
|---|---|---|---|---|
| 本地 HMI 壳 | 运行 | 读写(受控) | C:\Darra\HMI\ | WinForms + WebView2 全屏 |
| WebHMI | 运行 | 读写(受控) | HTTP + WebSocket 18823 | 浏览器 / WebView2;端口固定不可改 |
| 远程管理 | 运维 | 读写(受控) | HTTPS 18443 | 工程师监控 / 维护 / 诊断 |
| IDE 主通道 | 部署 | 读写 | TCP 18821 | 发布项目,不是页面脚本入口 |
window.darra | 脚本 | 读 + 受控写 | 同源 /ws | 唯一公开脚本入口 |
enabled_features.hmi=false 时 HMI 不启动。不要把 18823 直接暴露到公网。
选择原则
- PLC 已有真实过程量时,直接绑定 PLC 命名变量。
- 只属于页面交互的状态,使用 HMI 变量。
- 简单只读派生值,使用绑定表达式。
- 设备控制条件和状态转换,写入 PLC SCL。
- 不建立与 PLC 变量同名但含义不同的 HMI 变量。
更新与断线
| 状态 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 在线 | 运行 | 读,或受控写 | PLC 数据按项目更新周期推送,默认 100 ms |
| HMI 变量 | 运行 | 读写 | 界面内更新,不进扫描 |
| 断线 | 运行 | 禁止写 | 明确显示离线、保留必要的最后值 |
| 重连 | 运行 | 恢复读写 | 重新订阅后再恢复实时更新 |