TS-LTE-393_T 指令集_V3.7.5
文档名称 _V3.7.5 版本 3.7.5 日期 22-2-7 状态 内部发布 前言 感谢使用 TasTek 提供的型号为 TS-LTE-393 的 DTU 设备 本产品是一款 4G 透传设备 具有我司拓展的 T 命令接口 短信消息以及 TCP 通信 UDP 通信 MQTT 服务 使用前请仔 细阅读用户手册 您将领略其完善的功能和简洁的操作方法 此模块主要用于语音或者数据通讯 本公司不承担由于用户不正常操作造成的财产损失 或者人身伤害责任 请用户按照手册中的技术规格和参考设计开发相应的产品 同时注意使 用移动产品特别是 4G 产品应该关注的一般安全事项 在未声明之前 本公司有权根据技术发展的需要对本手册内容进行修改 版权声明 本手册版权属于 TasTek 任何人未经我公司书面同意复制 引用或者修改本手册都将 承担法律责任 本文档针对 3.7.4 之后的版本编写 2
目录 前言... 2 目录... 3. T 参数配置说明...6.. 进入参数配置状态流程...6.2. 通用参数配置 T 命令说明...6.3. 远程配置说明...6.4 指令范围说明...7 2. 基本 T 指令...7 2.+++ 退出透传模式进入命令模式...7 2.2T... 7 2.3.TO 退出命令模式进入透传模式... 8 2.4T&W 保存当前配置参数...8 2.5T&F 恢复出厂设置并重启...8 2.6T+CFUN=, 设置模块重启...8 2.7T+DTUMODE 配置工作模式...9 2.8T+URTCFG 串口参数设置...9 2.9T+DTUPCKET 串口打包参数设置... 2.T+DTULL 查询所有 DTU 类型参数... 2.T+UTOSTTUS 主动上报配置... 2 2.2T+UTOTO 自动退出配置状态时长修改... 2 2.3 T+SKCONNECT:查询 4 个通道的网络连接状况... 3 3 TCP/UDP T 指令...4 3.T+DSCDDR 设置连接服务器地址... 4 3.2T+SECSERVER 设置副服务器工作使能... 4 3.3T+DSC2DDR 设置连接副服务器地址... 5 4 塔石云 T 指令...5 4.T+DTUCLOUD 塔石云设置...5 5 MQTT 指令列表...6 5.T+IPPORT 设置 MQTT 服务器地址... 6 5.2T+IP2PORT 设置 MQTT 副服务器地址... 7 5.3T+MQTTSSL 设置 SSL 连接...7 5.4T+MQTT2SSL 设置副服务器 SSL 连接... 8 5.5T+CLIENTID 设置 CLIENTID...8 5.6T+CLIENT2ID 设置副服务器 CLIENTID... 8 5.7T+USERPWD 设置账号密码...9 5.8T+USER2PWD 设置副服务器账号密码... 9 5.9T+UTOSU 设置自动订阅...2 5.T+UTOSU2 设置副服务器自动订阅... 2 5.T+UTOPU 设置自动推送...2 3
5.2T+UTOPU2 设置副服务器自动推送... 2 5.3T+WILL 设置遗嘱信息...22 5.4T+WILL2 设置副服务器遗嘱信息... 23 5.5T+MQTTKEEP 设置 MQTT 协议心跳时间... 23 5.6T+MQTT2KEEP 设置副服务器 MQTT 协议心跳时间... 24 5.7T+CLENSESSION 清理会话...24 5.8T+CLENSESSION2 清理副服务器会话... 24 5.9T+MMQTTSU 设置多主题自动订阅... 25 5.2T+LOCKINFO 设置拦截非当前订阅主题的推送... 25 5.2 T+MQTTPUID:查询设置第二主题推送... 26 5.22 T+SECONDUTOPU 设置查询第二推送主题... 27 5.23T+MQTTLL 查询 MQTT 所有参数... 27 3.24T+MQTT2LL 查询副服务器 MQTT 所有参数... 28 6 阿里云直连 T 指令...3 6.T+LYMQTT 阿里云直连(目前仅支持一机一密)... 3 6.2T+LYREGIONID 阿里云直连的 RegionID... 3 7 HTTP T 指令...3 7.T+HTTPEN HTTP 模式配置...3 7.2T+HTTPURL HTTP URL 配置...3 7.3T+HTTPHED HTTP HED 配置...32 8 网络业务/保活 T 指令... 32 8.T+DTUID 注册包设置...32 8.2T+KEEPLIVE 心跳包设置...33 8.3T+HERTDODGE 业务心跳避让功能... 34 8.4T+RESTIME 定时重启设置...34 8.5T+RELINKTIME 重连间隔设置...35 8.6T+DSCTIME 连接超时设置...35 8.7T+CKTIME 网络数据超时设置... 36 8.8T+PORTTIME 串口数据超时设置... 36 9 网络数据 T 指令...37 9.T+CCHE 缓存保存功能...37 9.2T+TCPMODUS Modbus RTU 转 TCP 功能... 37 9.3T+TCPHEX 服务器 HEX 转换...38 9.4T+SENDID 多路数据协议区分配置... 39 9.5T+TRCE 配置各通道数据关联... 39 GPS T 指令...4.T+GPS 查询基站信息...4.2T+GPSINFO 查询经纬度...4.3T+URT2CFG 配置通道 2 功能... 4.4T+GPSCFG 配置 GPS 功能...4 物模型数据点采集 T 指令...42.T+POLL 轮询使能...42.2T+POLLSTR 轮询字串设置...43 4
.3T+JSONCFG 轮询 JSON 使能配置... 43.4T+REGCFG 轮询 JSON 寄存器配置... 44.5T+JSOSNSPEED 配置 JSON 携带 GPS 速度信息... 45.6 T+JSOSNLOCTION 配置 JSON 携带位置信息... 45.7 T+JSOSNTIME 配置 JSON 携带 GPS 时间信息... 46.8 T+JSONPUTIME 配置 JSON 每组上报周期... 47.9 T+JSONFORMT 配置 JSON 打包方式... 47 2 短信 T 指令...47 2.T+WORKMODE 短信透传模式设置... 47 2.2T+SMSSEND T 指令发送短信功能... 48 2.3T+REVNUM 设置短信透传号码... 48 3SIM 卡 T 指令...49 3.T+ICCID 查询 ICCID 号...49 3.2T+CSQ 查询信号强度...49 3.3T+CPIN 查询是否识卡...5 3.4T+CSTT PN 设置...5 3.5T+TIME 查询实时时间...5 3.6T+TIMESTMP 查询实时时间戳,... 5 4 设备信息 T 指令...5 4.T+CGMR 查询版本号...5 4.2T+GSN 查询 IMEI 号...5 4.3T+DEVICEID 配置模块标识符... 52 4.4T+SLEEP:设置设备休眠使能...52 联系方式... 53 5
. T 参数配置说明.. 进入参数配置状态流程 本设备开机初始化完成后会向串口输出"T Ready"字串并且进入透传模式 此时需要向 串口输入三个字节的+++才能退出数据模式进入命令模式才可以进行参数配置 想要再次进 入数据模式 向串口输入 TO 即可重新进入数据模式 或重启设备进入数据模式,或等待 UTOTO 超时自动进入数据模式.2. 通用参数配置 T 命令说明 注意 ) 所有命令配置成功后 都有""作为回应 失败则有"ERROR"作为回应 2) 常规设置命令都可以在命令后用等号来进行配置 例如 T+DTUID=,,,"" 3) 常规设置命令都可以在命令后用问号来查询当前配置 例如 T+DTUID? 4) 常规设置命令都可以在命令后用等号问号来查询配置格式 例如 T+DTUID=? 5) 所 有 参 数 用 半 角 逗 号 分 隔 字 符 串 参 数 需 要 放 在 半 角 引 号 中 例 如 T+DTUID=,,,"arr" 6) 设置完参数后需要发送 T&W 来保存相关数据 否则重启后新配置的参数会丢失 7) 大部分设置命令重启后生效 所以建议进行相关参数后进行保存然后通过 T+CFUN=, 命令重启 8) T 命令头部分大小写不敏感 9) 下文提到的数据格式为 HEX 格式 表示在配置输入时需要将字符串转换成对应的 6 进 制格式再输入 例如 勾选 HEX 之后 "23C"需要转换成"3323344243"后输入 ) 常规设置指令必须在指令头后跟?或者=或者=?来进行功能区分 特殊指令只要指令头对 应即可 ) 本文档中的指令一般不能直接使用 需要把中文符号换成英文符号 )下文中将用<CR>来代替"\r\n",即"回车".3. 远程配置说明 当设备与服务器建立连接后 直接往设备发送指定数据可以进行远程参数配置 2 远程参数配置格式为@DTU::,其中@DTU 为固定头 为相关远程配置指令 除命令头外 其他与普通配置时的指令一致 每项之间用英文的:隔开 3 特殊指令的远程配置指令的命令头与普通配置时一致 常规配置指令在远程配置时只需 要去掉 T+即可 4 6
串口指令 远程指令 T+DTUID? @DTU::DTUID? +DTUID:,,,"" 发送 @DTU::T&W 注意 常用远程配置的特殊指令只有以下几条 @DTU::T&W 保存参数 配置参数后要配置该条指令 @DTU::T&F 恢复出厂设置会刷新掉所配置的参数 @DTU::POWEROFF 重启设备 @DTU::CSQ 查询信号值 @DTU::ICCID 查询设备 ICCID.4 指令范围说明 文档中描述的参数范围是推荐使用的范围 设备在该范围下工作不会出现问题 2. 基本 T 指令 2.+++ 退出透传模式进入命令模式 类型 特殊指令 说明 此命令为三个字符+++ 长度必须为 3 头尾中间有其他字符均会导致进入透传模式 失败 在命令模式下输入此命令也会返回 注意 默认进入命令模式后 2 分钟自动进入透传模式(可以通过 T+UTOTO 修改该时间) 配置 +++ 如果不进入命令模式 发送的数据会被当成业务数据发送到网络 如果是采用远程配置的话 不需要进入命令模式 直接发送配置指令即可 2.2T 类型 特殊指令 说明 此命令需要\r\n 结尾 即 hex 的 xd xa 且顺序不能调换 配置 T<CR> 7
2.3.TO 退出命令模式进入透传模式 类型 特殊指令 配置 TO 在命令模式里面发送 TO 会进入数据模式里面 如果再次给设备发送 TO 会把 TO 当成业 务数据发送到网络 2.4T&W 保存当前配置参数 类型 特殊指令 配置 T&W 如果配置命令后 无论是远程配置 还是串口配置 不发送该条指令 重启后会丢失掉刚 才配置的参数 远程配置保存指令为@DTU::T&W 2.5T&F 恢复出厂设置并重启 类型 特殊指令 配置 T&F 配置该指令后 会把当前的全部参数恢复到出厂时 并重启设备 远程配置指令为@DTU::T&F 2.6T+CFUN=, 设置模块重启 配置 T+CFUN=, 配置该指令后 设备会重启 远程配置指令为@DTU::POWEROFF 8
2.7T+DTUMODE 配置工作模式 格式 T+DTUMODE=(,) 取值范围 ~6 不启用该通道 TCP/UDP 透传 2 MQTT 透传 3 塔石塔石云连接 4 塔石 IOT 云连接 暂不支持 5 HTTP 透传模式 6 阿里云直连 取值范围 ~4 代表 4 个不同的 SOCKET 通道 省略时仅配置通道 默认值 +DTUMODE:,,, 默认第一路为 TCP/UDP 透传 其他几路为默认关闭 特殊命令 T+DTUMODE=, 关闭所有通道 配置 T+DTUMODE=3,2(设置第 2 路连接为塔石云模式) 回应 T+DTUMODE? +DTUMODE=,,, 注意 HTTP 透传模式下 无法远程配置设备参数 2.8T+URTCFG 串口参数设置 格式 T+URTCFG=,,C,D 串口波特率 支持的波特率为 52 576 384 92 44 96 48 24 2 数据位 取值范围 ~ 7 位数据位 暂时不支持 8 位数据位 C 校验位 取值范围 ~2 无校验 NONE 奇校验 ODD 2 偶校验 EVEN D 停止位 取值范围 ~ 9
位停止位 2 位停止位 默认值 +URTCFG:96,,, 96 8 N 配置 T+URTCFG=52,,, T+URTCFG? +URTCFG: 52,,, 注意 目前暂时不支持 7 位 如果您使用的是 232 接口或者 TTL 接口可以将波特率提高到 234 或 468 但是需要您在实际使用的环境中实际测试 如果不知道当前的波特率可以长按 reload 恢复出厂设置 2.9T+DTUPCKET 串口打包参数设置 格式 T+DTUPCKET=, 串口打包时间 如果为 代表使用系统自定义的打包时间 非零的话为用户自定义 的打包时间 -5 毫秒 每包最大包长度 5-3 默认值 +DTUPCKET:,4 配置 T+DTUPCKET=,4 T+DTUPCKET? +DTUPCKET:,4 注意 系统自定义的打包时间是随波特率动态变化的 可以保证 2-52 波特率下上行 K 数据不会分包 自定义打包时间是指 前后两个字节间隔时间大于所设置的打包时间的 话 会被分成两个 TCP 数据包上传 最大包长度是指 如果连续不断的发送数据 任意两个字节间隔时间都小于打包时间 的话 DTU 会自动切分数据上传 切分的长度就是最大包长度 例如 96 下设置打包时间为 打包长度为 4 串口一次行上传 4 个数据 服务器会收到 包数据 数据长度为 4 如果串口一次性上传 4 个数据 服 务器会收到两包数据 一包数据 4 长度 一包数据 个长度
2.T+DTULL 查询所有 DTU 类型参数 类型 特殊指令 配置 T+DTULL? +DTUMODE:,,, +TCPMODUS:,,, +URTCFG:96,,, +WORKMODE: +REVNUM:"86",4, +CSTT:"","","" +RELINKTIME:3 +DSCTIME:3 +CKTIME: +PORTTIME: +DTUFILTER: ------------SOCKET_-----------+DSCDDR:,"tcp","22.23.64.87",58 +KEEPLIVE:,,"ping", +DTUID:,,,"tas", +DTUCLOUD:2,"8662624274796","42ee4b44954f959be44fc242337599", ------------SOCKET_2-----------+DSCDDR:2,"tcp","cloud.tastek.cn",67 +KEEPLIVE:,,"ping",2 +DTUID:,,,"tas2",2 +DTUCLOUD:,"cloudID","cloudPWD",2 ------------SOCKET_3-----------+DSCDDR:3,"tcp","cloud.tastek.cn",67 +KEEPLIVE:,,"ping",3 +DTUID:,,,"tas3",3 +DTUCLOUD:,"2659","23456",3 ------------SOCKET_4-----------+DSCDDR:4,"tcp","cloud.tastek.cn",67 +KEEPLIVE:,,"ping",4 +DTUID:,,,"tas3",4 +DTUCLOUD:,"2659","23456",4
2.T+UTOSTTUS 主动上报配置 格式 T+UTOSTTUS=, 连接状态上报使能 不主动上报任何状态变化 主动上报网络连接状态变化和重启原因 MQTT 工作模式连接状态上报为 +STTUS:, MQTT CONNECTED +STTUS:, MQTT DISCONNECT 外 其余均上报为 +STTUS:, CONNECTED +STTUS:, DISCONNECT 以及重启原因上报为 Network initialization failed! 网络初始化失败 NET STTE UNREGISTER restart! SIM 卡掉网 DSCTimeout restart! 网络连接超时 CKTimeout restart! 无网络下行数据超时重启 PORTTimeout restart! 无串口上行数据超时重启 ota restart! 远程升级 Restart Time out! 定时重启 2 不主动上报连接状态变化 上报 SIM 卡注网状态(3.6.8 添加) +STTUS:NET STTE REGISTERED +STTUS:NET STTE UNREGISTER 3 上报 SIM 卡注网状态 同时也上报连接状态变化(3.6.8 添加) 开机 T Ready 上报使能 取值范围 - 开机不上报 T Ready 开机上报 T Ready 默认开启 建议开启 默认值 +UTOSTTUS=, 配置 T+UTOSTTUS=, T+UTOSTTUS? +UTOSTTUS:, 2.2T+UTOTO 自动退出配置状态时长修改 类型 特殊指令 格式 T+UTOTO= 2
配置 自动退出配置状态时长 设置为 表示关闭该功能 >3 经过设定时间自动进入透传模式 单位 S T+UTOTO=2 T+UTOTO? +UTOTO: 2 2.3 T+SKCONNECT:查询 4 个通道的网络连接状况 类型 常规查询指令 用于通过串口查询当前的网络状态 (3.6.8 以后的版本具有该功能) 格式 T+SKCONNECT? 说明 可以通过串口 T 指令获取当前的网络连接状态 配置 T+SKCONNECT? 回复 +SKCONNECT:,,, 四个通道里面 只有通道 的网络连接已经建立 通道 2 通道 3 通道 4 网络连接未 建立 3
3 TCP/UDP T 指令 3.T+DSCDDR 设置连接服务器地址 格式 T+DSCDDR=,"","C",D 取值范围 -4 代表 4 个不同的 SOCKET 通道 为 TCP 或者 UDP C 为服务器地址 可填域名或 IP D 为端口号 范围 ~65535 默认值 +DSCDDR:,"TCP","cloud.tastek.cn",67 配置 T+DSCDDR=,"TCP","25.2.9.8",9 T+DSCDDR? +DSCDDR:,"tcp","cloud.tastek.cn",67 +DSCDDR:2,"tcp","cloud.tastek.cn",67... 3.2T+SECSERVER 设置副服务器工作使能 格式 T+SECSERVER=,,C,D SOCKET 通道 关闭 开启 SOCKET 通道 2 关闭 开启 C SOCKET 通道 3 关闭 开启 D SOCKET 通道 4 关闭 开启 默认值 +SECSERVER:,,, 4
配置 T+SECSERVER=,,, T+SECSERVER? +SECSERVER:,,, 注意 服务器使能后 会先尝试连接主服务器 3 次失败后会切换到副服务器 再连续 失败 3 次的话 再次切换尝试连接主服务器 不使能该功能 则不会切换 目前有副服务器 的工作模式分别是 TCP/UDP 工作模式 MQTT 工作模式 3.3T+DSC2DDR 设置连接副服务器地址 格式 T+DSC2DDR=,"","C",D 取值范围 -4 代表 4 个不同的 SOCKET 通道 为 TCP 或者 UDP C 为服务器地址 可填域名或 IP D 为端口号 范围 ~65535 默认值 +DSC2DDR:,"TCP","cloud.tastek.cn",67 配置 T+DSC2DDR=,"TCP","25.2.9.8",9 T+DSC2DDR? +DSC2DDR:,"tcp","cloud.tastek.cn",67 +DSC2DDR:2,"tcp","cloud.tastek.cn",67... 4 塔石云 T 指令 4.T+DTUCLOUD 塔石云设置 格式 T+DTUCLOUD=,"","C"(,D) 塔石云模式使能 取值范围 -2 5
2 设备 ID DTU 云 IOT 云 不开启塔石云 连接塔石 DTU 云 连接塔石 IOT 云 暂不支持 平台上创建设备后自动生成的 8 位 ID 经过塔石平台入库后的 5 位特殊标识符 一般为模块的 IMEI 号 可以通 过 T+GSN 指令查询 C 设备密码 DTU 云 平台上创建设备时填写的自定义密码 IOT 云 平台上设备所属产品的 ProductKey D 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +DTUCLOUD:,"2659","23456" 配置 T+DTUCLOUD=,"2345678","2345678" 通道 配置 返回 T+DTUCLOUD=,"2345678","2345678",2 只配置通道 2 返回 T+DTUCLOUD? +DTUCLOUD:,"2659","23456", +DTUCLOUD:,"266","23456",2... 注意 除了设置云模式 还要设置设备的工作模式 例如用 T+DTUCLOUD 设置了塔石 DTU 云工作模式 还要设置 T+DTUMODE 在塔石 DTU 云工作模式 5 MQTT 指令列表 5.T+IPPORT 设置 MQTT 服务器地址 格式 T+IPPORT="",(,C) MQTT 服务器地址 最大长度 256 MQTT 服务器端口号 取值范围 -65535 C 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +IPPORT: "iot.eclipse.org",8883 发送 T+IPPORT="iot.eclipse.org",8883 6
T+IPPORT? +IPPORT: "iot.eclipse.org",8883, +IPPORT: "iot.eclipse.org",8883,2... 5.2T+IP2PORT 设置 MQTT 副服务器地址 格式 T+IP2PORT="",(,C) MQTT 副服务器地址 最大长度 256 MQTT 副服务器端口号 取值范围 -65535 C 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +IP2PORT: "iot.eclipse.org",8883 发送 T+IP2PORT="iot.eclipse.org",8883 T+IP2PORT? +IP2PORT: "iot.eclipse.org",8883, +IP2PORT: "iot.eclipse.org",8883,2... 5.3T+MQTTSSL 设置 SSL 连接 该产品目前不区分单向和双向 格式 T+MQTTSSL=(,) SSL 使能 取值范围 -2 不启用 SSL SSL 单向验证 2 SSL 双向验证 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +MQTTSSL:,,, 发送 T+MQTTSSL=,2 开启第二路 MQTT 的 SSL 验证 T+MQTTSSL? +MQTTSSL:,,, 7
5.4T+MQTT2SSL 设置副服务器 SSL 连接 该产品目前不区分单向和双向 格式 T+MQTT2SSL=(,) SSL 使能 取值范围 -2 不启用 SSL SSL 单向验证 2 SSL 双向验证 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +MQTT2SSL:,,, 发送 T+MQTT2SSL=,2 开启第二路 MQTT 的 SSL 验证 T+MQTT2SSL? +MQTT2SSL:,,, 5.5T+CLIENTID 设置 CLIENTID 格式 T+CLIENTID=""(,) 代表 CLIENTID 最大长度 256 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +CLIENTID: "clientid" 发送 T+CLIENTID="4734F356D",2 (设置通道 2) T+CLIENTID? +CLIENTID: "4734F356D", +CLIENTID: "4734F356D",2... 5.6T+CLIENT2ID 设置副服务器 CLIENTID 8
格式 T+CLIENT2ID=""(,) 代表 CLIENT2ID 最大长度 256 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +CLIENT2ID: "clientid" 发送 T+CLIENT2ID="4734F356D",2 (设置通道 2) T+CLIENT2ID? +CLIENT2ID: "4734F356D", +CLIENT2ID: "4734F356D",2... 5.7T+USERPWD 设置账号密码 格式 T+USERPWD="",""(,C) 代表帐号 最大长度 64 代表密码 最大长度 64 C 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +USERPWD: "","" 发送 T+USERPWD="qwe","cf2" T+USERPWD? +USERPWD: "qwe","cf2", +USERPWD: "","",2... 5.8T+USER2PWD 设置副服务器账号密码 格式 T+USER2PWD="",""(,C) 代表帐号 最大长度 64 代表密码 最大长度 64 C 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +USER2PWD: "","" 发送 T+USER2PWD="qwe","cf2" 9
T+USER2PWD? +USER2PWD: "qwe","cf2", +USER2PWD: "","",2... 5.9T+UTOSU 设置自动订阅 格式 T+UTOSU=,"",C(,D) 订阅使能 取值范围 - 不开启自动订阅 开启自动订阅 代表自动订阅的主题 最大长度 64 MQTT 透传模式下不配置该参数 默认订阅主题 为""+5 位 IMEI 例如"866262548956" 阿里云直连模式下不配置该参数 默认订阅 主题为/$productkey/$devicename/user/get 例如"/avx4WG42fv/test_dev/user/get" C 自动订阅的 QOS 范围 -2 D 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +UTOSU:,"", 发送 T+UTOSU=,"sub", 配置通道 的默认订阅主题 T+UTOSU? +UTOSU:,"sub",, +UTOSU:,"sub",,2... 5.T+UTOSU2 设置副服务器自动订阅 格式 T+UTOSU2=,"",C(,D) 订阅使能 取值范围 - 不开启自动订阅 开启自动订阅 代表自动订阅的主题 最大长度 64 MQTT 透传模式下不配置该参数 默认订阅主题 为""+5 位 IMEI 例如"866262548956" 阿里云直连模式下不配置该参数 默认订阅 主题为/$productkey/$devicename/user/get 例如"/avx4WG42fv/test_dev/user/get" C 自动订阅的 QOS 范围 -2 2
D 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +UTOSU2:,"", 发送 T+UTOSU2=,"sub", 配置通道 的默认订阅主题 T+UTOSU2? +UTOSU2:,"sub",, +UTOSU2:,"sub",,2... 5.T+UTOPU 设置自动推送 格式 T+UTOPU=,"",C,D(,E) 推送使能 取值范围 - 不开启自动推送 开启自动推送 代表自动推送的主题 最大长度 64 MQTT 透传模式下不配置该参数 默认推送主题 为""+5 位 IMEI 例如"866262548956" 阿里云直连模式下不配置该参数 默认推送 主 题 为 /$productkey/$devicename/user/update 例 如 "/avx4wg42fv/test_dev/user/update" C 代表自动推送的 QOS 取值范围 -2 D 代表会话保持选项 返回 - 不写默认为 如果此参数不写 E 参数也不能写 防 止出错 E 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +UTOPU:,"",, 说明 若开启了自动推送 透传模式下串口收到的数据会直接推送 发送 T+UTOPU=,"pub",, 配置通道 的默认推送主题 T+UTOPU? +UTOPU:,"pub",,, +UTOPU:,"pub",,,2... 5.2T+UTOPU2 设置副服务器自动推送 2
格式 T+UTOPU2=,"",C,D(,E) 推送使能 取值范围 - 不开启自动推送 开启自动推送 代表自动推送的主题 最大长度 64 MQTT 透传模式下不配置该参数 默认推送主题 为""+5 位 IMEI 例如"866262548956" 阿里云直连模式下不配置该参数 默认推送 主 题 为 /$productkey/$devicename/user/update 例 如 "/avx4wg42fv/test_dev/user/update" C 代表自动推送的 QOS 取值范围 -2 D 代表会话保持选项 返回 - 不写默认为 如果此参数不写 E 参数也不能写 防 止出错 E 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +UTOPU2:,"",, 说明 若开启了自动推送 透传模式下串口收到的数据会直接推送 发送 T+UTOPU2=,"pub",, 配置通道 的默认推送主题 T+UTOPU2? +UTOPU2:,"pub",,, +UTOPU2:,"pub",,,2... 5.3T+WILL 设置遗嘱信息 格式 T+WILL="","",C,D(,E) 遗嘱主题 最大长度 64 遗嘱数据 最大长度 256 C 遗嘱信息 QOS 取值范围 -2 D 遗嘱保留 取值范围 - E 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +WILL: "","",, 发送 T+WILL="will","qwewqr",, 配置通道 的遗嘱信息 T+WILL? +WILL: "will","qwewqr",,, +WILL: "will","qwewqr",,,2... 22
5.4T+WILL2 设置副服务器遗嘱信息 格式 T+WILL2="","",C,D(,E) 遗嘱主题 最大长度 64 遗嘱数据 最大长度 256 C 遗嘱信息 QOS 取值范围 -2 D 遗嘱保留 取值范围 - E 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +WILL2: "","",, 发送 T+WILL2="will","qwewqr",, 配置通道 的遗嘱信息 T+WILL2? +WILL2: "will","qwewqr",,, +WILL2: "will","qwewqr",,,2... 5.5T+MQTTKEEP 设置 MQTT 协议心跳时间 格式 T+MQTTKEEP=(,) 心跳时间 单位秒 范围 6-36 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 说明 这个为 MQTT 协议心跳 默认值 +MQTTKEEP: 2 发送 T+MQTTKEEP=2 T+MQTTKEEP? +MQTTKEEP: 2 23
5.6T+MQTT2KEEP 设置副服务器 MQTT 协议心跳时间 格式 T+MQTT2KEEP=(,) 心跳时间 单位秒 范围 6-36 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 说明 这个为 MQTT2 协议心跳 默认值 +MQTT2KEEP: 2 发送 T+MQTT2KEEP=2 T+MQTT2KEEP? +MQTT2KEEP: 2 5.7T+CLENSESSION 清理会话 格式 T+CLENSESSION=(,) 说明 这个为 MQTT 协议清理会话标志位 清理会话使能 取值范围 - 禁用 启用 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +CLENSESSION: 发送 T+CLENSESSION= T+CLENSESSION? +CLENSESSION:, +CLENSESSION:,2... 5.8T+CLENSESSION2 清理副服务器会话 格式 T+CLENSESSION2=(,) 24
说明 这个为 MQTT 协议清理会话标志位 清理会话使能 取值范围 - 禁用 启用 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +CLENSESSION2: 发送 T+CLENSESSION2= T+CLENSESSION2? +CLENSESSION2:, +CLENSESSION2:,2... 5.9T+MMQTTSU 设置多主题自动订阅 格式 T+MMQTTSU=,"","C","D","E" 订阅使能 取值范围 - 不开启多主题自动订阅 开启多主题自动订阅 CDE 均代表自动订阅的主题 最大长度 64 默认值 +MQTTSU:,"", "","","" 发送 T+MMQTTSU=,"sub","sub2","sub3","sub4" 主题 配置通道 的默认订阅 T+MMQTTSU? + MMQTTSU:, "sub","sub2","sub3","sub4" 注意 只有通道 的主服务器可以同时订阅多个主题 5.2T+LOCKINFO 设置拦截非当前订阅主题的推送 格式 T+LOCKINFO=,,C,D 通道 拦截使能 取值范围 - 不开启拦截非当前订阅主题的推送功能 开启拦截非当前订阅主题的推送功能 25
通道 2 拦截使能 取值范围 - 不开启拦截非当前订阅主题的推送功能 开启拦截非当前订阅主题的推送功能 C 通道 3 拦截使能 取值范围 - 不开启拦截非当前订阅主题的推送功能 开启拦截非当前订阅主题的推送功能 D 通道 4 拦截使能 取值范围 - 不开启拦截非当前订阅主题的推送功能 开启拦截非当前订阅主题的推送功能 默认值 +LOCKINFO:,,, 发送 T+LOCKINFO=,,, 配置通道 的默认订阅主题 T+LOCKINFO? + LOCKINFO:,,, 5.2 T+MQTTPUID:查询设置第二主题推送 格式 T+MQTTPUID=,,C, D 通道号 -4 分别代表四个通道号 主题号码 -2 代表主题 2 代表主题二 C 使能号 - 禁止 启用 D 通道使能区分符 配置 T+MQTTPUID=,,, split 配置通道 2 数据仅来自串口 T+MQTTPUID? +TRCE:,,, split 注意 如果都不启用 串口数据会直接透传到两个主题 只启用一个主题标示符功能 除了该标示符的数据发送到指定主题外 其他数据都发送到另 外一个主题 都启用 则按照标示符发送 不符合标示符的数据包丢弃 举例 26
5.22 T+SECONDUTOPU 设置查询第二推送主题 格式 T+SECONDUTOPU=EN,"topic",socket 是否读取设置正常 En 是否启用第二推送主题 topic 第二主题名 socket 通道号 配置 T+SECONDUTOPU=, topic2, T+SECONDUTOPU? +SECONDUTOPU:, topic2, 5.23T+MQTTLL 查询 MQTT 所有参数 类型 特殊指令 配置 T+MQTTLL +DTUMODE:,,, +TCPMODUS:,,, +DEVICEID:"TS-LTE-362" +ENCRYPT: +CSTT:"","","" +MQTTSSL:,,, ------------SOCKET_-----------+IPPORT:"iot.3jyun.com",884, +CLIENTID:"2345", +USERPWD:"97233263c6a;","4dfb298cbc83d38fec43378a6b4ff2c", +UTOPU:,"/DH-974/97233263c6a/lm",,, +UTOSU:,"/DH-974/97233263c6a/Rcv",, +WILL:"","payload",,, +CLENSESSION:, +MQTTKEEP:3, ------------SOCKET_2-----------+IPPORT:"8l6aJwu76R8rhUgkM9s5.iot-as-mqtt.cn-shanghai.aliyuncs.com", 883,2 +CLIENTID:"2345 securemode=3,signmethod=hmacsha,timestamp=789 ",2 +USERPWD:"8l6aJwu76R8rhUgkM9s5&PKsOCgQwa6s","48fa2dc5666539f24a78 27
fdabc2787dec2",2 +UTOPU:,"/PKsOCgQwa6s/8l6aJwu76R8rhUgkM9s5/TEST",,,2 +UTOSU:,"/PKsOCgQwa6s/8l6aJwu76R8rhUgkM9s5/TEST",,2 +WILL:"","payload",,,2 +CLENSESSION:,2 +MQTTKEEP:3,2 ------------SOCKET_3-----------+IPPORT:"iot.eclipse.org",883,3 +CLIENTID:"clientid",3 +USERPWD:"username","userpwd",3 +UTOPU:,"pub",,,3 +UTOSU:,"sub",,3 +WILL:"","payload",,,3 +CLENSESSION:,3 +MQTTKEEP:3,3 ------------SOCKET_4-----------+IPPORT:"iot.eclipse.org",883,4 +CLIENTID:"clientid",4 +USERPWD:"username","userpwd",4 +UTOPU:,"pub",,,4 +UTOSU:,"sub",,4 +WILL:"","payload",,,4 +CLENSESSION:,4 +MQTTKEEP:3,4 3.24T+MQTT2LL 查询副服务器 MQTT 所有参数 类型 特殊指令 配置 T+MQTT2LL +DTUMODE:,,, +TCPMODUS:,,, +DEVICEID:"TS-LTE-362" +ENCRYPT: +CSTT:"","","" +MQTTSSL:,,, ------------SOCKET_-----------+IP2PORT:"iot.3jyun.com",884, +CLIENTID2:"2345", +USER2PWD:"97233263c6a;","4dfb298cbc83d38fec43378a6b4ff2c", 28
+UTOPU2:,"/DH-974/97233263c6a/lm",,, +UTOSU2:,"/DH-974/97233263c6a/Rcv",, +WILL2:"","payload",,, +CLENSESSION2:, +MQTT2KEEP:3, ------------SOCKET_2-----------+IP2PORT:"8l6aJwu76R8rhUgkM9s5.iot-as-mqtt.cn-shanghai.aliyuncs.com ",883,2 +CLIENTID2:"2345 securemode=3,signmethod=hmacsha,timestamp=789 ", 2 +USER2PWD:"8l6aJwu76R8rhUgkM9s5&PKsOCgQwa6s","48fa2dc5666539f24a7 8fdabc2787dec2",2 +UTOPU2:,"/PKsOCgQwa6s/8l6aJwu76R8rhUgkM9s5/TEST",,,2 +UTOSU2:,"/PKsOCgQwa6s/8l6aJwu76R8rhUgkM9s5/TEST",,2 +WILL2:"","payload",,,2 +CLENSESSION2:,2 +MQTT2KEEP:3,2 ------------SOCKET_3-----------+IP2PORT:"iot.eclipse.org",883,3 +CLIENTID2:"clientid",3 +USER2PWD:"username","userpwd",3 +UTOPU2:,"pub",,,3 +UTOSU2:,"sub",,3 +WILL2:"","payload",,,3 +CLENSESSION2:,3 +MQTT2KEEP:3,3 ------------SOCKET_4-----------+IP2PORT:"iot.eclipse.org",883,4 +CLIENT2ID:"clientid",4 +USER2PWD:"username","userpwd",4 +UTOPU2:,"pub",,,4 +UTOSU2:,"sub",,4 +WILL2:"","payload",,,4 +CLENSESSION2:,4 +MQTT2KEEP:3,4 29
6 阿里云直连 T 指令 6.T+LYMQTT 阿里云直连(目前仅支持一机一密) 注意 如需使用默认的 IP 端口 即由程序生成相应的 IP 需要配置对应通道的 T+IPPORT 指令使其 IP 为空 例如配置通道二 T+IPPORT="",883,2 格式 T+LYMQTT=,"","C","D"[,E] 模式使能 取值范围 -2 一机一密 一型一密 2 自动注册 字符串:PorductKey C 字符串:DeviceSecret(= 或 时);ccessKey ID(= 或 2 时) D 字符串:DeviceName(= 时);ccess Key Secret(=2 时) E 可选参数 范围 ~4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +LYMQTT:,"","","", 配置 T+LYMQTT=,"","","", 设置第一路的阿里云 MQTT 直连参数 T+LYMQTT? +LYMQTT:,"","","", +LYMQTT:,"","","",2... 6.2T+LYREGIONID 阿里云直连的 RegionID 格式 T+LYREGIONID=""[,] RegionID 例如 cn-shanghai 一般不改 可选参数 范围 ~4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +LYREGIONID:,"","","", 配置 T+LYREGIONID="cn-shanghai", 设置第一路的阿里云的 RegionID T+LYREGIONID? +LYREGIONID: "cn-shanghai", 3
+LYREGIONID: "cn-shanghai",2... 7 HTTP T 指令 7.T+HTTPEN HTTP 模式配置 格式 T+HTTPEN=,,C,D 取值范围 ~4 分别代表 4 个 socket 通道 方法选择 取值范围 - POST GET C 包头保留 取值范围 - 不返回包头 返回包头 D 重连机制 取值范围 - 目前均为立即重连 断开后等待有数据才发起连接 断开后立即重连 默认值 +HTTPEN:,,, 配置 T+HTTPEN=,,, 设置第一路 HTTP 参数 T+HTTPEN? +HTTPEN:,,, +HTTPEN: 2,,,... 7.2T+HTTPURL HTTP URL 配置 格式 T+HTTPURL=, 范围 ~4 分别代表 4 个 socket 通道 URL 字符串 默认值 +HTTPURL:, 配置 T+HTTPURL=,/EventTransfer/SetCPObject_RemeberDevice 3 设置第一
个通道 HTTP 的 URL T+HTTPURL? +HTTPURL:,/EventTransfer/SetCPObject_RemeberDevice +HTTPURL: 2,... 7.3T+HTTPHED HTTP HED 配置 格式 T+HTTPHED=, 范围 ~4 分别代表 4 个 socket 通道 HTTP 报文的 HED 组成部分 其中 Host 字段以及 POST 方式下的 Content-Length 字段由程序自动生成 默认值 +HTTPHED:, 配置 T+HTTPHED=,Connection: Keep-live 设置第一路连接的 HTTP HED T+HTTPHED? +HTTPHED:,Connection: Keep-live +HTTPHED: 2,... 8 网络业务/保活 T 指令 8.T+DTUID 注册包设置 格式 T+DTUID=,,C,"D"(,E) 注册包模式 取值范围 -3 不启用注册包 仅连接时上传 2 和数据一起上传 在数据前 3 包括,2 注册包内容 取值范围 -2 32
自定义注册包 IMEI(5 位模块对应的唯一识别码)(选取该位后 格式为 SCII 字符) 2 ICCID(2 位 SIM 卡对应编码)(选取该位后 格式为 SCII 字符) C 数据输入格式 取值范围 - SCII 格式 HEX 格式 D 数据内容 最大长度为 52yte E 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +DTUID:,,,"tas" 配置 T+DTUID=,,,"dtuid" 通道 配置 返回 T+DTUID=,,,"dtuid",2 只配置通道 2 查询所有 T+DTUID? 返回 +DTUID:,,,"dtuid", +DTUID:,,,"dtuid2",2... 注意 随数据上传的注册包与数据转换功能相互冲突 即与 TCP Modbus 功能冲突 不 能同时使用 8.2T+KEEPLIVE 心跳包设置 格式 T+KEEPLIVE=,,"C"(,D) 心跳时间间隔 取值范围 -65535 不启用 -65535 固定时间间隔 单位秒 数据输入格式 SCII 模式 HEX 模式 C 数据内容 最大长度 256 固件 3.4. 之后版本支持特殊含义字段 例如$(IMEI) $(ICCID) $(TIME) $(CSQ)等(格式为 SCII) D 可选参数 范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +KEEPLIVE:,,"ping" 配置 T+KEEPLIVE=6,,"keepalive" 通道 33
配置 返回 T+KEEPLIVE=6,,"keepalive",2 只配置通道 2 查询所有 T+KEEPLIVE? 返回 +KEEPLIVE: 2,,"keepalive", +KEEPLIVE: 2,,"keepalive",2... 注意:由于长时间不发送数据 基站会把设备提掉线 所以即便关闭心跳 设备如果检测到 连续 分钟没有数据从串口上行到网络 且也没有网络数据下行到串口 设备会主动发送 一条内容为 HEX 的心跳报到服务器 注意 心跳时间不建议设置的过长,最好再 6-6 秒之间 DTU 的业务心跳有检测网络状态 的功能 每次心跳都是一次对网络状态的检测 且默认业务心跳是开启避让功能的 即有数 据从串口发送到网络 或者有数据从网络发送到串口 心跳的时间都会重新刷新 并不会耗 费太多流量 8.3T+HERTDODGE 业务心跳避让功能 格式 T+HERTDODGE=, 业务心跳避让开关 避让 不避让 所设置的通道号 -4 默认值 +HERTDODGE:, 配置 T+HERTDODGE=, 返回 T+HERTDODGE? +HERTDODGE:, 注意 心跳避让指的是 有业务数据的时候 串口数据上行到服务器或服务器数据下发到 串口 都会刷新业务心跳时间 关闭避让后 对应通道的 设置为 后 业务心跳会定时 发送 不会因为业务数据的刷新时间 8.4T+RESTIME 定时重启设置 格式 T+RESTIME= 34
定时重启时间 单位秒 范围 -2592 达到设定的时间 模块自动重启 说明 定时重启时间为 为关闭此功能 默认值 +RESTIME: 配置 T+RESTIME=3 返回 T+RESTIME? +RESTIME: 3 8.5T+RELINKTIME 重连间隔设置 格式 T+RELINKTIME= 重连间隔 单位秒 范围 3-6 检测到掉线到重连的间隔 说明 如果重连间隔设置过短 当服务器出现问题时设备会不停重连而消耗流量 默认值 +RELINKTIME: 3 配置 T+RELINKTIME=3 返回 T+RELINKTIME? +RELINKTIME: 3 8.6T+DSCTIME 连接超时设置 格式 T+DSCTIME= 连接超时 单位秒 范围 6-6 在设定时间内没连上配置的服务器则重启模块. 说明 如果超时重启间隔设置过短 有可能导致在网络条件较差的情况下连不上服务器 而一直重启 该功能不能关闭 不能让设备处于长时间断开连接的状态 默认值 +DSCTIME: 3 配置 T+DSCTIME=6 T+DSCTIME? 35
返回 +DSCTIME: 6 8.7T+CKTIME 网络数据超时设置 格式 T+CKTIME= 网络数据超时时间 取值范围,6-65535 不启用该功能 6-65535 单位秒 超过所设时间未收到网络数据则重启模块 说明 在设置时间内 如果没有检测到有网络数据下发到设备 设备会认为当前网络连 接出现问题 会重启设备 默认值 +CKTIME: 65535 配置 T+CKTIME=6 返回 T+CKTIME? +CKTIME: 6 8.8T+PORTTIME 串口数据超时设置 格式 T+PORTTIME= 串口数据超时时间 取值范围,6-65535 不启用该功能 6-65535 单位秒 超过所设时间未收到串口数据则重启模块 说明 适用于串口有数据会主动上报 或者设置了自定义轮询的场景 如果串口数据超 时时间设置过短 且串口不会主动上报数据时 会导致模块频繁重启 默认值 +PORTTIME: 3 配置 T+PORTTIME=6 返回 T+PORTTIME? +PORTTIME: 6 36
9 网络数据 T 指令 9.T+CCHE 缓存保存功能 格式 T+CCHE= 缓存保存使能 取值范围 -2 不开启缓存保存 发送数据失败后会重发 数据以队列形式存储 开启缓存保存 数据以队列形式存储 2 无缓存功能 发送数据失败不重发 用于传输图片 视屏等大量数据 时需要调成该模式 默认值 +CCHE: 配置 T+CCHE= T+CCHE? +CCHE: 说明 最多缓存 K 数据 9.2T+TCPMODUS Modbus RTU 转 TCP 功能 格式 T+TCPMODUS=(,) 转换使能 取值范围 - 不开启转换 开启转换 将串口接收到的 Modbus RTU 数据转换成 Modbus TCP 数 据发送给服务器 反之将服务器下发的 Modbus TCP 数据转换成 Modbus RTU 数据之后发送给串口 可选参数 取值范围 -4 分别代表 4 个 socket 通道 省略时仅配置通道 默认值 +TCPMODUS:,,, 配置 T+TCPMODUS=,4 开启第四条轮询指令 T+TCPMODUS? 37
+TCPMODUS:,,, 注意 该功能与注册包随数据发送相冲突 9.3T+TCPHEX 服务器 HEX 转换 格式 T+TCPHEX=(,) 转换使能 取值范围 - 不开启转换 开启转换 开启转换时 服务器下发的数据会被转换为 HEX 下发到串 口 串口收到的数据会被转换为 SCII 发送到服务器 可选参数 取值范围 -5-4 分别代表 4 个 socket 通道 省略时仅配置通道 默认 5 代表短信通道 默认值 +TCPHEX=,,,, 配置 T+TCPHEX=, 开启第一路的 HEX 转换 T+TCPHEX? +TCPHEX:,,,, 说明 该功能打开后 串口发送 HEX 字符串 x2 x34 x56 网络端会收到 x3 x32 x33 x34 x35 x36 既实现了串口端发送 HEX 格式的 23456 服务器收到 SCII 格式的 23456 如果串口端发送 SCII 格式的 23456 也就是发送 HEX 格式的 3 32 33 34 35 36 那么服 务器会收到 HEX 格式的 33 3 33 32 33 33 33 34 33 35 33 36 SCII 格式的 33233343536. 也就是说该功能会把串口端收到的数据转换为 SCII 格式发送到网络 同理网络端发送的数 据会被转换为 HEX 格式发送到串口 注意 该功能打开后 如果网络端下发的数据不符合 HEX 数据的格式 如果出现了 -9 a-f,-f 之外的数据 该功能将不会生效 本帧数据会原样下发 同时该功能打开后 Modbus RTU 转 Modbus TCP 的功能也同样有效例如 服务器发送 SCII 格式的数据 6 3 串口收到 HEX 格式的数据 3 84 同理 如果串口发送 HEX 格式的 3 2 2 38 5 服务器收到 SCII 格式的 5 3 2 2 38
9.4T+SENDID 多路数据协议区分配置 类型 特殊指令 格式 T+SENDID= 使能参数 范围 ~ 代表开启协议区分使能 当使能开启时 串口收到数 据包的第一个字节将作为通道区分位 字符, 2, 3, 4 分别代表数据通 道,2,3,4 字符 5 代表短信通道 其余字符则数据会向所有通道发送 在开启使能后情况如下 例 串口收到数据 2TSTEK,那么 DTU 会向通道 2 所配置的连接传输字符串 TSTEK ; 例 2 串口收到数据 5TSTEK,那么 DTU 会向短信透传参数中的目标号码发送内 容为字符串 TSTEK 的短信; 例 3 串口收到数据 TSTEK,那么 DTU 会向所有配置的数据通道 不包括短信 发送字符串 STEK,由于第一个字符被当做通道号了,所以会被去掉; 例 4 DTU 接收到通道 2 配置连接所下发的数据时 如果收到数据为 SERVER, 那么 DTU 会向串口发送字符串 2SERVER,其中 2 为 DTU 自动添加的通道号 默认值 +SENDID: 配置 T+SENDID= T+SENDID? +SENDID: 9.5T+TRCE 配置各通道数据关联,仅当串口 2 的功能配置为数据透传时 该指令所配置的功能才生效 格式 T+TRCE=, 数据通道 取值范围 -6 同时设置所有通道 通道 数据关联性 2 通道 2 数据关联性 3 通道 3 数据关联性 4 通道 4 数据关联性 5 短信通道数据关联性 6 串口间数据关联性 此情况下 为非 时 两个串口数据相互转发 为 时则两个串口数据无关联 数据关联性 39
2 同时接收串口 和串口 2 的数据 接收来自串口 的数据 接收来自串口 2 的数据 默认值 +TRCE:,,,,, 配置 T+TRCE=2, 配置通道 2 数据仅来自串口 T+TRCE? +TRCE:,2,,,, 注意 请认真了解该指令 否者配置后会影响正常使用 可以恢复出厂设置解决 GPS T 指令.T+GPS 查询基站信息 类型 特殊指令 说明 查询基站信息 T+GPS +GPS: Lac:x58b,CellId:xb8aa2 注意:该 GSP 信息是通过基站定位换算得到的 定位并不一定精确 刷新频率为 分钟一次.2T+GPSINFO 查询经纬度 类型 特殊指令 说明 查询经纬度信息 配置 T+GPSINFO +GPSINFO: 3.84295,2.24433 注意 如果打开 GPS 模块定位功能 该指令获得的是 GPS 模块定位数值 否者为基站定位结 果 4
.3T+URT2CFG 配置通道 2 功能 格式 T+URT2CFG= 取值范围 -2 不启用 通道 2 作为数据透传通道 2 通道 2 作为 GPS 数据通道 默认值 +URT2CFG: 配置 T+URT2CFG=2 T+URT2CFG? +URT2CFG: 2 注意 该功能打开的话 将不会进入低功耗 如果需要 GPS 模块定位的话 需要打开该串口.4T+GPSCFG 配置 GPS 功能 格式 T+GPSCFG=,,C,D GPS 模式 单字节从最低位到高位分别为 GPS 总开关 第一到第四路上报开关 串口定时上报开关 高 2 位保留不生效 b 不开启 GPS 总开关及任何通道 b 开启 GPS 总开关 不开启串口及网络上报 3 b 开启 GPS 总开关 不开启串口上报 开启通道 上报 3 b 开启 GPS 总开关 不开启串口上报 开启通道 2,3 上报... 以此类推 上报周期 单位秒 > 超时后往设置的通道上报定位信息 C 初始化超时 单位秒 无论 GPS 是否初始化成功 不会重启 >6 如果设定时间内 GPS 没有初始化成功则重启模块 D GPS 信息上报格式 GPRMC 格式 GRMC 格式 2 GNRMC 混合模式 3 GP 经纬度格式 4 G 经纬度格式 5 GN 混合模式经纬度格式 4
默认值 +GPSCFG:,6,, 配置 T+GPSCFG=3,6,6, T+GPSCFG? +GPSCFG: 3,6,6, 物模型数据点采集 T 指令.T+POLL 轮询使能 格式 T+POLL=,,C 自定义轮询使能 取值范围 - 关闭数据采集功能 开启字串采集 透明上报 2 寄存器采集 JSON 上报 轮询时间间隔 取值范围 -65535 表示每条启用指令间的时间间隔 单位秒 C 轮询数据输入格式 取值范围 - SCII 格式 设置为 表示之后输入的轮询指令均为以 SCII 形式轮 询 即输入什么字串就轮询什么字串 HEX 格式 设置为 表示之后输入的轮询指令需要满足 HEX 格式 轮 询时会自动转成 6 进制对应的 SCII 字串 默认值 +POLL:,, 配置 T+POLL=,, T+POLL? +POLL:,, 注意 只有在透传模式 同时网络连接已经建立的时候才会有轮循 42
.2T+POLLSTR 轮询字串设置 格式 T+POLLSTR=,,C,"D" 轮询字串号 取值范围 - 字串轮询使能 取值范围 - 禁用该条轮询 启用该条轮询 C 字串 CRC 使能 取值范围 - 无操作 对所输入字串进行 Modbus CRC 校验并在轮询时添加在字串末尾 D 轮询字串数据 如果在 T+POLL 指令中设置了 HEX 标志位为 那么必须以 6 进制输入 轮询时自动转换成 IN 格式(例 所输入字串为"3323344243" 实际轮询的字串为"23C") 具体字符对应关系可以对照以下网址 http://ascii.9cha.com/ 默认值 +POLLSTR:,,,"33233" +POLLSTR:2,,,"44243"... 配置 T+POLLSTR=4,,,"33233" 开启第四条轮询指令 说明 如果需要配置特殊字符的话 可以配置整个字串转为 HEX 配置进去.3T+JSONCFG 轮询 JSON 使能配置 格式 T+JSONCFG=,[,"C",D,E] 轮询字串号 取值范围 - 轮询使能 取值范围 - 不开启 JSON 转换 开启 JSON 转换 开启该使能后 POLLSTR 的使能不再起作用 C JSON 关键字 D 数据来源 取值范围 - Modbus RTU 可以根据 Modbus 协议进行数据解析 自定义 E 固定为 备注 所有打包类型最终数据均会增加一个 Device_ID 字段 对应设备的 Device_ID 例如 Device_ID: 8645236985435,如果不想要的话可以吧设备 ID 设置为空 配置 T+JSONCFG=,,"name",, 43
T+JSONCFG? +JSONCFG:,,"r3",, +JSONCFG: 2,,"r4",, +JSONCFG: 3,,"r7",, +JSONCFG: 4,,"r2",,.4T+REGCFG 轮询 JSON 寄存器配置 格式 T+REGCFG=,,C,D,E,F,G,H,I, J,K,L 轮询字串号 取值范围 - 从站地址 取值范围 -255 C 功能码 -4,2 开关量 暂无 3,4 模拟量 D 寄存器地址 取值范围 -65535 E 数据长度 取值范围 2 或 4 字节 F 数据格式 取值范围 -6 6 位 有符号数 6 位 无符号数 2 6 位 按位读取 3 32 位 有符号数 4 32 位 无符号数 5 32 位 浮点型数 G 布尔值所在位置 取值范围 -6 仅 6 位 按位读取生效 H 字节顺序 取值范围 -4 仅 32 位 浮点型数生效 CD CD 2 DC 3 DC I 保留小数点位数 取值范围-9~9 正数小数点左移 负数小数点右移. J 是否添加单位 K 是否包含引号 不包含引号 数据增加引号 L 串口轮询间隔 取值范围>5ms 轮询完该条指令后经过多久轮询下一条(单 位毫秒) 注意 数据左移 会保留 2 位小数位 如果小于 2 位 则会上报. 例如本来寄存器数 据为 2 左移 2 位为.2 左移 3 位就变为了. 44
配置 T+REGCFG=,,3,,4,5,,,-3,"",,2 T+REGCFG? +REGCFG:,,3,,4,5,,,-3,"",,2 +REGCFG: 2,,3,,4,5,,,-3,"",,2 +REGCFG: 3,,3,,4,5,,,-3,"",,2 +REGCFG: 4,,3,,4,5,,,-3,"",,2... 注意 只有在透传模式 同时网络连接已经建立的时候才会有查询指令.5T+JSOSNSPEED 配置 JSON 携带 GPS 速度信息,仅当设备带有 L26C 定位模块 且打开 GSP 下 该指令所配置的功能才 生效 格式 T+JSONSPEED=,, C 使能位 json 数组不携带 GPS 速度信息 json 数组携带 GPS 速度信息 json 携带速度的数据格式 代表字符串类型 代表浮点型(步长.) C JSON 速度信息的 KEY 字串 默认值 +JSONSPEED=, 配置 T+JSONSPEED=,, Speed T+JSONSPEED? +JSONSPEED:,, Speed 如上述设置后 JSON 上传的时候会携带 GPS 速度信息 需要注意的是 该条指令需要在 GPS 信息总开关打开后才有效(T+GPSCFG) 在没有得到速度信息时上报的速度为 (版本 3.6.8 后添加该指令 )在没有获得 GPS 速度的时候 会上传..6 T+JSOSNLOCTION 配置 JSON 携带位置信息,仅当设备带有 L26C 定位模块 且打开 GSP 下 该指令所配置的功能才 生效 格式 T+JSONLOCTION=,, C, D 45
使能位 json 上报不携带 GPS 定位数据 json 上报携带 GPS 数据 格式位 上报字符串经纬度 上报字符串 RMC 2 分开上报浮点型经纬度 C 格式位为 或 的时候 Key 字符串 D 格式为 2 的时候 经度对应的 Key 字符串 默认值 +JSONLOCTION=,2, Longitude, Latitude 配置 T+JSONLOCTION=,2, Longitude, Latitude T+JSONLOCTION? +JSONLOCTION:,2, Longitude, Latitude 如上述设置后 JSON 上传的时候会携带 GSP 定位信息 需要注意的是 该条指令需要在 GSP 信息总开关打开后才有效(T+GPSCFG) 在没有得到定位信息时上报的内容为 (版本 3.6.8 后添加该指令).7 T+JSOSNTIME 配置 JSON 携带 GPS 时间信息,仅当设备带有 L26C 定位模块 且打开 GSP 下 该指令所配置的功能才 生效 格式 T+JSONTIME=, C 使能位 json 上报不携带 GPS 时间 json 上报携带 GPS UTC 格式时间 时间格式 字符串格式 浮点型. C JSON 时间信息的 KEY 字串 默认值 +JSONLOCTION=, UTC 配置 T+JSONLOCTION=,, UTC T+JSONLOCTION? +JSONLOCTION:,, UTC 如上述设置后 JSON 上传的时候会携带 GSP 时间信息 需要注意的是 该条指令需要在 GSP 信息总开关打开后才有效(T+GPSCFG) 在没有得到 GPS 信息时上报的内容为. (版 本 3.6.8 后添加该指令) 46
.8 T+JSONPUTIME 配置 JSON 每组上报周期 格式 T+JSONPUTIME= 每组上报的间隔 单位秒 默认值 +JSONPUTIME=, 配置 T+JSONPUTIME=3 T+JSONLOCTION? +JSONLOCTION: 3 如上述设置后 3 秒上传一次 json 数据.9 T+JSONFORMT 配置 JSON 打包方式 格式 T+JSONFORMT= 自定义打包 阿里云 link Json 2 OneNET Studio 打包方式 默认值 +JSONFORMT= 配置 T+JSONFORMT= T+JSONFORMT? +JSONFORMT: 2 短信 T 指令 2.T+WORKMODE 短信透传模式设置 类型 特殊发送指令 格式 T+WORKMODE= 模式使能 取值范围 -3 仅数据透传模式 47
2 仅短信透传模式 数据透传模式下 支持短信 T 配置参数 此项不包含短信透传功能 3.. 之后的版本默认都支持短信 T 配置 不用再配置成该模式 3 既有数据透传 也有短信透传 默认值 +WORKMODE: 配置 T+WORKMODE= 返回 T+WORKMODE? +WORKMODE: 2.2T+SMSSEND T 指令发送短信功能 格式 T+SMSSEND="",,C,"D" 目标号码 目前仅支持单个号码 默认为 C 数据输入格式 SCII 模式 HEX 模式 D 数据内容 最大长度 256 字节 配置 配置 T+SMSSEND="37XXXXXXXX",,,"TSTEK" T+SMSSEND="37XXXXXXXX",,,"5445354454" (实际发送内容为 TSTEK) 2.3T+REVNUM 设置短信透传号码 36X 设备目前后两个参数不起作用 所以不需要设置后两个参数 格式 T+REVNUM=""(,,C) 为手机号码 可以同时输入多个手机号 中间以分号(;)分隔 发送数据的编码格式 可省略 UTF7 纯英文数字编码 IN 二进制 发送什么 对方收到什么 2 Unicode 大端模式 3 UTF8 48
4 G232 一般串口助手的编码为 G232 C HEX 模式选择 可省略 直接发送数据 将数据转为 HEX 例如收到"2" 转为 x x2 发送 默认值 +REVNUM: "86",4, 配置 T+REVNUM="3888888888;86",4, T+REVNUM? +REVNUM: "86",4, 3SIM 卡 T 指令 3.T+ICCID 查询 ICCID 号 类型 特殊指令 配置 T+ICCID +ICCID: 89864389254942 注意 未识别到卡的时候返回 ERROR 3.2T+CSQ 查询信号强度 类型 特殊指令 说明 第一个参数为信号强度 取值范围 -3 一般信号需要在 6 以上为正常 T+CSQ +CSQ: 3,99 49
3.3T+CPIN 查询是否识卡 类型 特殊指令 说明 查询 SIM 卡是否识别 T+CPIN +CPIN: REDY (识卡) T+CPIN +CME ERROR (未识卡) 3.4T+CSTT PN 设置 格式 T+CSTT="","","C"[,D] 接入点 PN 帐号 C PN 密码 D PN 类型 (固件 3.2.6 以后支持) 公网 PN 专网 PN 无加密 2 专网 PN PP 加密 3 专网 PN CHP 加密 默认值 +CSTT: "","","", 配置 T+CSTT="","","", 返回 T+CSTT? +CSTT: "","","", 注意 PN 开启后 NTP 时间同步 ＯＴＡ远程升级功能将无法使用 2 第一次连接 PN 或者由 PN 切换为正常运营商的时候 第一次连接耗时较长 3 分 钟 3 L768H 模块 3.4.5 版本如果 PN 类型有加密 则需要短接 QL 与 3.3V 5
3.5T+TIME 查询实时时间 类型 特殊指令 说明 查询实时时间 仅注册上基站后生效(固件 3.2.6 以后支持) 配置 T+TIME +TIME: "2/3/9,4:38:34" 3.6T+TIMESTMP 查询实时时间戳, 类型 特殊指令 说明 查询实时时间 仅注册上基站后生效(固件 3.4. 以后支持) 附 https://tool.lu/timestamp/ 配置 T+TIMESTMP +TIMESTMP: 58884264 4 设备信息 T 指令 4.T+CGMR 查询版本号 类型 特殊指令 T+CGMR Revision: TS-LTE-36_2..4_D976 4.2T+GSN 查询 IMEI 号 类型 特殊指令 T+GSN 5
865542784 4.3T+DEVICEID 配置模块标识符 类型 特殊指令 格式 T+DEVICEID= 字符串类型 配置 T+DEVICEID="tastek" T+DEVICEID? +DEVICEID: "$(IMEI)" 4.4T+SLEEP:设置设备休眠使能 用于通过串口设置设备的休眠功能 (3.6.8 以后的版本具有该功能) 格式 T+SLEEP=E E 休眠使能位 的话设备不会休眠 设备会休眠 配置 T+SLEEP= 回复 配置 T+SLEEP? 回复 +SLEEP: 设置休眠后 无串口数据 网络下行数据 设备会自动进入休眠降低功耗 有串口数据或网 络下行数据的时候会主动唤醒设备 当 GPS 功能打开的时候 设备将无法进入休眠状态 52
版本历史 日期 版本 变更描述 作者 22-2-7 3.7.5 塔石云 Tastek 53
联系方式 公司 塔石物联网科技有限公司 地址 杭州市萧山区金城路 288 号 高运汇丰大厦 6 楼 网址 客户支持邮箱 support@tastek.cn 销售邮箱 sales@tastek.cn 品牌愿景 以互联网思维带动物联网的发展 公司文化 塔石人做踏实事 产品理念 容易上手 价格公道 价值观 认真倾听客户的需求和想法 微信 54