Files
vd_960/docs/DLD960_串口通信协议.md
T
wangfq ef806b6013 init: vd_960 项目初始化
- 双 MCU 架构:AT32F421(线圈) + CH32V208(通信)
- DLD960 串口通信协议 V1.01
- IoT MQTT 接口协议 V1.00 (JSON)
- TCP 接口协议 V1.00 (JSON)
2026-06-22 17:02:23 +08:00

12 KiB
Raw Blame History

DLD960 串口通信协议

1 通信说明

1.1 通信方式

串口通信,波特率:115200

2 协议格式

Package

1Byte 3Bytes 0~64Bytes 2Bytes
Magic byte Header Value Check Bytes

2.1 Magic Byte(1Byte)

标识协议类型,也表示数据包开始信息。

Magic Byte 说明
0x7F 屏、地感检测、探头的配置和查询协议,或者部分雷达的协议
0x8F 支持DBN查询和配置的专有协议

2.2 Header(3Bytes)

当Magic Byte为 0x7F时,Header字节定义如下:

1Byte 1Byte 1Byte
Addr 地址 LEN 数据长度 CMD 命令字节
  • LEN数据长度,表示数据包的有效数据(Value)长度,包括命令(CMD Byte)和数据(Data Bytes)
  • CMD 命令字节;
  • 该协议的详细说明参考《DCP101点阵驱动说明》以及相关的地感检测485协议

当Magic Byte为0x8F时,Header字节定义如下:

1Byte 1Byte 1Byte
SubPkgFlag 分包标记 LEN 数据长度 CMD 命令字节

分包标记 SubPkgFlag,高四位表示分包数量SubAmount,低四位表示为当前分包中第几个分包SubSequence,其中SubSequence = [1,SubAmount]

  • 00表示无分包,是一条数据完整的记录;
  • 当SubAmount不为0时,SubSequence从1开始到SubAmount结束,整合为一条完整的数据包。

2.3 校验字节(Check Bytes2Bytes)

当Magic Byte为0x7F时,校验字节实现参考《DCP101点阵驱动说明》《DPG100 485通信协议》 和相关的地感检测485协议说明,部分雷探头的协议也需要支持0x7F。 当Magic Byte为0x8F时,校验字节实现如下:

1Byte 1Byte
XOR 异或校验 SUM 和校验

XOR 异或校验,校验从分包标记字节开始,到命令数据的最后一个字节结束; SUM 和校验,校验从分包标记字节开始,到命令数据的最后一个字节结束。

3 Cmd详解

3.1 更改设备序列码(0x09)

Header Dev_Serial
Value(Hex) 00 08 09 xx
Length 3 Byte 6 Byte

返回:

Header status
Value(Hex) 00 01 11 00/01
Length 3 Byte 1 Byte

status: 00 success, 01 fail

3.2 查询设备信息命令(0x10)

Header Data Value
Value(Hex) 00 01 10
Length 3 Byte 0 Byte

返回:

Header Dev_Serial Hard Ver Soft Ver Model Num Sub_Code Bus1 Bus2 Bus3 Bus4
Value(Hex) 00 1C 10 xx 01 01 01 01 xx xx xx xx xx xx xx
Length 3 Byte 6 Byte 2 Byte 2 Byte 7~10 Byte 6 Byte 2 Byte 1 Byte 1 Byte 1 Byte 1 Byte
Describe 序列码 硬件版本号 软件版本号 产品型号 产品编码 子功能代码 总线1探头数 总线2 总线3 总线4

Model: 当首字节的值在[1,12]内时表示Mode的有效字节长度。 Sub_Code: 表示子功能代码 SUB_CODE,各个比特位对应不同的子功能,0表示禁用,1表示启用

[0] [1] [2] [3] [4] [5] [6] [7]
net iot RFU RFU RFU RFU RFU RFU
网络 MQTT
[8] [9] [10] [11] [12] [13] [14] [15]
RFU RFU RFU RFU RFU RFU RFU RFU

3.3 设置SSC网络配置(0x11)

Header Dev IP Subnet Mask Route IP LSSC IP DNS Port
Value(Hex) 00 19 11 xx xx xx xx xx xx
Length 3 Byte 4 Byte 4 Byte 4 Byte 4 Byte 4 Byte 10 Byte

