电导实验室图文资源库

外观

SerialWeb ​

SerialWeb 是一个基于 Web 浏览器运行的串口调试、协议解析与图形分析工具。
它把串口监视、时间线录制回放、文本解析、十六进制解析、时域图与频域图放进了同一套在线工作流中，让串口实验从“看到数据”走到“形成结果”，不再依赖多套割裂的软件工具。

在线访问地址：

快速上手 ​

如果你是第一次使用 SerialWeb，推荐按下面的顺序开始：

  1. 打开网页
  2. 在左侧打开设备连接管理
  3. 点击“连接设备”，从浏览器中选择目标串口
  4. 设置波特率、数据位、停止位、校验位
  5. 回到监视确认设备是否已经输出数据
  6. 如果这次实验需要保留过程，先开始REC时间线录制
  7. 再切换到解析建立文本模板或十六进制结构表
  8. 添加时域图和频域图进行观察
  9. 根据需要导出原始时间线或解析结果，进入下一步实验处理

如果你的目标不是只临时看一眼数据，而是希望后续还能回放、复查、重新解析和继续处理，那么“先录制时间线，再做解析”会是最稳妥的流程。

产品特点 ​

免费开源 ​

SerialWeb 以开放方式提供，适合个人实验、团队协作、教学演示和长期项目复用。

开箱即用 ​

打开浏览器即可使用。
你不需要再承担传统桌面工具常见的下载、安装、配置环境、手动更新和跨设备迁移负担。

轻量强大 ​

SerialWeb 的界面是轻量的，但能力不是轻量级的。
它覆盖了从原始串口接收、监视、录制，到协议解析、时域图、频域图，再到原始时间线和结构化结果导出的完整流程。

1. 产品定位 ​

SerialWeb 不是一个简单的“在线串口终端”，也不是一个单独的“波形绘图器”。
它的定位更接近于一个围绕原始串口数据构建的在线实验工作台。

在同一个页面中，你可以连续完成：

  1. 连接串口设备
  2. 接收并观察原始数据
  3. 录制为时间线
  4. 建立解析规则
  5. 提取结构化成功帧
  6. 绘制时域图和频域图
  7. 导出原始数据或解析结果

也就是说，它解决的不是“串口有没有打开”，而是“实验数据是否能被完整观察、复现、解释和带走”。

2. 适用场景 ​

SerialWeb 适合以下类型的工作：

  • 单片机、开发板、控制板卡与传感器的串口联调
  • 文本协议调试
  • 十六进制二进制协议解析
  • 连续采样数据的波形分析
  • 周期信号的频域观察
  • 实验数据记录、复盘与复现
  • 团队共享协议模板与实验过程

如果你的工作既要看原始串口内容，又要在后续继续做实验处理，那么 SerialWeb 会比传统“一个串口助手 + 一个绘图软件 + 一个导出脚本”的组合更连贯。

3. 运行方式与环境要求 ​

SerialWeb 基于浏览器的 Web Serial API 运行。
建议使用支持该能力的 Chromium 内核浏览器，并通过以下方式访问：

  • HTTPS
  • localhost

这也是它能够做到“直接在网页里连接串口”的前提。

4. 全局基础能力 ​

在进入监视模式与解析模式之前，先理解 SerialWeb 的几项全局基础能力，会更容易把整套流程用顺。

4.1 设备连接管理 ​

设备连接管理是整个系统的配置中枢。
在宽屏下，它以左侧面板展开 / 折叠；在窄屏下，它会以浮层形式打开，但两种形态下的内容和逻辑一致。

在这里可以完成以下配置：

  • 串口连接与断开
  • 自动重连
  • 波特率与预设值选择
  • 数据位、停止位、校验位
  • 失焦自动断连
  • 自动硬件流控
  • DTR / RTS / BREAK 控制
  • CTS / DSR / DCD / RI 状态查看
  • 文本编码设置
  • 换行模式设置
  • 十六进制显示 / 发送设置
  • 时间戳显示方式
  • 自动追加换行

这些配置不仅影响串口监视器显示，也会影响后续的录制、解析和回放行为，因此建议在实验开始前先完成确认。

4.2 深浅模式 ​

SerialWeb 支持自动与手动两种主题方式。

  • 页面会自动读取系统当前的浅色 / 深色主题
  • 同时你也可以通过顶部栏手动切换浅色模式与深色模式

这样可以在不同环境下自动适配观感，同时也允许你根据实验场景手动选择更适合当前观察的显示风格。

4.3 宽屏与窄屏适配 ​

SerialWeb 会根据屏幕宽度自动切换布局，以适应不同设备和使用场景。

在宽屏设备上：

  • 设备连接管理以左侧展开 / 折叠方式工作
  • 右侧拥有更完整的监视与图形分析空间

在窄屏设备上：

  • 设备连接管理以浮层方式打开
  • 时间线下拉与设备连接管理互斥
  • 弹出区域外背景自动变暗，帮助聚焦当前操作

