# 串口助手

**Repository Path**: jackhunx/serial-helper

## Basic Information

- **Project Name**: 串口助手
- **Description**: 嘉立创EDA扩展：【串口助手】的源码。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://ext.lceda.cn/item/qiuzhihhq/serial-helper
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-30
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

使用小提示:在嘉立创 EDA 扩展管理器中勾选显示在顶部菜单栏以便快速访问插件功能。

![显示在顶部菜单栏](1769137560501.png)

点击串口助手后，弹出串口助手页面，之后点击连接串口，选择对应串口，即可收发串口数据

![界面](1769173193352.png)

新增暗黑主题，黑暗环境不刺眼

![暗黑模式](1769173144171.png)

# 串口助手
无需另外软件，网页直接收发串口数据！

---

## 📌 一、功能概览

- 支持中文显示（自动 GBK 解码）;
- 串口参数可配置：波特率、数据位、停止位、校验位;
- 发送模式：**字符串** 或 **十六进制**（如 `AA 55 01`）;
- 实时日志显示 + 自动滚屏;
- 一键清空 / 导出日志为 `.txt` 文件;
- 发送后保留内容，方便重复调试;
- 硬件DTR、RTS流控，直接控制硬件DTR、RTS电平；
- 指定周期(ms)自动发送数据至串口；
- 接收的数据可以切换字符串/十六进制显示；
- 白色/暗黑界面切换。
---

## 🔧 二、使用步骤

### 1. **连接设备**
- 点击 **【🔌 连接串口】**
- 在弹出的窗口中选择你的串口设备（如 `USB-SERIAL CH340 (COM3)`）
- 确保串口参数与设备一致（默认 `9600,8,N,1`）

> 💡 常见参数：
> - Arduino/ESP32：9600 或 115200
> - STM32/STC等MCU：9600 或 115200,8,N,1（需根据实际调整）

---

### 2. **接收数据**
- 设备发送的数据会**实时显示在日志框**中
- 中文自动正确显示（如 `气压:102588Pa 温度:18.3℃`）
- 日志带时间戳，便于分析

---

### 3. **发送数据**
#### 字符串模式（默认）：
- 在输入框输入：`AT+RST`
- 点击 **【📤 发送】** 或按 **回车**
- 助手会自动添加换行符 `\n`

#### 十六进制模式：
- 切换到 **【十六进制】** 单选
- 输入：`AA 55 01 FF`（用空格分隔）
- 点击发送 → 实际发送 4 个字节：`0xAA, 0x55, 0x01, 0xFF`

> ✅ 支持大小写（`aa 55` 也可）
> ❌ 不要加 `0x` 前缀！

---

### 4. **管理日志**
- **🗑️ 清空日志**：清除当前所有日志
- **📥 导出日志**：下载为 `serial_log_2026-01-22-22-45-00.txt`
  - 文件包含完整通信记录，可用于分析或提交 bug

---

### 5. **断开连接**
- 点击 **【⏹️ 断开】** 安全释放串口
- 断开后可重新连接其他设备

---

## ⚠️ 三、常见问题 & 提示

| 问题 | 解决方法 |
|------|--------|
| **点击“连接”无反应** | 检查是否被浏览器阻止（地址栏右侧是否有盾牌图标？）|
| **收到乱码** | 检查波特率是否匹配；确认设备是否使用 GBK 编码（本工具已默认支持） |
| **十六进制发送失败** | 确保格式为 `AA 55 01`，不要有 `0x`、逗号或中文符号 |
| **无法再次连接** | 先点“断开”，再重连；或刷新页面 |
| **日志太多卡顿** | 及时“清空日志”或“导出后清空” |

---

## 🛡 四、安全说明

- 首次使用必须**手动选择设备**（浏览器安全策略，无法跳过）
- 所有数据**仅在本地处理**，不会上传到任何服务器
- 仅访问你授权的串口设备，其他硬件不可见

---

## 📎 五、适用场景

- 调试 Arduino / STM32 / ESP32 / STC 等串口输出
- 与传感器、蓝牙模块、自定义单片机通信
- 查看带中文的日志信息（如温湿度、气压）
- 发送指令测试设备响应（AT 命令、自定义协议等）

---

> ✅ **提示**：如果你经常使用相同参数，建议记下设置（如 `115200,8,N,1`），下次直接填入即可。

---