# SerialTool

**Repository Path**: qobn/serial-tool

## Basic Information

- **Project Name**: SerialTool
- **Description**: pc 端 串口测试工具 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 简单串口工具

### 环境准备
```bash
python -m venv venv  # 创建虚拟环境
source venv/bin/activate  # 激活虚拟环境
pip install -r requirements.txt  # 安装依赖
```

### 启动
```bash
python SerialManager.py
```

### 使用手册
1. 启动程序后，先确认已插入 USB 转串口设备。
1. 在界面中选择正确的 `COM/tty` 设备。
1. 选择合适的波特率（常见 9600/115200/19200）。
1. 点击连接按钮建立串口连接。
1. 发送区输入要发送的数据，选择发送格式（如文本或十六进制）。
1. 点击发送，接收区会显示串口返回数据。
1. 需要断开时点击断开按钮。

### 界面截图
- 主界面
  ![主界面](img/main.jpg)
- 配置界面
  ![配置界面](img/lock_set.png)
- 控制界面
  ![控制界面](img/lock_controll.png)

### 常见问题
1. 找不到设备：检查 USB 线和驱动是否正常安装。
1. 无法连接：确认端口未被其他程序占用。
1. 乱码：波特率或数据格式不匹配，请重新选择。

### 目录说明
- `SerialManager.py` 主程序入口
- `SerialController.py` 串口读写与通信逻辑
- `LockConfigWidget.py` 配置界面
- `LockControlWidget.py` 控制界面