# utools_serial_rw

**Repository Path**: fancy171101034/utools_serial_rw

## Basic Information

- **Project Name**: utools_serial_rw
- **Description**: 一个utools的串口工具

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-10
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 串口读写

用于 uTools 的串口收发工具，适合查看原始串口数据、发送 HEX 或文本内容，并记录每一次写入耗时。

![串口读写界面](public/demo.png)

## 功能

- 枚举、刷新并连接本机串口；默认优先选择 USB、SUB 或 `COM<number>` 设备端口。
- 支持在设置中配置波特率、HEX/文本模式、重复次数和发送间隔；配置保存在本地。
- 左侧实时显示串口原始数据，统计接收条数与字节数；可暂停显示、继续和清空。
- 右侧支持发送 HEX 字节或 UTF-8 文本，可从 uTools 文件入口或拖入 `.txt` 文件载入写入区。
- 支持重复发送：首次立即发送，后续发送在设定间隔结束后执行；发送中可取消。
- 发送日志实时记录源内容、每一次实际写入耗时，以及最终总耗时。
- 读写区域和右侧写入/发送日志区域均可拖动调整大小。

## 默认设置

| 项目 | 默认值 |
| --- | --- |
| 波特率 | `115200` |
| 数据格式 | `HEX` |
| 发送间隔 | `5000 ms` |
| 发送次数 | `1` |

在左上角设置按钮中可修改这些选项；点击“重置”会恢复默认值并保存到本地。

## HEX 写入

HEX 模式会将输入解析为真实字节，而不是把字符直接写入串口。空格、逗号、分号、下划线和连字符可作为分隔符。

```text
6D FF 3B 42 FC 72 5F B6
```

上例会写入 8 个字节。HEX 内容只能包含 `0-9`、`A-F` 和常见分隔符，且字节数必须完整。

## 关于接收分段

读取区域的每一行代表一次串口底层收到的数据块，不代表完整协议帧。一个协议帧可能被拆到多行，也可能多个协议帧合并到同一行；需要按设备协议自行进行帧头、长度和校验解析。

## 开发

```bash
npm install
npm run dev
```

在 uTools 插件开发模式中导入本项目目录。开发入口已在 `public/plugin.json` 中配置为：

```text
http://localhost:5173
```

## 构建

```bash
npm run build
```

构建产物位于 `dist/`，其中包含 uTools 所需的 `plugin.json` 与 `preload/services.js`。

## 项目结构

- `src/App.vue`：界面、设置、日志与交互逻辑。
- `public/preload/services.js`：串口枚举、连接、收发和取消写入。
- `public/plugin.json`：uTools 插件与文件入口配置。