产品定价 立即试用
社区版
入门 文档 指南 安装 架构 API 常见问题
目录

简单字段计算

简单字段计算使用单个数学表达式进行实时计算。 支持基本算术运算(+-*/)及标准函数如sqrtpowabsminmax。 适用于轻量转换与派生值,无需脚本。

在需要快速、声明式计算时使用简单字段计算,例如:

  • 归一化与缩放(乘数、偏移、校准系数)
  • 派生传感器指标(如露点、热指数、功率 = 电压 × 电流)
  • 基于阈值的值(限幅、简单评分、差值)
  • 跨实体计算(如合并设备遥测与资产属性)

配置

打开 创建字段计算 对话框并指定:

  • 字段计算 title
  • 将应用字段计算的 entity或entity profile
  • 选择 “Simple” 作为字段计算 type

参数

简单字段计算的arguments可为latest telemetryattribute。 数据源可为Current entity、另一Device/AssetCustomerCurrent tenantCurrent owner

参数类型与配置详见 Arguments


表达式

Expression 区域使用单个数学公式定义计算。

  • 按名称直接引用 argument 变量(如temperature、humidity)
  • 支持算术运算(+-*/)及标准函数如 abssqrtpowminmax
  • 产生单个结果值,保存在配置的输出key下

输出

计算结果以 time seriesattribute 形式存储。

在Output中指定:

  • Key — 存储计算值的名称
  • Decimals — 可选舍入

[仅适用于Time series]
Use latest timestamp — 使用最新argument时间戳而非服务器时间存储结果。

输出类型与处理策略详见 Output


示例:露点计算

场景
Smart Device实时发送 temperaturehumidity 遥测。

目标
计算露点,并将结果以遥测形式存储在同一设备的 dewPoint key下。

字段计算配置
下载“露点计算”字段计算配置 (JSON)


配置步骤

1. 导入演示设备

导入发布温度和湿度遥测的设备。

  1. 下载CSV文件:dew-point-calculation-device-data.csv
  2. 转到“设备”并导入该CSV文件。

CSV包含:

  • 名称: Smart Device
  • 类型: smart-device
  • 时间序列: humiditytemperature

关于CSV的重要说明: humiditytemperature 键的列类型必须设置为“时间序列”。


2. 将字段计算应用于设备配置

导入智能设备时,系统会自动创建“smart-device”配置文件并将其分配给该设备。
将字段计算应用于此配置文件,以便它在使用同一配置文件的所有设备上运行。

  1. 下载字段计算配置文件 (JSON)
  2. 转到“字段计算”标签页并导入配置。

此示例中使用的表达式:

1
2
(243.04 * (ln(humidity / 100) + 17.625 * temperature / (243.04 + temperature)) /
(17.625 - (ln(humidity / 100) + 17.625 * temperature / (243.04 + temperature))))

输出设置:

  • 输出类型: 时间序列
  • 键: dewPoint


结果

露点被计算并作为遥测保存在智能设备上,存储在 dewPoint 键下。


反馈

欢迎为ThingsBoard在 github 加星。 如有疑问,请 联系我们