# VUE-ComTest

**Repository Path**: tx007007/vue-com-test

## Basic Information

- **Project Name**: VUE-ComTest
- **Description**: 采用VUE开发的一个串口助手
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-22
- **Last Updated**: 2025-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ComTest - 串口通信测试工具

## 项目介绍
ComTest是一个基于Web技术开发的串口通信测试工具，使用Vue.js框架构建，支持串口参数配置、数据发送与接收、十六进制显示等功能。该工具可帮助开发者快速测试和调试串口设备通信。

## 功能特点

### 1. 串口配置
- 支持选择串口端口
- 可配置波特率、数据位、校验位和停止位
- 支持常用波特率（9600、115200等）

### 2. 数据接收
- 实时显示接收到的串口数据
- 支持ASCII和十六进制两种显示模式
- 支持自动添加时间戳
- 支持数据保存功能
- 支持自动断帧处理

### 3. 数据发送
- 支持文本和十六进制两种发送模式
- 自动在十六进制模式下格式化显示数据
- 支持定时发送功能
- 支持多种发送脚本

### 4. 数据管理
- 支持数据计数统计
- 支持数据导出为CSV格式
- 支持清空接收数据

### 5. 模拟功能
- 当浏览器不支持Web Serial API时，提供模拟模式
- 支持生成多种类型的模拟数据（ASCII、十六进制、ADC数据）

## 安装与运行

### 环境要求
- Node.js 14.x 或更高版本
- npm 6.x 或更高版本
- 支持Web Serial API的浏览器（推荐Chrome 89+或Edge 89+）

### 安装步骤
1. 克隆或下载项目到本地
2. 进入项目目录
   ```
   cd ComTest
   ```
3. 安装依赖
   ```
   npm install
   ```

### 运行开发服务器
```
npm run dev
```

开发服务器启动后，可通过浏览器访问 http://localhost:5173/ 或 http://localhost:5174/（取决于端口占用情况）使用工具。

### 构建生产版本
```
npm run build
```
构建后的文件将生成在 `dist` 目录中，可以部署到任何静态网站服务器。

## 使用说明

### 基本操作流程

1. **扫描端口**
   - 点击"扫描端口"按钮，系统会列出可用的串口设备

2. **选择端口并配置参数**
   - 从下拉菜单中选择要使用的串口端口
   - 配置波特率（默认为115200）、数据位、校验位和停止位

3. **打开端口**
   - 点击"打开端口"按钮，系统会尝试连接到选定的串口设备
   - 如果浏览器不支持Web Serial API，将自动进入模拟模式

4. **发送数据**
   - 在发送框中输入要发送的数据
   - 如需以十六进制格式发送，勾选"十六进制发送"选项
   - 点击发送按钮或按回车键发送数据

5. **接收数据**
   - 接收到的数据将实时显示在接收框中
   - 可通过"十六进制显示"切换显示模式

### 高级功能

#### 十六进制发送模式
- 勾选"十六进制发送"后，发送框中的数据将自动以十六进制格式显示
- 支持输入格式为空格分隔的十六进制值（如："48 65 6C 6C 6F"）
- 系统会自动验证输入的十六进制格式是否有效

#### 数据导出
- 点击"保存数据"按钮，可将当前接收的数据导出为CSV格式文件
- 导出的文件包含时间戳和对应的数据内容

#### 模拟数据
- 在模拟模式下，系统会自动生成模拟数据并显示在接收框中
- 可在设置中选择不同类型的模拟数据（ASCII、十六进制、ADC数据）

## 技术栈
- Vue.js 3
- Vite 5
- JavaScript/HTML/CSS
- Web Serial API（用于实际串口通信）

## 注意事项

1. **浏览器兼容性**
   - 目前Web Serial API仅支持Chrome、Edge等基于Chromium的浏览器
   - Firefox和Safari浏览器暂不支持Web Serial API，将自动进入模拟模式

2. **安全权限**
   - 使用Web Serial API需要用户授权浏览器访问串口设备
   - 首次使用时会弹出权限请求对话框，请选择"允许"

3. **数据格式**
   - 在十六进制模式下，确保输入有效的十六进制字符（0-9、A-F、a-f）
   - 系统会自动过滤掉不可打印的字符，保留可打印ASCII字符和换行符

4. **性能优化**
   - 对于大量数据的接收，系统使用了高效的字符串构建方式，避免性能问题
   - 长时间运行可能会积累大量数据，建议定期清空接收数据

## 常见问题解答

**Q: 为什么扫描不到我的串口设备？**
A: 请确保设备已正确连接到电脑，并且驱动程序已安装。部分系统可能需要管理员权限才能访问串口。

**Q: 为什么无法打开端口？**
A: 可能的原因包括：端口已被其他程序占用、权限不足、设备已断开连接等。请关闭其他可能占用串口的程序，然后重试。

**Q: 发送的数据与接收的数据不一致？**
A: 请检查波特率、数据位、校验位和停止位等参数是否与设备要求一致。在十六进制模式下，确保输入的格式正确。

**Q: 如何在没有实际串口设备的情况下测试工具功能？**
A: 当浏览器不支持Web Serial API或没有可用串口设备时，工具会自动进入模拟模式，并生成模拟数据用于测试。

## 更新日志

### 最新更新
- 修复了波特率默认显示值为9600的问题，修改为115200
- 实现了十六进制发送功能，勾选后自动格式化发送框数据
- 优化了数据处理逻辑，确保换行符正确显示
- 修复了偶尔无法换行的问题

## 版权信息

本项目为串口通信测试工具，仅供学习和测试使用。

© 2023 ComTest Team