docs: 加入三份协议文档 + 更新README架构图

This commit is contained in:
wangfq
2026-05-27 10:13:41 +08:00
parent 9820f3cfc1
commit 3d7af31f11
4 changed files with 971 additions and 1 deletions

443
docs/DG430串口协议.md Normal file
View File

@@ -0,0 +1,443 @@
# 测试工装DG430串口协议
DG430地感测试工装协议说明
V2.0.1-20260522
# 1 硬件介绍
   接口:
IN1和GND接地感的存在信号
IN2和GND接地感的脉冲信号
IN3和COM接按钮按下开始测试
IN4和COM接按钮按下复原位置
PU+/PU-/DR+/DR-/MF+/MF-:接电机驱动器;
+5V/GND/NO/NC接限位开关有信号电机停转
485A/485B485信号USB转485接电脑
VCC/GND电源输入直流9-36V
+5V/GND5V直流电输出
GND/LP接地感线圈
SW3接激光探头
拨码开关(对应地感测试正常不报警):
    DIP1---OFF,DIP2---OFF测试132系列地感
    DIP1---ON,DIP2---OFF测试110系列地感
数码管显示:
进入和离开对应地感的触发和释放距离单位mm
# 2 声音提示说明
2声-----工作频率和峰峰值不对,可能不在最低频;
3声-----灵敏度不对,可能不是最低灵敏度;
4声-----灵敏度提升不对132的DIP5不在OFF
5声-----不是离开脉冲;
6声-----脉冲继电器无输入;
# 3 数据显示
   安装软件“dg430\_tool”可显示峰峰值、工作频率、出发距离、释放距离、故障信息、继电器输出等。
# 4 通讯方式
通信采用一问一答方式。即主机发送一个命令,从机返回应答;主机发送下一条命令,从机当前命令的应答。
RS485串口 通信波特率19200bps8位数据位1位停止位无校验位。
TTL串口 通信波特率 1152008位数据位1位停止位无校验位。
# 5 通讯数据包格式
| | 起始字节 | 地址 | 数据长度 | 命令 | 命令数据 | 异或 | 和校验 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 字段值 | STX | ADDR | LEN | CMD | DATA | XOR | SUM |
| 数据类型 | INT8U | INT8U | INT8U | INT8U | INT8U | INT8U | INT8U |
| 字节数 | 1字节 | 1字节 | 1字节 | 1字节 | LEN-1 | 1字节 | 1字节 |
STX  单字节表示数据包开始信息用0x7F 表示。
ADDR单字节表示通信地址。
LEN  单字节表示数据包的有效数据长度即命令和命令数据的总和。
CMD 单字节表示数据包的命令。
DATA 多字节表示数据包的命令数据一个数据包中可以没有命令数据。
XOR  异或校验校验从地址开始命令数据的最后一个字节结束。
SUM 和校验校验从地址开始命令数据的最后一个字节结束。
## 5.1 开始测试指令命令 0xB0
  上位机发送格式:
| 7Fh | 80h + ADD | 01h | B0h | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
       说明该指令为上位机发送给DG430。DG430接收到该指令后返回协议并开始测试。
测试用例7F 81 01 B0 30 32 
设备返回格式:
| 7Fh | 80h + ADD | 02h | B0h | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 说明:无论是按键开始测试还是发送协议开始测试都会返回该协议;
Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 B0 00 33 33 
## 5.2 测试复原位置指令命令 0xB1
  上位机发送格式:
| 7Fh | 80h + ADD | 01h | B1h | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
说明该指令为上位机发送给DG430。DG430接收到该指令后返回协议并开始复原位置。
测试用例7F 81 01 B1 31 33 
返回格式:
| 7Fh | 80h + ADD | 02h | B1h | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 B1 00 32 34 
## 5.3 上报状态指令命令 0xB2
  设备上报格式:
| 7Fh | 80h + ADD | 15h | B2h | 状态内容 | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
状态内容详细说明20字节
| | 设备型号 | 测试模式 | 是否正常完成测试 | 是否有故障 | 继电器输出 | 峰峰值 | 开始工作频率 | 进入工作频率 | 离开工作频率 | 进入高度 | 离开高度 | 进入速度 | 离开速度 | RFU |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 字节数 | 1字节 | 1字节 | 1字节 | 1字节 | 1字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 | 2字节 |
 7F 81 18 B2 01 00 00 0F 03 2F 0D EC C9 CC C9 EC C9 18 01 28 01 37 00 30 00 00 00 36 42  
