# 串口调试助手

**Repository Path**: fan-wenshan/serial-debugging-assistant

## Basic Information

- **Project Name**: 串口调试助手
- **Description**: 串口调试助手，专为嵌入式开发设计的开源工具，支持多种设备连接与数据传输测试，助力开发者高效调试。
- **Primary Language**: C++
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-25
- **Last Updated**: 2025-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 串口调试助手

## 介绍
这是一个基于Qt框架开发的串口调试助手，专为嵌入式开发设计，提供直观的图形界面来进行串口通信调试。支持多种串口参数配置、数据发送接收、定时发送和历史记录等功能，帮助开发者高效调试串口设备。

## 功能特点
- 自动检测并列出可用串口设备
- 支持多种串口参数配置：
  - 波特率：1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200等
  - 数据位：5, 6, 7, 8位
  - 校验位：无校验、偶校验、奇校验、空格校验、标记校验
  - 停止位：1, 2位
  - 流控：无流控
- 数据发送与接收功能
  - 支持字符串和HEX格式发送
  - 多文本预设发送区，可快速发送常用指令
  - 定时发送功能
- 数据显示与管理
  - 接收数据实时显示
  - 发送/接收字节数统计
  - 历史记录保存与查看
  - 接收数据清空与保存
- 用户友好界面
  - 分区布局：接收区、历史记录区、多文本发送区
  - 状态指示：发送成功/失败提示

## 软件架构
该项目基于Qt 5.12.12框架开发，采用C++语言编写，主要包含以下组件：
- **main.cpp**：程序入口点，创建应用实例和主窗口
- **widget.h/widget.cpp**：主窗口类实现，包含串口操作、UI交互等核心逻辑
- **widget.ui**：使用Qt Designer设计的用户界面布局
- **res.qrc**：资源文件，包含应用图标等资源
- **serial-debugging-assistant.pro**：Qt项目文件

## 安装教程
### 环境要求
- Qt 5.12.12或更高版本（推荐使用MinGW 32-bit编译器）
- Windows操作系统

### 安装步骤
1. 确保已安装Qt开发环境，建议使用Qt 5.12.12版本，并勾选MinGW 32-bit编译器组件
2. 克隆或下载本项目到本地
3. 打开Qt Creator，通过"文件"->"打开文件或项目"选择项目根目录下的`serial-debugging-assistant.pro`文件
4. 选择构建套件（推荐：Desktop Qt 5.12.12 MinGW 32-bit）
5. 点击"构建"->"构建项目"编译项目
6. 编译完成后，点击"运行"按钮启动应用程序

## 使用方法
### 基本操作
1. 启动应用程序，界面将显示所有可用串口
2. 在串口配置区域选择合适的参数（波特率、数据位、校验位、停止位、流控）
3. 点击"打开串口"按钮连接设备
4. 在发送区输入要发送的数据
5. 点击"发送"按钮发送数据
6. 接收的数据将显示在接收区，并自动更新接收字节数统计

### 高级功能
- **定时发送**：勾选"定时发送"复选框，设置时间间隔，系统将自动循环发送当前输入框中的数据
- **多文本发送**：在右侧多文本区域预设常用指令，点击对应编号按钮快速发送
- **历史记录**：所有发送的指令会自动保存到历史记录区，方便查看和复用
- **数据保存**：点击"保存接收"按钮可将接收区数据保存到文件
- **清空接收**：点击"清空接收"按钮可清除接收区内容

## 项目结构
```
serial-debugging-assistant/
├── .gitee/              # Gitee相关配置文件
├── .gitignore           # Git忽略文件
├── LICENSE              # 许可证文件
├── README.md            # 中文说明文档
├── README.en.md         # 英文说明文档
├── Serial-Debug-Assistant.pro.user  # Qt项目用户配置
├── main.cpp             # 程序入口
├── mianicon.png         # 应用图标
├── res.qrc              # 资源文件
├── serial-debugging-assistant.pro  # Qt项目文件
├── widget.cpp           # 主窗口实现
├── widget.h             # 主窗口头文件
└── widget.ui            # 界面布局文件
```

## 贡献指南
1. Fork本仓库
2. 创建特性分支 (`git checkout -b feature/xxx`)
3. 提交代码更改 (`git commit -m 'Add some feature'`)
4. 推送到分支 (`git push origin feature/xxx`)
5. 创建Pull Request

## 许可证
本项目采用MIT许可证，详情请查看<mcfile name="LICENSE" path="e:/QT/serial-debugging-assistant/LICENSE"></mcfile>文件。