可用于工业设备 TCP/UDP 通信联调、日志查看与故障排查。项目支持客户端/服务器收发、ASCII/HEX 转换、实时日志、历史记录筛选搜索、网络状态监控和设备预设，便于快速验证设备通信链路。【此简介由AI生成】
当前访问频次受限，请登录后继续访问
调试助手 - HarmonyOS工业设备通信调试工具
📱 应用简介
调试助手是一款专为工业设备通信调试设计的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. 数据收发
发送数据：
- 在发送框输入数据内容
- 选择数据格式（ASCII/HEX）
- 点击**【发送】**按钮
接收数据：
- 接收到的数据会自动显示在接收区
- 每条数据带有时间戳和方向标识（TX/RX）
数据格式切换：
- 点击Hex或ASCII按钮切换显示格式
- 发送框内容会自动进行相应转换
5. 其他操作
- 清空日志：清除当前显示的通信记录
- 断开连接：断开当前连接
- 保存预设：将当前配置保存为设备预设
二、历史记录页面
1. 查看历史记录
- 所有通信记录自动保存
- 显示时间、协议类型、数据内容
2. 筛选记录
按协议类型筛选：
- 全部类型
- TCP客户端
- TCP服务器
- UDP客户端
- UDP服务器
按时间范围筛选：
- 全部时间
- 今天
- 本周
- 本月
3. 搜索记录
- 在搜索框输入关键词
- 快速定位包含关键词的记录
4. 记录操作
- 点击记录查看详细信息
- 长按记录删除
- 支持批量删除
三、设置页面
1. 网络信息查看
- 本机IP：当前设备的IP地址
- 网络状态：已连接/未连接
- 网络类型：WiFi/移动网络
- 子网掩码：当前网络的子网掩码
- 网关：默认网关地址
- DNS：DNS服务器地址
- 网络接口：网络接口名称
2. 应用设置
- 主题设置（深色/浅色）
- 字体大小调整
- 日志保存路径设置
- 自动重连设置
📋 操作示例
示例1：TCP客户端连接
- 选择TCP客户端模式
- 输入目标IP：
192.168.1.100 - 输入目标端口：
8080 - 点击**【连接】**
- 连接成功后，在发送框输入：
Hello Server - 点击**【发送】**
- 接收区显示服务器返回的数据
示例2：TCP服务器创建
- 选择TCP服务器模式
- 输入本地端口：
8080 - 点击**【连接】**（开始监听）
- 等待客户端连接
- 客户端连接后，可以收发数据
- 支持多客户端同时连接
示例3：UDP通信
UDP客户端：
- 选择UDP客户端模式
- 输入目标IP和端口
- 点击**【连接】**（绑定本地端口）
- 发送数据到指定目标
UDP服务器：
- 选择UDP服务器模式
- 输入本地端口
- 点击**【连接】**（开始监听）
- 接收来自任何发送方的数据
示例4：HEX数据发送
- 切换到HEX格式
- 输入十六进制数据：
48 65 6C 6C 6F（对应ASCII: "Hello"） - 点击**【发送】**
- 接收数据也以HEX格式显示
⚙️ 技术特性
网络通信
- 基于HarmonyOS原生Socket API
- 支持IPv4地址格式
- 自动处理网络状态变化
- 异步非阻塞通信
数据处理
- UTF-8编码支持
- 十六进制数据解析
- 大小端字节序支持
- 数据校验和计算
性能优化
- 消息队列缓冲
- 懒加载历史记录
- 内存自动管理
- 低功耗设计
🔒 权限说明
应用需要以下权限：
- 互联网权限：进行网络通信
- 网络状态权限：获取网络信息
- 后台网络权限：保持后台连接
📝 注意事项
连接相关
- IP地址格式：确保输入正确的IPv4地址格式（如：192.168.1.100）
- 端口范围：有效端口范围为1-65535，避免使用系统保留端口（<1024）
- 网络环境：确保设备与目标设备在同一网络或可路由到达
- 防火墙设置：服务器模式需确保防火墙允许指定端口
数据收发
- 数据大小：建议单次发送数据不超过1KB，大数据请分包发送
- 编码格式：ASCII模式使用UTF-8编码，HEX模式使用空格分隔
- 连接状态：发送前确保连接状态为"已连接"
- 超时处理：长时间无响应请检查网络连接
历史记录
- 存储空间：历史记录占用本地存储，定期清理
- 隐私保护：敏感数据发送后建议删除记录
- 数据备份：重要记录可导出备份
🛠️ 故障排查
无法连接
- 检查网络连接状态
- 确认目标IP和端口正确
- 检查防火墙设置
- 尝试ping目标地址
数据发送失败
- 确认连接状态为"已连接"
- 检查数据格式是否正确
- 查看错误日志信息
- 重启应用重试
接收不到数据
- 确认对方已发送数据
- 检查网络稳定性
- 查看是否有防火墙拦截
- 确认协议类型匹配
历史记录丢失
- 检查存储权限
- 确认应用未异常退出
- 查看存储空间是否充足
📞 技术支持
- 应用版本：1.0.0
- 开发平台：HarmonyOS API 23
- 支持设备：手机、平板
📄 许可证
本项目仅供学习和研究使用，请勿用于商业用途。
调试助手 - 让工业设备通信调试更简单！