众山科技 DTU 串口控制模式通讯协议
众山科技 DTU 串口控制模式通讯协议
控制模式通讯协议/参数配置通信协议/远程参数配置通信协议 V2.3
<此文档所述的指令格式仅适用于我公司 201707 新版本云 DTU>
关键字：DTU、用户机、WIFI
一、 通讯接口
⚫ WIFI DTU 与用户机采 TTL 进行通讯
⚫ 串行端口默认为如下设置：
xx率 9600,8 位数据位，1 位停止位,不检验
ZS DTU 配置参数简介
当 WIFI DTU 收到配置参数命令后，如果格式/协议没有错误，则写入不掉电存储器中，并返回 00F0 命令（OK），否则返回 00F1 命令（ERROR）
**************DTU 参数配置命令具体格式指令如下****************
AA55<Length><CMD><DATA><ACC>
AA55： 包开始，固定为 0xAA55，2Byte。
Length：包长度，包括<Length>后面的所有字节数，2Byte。 CMD： 命令号，2Byte，文档下面详细解释各种命令的含义。 DATA： 数据，根据不同的命令可选，有不同的格式。
ACC： 累加和校验，为<Length><Cmd><Data>的累加和，自动溢出，2Byte。
注：所有多字节数据的传送顺序都是从高字节到低字节，所有的通讯数据包都必须按照上述格式进行封包，否则都视为无效包，不进行处理。
*************************************************************************
二．WIFI DTU 参数命令号（CMD）释义：
0090 设置云开关
Data：1Byte，HEX 格式，0x00 表示关闭，0x01 表示开启，默认开。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0092 设置云密码
Data：6Byte，ASCII 码表示，可以为任意 ASCII 码字符。
ID 为 “12345678” ， 则 Data 为 ：
0x31,0x32,0x33,0x34,0x35,0x36,0x37,0x38。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0091 DTU 云 ID (此项参数不允许用户自行修改，可作为查询使用)
0030 设置 DTU 身份识别 ID（自建数据中心一般需要设置）
Data ： DTU 的 8 位 ID 号， 8Byte ， ASCII 格式， 如 ID 为
“12345678”，
则 Data 为：0x31,0x32,0x33,0x34,0x35,0x36,0x37,0x38。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0031 设置数据采集中心登录口令
Data：登录口令，6Byte，ASCII 码表示，不限于数字，可以为任意
ASCII
码字符。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0033 设置WiFi 名称
Data：登录口令，6Byte，ASCII 码表示，不限于数字，可以为任意
ASCII
码字符。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0034 设置WiFi 密码
Data：最大支持 20 个字符，ASCII 码表示
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0040：设置通讯协议
Data：通讯协议，TCP 通讯或者 UDP 通讯，默认为 UDP-ZSD 通讯。
1Byte，HEX 格式，0x00 表示采用 TCP-ZSD 通讯，0x01 表示采用 UDP-ZSD 通讯，0x02 表示采用 TCP Client 通讯，0x03 表示采用 UDP
Master 通讯。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0041：设置主数据中心 IP 或域名
Data：IP 地址或域名，ASCII 格式，最长 32Byte。
对于支持多个中心的型号，设置多个中心地址时，采用逗号分隔
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0042：设置主数据中心侦听端口号
Data：端口号，十进制可见字符表达，最大 32Byte。
对于支持多个中心的型号，设置多个中心端口号时，采用逗号分隔
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0060：设置备用数据中心 IP 或域名
Data：IP 地址或域名，ASCII 格式，最长 32Byte。
对于支持多个中心的型号，设置多个中心地址时，采用逗号分隔
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0061：设置备用数据中心侦听端口号
Data：端口号，十进制可见字符表达，最大 32 字节。
对于支持多个中心的型号，设置多个中心端口号时，采用逗号分隔
0045：设置串口xx率
Data：xx率，ASCII 码表示，默认为“115200”。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0050：设置 DTU 登陆模式
Data：登陆模式，1Byte，HEX 格式，0x00 表示无登陆包，0x01 表示
有登陆包，中心无应答，0x02 有登陆包，中心有应答 DTU 响应 00F0（OK）或 00F1（ERROR）命令 004C：登录包发送内容
Data：登陆包发送内容，HEX 格式，最长 30 个字节 DTU 响应 00F0（OK）或 00F1（ERROR）命令 0051：数据中心应答登陆包的内容
Data：应答登陆包的内容，HEX 格式，最长 30 个字节 DTU 响应 00F0（OK）或 00F1（ERROR）命令 004D：数据包前缀内容
Data：数据包前缀内容，HEX 格式，最长 30 个字节
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0049：心跳模式
Data：心跳模式，1Byte，HEX 格式，0x00 表示无心跳包，0x01 有心跳包，
中心无应答，0x02 有心跳包，中心有应答
DTU 响应 00F0（OK）或 00F1（ERROR）命令 004A：心跳包发送内容
Data：心跳包发送内容，HEX 格式，最长 30 个字节 DTU 响应 00F0（OK）或 00F1（ERROR）命令 004B：数据中心应答心跳包的内容
Data：应答登陆包的内容，HEX 格式，最长 30 个字节 DTU 响应 00F0（OK）或 00F1（ERROR）命令 0044：设置心跳包时间间隔
Data：心跳时间，2Byte，HEX 格式，单位为秒。默认心跳时间（5 分
钟），最大为 6500 秒。0 或大于 6500 表示不使用心跳。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0035：设置主DNS IP
Data： 4Byte，HEX 格式
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0036：设置备用DNS IP
Data： 4Byte，HEX 格式
DTU 响应 00F0（OK）或 00F1（ERROR）命令
0037：自动获取 DNS 允许 Data： 1Byte，HEX 格式 0X00 关闭
0X11 开启
DTU 响应 00F0（OK）或 00F1（ERROR）命令
E003：恢复出厂默认配置
出厂默认配置见后。
DTU 响应 00F0（OK）或 00F1（ERROR）命令
E000：配置参数查询
Data 格式：[cmd1][cmd2]……[cmdn]
cmd：2Byte，需要查询的参数，对应以上配置参数命令，如果 Data 为空，则表示查询所有配置参数
DTU 响应 E000 命令 E000：回应配置参数显示 Data 格式：
<length1><cmd1><para1><length2><cmd2><para2>….
<lengthn><cmdn><paran> length：cmd 与 para 的长度，2Byte
cmd：对应以上各配置参数命令，表示后面具体为哪一个配置参数， 2Byte
para： 参数内容，格式与各配置参数命令的 Data 格式一样此命令用于响
应 E000 命令。
E004：查询 DTU 状态
DTU 响应 E004 命令 返回 DTU 状态 Data：1Byte，HEX 格式
0x01：未注册状态（连接WiFi）
0x04：在线状态，未登录到数据中心
0x05：在线状态，登录到数据中心
E006：DTU 复位
DTU 响应 00F0（OK）或 00F1（ERROR）命令
注意:此配置协议为本地串口的协议如果需要使用命令远程配置则： TCP_CLENT 远程配置格式如下：
<命令字节长度高字节><命令字节长度低字节>5A<--> UDP_MASTER 远程配置格式如下：
5A<-->
其中<-->表示替换“ZS DTU 配置参数简介”里所对应的命令格式例：远程配置 UDP_MASTER 云开关 关闭
5A AA 55 00 05 00 90 00 00 95
本地配置云关闭命令
出厂默认配置
配置参数 | 出厂默认配置值 |
云开关 | 开 |
云 ID | 0000000000000005 |
云密码 | 000000 |
DTU 身份识别 ID | 00000000 |
数据中心登录密码 | 000000 |
WiFi 名称 | ZSTEL |
WIFI 密码 | 12345678 |
手动配置 WiFi 允许 | 关闭 | |
网络通信协议 | ZSD_UDP | |
主数据中心 | 0.0.0.0 | |
主数据中心侦听端口号 | 0 | |
备用数据中心 | 0.0.0.0 | |
备用数据中心侦听端口号 | 0 | |
串口xx率 | 9600 | |
串口通信选项 | “8N1” | |
DTU 登录模式 | 无登录包 | |
登录包发送内容 | 全 0 | |
登录包数据应答内容 | 全 0 | |
数据包前缀内容 | 全 0 | |
心跳模式 | 无心跳 | |
心跳内容 | 全 0 | |
心跳应答 | 全 0 | |
心跳时间 | 60S | |
主 DNS 地址 | 8.8.8.8 | |
副 DNS 地址 | 4.2.4.2 | |
设置 DNS 生效允许 | 关闭 | |
注意：操作完毕后需，复位设备！