变量绑定
变量绑定把控件与实时数据连接起来。放好显示控件或写控件后,用数据绑定向导选择变量、检查类型并设置转换方式。
运行时由 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 | 派生显示值 |
优先从项目变量树选择带名称、类型和注释的变量。直接地址仅在项目已经明确分配时使用。
绑定方向
| 方向 | 类别 | 读写 | 适用控件 | 行为 |
|---|---|---|---|---|
| 单向读取 | 显示 | 只读 | 标签、指示灯、仪表、液位、趋势 | 数据变化后更新显示 |
| 双向读写 | 操作 | 读写 | 输入框、滑块、旋钮、开关 | 回显当前值,用户提交后请求写入 |
| 只写请求 | 操作 | 只写 | 自复位、置位、复位按钮 | 按控件动作写入请求值 |
能读取变量不表示一定能写入。写入还必须满足变量可写、控件未只读、用户权限足够以及项目允许该写入。
数据绑定向导
- 选中控件并打开“数据绑定”。
- 在左侧变量树搜索或展开变量。
- 在右侧选择控件字段。
- 双击变量或拖到目标字段。
- 检查类型和转换预览。
- 应用后保存页面。
字段名写入 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} 占位 | 设计期示意,运行以表达式为准 |
内置单位预设:
| 预设 | 类别 | 读写 | K | B |
|---|---|---|---|---|
| m → mm | 单位 | 只读 | 1000 | 0 |
| mm → m | 单位 | 只读 | 0.001 | 0 |
| °C → °F | 单位 | 只读 | 1.8 | 32 |
| °F → °C | 单位 | 只读 | 0.5555556 | −17.778 |
| kg → g | 单位 | 只读 | 1000 | 0 |
| g → kg | 单位 | 只读 | 0.001 | 0 |
| V → kV | 单位 | 只读 | 0.001 | 0 |
| kV → V | 单位 | 只读 | 1000 | 0 |
| A → mA | 单位 | 只读 | 1000 | 0 |
| mA → A | 单位 | 只读 | 0.001 | 0 |
| MPa → bar | 单位 | 只读 | 10 | 0 |
| bar → MPa | 单位 | 只读 | 0.1 | 0 |
需要多变量计算时,不使用转换器拼接脚本,而应使用只读绑定表达式。
更新周期
| 参数 | 类别 | 读写 | 范围 |
|---|---|---|---|
| 项目默认更新周期 | 运行 | 读写 | 默认 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 变量 | 读写 | 是否误把页级变量当作全局变量 |