QtSerialMonitor 功能详细介绍

概述

QtSerialMonitor 是一款使用 Qt / C++ 编写的通用串口监视与数据绘图工具，由 mich-w 开发维护。遵循 GPL-3.0 许可证开源分发。本包为 Windows x64 绿色版（含 Qt 运行库），位于 `deploy` 子目录。

• 项目地址：https://github.com/mich-w/QtSerialMonitor
• 当前版本：v1.53
• 运行平台：Windows x64
• 部署方式：进入 `deploy` 子目录，双击 `QtSerialMonitor.exe` 即可运行（绿色版，含 Qt 运行库）
• 技术栈：Qt / C++（QCustomPlot 绘图库）

核心功能模块

1. 串口收发终端

• 串口参数配置：波特率、数据位、停止位、校验位、流控全可配置
• 收发显示：实时显示发送和接收数据，支持 HEX/ASCII 模式
• 命令历史：自动记录发送历史，支持上下键回溯
• 自动重连：设备插拔自动重连
• 自动滚动：新数据自动滚到底部

2. UDP 网络协议支持

• UDP 通信：支持 UDP 数据收发
• 端口配置：绑定本地端口，发送目标数据
• 数据查看：同串口界面，支持 HEX/ASCII 切换

3. 可调整大小的 UI 组件

• 自适应布局：窗口组件大小可自由调整
• 灵活布局：根据使用场景自定义界面布局
• 多面板：支持多个功能面板同时显示

4. 多曲线数据绘图

• 实时绘图：基于 QCustomPlot 库实时绘制数据曲线
• 多曲线显示：支持同时显示多条数据曲线
• 数据滤波：基础数据滤波功能（移动平均等）
• 波形控制：缩放、平移、暂停

5. 打印支持

• 图形保存：曲线图可保存为图片文件
• 打印输出：支持直接打印当前图形
• 导出功能：图形数据可导出为图片格式

6. 数据日志读写

• CSV 支持：读写 `.csv` 数据日志文件
• TXT 支持：读写 `.txt` 文本日志
• 数据导入：从文件加载历史数据
• 数据分析：对加载的数据进行可视化展示

配置文件说明

依赖与第三方库

适用场景与优势

版本历史摘要

运行方式

1. 解压软件包到任意目录
2. 进入 `deploy` 子目录
3. 双击 `QtSerialMonitor.exe` 即可运行
4. 无需安装任何额外依赖（Qt 运行库已内置）

提示：本绿色版已包含 Qt 运行库，无需单独安装 Qt。

QtSerialMonitor 详细使用教程

目录

