串口调试助手 · SerialLab

🔌 串口调试助手 -- 未连接 - ↓接收 0B · ↑发送 0B 学习首页

🔌 连接与参数

未连接

常用预设

波特率数据位停止位校验

RTS/CTS 流控自动重连失焦断连

每档采样 ms

改参数自动关端口重开。乱码按顺序试：识别编码 → 扫描波特率 → 二进制协议先在「解析」页签把模式切到 HEX 并配好帧结构，扫描才会按帧成功率判分（否则只按「像不像文本」判，HEX 帧永远扫不出来）。

🔀 手动信号

CTS - · DSR - · DCD - · RI -

🔤 编码与显示

编码发送换行

HEX 显示 HEX 发送显示时间戳

这三个只决定监视器「怎么显示」；把数据解析成通道请到「解析」页签，显示细节（时间格式/字号/标红）请到「显示」页签。

复位等待 ms

📦 开源协议预设

点一下即套用社区事实标准的帧结构，套用后仍可手动微调。完整的数据格式说明见介绍页「数据格式说明」一节。

🧭 解析模式

文本十六进制

📝 文本解析

等号 = 冒号 :

后缀数字视为独立通道（temp1 / temp2）

每行形如 temp=25.3, cur:1.02；数值支持整数与小数。Teleplot 的 >name:value 前缀写法也能直接解析。

📋 字段表

偏移相对整帧起始（含帧头）；类型支持 int8/uint8/int16/uint16/int32/uint32/float32。

🕒 时间与刷新

时间戳口径

刷新节流

串口数据一直在收，只是屏幕按这个频率重画。串口很吵（上百 Hz）时调低更省 CPU。

🔤 字体与高亮

监视器字号 px

数字高亮

解析 / 校验失败的行整行标红并标注原因

图表图例的勾选跨面板同步（按通道名）

量级差过大时提示拆分面板

🧠 面向 AI 的自动化回路

自动存档（连上或进入演示后自动录制，滚动保留最近数据）

存档上限帧

实际保留最近若干条原始记录（以当前生效值为准）

「复制 AI 提示词」把现场摘要（生效配置 + 帧结构 + 通道统计 + 失败原因 + 最近样本）拼成一段话写进剪贴板，直接粘给 AI 就够；要完整数据再导出调试包。

「存档上限」同时管录制帧数与原始记录条数——两者同源，不会再出现「界面写 2 万、AI 只拿到 5 千」。

「重放」用当前解析规则把缓存里的原始字节重新解一遍——改完帧结构不必让硬件重跑。

🤖 把数据送到 AI 能读到的地方

两条互补的通道：想「零配置、连上就能被 AI 读到」用上面的数据文件夹（推荐）；想「跨浏览器、可被脚本轮询」用 HTTP 上报。两者都不影响正常调试。

持续写入本地文件（单文件模式）

仅 Chromium 系浏览器。点「选择文件并开始」选一个保存位置（建议存到本仓库工作目录下），之后调试包会持续追加写入该文件，AI 直接读它即可，无需任何本地服务。刷新页面后需重选一次。推荐用顶部「📁 数据文件夹」代替。

HTTP 上报本地收件箱端口

先在本地跑一次收件箱：python _本地工具/serial-inbox.py。勾选后按生效间隔把调试包 POST 到 http://127.0.0.1:7788/ingest，落盘在 _本地工具/serial-inbox/。任何浏览器都可用。

通道状态：未启用

波形图片同样能被 AI 直接看；每张图都带面板名与生成时刻，便于多轮对照。也可点单个图表标题栏的 ⤓ 导出。

♻️ 恢复

把串口参数、解析规则、发送工作流、通道、面板与显示设置全部恢复默认，并清空本地存储。建议先用「数据」页签的「导出文件」备份一份。

📈 通道

解析出新键名时会自动建通道；这里可改标签、单位、颜色与显示精度。默认 8 色板深浅主题各一套，同屏曲线不会撞色。

⏱ 定时发送

🎯 触发应答

接收内容包含「匹配」字样时，自动发送「应答」内容。

⭐ 预设发送

预设项可绑定单字符快捷键（聚焦在发送框外时也生效），并可设置期望回包与超时。

🧩 新增图表框

渲染器

「图表」是声明式配置：选一个内置渲染器，再绑定通道、公式、坐标轴与颜色，零代码执行。把面板拖到主位即可与串口监视器互换位置。

✂ 拆分图表框

要拆的图表框

一块图表框里挤了太多通道时，共用一个 Y 轴会让跨度小的那条被压成贴底直线。这里自己勾选「哪些通道挪到新面板」——只挪走你勾的，其余留在原面板、量程不动。另有自动提示：量级差过大时会弹一次「按量级拆分」。

🗂 工作区面板

📦 面板包

⏺ 录制与冻结

录制中的原始帧会进内存缓冲，停止后可在下方回放或导出。

🎞 录制记录

📁 数据文件夹（存给 AI / Excel）

功能标识保留最近个

命名规范：seriallab_v<版本>_log-<功能标识>_<时间>.ndjson（持续调试流）与 seriallab_v…_data-<标识>_<时间>.csv（数据表）——AI / 脚本按 seriallab_v* 通配即可定位；超出「保留最近」个数的旧文件自动删除。落盘不受屏幕暂停影响，暂停期间照常写入。

⤓ 导出数据

CSV 带 UTF-8 BOM，Excel 打开中文不乱码。Markdown 是唯一「粘上去就能读」的格式：通道统计与最近记录都是表格，可直接贴进文档或对话。

🧾 配置

📴 离线

离线单文件打开后可查看界面与演示数据，但受浏览器安全模型限制，file:// 下无法使用真实串口；真机使用请通过 localhost 或 HTTPS 访问。

📜 日志

🧪 运行控制

未在测试

没硬件也能测：点一个案例卡片一键开跑，然后看监视器与波形的表现；再点一次同一卡片即停止。要把数据存成文件给 AI / Excel？到左栏「数据」页签点「📁 绑定数据文件夹」。

⭐ 常用案例

🧯 故障注入案例

特殊功能，日常调试用不到：注入对应故障后，练习在监视器与波形里识别「失败行标红 / 乱码排查条 / 时域断线」。

🎛 手动调参（一般不用碰）

拟真电机信号（阶跃 / 超调 / 纹波 / 噪声）

丢帧 % 错帧 % 粘包 % 乱码 %

无硬件时演练整条排错链路：失败行标红、失败原因分布、AI 调试包失败样本、乱码监测。全部 0 = 关闭注入。案例卡片本质就是帮你预设这几个参数。

主区监视器在上 · 波形在下 · 分割线可拖拽新图表