因此无论是在桌面端长期实验，还是在平板 / 小尺寸设备上临时查看数据，系统都能保持一致的功能逻辑。

4.4 时间线系统 ​

时间线系统是 SerialWeb 的核心能力之一，而且在实际使用中应当尽早启用。
它不是一个附属的“顺手录一下日志”功能，而是一套围绕原始数据进行记录、回放和导出的实验材料体系。

时间线记录的内容 ​

时间线保存的是带时间信息的原始串口数据，而不是仅仅保存一份监视器文本。
这意味着一条时间线可以在后续重新用于：

  • 重建串口监视器显示
  • 重新应用文本解析模板
  • 重新应用十六进制结构表
  • 重新生成时域图与频域图

换句话说，它保存的是“实验现场”，不是“实验截图”。

为什么建议先录制时间线 ​

在很多实验场景里，最关键的数据往往出现在很短的时间窗口内。
如果只在监视器里看而不录制，那么后续一旦需要：

  • 复盘异常数据
  • 重新套解析模板
  • 重新导出原始内容
  • 和别人共享现场

你就只能依赖临时截图或复制文本，这会丢失很多上下文信息。

因此，SerialWeb 推荐的工作方式是：
先录制原始时间线，再逐步建立解析与图形分析。

时间线回放 ​

录制完成后，可以在顶部动态条中切换到对应时间线进行回放。

回放时，系统会根据原始数据重新生成：

  • 串口监视器内容
  • 解析结果
  • 时域图
  • 频域图

因此，回放并不是播放一张静态快照，而是重新走一遍数据解释过程。

时间线原始数据导入与导出 ​

时间线系统支持原始数据时间线的导入与导出，格式包括：

  • BIN
  • TXT
  • CSV

这部分数据保留的是原始串口数据与时间关系，适合：

  • 保存实验现场
  • 做时间线回放
  • 分享原始测试过程
  • 作为原始实验数据材料归档
  • 导出为 TXT / CSV 进入下一步原始数据处理流程

这里要特别强调：

录制得到的时间线本身，不仅可以回放，也可以直接导出为 TXT / CSV 用于后续实验处理。

基于解析设置导出标准结果数据 ​

除了原始时间线数据外，SerialWeb 还支持在已有解析设置的前提下，将当前时间线中的数据按解析结果导出为标准结果格式：

  • TXT
  • CSV

这部分导出的不再是原始串口流，而是已经按文本模板或十六进制结构表解释后的结构化字段数据。
因此它非常适合直接交给：

  • Excel
  • Python / MATLAB / Origin
  • 实验数据处理脚本
  • 报告与论文整理流程

也就是说，时间线系统既能保存原始现场，也能直接生成后续分析使用的标准数据结果。

冻结与锁定冻结 ​

冻结属于时间线系统中的“实时观察辅助能力”。

在正常实时模式下，若串口已连接且当前未录制，则顶部动态条会显示冻结按钮。
冻结逻辑同时作用于：

  • 监视模式
  • 解析模式

也就是说，在两种模式下，你都可以临时冻结当前显示，或者进一步锁定冻结结果。

冻结规则如下：

  • 鼠标进入动态条区域时，仅显示暂停按钮
  • 鼠标悬浮到暂停按钮上时进入临时冻结
  • 点击按钮后进入锁定冻结
  • 再次点击解除锁定

冻结只影响显示层，不影响后台继续接收原始数据。
因此它非常适合在高速数据流中暂停观察局部状态，又不打断真实实验过程。

5. 监视模式 ​

监视模式用于直接观察串口原始收发内容，是整个工作流的第一视角。
它解决的核心问题是：设备到底发了什么，系统到底收到了什么。

5.1 串口监视器 ​

串口监视器负责展示原始收发过程，它的重点不是把字节简单拼成一块文本，而是尽量保留真实接收节奏。

自动分显示帧 ​

原始数据进入监视器后，会按以下逻辑自动组织显示帧：

  • 遇到 \r\n、\r、\n 时自动分帧
  • 出现空闲间隙时自动分帧
  • 如果设备持续发送且不换行，则继续接续到当前消息中

这样做的结果是：

  • 行式文本协议可读性更好
  • 长时间连续流数据不会被粗暴打碎
  • 串口监视器仍然保留一定的接收过程感

顶部状态信息 ​

监视器上方会显示当前模式与统计值，例如：

  • 模式状态
  • TX 统计
  • RX 统计
  • FPS 刷新速率

在时间线回放模式下，这些统计会根据当前回放位置重新计算，而不是直接沿用实时模式的累计值。

显示缓存控制 ​

为了避免运行时间变长后监视器本身拖慢系统，SerialWeb 会控制监视器可见缓存，仅保留最近一段有效数据，并及时清除过早内容，以保持流畅性。

5.2 数据发送 ​

监视模式下，除了观察接收内容，你还可以主动驱动协议交互。

立即发送 ​

支持手工输入后立即发送，并遵循当前的编码、换行和十六进制设置。

定时发送 ​

