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 数据格式必须严格遵守上述定义。
|
|||
|
|
- 服务端和客户端应处理可能的网络异常和数据解析错误。
|