65 lines
1.5 KiB
Markdown
65 lines
1.5 KiB
Markdown
# 搭接焊缝检测 TCP/IP 通信协议文档
|
||
|
||
## 1. 概述
|
||
|
||
本文档描述了如何通过 TCP/IP 协议与搭接焊缝检测软件进行交互。我们的软件作为服务端，客户端通过 TCP/IP 连接发送指令，服务端执行检测并将结果以 JSON 格式返回。
|
||
|
||
## 2. 通信协议
|
||
|
||
- **协议类型**: TCP/IP
|
||
- **数据格式**: JSON
|
||
- **服务端**: 搭接焊缝检测软件
|
||
- **客户端**: 外部设备
|
||
- **通信端口**: 可根据项目在软件上进行配置
|
||
|
||
## 3. 通信流程
|
||
|
||
1. 客户端连接到服务端。
|
||
2. 客户端发送开始检测指令。
|
||
3. 服务端执行检测。
|
||
4. 检测完成后，服务端将结果以 JSON 格式发送给客户端。
|
||
|
||
## 4. 指令格式
|
||
|
||
### 4.1 开始检测
|
||
|
||
客户端发送以下 JSON 指令以启动检测（**时间戳为毫秒级**）：
|
||
|
||
```json
|
||
{
|
||
"command": "start_detection",
|
||
"timestamp": 1698409200000
|
||
}
|
||
```
|
||
|
||
## 5. 响应格式
|
||
|
||
### 5.1 检测结果
|
||
|
||
检测完成后，服务端将返回 JSON 格式的检测结果（**响应中的时间戳与请求中的时间戳对应**）：
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"message": "检测成功",
|
||
"timestamp": 1698409200000,
|
||
"result": [
|
||
[
|
||
// 焊缝上的点
|
||
{"x": 1.0, "y": 2.0, "z": 3.0},
|
||
{"x": 4.0, "y": 5.0, "z": 6.0}
|
||
],
|
||
[
|
||
{"x": 7.0, "y": 8.0, "z": 9.0},
|
||
{"x": 10.0, "y": 11.0, "z": 12.0}
|
||
]
|
||
]
|
||
}
|
||
```
|
||
|
||
## 6. 注意事项
|
||
|
||
- 确保 TCP/IP 连接稳定。
|
||
- JSON 数据格式必须严格遵守上述定义。
|
||
- 服务端和客户端应处理可能的网络异常和数据解析错误。 |