适合周期轮询、心跳包、采样触发等场景。
你可以维护一个发送队列，系统按固定间隔自动循环发送。

触发发送 ​

触发发送允许你定义“收到什么后自动回复什么”。
这适合：

  • 简单握手
  • 自动应答
  • 根据设备返回值推动测试流程

预设发送 ​

预设发送可以把高频使用的命令整理成固定条目，并可附带预期响应，用于稳定重复验证设备状态或协议阶段。

5.3 在监视模式中的典型使用方式 ​

监视模式最适合承担这些任务：

  • 确认串口是否已正常连接
  • 验证设备是否真的在发数据
  • 观察换行与分帧情况
  • 检查编码是否正确
  • 用自动发送或触发发送完成联调
  • 在冻结状态下快速查看高速流中的局部细节

它通常是整个实验的起点。

6. 解析模式 ​

解析模式建立在同一份原始数据上。
它的目标不是再重复显示终端内容，而是把原始串口数据转换成成功解析帧，再进一步变成结构化结果和图形分析结果。

6.1 文本解析 ​

如果设备输出的是文本形式数据，文本解析通常是建立结构化分析的最快方式。

你可以通过模板提取例如：

  • A=12,B=3.14
  • temp-1=25.4
  • adc.ch0=1024

这样的字段结构。

模板中的名称匹配比较宽松，常见的：

  • _
  • -
  • .

都能作为字段名的一部分直接使用。

自动识别模板 ​

SerialWeb 还具备自动识别稳定文本结构的能力。
当系统检测到可用模板时，可以提示你：

  • 一键应用推荐模板
  • 自动切换到解析模式
  • 自动添加时域图与频域图

这让从“看原始文本”过渡到“进入图形分析”变得非常快。

6.2 十六进制解析 ​

如果设备输出的是二进制协议，则可以使用十六进制结构表建立帧结构。

可定义的结构包括：

  • 帧头
  • 数据
  • 校验和
  • 帧尾
  • 间隔符

默认结构采用常见形式：

  • 帧头 A5
  • 数据
  • 校验和 SUM8
  • 帧尾 5A

支持的数据类型 ​

系统支持的类型覆盖常见整数与浮点数据，例如：

  • uint8 / int8
  • uint16 / int16（大小端）
  • uint32 / int32（大小端）
  • float32（大小端）
  • float16 / ufloat16（大小端）
  • bool8

因此既能处理控制协议，也能处理采样流、状态帧和混合结构帧。

6.3 实时解析结果 ​

无论是文本解析还是十六进制解析，只要一帧成功识别，它就会进入统一的成功帧序列。
系统会把当前最新解析值显示成实时结果卡片，帮助你快速确认字段是否提取正确。

6.4 时域图 ​

时域图适合观察：

  • 趋势
  • 波动
  • 周期
  • 阶跃
  • 多通道关联

你可以为不同字段添加独立图框，并通过图框设置完成绑定与观察。

6.5 频域图 ​

频域图适合观察：

  • 周期信号主频
  • 频率成分分布
  • 采样节奏与稳定性

时域图和频域图都建立在统一的成功帧序列之上，因此你看到的图形结果与解析结果是统一的。

6.6 图框管理 ​

在解析模式中，你可以围绕不同字段自由建立图框。
图框支持：

  • 添加时域图
  • 添加频域图
  • 调整图框顺序
  • 设置绑定字段
  • 设置显示方式

这意味着从原始串口数据到图形分析，全都可以在同一页中完成，而不需要切到其他软件。

6.7 解析结果导出 ​

解析模式下，结构化结果可以直接导出为：

  • CSV
  • TXT

这些导出结果非常适合直接交给：

  • Excel
  • Python / MATLAB / Origin
  • 各类实验数据处理脚本
  • 报告与论文整理流程

也就是说，解析模式不是“看个图就结束”，而是可以直接把数据送入后续实验分析链路。

6.8 解析配置复制与复用 ​

图形解析配置支持复制与粘贴。
这意味着你可以把一整套解析模板、图框结构与图形配置快速迁移到另一台设备、另一位同事或另一套实验环境中。

这对于：

  • 团队统一协议模板
  • 保存成熟实验配置
  • 快速复用测试流程

都非常实用。

7. 推荐的实际使用方式 ​

如果你希望把 SerialWeb 真正用于实验，而不只是临时看一眼串口内容，推荐采用以下思路：

先连接设备并确认原始数据已经正确出现，再尽早开始录制时间线；随后建立文本解析模板或十六进制结构表，并加入时域图和频域图；最后根据需要导出原始时间线或结构化解析结果，继续进入实验处理。

这条流程的优势是：

  • 原始数据始终保留
  • 解析规则可反复调整
  • 图形分析与导出都基于同一份真实数据
  • 整个实验过程更容易复现、共享和归档

8. 项目信息与联系 ​

SerialWeb 是一个免费开源、开箱即用、轻量强大的在线串口实验工具。
如果你希望继续关注项目、反馈问题或联系电导实验室，可以通过以下方式：