# 字符串模板变量说明

# 一、简介

变量,格式如${XXX},是DTU参数的一个占位符号,在DTU逻辑会自动把它匹配成设备运行的实际值,用来实现批量自动替换的功能。

变量分为通用变量和专用变量。

通用变量在全部的字符串模式下都能匹配,比如${imei},${iccid}等;专用变量只有特定功能应用。

# 二、使用场景

使用场景一:

在分组里面定义MQTTtopic的时候,可以写成/xxx/${imei},设备就会自动把${imei}替换成模组的实际值,如86514568912345,设备真实的topic是/xxx/86514568912345,达到自动匹配的目的。

使用场景二:

变量可以在字符串里面自由组合,可以组成json给格式,比如在心跳包里面设置心跳数据 {"IMEI":"${imei}","SN":"${sn}"}

# 三、注意事项

  1. 变量引用都是字符串格式的,不是整数和浮点数
  2. 变量只能用在配置界面的字符串模式,比如心跳包,注册包,定位上报,MQTT topic等地方。不能用在数据模板里面。
  3. 一句话里面同一个变量如果出现多次,只会匹配第一次出现的位置,其他地方的变量不能匹配。

# 四、变量

变量名 说明 通用/专用
${imei} 模组IMEI 通用
${sn} 模组S/N 通用
${imsi} SIM卡IMSI 通用
${iccid} SIM卡ICCID 通用
${data} 串口数据 专用
${dataHex} 串口数据 专用