# 字符串模板变量说明
# 一、简介
变量,格式如${XXX},是DTU参数的一个占位符号,在DTU逻辑会自动把它匹配成设备运行的实际值,用来实现批量自动替换的功能。
变量分为通用变量和专用变量。
通用变量在全部的字符串模式下都能匹配,比如${imei},${iccid}等;专用变量只有特定功能应用。
# 二、使用场景
使用场景一:
在分组里面定义MQTTtopic的时候,可以写成/xxx/${imei},设备就会自动把${imei}替换成模组的实际值,如86514568912345,设备真实的topic是/xxx/86514568912345,达到自动匹配的目的。
使用场景二:
变量可以在字符串里面自由组合,可以组成json给格式,比如在心跳包里面设置心跳数据
{"IMEI":"${imei}","SN":"${sn}"}
# 三、注意事项
- 变量引用都是字符串格式的,不是整数和浮点数
- 变量只能用在配置界面的字符串模式,比如心跳包,注册包,定位上报,MQTT topic等地方。不能用在数据模板里面。
- 一句话里面同一个变量如果出现多次,只会匹配第一次出现的位置,其他地方的变量不能匹配。
# 四、变量
| 变量名 | 说明 | 通用/专用 |
|---|---|---|
| ${imei} | 模组IMEI | 通用 |
| ${sn} | 模组S/N | 通用 |
| ${imsi} | SIM卡IMSI | 通用 |
| ${iccid} | SIM卡ICCID | 通用 |
| ${data} | 串口数据 | 专用 |
| ${dataHex} | 串口数据 | 专用 |
← 配置参数含义说明 数据发送/接收模板说明 →