1. [快速上手（5分钟入门）](#快速上手5分钟入门)
2. [串口基础收发操作](#串口基础收发操作)
3. [UDP 网络通信](#udp-网络通信)
4. [数据绘图与曲线](#数据绘图与曲线)
5. [数据滤波](#数据滤波)
6. [数据日志导入导出](#数据日志导入导出)
7. [打印与图片保存](#打印与图片保存)
8. [窗口布局调整](#窗口布局调整)
9. [配置管理](#配置管理)
10. [常见问题与故障排查](#常见问题与故障排查)

快速上手（5分钟入门）

1.1 启动程序

# 进入目录
cd D:\工业协议\商业产品\开源工具包\QtSerialMonitor\deploy

# 双击运行
QtSerialMonitor.exe

• 首次运行自动生成配置文件
• 界面默认中文，顶部菜单：`文件` `设置` `工具` `帮助`

1.2 打开串口（最基础操作）

• 选择端口：顶部下拉框 `端口` → 选择目标 COM 口（如 `COM3`）
• 设置参数：
• 波特率：`9600`（默认，按设备手册修改）
• 数据位：`8`
• 停止位：`1`
• 校验位：`None`
• 打开：点击 `打开串口` 按钮 → 状态灯变绿
• 测试发送：
• 发送区选择 `HEX` 模式
• 输入：`01 03 00 00 00 01`（标准 Modbus 读保持寄存器示例）
• 点击 `发送` → 接收区显示返回报文

成功标志：接收区出现数据行，含时间戳和收发数据

串口基础收发操作

2.1 编码模式切换

2.2 收发区功能

2.3 发送区功能

UDP 网络通信

3.1 UDP 发送

1. 菜单 `工具` → `UDP` → `UDP Client`
2. 配置目标地址：`IP:Port`（如 `192.168.1.200:9000`）
3. 点击 `连接` → 开始发送 UDP 数据
4. 接收区显示返回数据

3.2 UDP 监听

1. 切换 `UDP Server` 模式
2. 绑定本地端口 `9000`
3. 点击 `开始监听`
4. 收到数据后显示在接收区

数据绘图与曲线

4.1 打开绘图窗口

1. 菜单 `视图` → `数据绘图`（或快捷键 `F3`）
2. 独立可停靠窗口显示曲线图

4.2 添加数据通道

1. 曲线窗口右键 `添加通道` → 配置：
2. 通道名：`温度`
3. 数据源：串口接收解析 / 手动输入
4. 解析规则：正则表达式提取数据值
5. 数据类型：整数 / 浮点数
6. 单位：°C / mV 等
7. 颜色/线型：自动分配或手动指定
8. `确定` → 曲线实时绘制

4.3 曲线操作

4.4 多曲线显示

• 支持同时显示多条数据曲线
• 每条曲线独立配置颜色、线型、数据源
• 曲线图例可显示/隐藏

数据滤波

5.1 启用滤波

• 曲线窗口右键 `数据滤波` → 启用
• 选择滤波方式：
• 移动平均：平滑数据波动
• 峰值滤波：去除异常峰值
• 阈值滤波：超出阈值的数据过滤

5.2 滤波参数配置

数据日志导入导出

6.1 导出数据日志

1. 菜单 `文件` → `导出日志` → 选择格式：
2. CSV：表格格式，可用 Excel 打开
3. TXT：纯文本格式
4. 选择保存路径
5. 数据包含时间戳、方向、数据值

6.2 导入历史数据

1. 菜单 `文件` → `导入日志` → 选择 `.csv` 或 `.txt` 文件
2. 数据自动加载到曲线图和表格中
3. 可对历史数据进行分析和回放

6.3 日志文件结构

data/
├─ 20260115_083000_COM3.csv    # CSV格式，含时间戳和数据
├─ 20260115_083000_COM3.txt    # TXT格式
└─ index.json                   # 索引文件

打印与图片保存

7.1 保存曲线图片

1. 在曲线窗口点击右键
2. 选择 `导出图片` → 选择格式（PNG/JPG/BMP）
3. 选择保存路径

7.2 打印输出

1. 菜单 `文件` → `打印`
2. 选择打印范围（当前视图/全部数据）
3. 选择打印机 → 点击 `打印`

窗口布局调整

8.1 调整组件大小

• 拖动面板边框调整组件大小
• 支持多个面板自由排列
• 布局自动保存

8.2 面板停靠与浮动

• 面板可停靠到主窗口边缘
• 也可浮动为独立窗口
• 拖拽面板标题栏切换状态

8.3 保存/恢复布局

1. 菜单 `设置` → `窗口布局` → `保存布局`
2. 给布局命名（如 `默认布局`、`调试布局`）
3. 需要时 `加载布局` 选择已保存的布局

配置管理

9.1 保存配置

1. 菜单 `设置` → `保存配置`
2. 配置文件自动保存至 `settings.ini`
3. 包含串口参数、窗口布局、绘图设置等

9.2 加载配置

1. 菜单 `设置` → `加载配置`
2. 选择配置文件
3. 所有设置自动恢复

9.3 配置文件位置

QtSerialMonitor/
├─ QtSerialMonitor.exe
├─ settings.ini          # 用户设置
├─ plots.cfg             # 图表配置
└─ data/                 # 数据日志目录

常见问题与故障排查

进阶技巧

10.1 快捷键

10.2 多实例运行

• 复制整个目录 → 重命名 → 同时运行多实例
• 各实例监控不同设备

10.3 批量数据处理

• 导入大量 CSV 数据
• 使用绘图窗口进行批量分析
• 导出分析结果

附录：典型应用场景

Arduino 项目调试

1. 连接 Arduino 到 COM 口
2. 打开串口，波特率 `9600`
3. 上传串口监视代码
4. 查看实时数据和曲线
5. 使用数据滤波平滑曲线

传感器数据采集

1. 连接传感器到串口
2. 配置数据解析规则
3. 实时绘制温度/压力等曲线
4. 导出 CSV 进行后续分析
5. 打印或保存曲线图片

通信协议分析

1. 选择 HEX 模式
2. 发送特定指令
3. 分析返回数据
4. 保存日志用于回溯

提示：本教程基于 QtSerialMonitor v1.53 编写，界面细节可能随版本微调。遇到未覆盖场景，请参考程序内 `帮助` → `在线文档` 或 GitHub Issues: https://github.com/mich-w/QtSerialMonitor/issues