RiverPlusCOM串口调试助手

70 阅读11分钟

转载请注明出处,谢谢


一、关于这个工具

我是个爱折腾的人,平时没少和各种串口设备打交道。调试的时候,总觉得缺一个真正顺手的工具——于是就自己动手做了这一个。

它不追求大而全,只求好用:打开就能连、配置自己记、常用指令排好队自动发,还能自动回复

最得意的一点:它能自动回复——设备发来什么,它按你设的规则自己接话。你不在位子上,链路也照样跑得通。这一点下面会细说。

项目说明
名称RiverPlusCOM串口调试助手
当前版本V1.0.0 预览版
运行环境Windows / .NET Framework 4.8
作者RiverPlus
定位免费、个人维护、仅供学习交流

image.png

二、项目亮点

把串口调试里最常用的需求一次性照顾到,几个最实用的点:

  • 🤖 自动回复(核心亮点) :按规则自动应答,让串口工具从“监听器”升级为“智能从机”,协议调试进入自动化模式。
  • 📋 多条发送 + 循环发送:把常用指令排成一队,勾选后按设定周期自动循环发送,调试重复指令不用再手动狂点。
  • 👀 接收区看得清也停得住:连续到达的数据自动合并成一条;关掉自动滚动,历史内容不会被冲掉、选中文字不会丢;接收 / 发送 / 自动回复三色区分,一眼分清。
  • 💾 配置自动保存 + 导入导出:串口参数、指令集、发送历史各自存好,换电脑、分享同事一键搞定;窗口大小和面板状态下次打开原样恢复。
  • ⌨️ 顺手的小操作:单条发送回车即发、Ctrl+回车换行、最近 20 条发送历史随时复用;状态栏一键置顶,调试时不被别的窗口盖住。

三、几分钟上手

  1. 准备:下载并解压软件(下载方式见文末),确认电脑已装好 .NET Framework 4.8(Win10 1809+ / Win11 通常自带,没有就去微软官网装运行库)。
  2. 连接:USB 转串口线接好设备 → 打开软件 → 选对 串口号波特率 → 点「打开串口」(按钮会变成「关闭串口」,参数框同时锁定,防止误改)。
  3. 收发:在「单条发送」里敲指令按回车即可发出;在「多条发送」里排好队伍点「循环发送」;收到的内容实时显示在上方接收区。

💡 收不到数据?先核对双方波特率、数据位、停止位、校验位是否一致;中文乱码请勾选「16进制显示」。


四、功能全景

image.png

image.png


五、界面导览

软件界面自上而下分为三块:串口参数区 + 接收区(上)、功能标签页(下)、状态栏(底)。下方标签页共五个:单条发送、多条发送、自动回复、帮助。


六、功能详解

6.1 串口参数区:把线接上

参数可选值默认值
串口自动枚举系统可用 COM 口,点「刷新」重新扫描第一个可用端口
波特率预置 1200 ~ 921600,也可直接输入任意值9600
数据位5 / 6 / 7 / 88
停止位1 / 1.5 / 21
校验位None / Odd / Even / Mark / SpaceNone
DTR / RTS硬件流控开关关闭

细节:

  • 打开串口后,串口号 / 波特率 / 数据位 / 停止位 / 校验位 / 刷新按钮全部禁用,避免连线中途误改参数。
  • 除波特率外的下拉框都设为纯列表样式(不可手输),并禁用了滚轮翻页——滚动时不会再因为误触滚轮把参数改掉。

6.2 接收区:看得清,也停得住

① 显示开关

开关作用默认
16进制显示收到的数据以 48 65 6C 6C 6F 形式展示,排查二进制协议不再是天书
显示时间戳每条报文前加 [HH:mm:ss.fff] 毫秒级前缀
显示发送自己发出去的内容也回显到接收区
自动滚动新数据到来时自动跟随滚动到最新

② 智能合并报文