返回:

Header status
Value(Hex) 00 01 11 00/01
Length 3 Byte 1 Byte

status: 00 success, 01 fail

3.4 查询SSC网络配置(0x12)

Header Data
Value(Hex) 00 01 12
Length 3 Byte 0 Byte

返回:

Header Dev IP Subnet Mask Route IP LSSC IP DNS Port
Value(Hex) 00 19 12 xx xx xx xx xx 00
Length 3 Byte 4 Byte 4 Byte 4 Byte 4 Byte 4 Byte 10 Byte

3.5 设置IoT网络配置(0x13)

Header IoT Host(Domain name/IP) + Port + ClientID + Username + Password
Value(Hex) xx xx 13 xx 00 xx 00 xx 00 xx 00 xx
Length 3 Byte xx Byte

注:

  • 数据部分的不同字段通过 0x00 分隔
  • ClientID 为空时用一个空格符替代

返回:

Header Status
Value(Hex) 00 01 13 00/01
Length 3 Byte 1 Byte

Status: 00 success, 01 failed

3.6 查询IoT网络配置(0x14)

Header Data
Value(Hex) 00 01 14
Length 3 Byte 0 Byte

返回:

Header IoT Host(Domain name/IP)
Value(Hex) 00 xx 14 xx
Length 3 Byte xx Byte

3.7 设置设备Topic(0x15)

Header ClientID_Enable + Topic_Pub + Topic_Sub
Value(Hex) xx xx 15 xx 00 xx 00
Length 3 Byte xx Byte
  • 数据部分不同字段通过0x00 来分隔
  • Client_Enable: 0x00 disable, 0x01 enable

返回:

Header Status
Value(Hex) 00 01 15 00/01
Length 3 Byte 1 Byte

Status: 00 success, 01 failed

3.8 查询设备Topic(0x16)

发送:

Header
Value(Hex) 00 01 16
Length 3 Byte

Status: 00 success, 01 failed

返回:

Header ClientID_Enable + Topic_Pub + Topic_Sub
Value(Hex) xx xx 16 xx 00 xx 00
Length 3 Byte xx Byte

3.9 验证设备密码(0x1C)

Header Password
Value(Hex) 00 07 1C 31 32 33 34 35 36
Length 3 Byte 6 Byte

返回:

Header Status
Value(Hex) 00 01 1C 00/01
Length 3 Byte 1 Byte

Status: 00 Success, 01 Failed

3.10 设置设备密码(0x1D)

Header Old Password New Password
Value(Hex) 00 0D 1D
Length 3 Byte 6 Byte 6 Byte

返回:

Header Status
Value(Hex) 00 02 1D 00/01
Length 3 Byte 1 Byte

3.11 设备出厂初始化(0x1E)

Header Data
Value(Hex) 00 01 1E
Length 3 Byte 0Byte

返回:

Header Status
Value(Hex) 00 02 1E 00/01
Length 3 Byte 1 Byte

3.12 设备复位(0x1F)

Header Data
Value(Hex) 00 01 1F
Length 3 Byte 0 Byte

设备无回复。

3.13 设置车检器多路参数(0x63)

Header AutoMode + Amount + Param[Sensitivity, Loop_Delay, Output_Mode, Exist_Mode, Direction_Mode]
Value(Hex) 00 xx 63 xx
Length 3 Byte (2 + 5 * Amount) Byte
  • AutoMode: 是否处于自动模式(自动调频),0表示不启用,默认0。
  • Sensitivity: 低四位表示灵敏度,0~9级,值越大,灵敏度越高,默认7;高四位表示高低频,其中,[4,5]表示线圈的高低频。
  • Loop_Delay: 地感延时时间,0~200, 0.1s为一级,延时时间范围:[0, 20秒];
  • Output_Mode: 低三位有效,地感输出方式,0 - 存在输出,1-进入脉冲,2-离开脉冲,3-方向判别;高5位表示SafeMode:是否开启安全模式, 0 关闭,非 0 开启安全模式,分钟为单位。
  • Exist_Mode:低四位表示地感存在方式,0-永久存在,非0-有限存在的分钟数;
  • Direction_Mode:
    • 低三位表示方向判别模式,0 表示触发模式, 1-6 表示方向判别的输出模式,对应以前的 0-5, update 2023-02-24
    • 高四位表示Function_Mode,功能模式,是否启用特殊的模式
