## 📱 应用简介

**调试助手**是一款专为工业设备通信调试设计的HarmonyOS应用，支持TCP/UDP协议的客户端和服务器模式，提供实时的数据收发、历史记录查询和网络状态监控功能。

---

## ✨ 核心功能

### 1. **多协议支持**
- **TCP客户端**：连接远程TCP服务器
- **TCP服务器**：创建本地TCP服务，接受客户端连接
- **UDP客户端**：向远程UDP服务发送数据
- **UDP服务器**：创建本地UDP服务，接收数据报

### 2. **数据格式转换**
- **ASCII模式**：以文本形式显示和发送数据
- **HEX模式**：以十六进制形式显示和发送数据
- **自动转换**：切换格式时自动转换发送框内容

### 3. **实时通信监控**
- 实时显示发送和接收的数据
- 时间戳标记每条消息
- 区分发送（TX）和接收（RX）方向
- 支持数据清空和日志导出

### 4. **历史记录管理**
- 自动保存通信记录
- 支持按协议类型筛选（TCP/UDP）
- 支持按时间范围筛选（今天/本周/本月）
- 搜索功能快速定位记录
- 记录详情查看和删除

### 5. **网络状态监控**
- 实时显示本机IP地址
- 网络连接状态检测
- WiFi/移动网络识别
- 子网掩码、网关、DNS信息显示

### 6. **设备预设管理**
- 保存常用设备连接配置
- 快速加载预设配置
- 设备描述和备注功能

---

## 🚀 使用指南

### 一、设备连接页面

#### 1. 选择通信协议
在页面顶部选择通信模式：
- **TCP客户端**：主动连接远程服务器
- **TCP服务器**：等待远程客户端连接
- **UDP客户端**：向远程UDP服务发送数据
- **UDP服务器**：接收UDP数据报

#### 2. 配置连接参数

**TCP/UDP客户端模式**：
```
目标IP：输入远程服务器IP地址（如：192.168.1.100）
目标端口：输入远程服务器端口（如：8080）
```

**TCP/UDP服务器模式**：
```
本地端口：设置监听端口（如：8080）
```

#### 3. 建立连接
- 点击**【连接】**按钮建立连接
- 连接状态会实时显示：
  - 🔴 **未连接**：灰色标识
  - 🟡 **连接中**：黄色标识
  - 🟢 **已连接**：绿色标识

#### 4. 数据收发

**发送数据**：
1. 在发送框输入数据内容
2. 选择数据格式（ASCII/HEX）
3. 点击**【发送】**按钮

**接收数据**：
- 接收到的数据会自动显示在接收区
- 每条数据带有时间戳和方向标识（TX/RX）

**数据格式切换**：
- 点击**Hex**或**ASCII**按钮切换显示格式
- 发送框内容会自动进行相应转换

#### 5. 其他操作
- **清空日志**：清除当前显示的通信记录
- **断开连接**：断开当前连接
- **保存预设**：将当前配置保存为设备预设

---

### 二、历史记录页面

#### 1. 查看历史记录
- 所有通信记录自动保存
- 显示时间、协议类型、数据内容

#### 2. 筛选记录

**按协议类型筛选**：
- 全部类型
- TCP客户端
- TCP服务器
- UDP客户端
- UDP服务器

**按时间范围筛选**：
- 全部时间
- 今天
- 本周
- 本月

#### 3. 搜索记录
- 在搜索框输入关键词
- 快速定位包含关键词的记录

#### 4. 记录操作
- 点击记录查看详细信息
- 长按记录删除
- 支持批量删除

---

### 三、设置页面

#### 1. 网络信息查看
- **本机IP**：当前设备的IP地址
- **网络状态**：已连接/未连接
- **网络类型**：WiFi/移动网络
- **子网掩码**：当前网络的子网掩码
- **网关**：默认网关地址
- **DNS**：DNS服务器地址
- **网络接口**：网络接口名称

