# serial_tool_ai

**Repository Path**: madaostdio/serial_tool_ai

## Basic Information

- **Project Name**: serial_tool_ai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 串口上位机（Python + PyQt5）

这是一个使用 Python 编写的简易串口调试助手（上位机），在 Windows 下运行良好，也可在其他安装了 Python 的系统使用。

## 功能特性

- 串口管理：枚举可用串口，打开 / 关闭串口
- 参数配置：波特率、数据位、校验位、停止位配置
- 数据接收：
  - 文本模式显示
  - 十六进制显示（可选）
  - 自动滚动、清空接收区
- 数据发送：
  - 文本发送，可选自动追加 `\r\n`
  - 十六进制发送（以空格或逗号分隔，如：`01 02 0A FF`）
  - 清空发送区

## 环境准备

1. 安装 Python（建议 3.8+）
2. 在本项目目录下安装依赖：

```bash
pip install -r requirements.txt
```

如果你有多版本 Python，可使用：

```bash
py -3 -m pip install -r requirements.txt
```

## 运行方式

在项目目录 `e:\\workplace\\cursor_workplace` 下执行：

```bash
python main.py
```

或：

```bash
py main.py
```

## 使用说明

1. 启动程序后，点击“刷新串口”，在“串口”下拉框中选择需要打开的串口
2. 根据设备要求设置波特率、数据位、校验位、停止位
3. 点击“打开串口”，状态栏会显示“已连接”
4. 在“发送区”输入要发送的内容：
   - 文本模式：直接输入字符串，若勾选“自动添加换行(\\r\\n)”则会自动在末尾追加回车换行
   - 十六进制模式：勾选“十六进制发送”，输入如 `01 02 0A FF` 这样的 16 进制字节序列
5. 点击“发送”发送数据
6. 接收的数据会显示在上方“接收区”，可选择“十六进制显示”查看原始字节

## 常见问题

- 启动提示未找到 `pyserial`：
  - 请先执行 `pip install -r requirements.txt`
- 串口列表为空：
  - 检查设备是否正确连接
  - 若使用 USB 转串口，请安装对应驱动后重新点击“刷新串口”