Header Status
Value(Hex) 00 02 63 00/01
Length 3 Byte 1 Byte

3.14 读取车检器多路参数(0x64)

Header Param
Value(Hex) 00 01 64
Length 3 Byte

返回:

Header AutoMode+Amount + Data[Sensitivity, Loop_Delay, Output_Mode, Exist_Mode, Direction_Mode, freq1, freq2, freq3]
Value(Hex) 00 xx 64 XX
Length 3 Byte (2 + 8 * Amount) Byte

3.15 设置主动上报(0xC5)

设置主动上报是否使能、类型、时长等。

7Fh ADDR Len C5 SensType(1Byte) Enable(1Byte) Interval(1Byte) Timeout(1Byte) XOR SUM

Enable: 是否使能,第0位 0 禁用, 1 使能; 0x10表示只上报一次,此时相当于查询功能;第5位表示是否环境评估,如0x21,表示环境评估类型 Interval: 当最高位为0时,上报不需要确认,低七位表示上报间隔,0表示实时,低七位非0表示以秒为单位的上报的间隔;最高位为1时,表示上报需要回复确认。 Timeout: 单位:分钟;0表示没有时间限制。

3.16 设备主动上报传感信息(0xC0)

设备主动上报传感信息指令,具体传感数据需要根据不同的类型进行解析。

7Fh ADDR Len C0 SensType(1Byte) SubPkgFlag(1Byte) SensData XOR SUM

SensType: 传感数据类型 SubPkgFlag: 分包标记,高四位表示分包数量 SubAmount,低四位表示为当前分包中第几个分包 SubSequence,其中 SubSequence = [1,SubAmount]

  • 00 表示无分包,是一条数据完整的记录;
  • 当SubAmount不为0时,SubSequence从1开始到SubAmount结束,整合为一条完整的数据包。
  • 当SensType为0x05时,SubPkgFlag作为传感数据使用。
  • 当SensType为0x06、0x07、0x09时,SubPkgFlag的Seq和SubAmount分开各用一个字节表示。

SensData:传感数据

SensType 类型说明 SensData 传感数据说明
0x0C 多线圈传感信息 四路线圈

上报线圈传感数据单元(多路线圈,每一路线圈单元的配置)

字段 字节数 内容 详情
配置 1 1 freq_level, Directionfreq_type, sens 线圈 1 配置
freq_level:高低频,两个比特位,00 表示高频(33nF),01表示中高(43nF), 10表示中低(66nF), 11表示低频(76nF)。
Direction: 0 表示触发,1 表示方向判别
freq_type: 0 表示初始频率,1 表示当前实时频率。
sens:低四位表示当前的灵敏度等级
线圈评估条件 1 condition, loop_state loop_condition 正常(0)有效,环境状态条件(环境状态评估值,值越大,干扰越大),高四位有效。低四位中,其中第3位表示线圈状态,0 表示正常,1 表示线圈断开;第 2 位表示有无车,0 表示无车,1 表示有车;低两位表示杂项类型,0b00表示时间量,0b01表示线圈断开次数;0b10表示车流量数
频率 1 3 frequent 低字节在前
变化量 1 2 variation 低字节在前
杂项 4 in_out_passtime/cut_amount/flow_amount 杂项类型,可能是时间量,也可能是线圈断开次数、车流量数,说明:
1、通过时间或车间距,5ms为单位,最大计时()
2、线圈断开次数
3、车流量数

eg:

7F 00 2F C0 0C 00 D2 00 00 00 00 00 00 00 00 00 00 52 00 00 00 00 00 00 00 00 00 00 92 00 00 00 00 00 00 00 00 00 00 D2 00 00 00 00 00 00 00 00 00 00 23 83

注意,如果有续包,最后一包上位机无返回。中间续包上位机返回传感类型,当前收到包的序列和子包的数量:

7Fh ADDR 07 C0 SensType Seq(1Byte) SubAmount(1Byte) XOR SUM

修订记录

版本 修订时间 修订说明 修订人
V1.00 2026-03-11 创建协议初始版本 wangfq
V1.01 2026-06-22 补充遗漏的接口说明 wangfq