跳到主要内容

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 直接暴露到公网。

选择原则​

  1. PLC 已有真实过程量时,直接绑定 PLC 命名变量。
  2. 只属于页面交互的状态,使用 HMI 变量。
  3. 简单只读派生值,使用绑定表达式。
  4. 设备控制条件和状态转换,写入 PLC SCL。
  5. 不建立与 PLC 变量同名但含义不同的 HMI 变量。

更新与断线​

状态类别读写说明
在线运行读,或受控写PLC 数据按项目更新周期推送,默认 100 ms
HMI 变量运行读写界面内更新,不进扫描
断线运行禁止写明确显示离线、保留必要的最后值
重连运行恢复读写重新订阅后再恢复实时更新

相关文档​