串口数据往往连续到达,一条完整报文可能被拆成几段。工具会把短时间内连续到达的内容自动合并成一条,只打一个时间戳,并保留报文自带的分行。所以日志里一条报文就是一条,清清楚楚;关软件前也会把最后一段数据完整刷出,不会丢。

③ 关闭自动滚动,画面停得住

关掉「自动滚动」后,你翻看的历史内容不会被新数据冲掉,选中的文字也不会丢失。

④ 三色日志,一眼分清谁是谁

内容颜色
接收到的数据深灰 #2D2D2D
自己发出的内容蓝色 #0B62C7(前缀 [发送]
自动回复发出的内容青绿 #0E8A6B(前缀 [自动回复]

⑤ 容量保护:接收内容超过 5000 行时自动裁剪,只保留最近 3000 行,长时间挂机也不会把内存吃穿。需要留存时用「保存接收」导出为 .txt

6.3 单条发送:历史记录 + 回车即发

  • 回车 = 发送Ctrl + 回车 = 在光标处换行(不会发送)。这对调试多行指令很关键。
  • 发送历史:自动记住最近 20 条发送内容,下拉即可复用;按内容去重,重复发送的内容会被提到最前面;多行指令也能完整保留和回填,下拉列表里换行以符号显示。
  • 输入框做了高亮处理,待发送的内容更醒目。
  • 「16进制发送」支持空格、横杠、逗号分隔,形如 01 03 00 00-00 01;格式不对会直接提示,不会把错数据发出去。
  • 「发送新行」勾选后自动在末尾追加 \r\n(多数设备指令的结束符)。

6.4 多条发送:把常用指令排好队

这是日常用得最多的一页。

  • 布局:每页 10 条,2 列 × 5 行;序号跨页连续递增,翻页不会重新开始编号。
  • 点序号即发:每行右侧的序号就是发送按钮,调哪条点哪条,空内容不发送。
  • 勾选启用:只有勾选的行参与循环发送。
  • 分页管理:首页 / 上一页 / 下一页 / 尾页,外加页码输入框 + 「跳转」;「添加页码」「移除此页」随时增删页面(至少保留一页)。
  • 循环发送:设定周期(毫秒,默认 1000)后点「循环发送」,所有勾选且非空的指令会按周期自动发送;点「停止循环」或关闭串口即全部停止。
  • 全局开关:面板上的「16进制发送」「发送新行」作用于本页发送。
  • 导入 / 导出:整套指令导出为 .ini,换电脑、分享同事都能直接用。导出文件只包含指令行数据,不会覆盖本机的面板选项。

6.5 自动回复:让工具替你应答(核心亮点)

🌟 这是最得意的功能,也是它和普通串口助手最大的区别——它能替你回话

在「自动回复」页维护一张规则表,让软件扮演设备端,在你不在场时也能自动应答:

| 序号 | 启用 | 匹配模板(收到) | 应答模板(回复) | 备注 |

  • 每页 8 条,2 列 × 4 行;序号跨页连续。
  • 匹配方式:设备发来的数据按当前显示形式(文本或 16进制字符串)做包含匹配。命中后立刻自动回复应答模板,并在接收区打一条青绿色的 [自动回复] 记录。
  • 只有同时填了匹配模板和应答模板勾选启用的规则才生效。
  • 导入 / 导出 CSV:文件带表头 匹配模板,应答模板,备注,用 Excel 批量维护规则再导回来很方便。

典型用法:上位机程序还没写完,先用它模拟下位机应答,把链路先跑通;或者做压力测试时让工具自动"接话"。

6.6 帮助与打赏:如果它帮到了你

这个工具是我利用业余时间一点点做出来、并且会长期维护下去的。它完全免费,你拿到手就能用,没有弹窗、没有套路。

如果你用着觉得"诶,这玩意儿还挺省心",那对我来说就是最大的鼓励。软件里放了一个打赏页,要是愿意,可以请我喝杯咖啡,金额随意,哪怕只是扫一下我也很开心。当然,不扫码也完全没关系,工具你照样放心用

