跳到主要内容

绑定表达式

绑定表达式用于计算只读显示值。一个控件需要单位换算、组合状态或阈值判断时,使用 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,不要把表达式当成赋值。

相关文档​