# serial_tool

**Repository Path**: Hongbin-Wei/serial_tool

## Basic Information

- **Project Name**: serial_tool
- **Description**: 一个安卓端的串口工具，用于做验证使用
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# serial_tool

一款Android平台的USB串口调试工具应用，用于连接和管理USB转串口设备，支持数据收发、参数配置等功能。

## 功能特性

- **设备扫描**：自动检测并列出可用的USB串口设备
- **设备连接**：支持USB设备的连接、断开操作
- **参数配置**：可配置波特率、数据位、停止位、校验位、流控制等串口参数
- **数据收发**：支持以ASCII或HEX格式发送和接收数据
- **日志显示**：实时显示收发数据及时间戳
- **多设备支持**：兼容多种CH340、CP210x等常见USB转串口芯片

## 项目结构

```
app/
├── src/main/
│   ├── java/com/example/usbserial/
│   │   ├── MainActivity.java       # 主界面：设备扫描与连接
│   │   ├── SerialActivity.java    # 串口通信界面
│   │   ├── SerialManager.java     # 串口管理核心类
│   │   ├── DeviceInfo.java       # USB设备信息
│   │   ├── DeviceAdapter.java    # 设备列表适配器
│   │   ├── SerialParameters.java   # 串口参数配置
│   │   ├── RecvLog.java          # 接收日志数据
│   │   ├── RecvLogAdapter.java  # 接收日志适配器
│   │   ├── DataLog.java         # 数据日志
│   │   └── DataLogAdapter.java  # 数据日志适配器
│   └── res/
│       ├── layout/               # 布局文件
│       ├── values/              # 资源文件
│       └── xml/                # USB设备过滤器
└── build.gradle                # 应用模块配置
```

## 技术栈

- **语言**：Java
- **最小SDK**：21 (Android 5.0)
- **目标SDK**：34 (Android 14)
- **主要依赖**：
  - `com.mik3y:usb-serial-for-android` - USB串口驱动库
  - `androidx.appcompat` - Material Design组件

## 安装教程

1. 确保Android设备已开启"开发者选项"中的"USB调试"
2. 将项目克隆到本地：`git clone https://gitee.com/Hongbin-Wei/serial_tool.git`
3. 使用Android Studio打开项目，等待Gradle同步完成
4. 连接Android设备，构建并运行（Build → Run 'app'）

## 使用说明

### 1. 扫描设备
点击"扫描设备"按钮，应用将自动检测并列出可用的USB串口设备。选择需要连接的设备后，可配置串口参数。

### 2. 配置串口参数
- **波特率**：9600、19200、38400、57600、115200等常用速率
- **数据位**：5、6、7、8位
- **停止位**：1、1.5、2位
- **校验位**：无、奇校验、偶校验、Mark、Space
- **流控制**：无、RTS/CTS、DSR/DTR、XON/XOFF

### 3. 连接设备
配置好参数后，点击"打开"按钮连接设备。连接成功后会自动跳转到串口通信界面。

### 4. 发送数据
在通信界面输入要发送的内容，选择ASCII或HEX格式，点击"发送"按钮。

### 5. 接收数据
接收到的数据会实时显示在列表中，支持切换ASCII或HEX格式查看。

## 注意事项

- 部分设备可能需要授予USB权限才能正常通信
- 确保使用的USB OTG线材支持数据传输
- 某些芯片可能需要安装对应的驱动程序

## 参与贡献

1. Fork本仓库
2. 新建功能分支：`git checkout -b feat_xxx`
3. 提交修改：`git commit -m '添加xxx功能'`
4. 推送到远程：`git push origin feat_xxx`
5. 创建Pull Request

## 许可协议

本项目仅供学习和研究使用。