有想法、碰到问题、或者想加点什么功能,都欢迎联系我或评论区提出来。一个好用的小工具,靠的往往就是这些真实的反馈。

6.7 状态栏

底部状态栏实时显示:当前时间(每秒刷新)、连接状态已连接 COM3@9600 / 未连接)、收发字节数R:接收 S:发送),最右侧是 「置顶」 按钮——调试时把窗口钉在最前,不被别的窗口盖住。


七、你的配置会自动保存

程序会在目录下生成三个配置文件,分别保存不同类型的数据,互不干扰:

  • 主配置:串口参数、显示选项、单条发送设置、自动回复规则
  • 多条发送配置:你排好的指令集
  • 发送历史:最近用过的发送内容

好处很直接:多条发送是变动最频繁的数据,单独存一份,分享 / 备份指令时不会把串口参数一起带出去。

其它:

  • 关闭窗口时统一保存,下次打开原样恢复;
  • 保存时会自动去掉末尾的空规则,文件不会越存越臃肿;
  • 窗口只能往大拖,不会被缩到控件互相挤压;
  • 老版本升级时,原有的指令会自动并入新格式,无需手动迁移。

八、快捷键与操作小技巧

操作效果
单条发送框 Enter发送
单条发送框 Ctrl + Enter在光标处插入换行(不发送)
多条发送页码框 Enter跳转到该页
点击行序号立即发送该行
点「置顶」窗口置顶 / 取消置顶
关闭串口自动停止所有循环发送

九、常见问题(FAQ)

Q:打开软件提示缺少 .NET Framework 4.8?

A:去微软官网下载安装 .NET Framework 4.8 运行库。Win10 1809+ 与 Win11 通常已自带。

Q:收不到数据 / 数据是乱码?

A:先核对双方的波特率、数据位、停止位、校验位是否完全一致。中文乱码可勾选「16进制显示」;程序收发统一使用 UTF-8,若对方设备使用其它编码(如 GBK),文本会显示异常,需要确认设备的编码方式。

Q:日志里一条报文被拆成了好几行?

A:工具默认会把短时间内连续到达的数据自动合并成一条(约 80 毫秒内的数据合并显示,只打一个时间戳)。若设备端发送间隔本身较长、一段数据本来就是分多次发出来的,日志里自然会是多行;这种情况下一般不影响使用,让设备一次发送完整报文即可避免。

Q:我攒的指令和规则会丢吗?

A:不会。关闭窗口时自动写入配置文件,下次启动原样恢复。重要配置建议用「导出」单独备份一份。

Q:多条发送的文件能和别人共享吗?

A:可以。点「导出」得到只含指令行数据的 .ini,对方点「导入」即可,不会覆盖他本机的串口参数。

Q:自动回复支持 16 进制回复吗?

A:匹配是按当前显示形式(文本或 16进制字符串)做包含匹配;应答模板目前按 UTF-8 文本发出并自动追加换行。二进制协议的 16 进制应答会在后续版本中完善。


十、许可与用户协议

本软件为免费软件,使用即代表你同意以下条款:

  1. 本软件为免费软件;
  2. 仅供内部 / 授权用户免费使用,不限频次;未经作者许可,严禁将本软件或其副本泄露、提供给任何外部第三方,或上传至公共网络平台;
  3. 不可对本软件进行逆向工程;
  4. 使用本软件所产生的任何后果,由用户自行承担;
  5. 本软件由个人开发者维护,仅供学习交流。

运行环境:.NET Framework 4.8。

联系方式


下载(网盘)

💾 本项目通过网盘分发,下载后解压即可运行(需先安装 .NET Framework 4.8)。

📦 点击从夸克网盘下载 RiverPlusCOM

转载请注明出处,谢谢

一个小小的串口工具,一份写给用得顺手的人的说明。