03-界面说明
界面说明
整体布局
┌──────────────────────────────────────────────────────────────┐
│ ◆ 串口调试助手 v1.0 ⚫ 未连接 │ ← 头部栏
├────────────┬─────────────────────────────────────────────────┤
│ 串口设置 │ ┌─ 日志输出区 (QListWidget) ────────────────┐ │
│ ┌────────┐ │ │ [10:23:45.123] [TX] Hello Serial! │ │
│ │串口 │ │ │ [10:23:45.125] [RX] Hello Serial! │ │
│ │波特率 │ │ │ [10:23:50.000] [SYS] 串口已打开 COM3 │ │
│ │数据位 │ │ └──────────────────────────────────────────┘ │
│ │停止位 │ │ ┌─ 状态栏 ─────────────────────────────────┐ │
│ │校验位 │ │ │ TX: 128 bytes │ RX: 256 bytes [清][导]│ │
│ │流控 │ │ └──────────────────────────────────────────┘ │
│ │DTR/RTS │ │───────────────────────────────────────────────│
│ │编码 │ │ 发送区 │
│ └────────┘ │ ┌──────────────────────────────────────────┐ │
│ 显示设置 │ │ (QPlainTextEdit) │ │
│ ┌────────┐ │ └──────────────────────────────────────────┘ │
│ │Hex显示 │ │ ☐ Hex发送 ☐ Enter发送 [行尾▼] [发送] │ │
│ │时间戳 │ │ ☐ 自动发送 间隔 [1000] ms │ │
│ │自动滚动│ │ │ │
│ │行距/字号│ │ │ │
│ └────────┘ │ │ │
│ 数据可视化 │ │ │
│ ┌────────┐ │ │ │
│ │图表配置│ │ │ │
│ └────────┘ │ │ │
└────────────┴─────────────────────────────────────────────────┘
头部栏
| 元素 | 说明 |
|---|
| ◆ 串口调试助手 | 工具名称 |
| v1.0 | 版本号 |
| ⚫/🟢 | 连接状态指示灯（绿=已连接） |
左侧面板
| 控件 | 说明 | 可选值 |
|---|
| 串口 | 选择可用 COM 口 | 自动检测（点击刷新更新） |
| 波特率 | 通信速率 | 9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600 等 |
| 数据位 | 每帧数据位数 | 5, 6, 7, 8 |
| 停止位 | 停止位长度 | 1, 1.5, 2 |
| 校验位 | 错误检测方式 | None, Even, Odd, Mark, Space |
| 流控 | 流量控制方式 | None, RTS/CTS, XON/XOFF |
| DTR | 数据终端就绪 | 勾选开启 |
| RTS | 请求发送 | 勾选开启 |
| 编码 | 字符编码 | UTF-8, ASCII, GBK, GB2312, Unicode |
- 底部按钮：
- 连接/断开：打开或关闭串口
- 刷新：重新扫描可用串口列表
显示设置区
| 控件 | 说明 |
|---|
| 十六进制显示 | 勾选后日志以十六进制展示（如 48 65 6C 6C 6F） |
| 显示时间戳 | 勾选后每条日志前显示精确时间（格式 HH:mm:ss.zzz） |
| 自动滚动 | 勾选后新日志自动滚动到底部（推荐开启） |
| 行间距 | 调整日志行间距（-10 ~ +10 px） |
| 字号 | 调整日志字体大小（7 ~ 18 pt） |
数据可视化区（图表）
左侧底部面板，用于从接收数据中实时提取数值并绘制图表。基本配置项：
| 控件 | 说明 |
|---|
| 启用图表 | 勾选后激活图表功能 |
| 预设模板 | 快速选择常用图表配置 |
| 图表类型 | 折线图/平滑曲线/散点图/面积图/柱状图/饼图 |
| 规则名称 | 数据提取规则的标识 |
| 表达式 | 数值提取的正则或 JSON 路径 |
| 添加规则 | 将规则加入列表 |
| 智能分析 | 自动扫描数据推荐规则 |
| 时间窗口 | 图表显示的时间范围（5-600 秒） |
| 清除图表数据 | 清空图表所有数据 |
详细使用说明见下一章「功能详解」中的数据可视化部分。
右侧面板
| 特性 | 说明 |
|---|
| 字体 | Consolas 等宽字体 11pt |
| TX 颜色 | 🟡 金色 #FFD700 |
| RX 颜色 | 🟢 青色 #00FFC8 |
| SYS 颜色 | ⚪ 灰色 |
| 右键菜单 | 复制 / 复制全部 |
| 多选 | 支持 Shift/Ctrl 多选 |
状态栏
| 元素 | 说明 |
|---|
| TX: xxx bytes | 累计发送字节数 |
| RX: xxx bytes | 累计接收字节数 |
| 重置计数 | 清零 TX/RX 计数器 |
| 清除日志 | 清空日志列表 |
| 导出 | 导出日志为 TXT 或 CSV 文件 |
发送区
| 控件 | 说明 |
|---|
| 发送编辑框 | 输入要发送的文本或十六进制数据 |
| Hex发送 | 勾选后将编辑框内容作为十六进制解析发送 |
| Enter发送 | 勾选后在编辑框中按 Enter 即可发送 |
| 行尾 | 选择发送时自动追加的换行符：无、\n、\r、\r\n |
| 发送按钮 | 手动发送数据 |
| 自动发送 | 勾选后按指定间隔自动循环发送 |
| 间隔(ms) | 自动发送的时间间隔（毫秒） |