#### 2. 应用设置
- 主题设置（深色/浅色）
- 字体大小调整
- 日志保存路径设置
- 自动重连设置

---

## 📋 操作示例

### 示例1：TCP客户端连接

1. 选择**TCP客户端**模式
2. 输入目标IP：`192.168.1.100`
3. 输入目标端口：`8080`
4. 点击**【连接】**
5. 连接成功后，在发送框输入：`Hello Server`
6. 点击**【发送】**
7. 接收区显示服务器返回的数据

### 示例2：TCP服务器创建

1. 选择**TCP服务器**模式
2. 输入本地端口：`8080`
3. 点击**【连接】**（开始监听）
4. 等待客户端连接
5. 客户端连接后，可以收发数据
6. 支持多客户端同时连接

### 示例3：UDP通信

**UDP客户端**：
1. 选择**UDP客户端**模式
2. 输入目标IP和端口
3. 点击**【连接】**（绑定本地端口）
4. 发送数据到指定目标

**UDP服务器**：
1. 选择**UDP服务器**模式
2. 输入本地端口
3. 点击**【连接】**（开始监听）
4. 接收来自任何发送方的数据

### 示例4：HEX数据发送

1. 切换到**HEX**格式
2. 输入十六进制数据：`48 65 6C 6C 6F`（对应ASCII: "Hello"）
3. 点击**【发送】**
4. 接收数据也以HEX格式显示

---

## ⚙️ 技术特性

### 网络通信
- 基于HarmonyOS原生Socket API
- 支持IPv4地址格式
- 自动处理网络状态变化
- 异步非阻塞通信

### 数据处理
- UTF-8编码支持
- 十六进制数据解析
- 大小端字节序支持
- 数据校验和计算

### 性能优化
- 消息队列缓冲
- 懒加载历史记录
- 内存自动管理
- 低功耗设计

---

## 🔒 权限说明

应用需要以下权限：
- **互联网权限**：进行网络通信
- **网络状态权限**：获取网络信息
- **后台网络权限**：保持后台连接

---

## 📝 注意事项

### 连接相关
1. **IP地址格式**：确保输入正确的IPv4地址格式（如：192.168.1.100）
2. **端口范围**：有效端口范围为1-65535，避免使用系统保留端口（<1024）
3. **网络环境**：确保设备与目标设备在同一网络或可路由到达
4. **防火墙设置**：服务器模式需确保防火墙允许指定端口

### 数据收发
1. **数据大小**：建议单次发送数据不超过1KB，大数据请分包发送
2. **编码格式**：ASCII模式使用UTF-8编码，HEX模式使用空格分隔
3. **连接状态**：发送前确保连接状态为"已连接"
4. **超时处理**：长时间无响应请检查网络连接

### 历史记录
1. **存储空间**：历史记录占用本地存储，定期清理
2. **隐私保护**：敏感数据发送后建议删除记录
3. **数据备份**：重要记录可导出备份

---

## 🛠️ 故障排查

### 无法连接
- 检查网络连接状态
- 确认目标IP和端口正确
- 检查防火墙设置
- 尝试ping目标地址

### 数据发送失败
- 确认连接状态为"已连接"
- 检查数据格式是否正确
- 查看错误日志信息
- 重启应用重试

### 接收不到数据
- 确认对方已发送数据
- 检查网络稳定性
- 查看是否有防火墙拦截
- 确认协议类型匹配

### 历史记录丢失
- 检查存储权限
- 确认应用未异常退出
- 查看存储空间是否充足

---

## 📞 技术支持

- **应用版本**：1.0.0
- **开发平台**：HarmonyOS API 23
- **支持设备**：手机、平板

---

## 📄 许可证

本项目仅供学习和研究使用，请勿用于商业用途。

---

**调试助手** - 让工业设备通信调试更简单！

仓库地址：tools_oh_next_app:基于 HarmonyOS 生态的工业设备通信调试应用项目 - AtomGit