跳到主要内容

变量绑定

变量绑定把控件与实时数据连接起来。放好显示控件或写控件后,用数据绑定向导选择变量、检查类型并设置转换方式。

运行时由 window.darra 订阅并推送;写入走事务回执。现场包在 C:\Darra\HMI\。

可绑定数据​

数据类别读写示例用途
PLC 项目变量过程数据读,或受控写DB1.Temperature过程值、状态和设定值
直接地址过程数据读,或受控写M0.0、MW100已在项目中确认含义的地址
HMI 全局变量HMI 变量读写hmi.global.SelectedUnit跨页面共享的纯界面状态
HMI 页级变量HMI 变量读写hmi.page.main.SelectedTab当前页面私有状态
只读表达式派生显示只读DB1.Speed / 60.0派生显示值

优先从项目变量树选择带名称、类型和注释的变量。直接地址仅在项目已经明确分配时使用。

绑定方向​

方向类别读写适用控件行为
单向读取显示只读标签、指示灯、仪表、液位、趋势数据变化后更新显示
双向读写操作读写输入框、滑块、旋钮、开关回显当前值,用户提交后请求写入
只写请求操作只写自复位、置位、复位按钮按控件动作写入请求值

能读取变量不表示一定能写入。写入还必须满足变量可写、控件未只读、用户权限足够以及项目允许该写入。

数据绑定向导​

  1. 选中控件并打开“数据绑定”。
  2. 在左侧变量树搜索或展开变量。
  3. 在右侧选择控件字段。
  4. 双击变量或拖到目标字段。
  5. 检查类型和转换预览。
  6. 应用后保存页面。

字段名写入 data-darra-bind-<FieldName>;主字段 value 可简写为 data-darra-bind。已注册字段见 控件库。

字段类型类别读写兼容变量
BOOL类型读检查BOOL
NUM类型读检查整数、位串、浮点和 TIME / TOD / DATE / DT
STRING类型读检查STRING、WSTRING、CHAR、WCHAR
ANY类型读检查任意类型

类型警告意味着控件可能显示或写入错误值,应先修正,不要直接忽略。

转换方式​

转换类别读写参数用途
无转换 None转换只读无原值显示
线性比例 Linear转换只读K、B显示值 = K × 原值 + B
单位换算 Unit转换只读预设或 K、B工程单位转换
反向布尔 InverseBool转换只读无真值与假值互换
自定义 Custom转换只读${value} 占位设计期示意,运行以表达式为准

内置单位预设:

预设类别读写KB
m → mm单位只读10000
mm → m单位只读0.0010
°C → °F单位只读1.832
°F → °C单位只读0.5555556−17.778
kg → g单位只读10000
g → kg单位只读0.0010
V → kV单位只读0.0010
kV → V单位只读10000
A → mA单位只读10000
mA → A单位只读0.0010
MPa → bar单位只读100
bar → MPa单位只读0.10

需要多变量计算时,不使用转换器拼接脚本,而应使用只读绑定表达式。

更新周期​

参数类别读写范围
项目默认更新周期运行读写默认 100 ms,可设 10–10000 ms

普通状态和过程值通常保持默认值。趋势和大量控件应根据画面负载选择周期。不要把 HMI 更新周期当作 PLC 扫描周期。

脚本订阅可用 darra.subscribe(name, { pushRate }, callback),pushRate 为 onChange、periodic:N 或 onDemand;周期 N 为 100 到 60000 ms。

绑定表达式​

表达式使用 C# 风格的 SCL 语法,只读:

DB1.Temp * 1.8 + 32.0
DB1.Run && !DB1.Fault
ABS(DB1.Actual - DB1.Setpoint)

除零、变量缺失或类型不兼容时返回空值,控件应配置回退文本。完整语法见 绑定表达式。

写控件检查​

检查类别读写说明
最小值 / 最大值 / 步进量程写输入框必须设置
确认或自复位安全写危险操作
断线禁止写入运行禁止写offline 后写控件不可用
请求或设定变量数据写不直接复制设备联锁
PLC SCL控制读写状态转换和安全处理

常见问题​

现象类别读写检查项
没有实时值运行只读变量名称、类型、运行时连接和更新周期
显示为空显示只读变量尚无值、表达式失败或未设置回退值
输入被拒绝操作写只读状态、权限、允许写入范围和输入范围
单位不正确转换只读线性参数 K、B 和单位文本
页面间值不一致HMI 变量读写是否误把页级变量当作全局变量

相关文档​