说明该协议为每次测量完成后DG430主动上报上位机无回复
设备型号01-----PD132系列
          02-----DLD110系列
测试模式0 为灵敏度测试模式1为模拟过车测试模式
是否正常完成测试00-----正常;
01----不正常,可能是复原位置或者继电器存在信号无输出;
02\----地感死机,有进入高度,到复原位置的距离时地感死机导致继电器还没有断开;
是否故障: 00-----无故障;
         BIT0-----为1时表示工作频率不是最低频
         BIT1-----为1时表示灵敏度不是最低灵敏度
         BIT2-----为1时表示灵敏度提升拨码没有在OFF
         BIT3-----为1时表示脉冲输出不是离开脉冲
继电器输出:表示存在继电器信号和脉冲继电器信号是否有输出;
            BIT0-----为1时表示存在继电器信号有输出接DG430的IN1
            BIT1-----为1时表示脉冲继电器信号有输出接DG430的IN2
峰峰值线圈无车LC震荡的峰峰值误差±10%,小端模式,低字节在前,
高字节在后计算公式单位V峰峰值=((X\*3.3)/4095)\*4
开始工作频率刚开始测试时线圈无车LC震荡的工作频率无误差低字节在前高字节在后计算公式单位HZ工作频率=10\*X
进入工作频率:线圈从无车到有车时的工作频率;
离开工作频率:线圈从无车到有车时的工作频率;
进入高度刚进入线圈有车时的高度单位mm小端模式
离开高度刚离开线圈无车时的高度单位mm小端模式
进入速度:单位 分米/每秒,小端模式;
离开速度:单位 分米/每秒,小端模式;
RFU保留字节
## 5.4 更改RTC时间和日期命令 0xB3 (弃用)
  上位机发送格式:
| 7Fh | 80h + ADD | 09h | B3h | 时间(4字节) | 日期(4字节) | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- | --- |
 说明时间和日期按照RTC寄存器格式发送发送格式为上位机发给DG430收到后DG430更改自己的RTC时间,小端模式,低字节在前,高字节在后;
7F 81 09 B3 00 12 14 00 28 67 21 00 53 13时间14:12:00日期2021-07-28
     返回格式:
| 7Fh | 80h + ADD | 02h | B3h | 01h | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
  7F 81 02 B3 01 31 37
## 5.5 电机前进指令命令 0xBA
  上位机发送格式:
| 7Fh | 80h + ADD | 01h | BAh | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
说明该指令为上位机发送给DG430。DG430接收到该指令后返回协议并驱动电机前进。
测试用例7F 81 01 BA 3A 3C 
返回格式:
| 7Fh | 80h + ADD | 02h | BAh | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 BA 00 39 3D
## 5.6 电机后退指令命令 0xBB
  上位机发送格式:
| 7Fh | 80h + ADD | 01h | BBh | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
说明该指令为上位机发送给DG430。DG430接收到该指令后返回协议并开始复原位置。
测试用例7F 81 01 BB 3B 3D
返回格式:
| 7Fh | 80h + ADD | 02h | BBh | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 BB 00 38 3E 
## 5.7 电机停止指令命令 0xBC
  上位机发送格式:
| 7Fh | 80h + ADD | 01h | BCh | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
说明该指令为上位机发送给DG430。DG430接收到该指令后返回协议并开始复原位置。
测试用例7F 81 01 BC 3C 3E 
返回格式:
| 7Fh | 80h + ADD | 02h | BCh | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 BC 00 3F 3F 
## 5.8 获取设备版本号指令命令0x4A
| 7Fh | 80H +ADD | LEN | 4Ah | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
获取控制卡的版本号
LEN: 0x01
eg: 7F 81 01 4A CA CC
返回格式::
| 7Fh | 80H +ADD | LEN | 4Ah + 00 + 硬件版本号+软件版本 | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
LEN:0x08
硬件版本号3个字节
软件版本号3个字节
eg: 7F 81 08 4A 00 03 03 00 03 04 00 C4 E0, 表示硬件版本号3.3.0固件版本为3.4.0
## 5.9 配置设备测试参数命令 0x4B
  上位机发送格式:
| 7Fh | 80h+ADD | 10h | 4Bh | Addr | DevType | TestMode | ResetDis | MinusDis | SensMin | SensMax | FreMin | FreMax | PeakMin | PeakMax | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1B | 1B | 1B | 1B | 1B | 1B | 1B | 1B | 1B | 2B | 2B | 2B | 2B | 2B | 2B | 1B | 1B |
说明该指令为上位机发送给DG430。DG430接收到该指令后返回协议并更新测试参数。
Addr1Byte, 设备地址、485地址
DevType1Byte, 设备型号
TestMode: 1Byte, 测试模式0 灵敏度测试模式1 模拟过车模式
ResetDis: 复位距离单位cm
MinusDis: 皮距激光到线圈的距离测算的实际高度要减去这个皮距单位cm。
SensMin,SensMax: 2Byte, 灵敏度最小、最大值
FreMin, FreMax: 2Byte, 频率最小、最大值
PeakMin, PeakMax: 2Byte, 峰峰值最小、最大值
测试用例7F 81 12 4B 01 01 00 30 0D 00 8B 00 E6 07 76 06 D6 09 B0 0C 1C 80 C8
用例说明:
Addr0x01 DevType: 0x01, 00: Sensity Test Mode, ResetDis: 48cm,  MinusDis: 13cm,  SensMin:  139, SensMax: 230, Fre\_Min:1910, FreMax: 1750, PeakMin: 2480, PeakMax: 3100。
返回格式:
| 7Fh | 80h + ADD | 02h | 4Bh | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 4B 00 C8 CE 
## 5.10 查询设备测试参数命令 0x4C
  上位机发送格式:
| 7Fh | 80h + ADD | 01h | 4Ch | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
| 1B | 1B | 1B | 1B | 1B | 1B |
说明该指令为上位机发送给DG430。DG430接收到该指令后返回协议并开始复原位置。
测试用例7F 81 01 4C CC CE
返回格式:
| 7Fh | 80h+ADD | 13h | 4Ch | Flag | Addr | DevType | TestMode | ResetDis | MinusDis | SensMin | SensMax | FreMin | FreMax | PeakMin | PeakMax | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1B | 1B | 1B | 1B | 1B | 1B | 1B | 1B | 1B | 1B | 2B | 2B | 2B | 2B | 2B | 2B | 1B | 1B |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 13 4C 00 01 01 00 30 0D 00 8B 00 E6 07 76 06 D6 09 B0 0C 1C 86 CA
## 5.11 出厂初始化指令命令0x4D
| 7Fh | 80H +ADD | LEN | 4Dh | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
上位机发送该指令后DG430进行出厂初始化操作
LEN: 0x01
eg: 7F 81 01 4D CD CF
| 7Fh | 80h + ADD | 02h | 4Dh | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 4D 00 CE D0 
## 5.12 设备复位指令命令0x4E
| 7Fh | 80H +ADD | LEN | 4Eh | XOR | SUM |
| --- | --- | --- | --- | --- | --- |
获取控制卡的版本号
LEN: 0x01
eg: 7F 81 01 4E CA CC
返回格式:
| 7Fh | 80h + ADD | 02h | 4Eh | Flag | XOR | SUM |
| --- | --- | --- | --- | --- | --- | --- |
 Flag:是否故障标志
00----正常
01----故障
     测试用例7F 81 02 4E 00 CD D1 
# 更新记录
| **版本号** | **更新日期** | **状态** | **更新内容** | **更新人** |
| --- | --- | --- | --- | --- |
| V1.0.6 | 2021-07-30 | | 发布测试工装V1的协议。 | 何燕山 |
| V2.0.0 | 2026-05-21 | | 增加配置指令:电机前进、后退、停止指令,获取版本号、读写测试指令 | 王飞强 |
| V2.0.1 | 2026-05-22 | | 增加出厂初始化指令、设备复位指令 | 王飞强 |
| V2.0.2 | 2026-05-25 | | 增加测试模式,增加进入速度和离开速度 | 王飞强 |
| | | | | |