YeeCOM移讯通DTU基本配置指令教程(详细版) 1.概述2G/4G/5G/NB-IoT/WIFI DTU 配置指令功能和参数说明可通过移讯通串口配置工具或任意串口工具、短消息、后台中心服务器三种方式对 DTU 进行配置和查询只需一次配置后 DTU 可以根据配置的参数自动运行相关模式和功能2 DTU配置方式注意1除主中心地址为必配参数其他参数都可使用默认值或根据需求选配注意2参数设置后永久保存自动按配置功能运行注意3特殊配置指令可通过DTU命令发送框手动发送配置注意4编辑好参数后可一键保存参数脚本,后续加载和配置更方便2.1 配置工具/AT 命令本地配置设备出厂参数配置或设备调试时先将设备通过串口线与电脑连接然后使用我司配置工具发送命令即可轻松配置参数作用和具体值请参考后面指令说明配置工具如下图:本图供参考按键位置功能可能有变动或优化备注 1如果忘记 DTU 波特率是多少怎么办?a.可以打开配置工具将串口波特率设置为9600无校验8 位数据1 位停止位无流控(注意串口收发是否正常),点击配置工具按键“配置模式”并 DTU 重新上电。正常进入配置模式 DTU 会输出如下字符串可以对相关参数修改和配置Enter Configure Mode备注2特殊配置指令可以通过DTU命令发送框手动发送配置即可也可一键保存参数方便后续加载配置详细参考下面指令说明2.2 短消息远程短信配置该方式适合当数据中心服务器出现故障DTU无法连接服务器时可以用手机或SIM卡管理平台以短信方式配置DTU。(需设备卡支持短信,大部分物联卡不支持短信)NB-IoT/WIFI设备不支持短信功能2.3 后台服务器远程远程软件配置当DTU已经连接到后台服务器中心端以后中心端可以根据需要配置或查询DTU的参数。3DTU基本命令及参数设置命令格式AT*命令参数 1,…,参数 n#查询命令格式AT*命令备注1设置命令以AT*开头以#作为结束标志,串口发送AT命令后面要跟回车符查询命令以AT*开头以?作为结束标志备注2设置命令执行成功返回OK\r\n,执行失败返回ERROR\r\n,查询命令执行成功返回命令:参数1,…,参数n\r\nOK\r\n执行失败返回ERROR\r\n,备注3一条命令需一次性发给DTU不可分开发送支持多条指令可一起编辑和发送3.1 DTU 工作模式命令描述用来配置 DTU 的工作的协议模式*默认固定为 12023 年后版本请在各中心通道协议类型配置同时也向前兼容以前版本*当前已支持 HTTP/MQTT/FTP/阿里云/中移云/百度云/电信云等,部分型号支持 HTTPS/MQTTS/WebSocket3.2 中心协议类型,地址和端口(必配)命令描述配置中心服务器连接协议类型,地址和端口参数说明:n:第几路连接最大 6 路 n 范围为 0-5协议模式中心服务器协议类型0-TCP 透传传输1-UDP 透传传输2-TCPTLS 透传传输8-HTTP 协议9-标准 MQTT 协议模式10-MQTT 阿里云 IoT11-MQTT 中移 Onenet 云12-YeeCOM 物联云13-HTTPS14-MQTTS19-WebSocket20-WSSx-其他定制协议ip addr连接的服务器中心端地址支持域名和 IP(请用固定 IP) port: 连接的服务器中心端端口号。配置中心通道0连接标准 MQTT 地址端口AT*SERVER09,47.94.253.148,1883#例 2配置中心通道1连接阿里云地址端口AT*SERVER110,a1LAovXod.iot-as-mqtt.cn-shanghai.aliyuncs.com,1883#3.3 DTU 在线模式命令描述用来配置 DTU 的连接在线模式参数说明:mode0-离线模式DTU 不做连接请求mode1-永远在线模式默认值DTU 加电之后一直和数据中心保持连接断线自动重连无数据传输时定时发送心跳包mode2-唤醒在线模式DTU 加电不上线当接到唤醒短信、唤醒电话或唤醒 AT 命令的时候自动连接上线唤醒上线后如果连续 300s(可以配置)没有数据传输即下线mode3-按需在线模式DTU 加电不上线当串口有数据发送时即触发 DTU 自动上线然后发送数据如果连续300s(可以配置)没有数据传输即下线。mode4-周期在线模式DTU 按配置的周期自动上线和下线参数可配置参考指令AT*SCHTIME指令举例:AT*GPRSMODE1#3.4 DTU 中心模式命令描述用来配置 DTU 连接多个中心地址 IP 和端口的模式参数说明:mode0-单主中心DTU 只连接主中心和数据传输mode1-主备中心切换首先连接主中心如果主中心不能连接则连接备中心保证数据可靠传输默认配置mode2-主备中心同时连接支持同时连接主中心和备中心支持多个中心地址同时数据传输mode3-主备中心同时连接各通道,独立分开传输//只往地址 1 发送数据SNDPORT1data//只往地址 2 发送数据SNDPORT2data//地址 1 收到数据输出格式为RCVPORT1data//地址 2 收到数据, 输出格式为RCVPORT2data如果为不带前缀的数据将发送所有通道moden-其他定制通道模式说明 1:多中心模式会增加数据流量开销请做好流量计算说明 2:多中心模式,如果其中 1 个中心配置了,但是服务器是关闭状态,DTU 会不断尝试连接该中心也会引起较大数据流量开销。指令举例:AT*CHMODE3#//配置为主副独立传输模式SNDPORT1123test//只往中心地址 1 发 123test 数据RCVPORT1456abc//收到中心地址 1 的 456abc 数据3.5 DTU 调试模式命令描述用来配置 DTU 的调试信息模式参数说明:mode0-关闭模式没有 DTU 调试信息输出默认配置mode1-联网状态回显模式实时向串口输出网络连接发送接收掉线状态信息可供外设实时监测当前设备运行联网状态提示输出有如下信息输出GPRS INIT OK//网络初始化完成GPRS CREATE OK//网络 scoket id 创建成功GPRS CREATE ERR//网络 scoket id 创建失败GPRS TYPE ERR//连接服务器地址类型错误GPRS CONNECT OK//网络 scoket 连接服务器地址端口成功GPRS CONNECT ERRn//网络 scoket 连接服务器地址端口失败GPRS SEND OK%d//网络 scoket 发送数据到成功GPRS SEND ERR%d//网络 scoket 发送数据到失败GPRS CLOSE OK//网络 scoket 关闭GPRS RECV OK%d//网络 scoket 接收到服务器数据GPRS REG OK//网络注册包应答返回mode2-TRACE 调试模式实时输出 DTU 运行的 TRACE 信息此模式仅用于前期调试产品发布或连接外设时请关闭该模式否则可能引起 Trace 信息数据输出给外设干扰正常运行mode3-在线离线提示模式实时向串口输出连接到服务器或断开服务器的提示信息方便外设判断 DTU 当前在线离线状态提示输出格式ONLINE:n//连接到服务器OFFLINE:n//从服务器断开n:表示第几路中心地址,n1 为主中心3.6 DTU ID 配置命令描述DTU ID 配置参数说明:id用户可以根据自己需要设置 DTU ID 号如果用户没有配置默认会自动读取模块 IMEI 号作为 DTU ID 号DTU ID 最大长度 32 字节最小长度 1 字节DTU ID 也是将作为心跳包数据一部分。指令举例 1:AT*DTUIDYXT0001#指令举例 2:AT*DTUIDIMEI#//该配置会自动读取通讯模块 IMEI 作为设备 DTUID指令举例 3:AT*DTUIDICCID#//该配置会自动读取 sim 卡 ICCID 作为设备 DTUID3.7 带 DTU ID 上报数据命令描述该功能用来配置 DTU 发送到后台中心服务器的数据包是否自动带上 DTUID通过该功能服务器可以方便的识别收到的数据是哪台 DTUID 设备发送的参数说明:n0: 关闭带ID发送(默认)n1: 打开带ID发送指令举例:AT*DATAID1#开启该功能后发送到服务器的数据为DTU ID要上发的数据例如如果当前 DTUID 为 ABC123456 要发送的数据为 testdata111则服务器将收到的数据为ABC123456testdata1113.8 DTU 串口参数命令描述DTU 串口参数配置参数说明:baudrate:UART 波特率支持 1200、2400、4800、9600、14400、19200、38400、57600 和 115200默认值 9600dataBits:数据位5、6、7、8默认值8parity:校验位0-无校验、1-奇校验、2-偶校验、3-空格默认值0stopBits:停止位1、2、3(表示 1.5 位)默认值1flowControl:串口流控0-无流控1-硬件流控2-软件流控默认值 0指令举例:AT*UART9600,8,0,1,0#3.9 串口数据帧间隔时间命令描述当DTU在接收串口数据包之间间隔小于这个时间时会合并为一帧数据发送到服务器,大于间隔时间则表示串口数据帧结束,将封包发送;参数说明:time:串口数据帧间隔超时时间,范围为(10-5000ms),默认为100ms注 1:如果缓冲区收满最大字节缓存将强制发送数据帧。注 2:若用指令AT*DFLENn#配置了帧长度 n,则只要串口收到数据长度n 则将自动打包发送注 3:间隔时间也不能设置过大最好小于 1000ms过大会增加传输延时时间。指令举例:AT*DFI300#3.10 串口数据帧长度命令描述当DTU串口收到数据长度设置的数据帧长度时,则将自动打包发送;参数说明:n:串口数据帧长度,范围为(0, 5-最大包长度),默认为0-表示不使用数据帧长度发送;最大包长度:一次能发送的最大长度,一般为1k-8k,不同型号最大长度不一样;指令举例:AT*DFLEN20#//收到数据长度20 字节后,则自动发送帧数据3.11 心跳时间命令描述DTU 在永远在线模式下的心跳间隔时间配置如改时间无数据上报则启动心跳包发送参数说明:time:心跳间隔时间范围为(0-3600s)默认配置为 60s0 为不启用心跳包注意如果心跳时间配置为0则不发送心跳包不维持 DTU 始终在线链路DTU 在一段时间内没有数据收发时则可能断开连接断开连接自动重连。指令举例:AT*HBTIME60#//心跳时间 60sAT*HBTIME0#//关闭心跳包3.12 心跳包头命令描述永久在线模式下心跳包用来维持 DTU 和后台服务器的在线链路在一定时间内如果没有 GPRS 数据发送心跳包将自动发送一次心跳包心跳包头DTU ID默最大长度323264 字节默认格式其他格式见备注说明head:心跳包头编码为任意组合和长度小于 32 个字符的 ASCII 字符串也可以为空默认编码是三个$$$号,可以用来区分其他普通数据备注 1心跳包头加前缀HEX表示按 16 进制发送心跳数据命令格式AT*HBHEADHEX16进制数据字符串#指令举例:AT*HBHEADHEXFE112233445566#表示将16进制数据0xFE 0x 11 0x 22 0x 33 0x 44 0x 55 0x 66作为心跳包备注 2心跳包头加前缀NID表示不DTU ID发送命令格式AT*HBHEADNID字符串#指令举例:AT*HBHEADNID123abc#表示将123abc作为心跳包:3.13 注册包模式命令描述当 DTU 一旦 TCP/UDP 链路建立成功后将发送首次注册包给数据中心数据中心接收到注册包并分析完后就可以判断当前连接的合法性和确定对应的 DTU 终端并与之建立可靠稳定的数据传输参数说明:mode0关闭注册包mode1注册包DTUID默认值注册包注册包DTU ID最大长度323264 字节。mode2只发送注册包以 ASCII 文本模式发送注册包mode3只发送注册包以 16 进制形式发送注册包mode5该模式 MQTT 协议也发送注册包其他模式 MQTT 协议不发注册包moden其他定制格式指令举例:AT*REGPKG1#3.14 注册包命令描述注册包配置当 DTU 一旦 TCP/UDP 链路建立成功后将发送首次注册包给数据中心数据中心接收到注册包并分析完后就可以判断当前连接的合法性和确定对应的 DTU 终端并与之建立可靠稳定的数据传输参数说明:text:注册包编码为任意组合和长度小于 64 个字符的 ASCII 字符串也可以为空默认编码是三个号,可以用来区分其他普通数据指令举例:例如配置注册包为AT*REGHEAD31323334#注册包模式1时注册包为31323334dtuid注册包模式2时注册包为31323334注册包模式3时注册包为16进制的0x31 0x32 0x33 0x343.15 接入点 APN 网关命令描述移动数据接入点配置,国内普通卡一般无需配置 apn默认值即可专网卡或国外使用一般需要配置 APN根据卡商提供参数配置即可参数说明:专网卡或国外使用用户需要根据使用的运营商手机卡配置相应的 APN 网关. 默认配置CMNET, , ,。指令举例:AT*APNcmnet,user,pwd#3.16 DTU 唤醒命令命令描述当 DTU 工作在唤醒模式下如果收到命令DTU 立即启动数据连接请求唤醒上线后如果连续一段时间(参考下线时间配置)没有数据传输即下线。3.17 DTU 离线命令命令描述当 DTU 在按需模式或者唤醒模式下如果收到该命令则连接主动断开连接并下线。3.18 自动下线时间命令描述DTU 在线模式2-唤醒在线或3-按需在线或4-周期在线模式下并连接上网以后如果超过该配置时间内没有数据收发则自动下线。参数说明:time: DTU 自动下线时间配置默认配置为 300s, 范围为(5-3600s)。3.19 周期在线周期命令描述DTU 在线模式4-周期在线时配置周期在线时间周期下线时间参考 AT*IDLTIME 指令命令格式AT*SCHTIMEtime min#参数说明:time min范围:1-9999单位分钟,默认 60 分钟指令举例:AT*SCHTIME5#//5 分钟上线一次AT*IDLTIME60#//上线后 60s 自动下线注配置工具可在资源里下载压缩包解压使用。