绑定表达式
绑定表达式用于计算只读显示值。一个控件需要单位换算、组合状态或阈值判断时,使用 C# 风格的 SCL 表达式,而不是在页面中复制控制逻辑。
表达式由 HMI 运行时求值,不经过 window.darra.write。结果为空时由控件回退值处理。现场包在 C:\Darra\HMI\。
基本写法
变量名直接写入表达式:
DB1.Temp
DB1.Pump.Speed * 60.0
DB1.Run && !DB1.Fault
| 能力 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 变量读取 | 表达式 | 只读 | 直接写符号名 |
| 赋值 | 表达式 | 无 | 不支持 |
| 副作用 | 表达式 | 无 | 不支持 |
| 设备控制 | 表达式 | 无 | 必须用 PLC SCL |
运算符
| 运算符 | 类别 | 读写 | 说明 |
|---|---|---|---|
+ - * / % | 算术 | 只读 | 数值运算;字符串 + 为拼接 |
== != < <= > >= | 比较 | 只读 | 比较结果为 BOOL |
&& || ! | 逻辑 | 只读 | 短路求值 |
( ) | 分组 | 只读 | 改变优先级 |
字面量
| 字面量 | 类别 | 读写 | 示例 |
|---|---|---|---|
| 十进制数字 | 常量 | 只读 | 1500、32.0 |
| 单引号或双引号字符串 | 常量 | 只读 | "速度 " |
true / false | 常量 | 只读 | 布尔 |
null | 常量 | 只读 | 空 |
DB1.Speed > 1500
DB1.Mode == 2
"速度 " + DB1.Speed
字符串不支持转义序列;需要复杂文本时使用格式和单位字段。
函数
| 函数 | 类别 | 读写 | 参数 | 说明 |
|---|---|---|---|---|
ABS(x) | 数学 | 只读 | 1 | 绝对值 |
MAX(a, b) | 数学 | 只读 | 2 | 较大值 |
MIN(a, b) | 数学 | 只读 | 2 | 较小值 |
ROUND(x) | 数学 | 只读 | 1 | 四舍五入 |
FLOOR(x) | 数学 | 只读 | 1 | 向下取整 |
CEIL(x) | 数学 | 只读 | 1 | 向上取整 |
函数名不区分大小写,文档统一使用大写 SCL 风格。
常用示例
单位换算
DB1.TempC * 1.8 + 32.0
DB1.PressureMpa * 10.0
组合状态
DB1.Run && !DB1.Fault
DB1.AutoMode || DB1.ManualMode
偏差和范围
ABS(DB1.Actual - DB1.Setpoint)
DB1.Level >= 20 && DB1.Level <= 80
MAX(DB1.Axis1Load, DB1.Axis2Load)
不支持的内容
| 语法 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 赋值和变量声明 | 语句 | 无 | 不是 SCL 程序 |
| 条件语句、循环、函数定义 | 语句 | 无 | 不支持 |
| 三元运算符 | 运算 | 无 | 不支持 |
| 任意方法调用 | 调用 | 无 | 仅上表函数 |
| 数组或对象构造 | 结构 | 无 | 不支持 |
| 设备控制和写入 | 控制 | 无 | 用按钮 / darra.write / PLC SCL |
需要多状态文字或颜色时,优先使用离散映射;需要数值到位置或尺寸的变化时,使用区间动画。
错误处理
| 情况 | 类别 | 读写 | 结果 |
|---|---|---|---|
| 语法错误 | 诊断 | 只读 | 表达式无结果 |
| 变量不存在 | 诊断 | 只读 | 返回空值 |
| 类型不兼容 | 诊断 | 只读 | 返回空值 |
| 除数为零 | 诊断 | 只读 | 返回空值 |
| 未知函数 | 诊断 | 只读 | 表达式无结果 |
为显示属性设置回退值,例如 --、离线 或 false。不要用回退值掩盖变量名或类型错误。
设计原则
- 表达式保持短小、只读和可测试。
- 同一工程量换算应统一,避免各页面重复不同公式。
- 设备阈值、联锁和状态转换放在 PLC SCL 中,HMI 只显示 PLC 已计算的结果。
- 高频变化值优先直接绑定,避免堆叠复杂表达式。
- 需要写入时使用写控件或
window.darra.write,不要把表达式当成赋值。