piopulse 0.2.2

A terminal user interface (TUI) embedded debugger for serial debugging, telemetry plotting, dashboards, and ESP32 flashing.
piopulse-0.2.2 is not a library.

PioPulse

Crates.io License: MIT Docs.rs

默认中文文档。英文版见：README.en.md。

PioPulse 是一个 TUI 版本的嵌入式调试器。

它运行在终端里，面向 ESP32 和其他串口类嵌入式设备，把串口调试、遥测绘图、交互仪表盘、批量烧录和产线配置放在同一个键盘优先的界面中。它不是 Web 控制台，也不是桌面 GUI；核心使用场景是在终端中快速连接设备、观察数据、发送命令、记录调试过程，并在需要时进入多工位烧录流程。

界面总览

PioPulse 的主界面分为 5 个 TUI 页签：

  • 1：串口调试界面
  • 2：遥测绘图界面
  • 3：组件仪表盘界面
  • 4：批量烧录界面
  • 5：配置界面

下面按界面说明功能。

界面预览

截图资源位于 sources/ 目录，可直接在仓库首页展示主要界面状态。

串口调试 串口监视
串口调试界面 串口监视界面
批量烧录 遥测波形
批量烧录界面 遥测波形界面

演示视频：PioPulse TUI 操作录屏

界面 1：串口调试界面

这是 PioPulse 的主要嵌入式调试工作台，用来替代普通串口助手。

这个界面可以：

  • 选择当前调试串口
  • 启动或停止串口监视
  • 查看 RX/TX 调试日志
  • 在接收区查看设备输出
  • 在发送区输入并发送命令
  • 切换波特率
  • 切换 RX Hex 显示
  • 切换 TX Hex 发送
  • 控制发送时是否自动追加换行
  • 控制日志是否自动滚动
  • 使用快捷命令模板
  • 录制串口时间线
  • 回放时间线并重新解析数据

常用操作：

  • P：打开端口选择菜单
  • M：启动或停止串口监视
  • Space / Enter / I：进入发送输入
  • B：切换波特率
  • H：切换 RX Hex 显示
  • T：切换 TX Hex 发送
  • N：切换自动追加换行
  • S：切换自动滚动
  • R：开始或停止时间线录制
  • Y：开始或停止时间线回放

界面 2：遥测绘图界面

这个界面用于把串口中的结构化数据流转换成 TUI 内的实时图形，适合调试传感器、控制器、IMU、PID、电机状态和其他嵌入式遥测数据。

支持的 VOFA+ 数据解析模式：

  • FireWater
  • JustFloat
  • IndexFloat

支持的视图模式：

  • 波形图
  • 柱状图
  • 直方图
  • FFT 频谱
  • IMU 姿态视图
  • ROI 图像/区域预览

这个界面可以：

  • 选择采集端口
  • 查看当前协议、视图模式和运行状态
  • 启动或暂停数据采集
  • 清空当前端口的遥测缓冲区
  • 缩放、平移和重置波形窗口
  • 查看样本数量、通道数量和实时统计
  • 使用底部快捷命令向设备发送调试命令

常用操作：

  • M：切换 VOFA+ 解析模式
  • V：切换绘图视图
  • Space / S：启动或暂停绘图采集
  • C：清空当前端口遥测缓冲区
  • + / -：缩放视图
  • , / .：平移视图
  • 0：重置视图
  • [ / ] 或左右方向键：切换端口

界面 3：组件仪表盘界面

这个界面用于搭建 TUI 内的调试面板。它可以把常用控制件和显示件组合成一个嵌入式设备调试仪表盘，适合做参数调试、状态观察和交互控制原型。

当前可添加的组件包括：

  • Button
  • Slider
  • Dial
  • Knob
  • Toggle
  • Light
  • Gauge
  • Dashboard
  • Joystick
  • Pad
  • Ring
  • Cube
  • Image
  • Delay
  • Example

这个界面可以：

  • 从模块目录添加组件
  • 在分屏布局中显示多个组件
  • 选择当前聚焦组件
  • 删除当前组件
  • 查看当前端口的遥测缓存状态
  • 使用 3D Cube 观察或手动调试姿态数据
  • 使用按钮、滑块、仪表、指示灯等组件构建设备控制面板

常用操作：

  • A：打开组件添加菜单
  • D：删除当前组件
  • 左右方向键：切换聚焦组件
  • 在 Cube 组件上可使用 U/J/I/K/O/L 调整姿态，R 重置姿态

界面 4：批量烧录界面

这个界面是 PioPulse 的产线烧录工作台，用于多串口、多设备并发烧录。它仍然是 TUI 调试器的一部分，但面向更接近工厂或实验室批量验证的流程。

这个界面可以：

  • 自动扫描 USB 串口设备
  • 显示当前可烧录设备列表
  • 并发执行多个设备的烧录任务
  • 每个设备独立显示状态、进度和结果
  • 单个设备失败时不阻塞其他设备
  • 读取芯片与 MAC 信息
  • 生成并写入 NVS 身份数据
  • 记录 SN、Device Name、批次、固件版本和 Trace ID
  • 展示校验方式、QA 结果、安全状态和写入字节数

设备表会显示的典型信息包括：

  • 端口
  • 目标芯片
  • MAC 地址
  • SN
  • Device Name
  • 固件版本
  • 批次号
  • 当前流程状态
  • 烧录进度
  • QA 结果
  • 安全状态
  • Trace ID

常用操作：

  • Space：烧录选中的设备
  • B：批量烧录全部设备
  • C：在未烧录时清空生产统计
  • F2：在宽屏终端中显示或隐藏侧边栏

界面 5：配置界面

这个界面用于维护项目配置、烧录参数和产线策略。配置页默认受管理员模式保护，避免操作员误改关键参数。

可以配置的内容包括：

  • 项目名称
  • 芯片类型
  • 波特率
  • Flash 模式、频率和大小
  • bootloader、partitions、otadata、app 固件路径与偏移
  • NVS 偏移
  • 校验方式
  • 空片检查策略
  • 擦除模式
  • 增量烧录开关
  • Secure Boot 策略
  • Flash Encryption 策略
  • 烧录后锁定策略
  • 操作员角色
  • 固件版本
  • SN 前缀
  • 批次号
  • MES 地址
  • 标签模板
  • QA 测试脚本

常用操作：

  • F1：进入或退出管理员模式
  • 上下方向键：选择配置项
  • Enter：在管理员模式下编辑当前配置项
  • Esc：取消编辑或退出弹窗
  • Space：在配置确认后也可触发烧录流程

运行

cargo run

全局快捷键

  • 1：串口调试界面
  • 2：遥测绘图界面
  • 3：组件仪表盘界面
  • 4：批量烧录界面
  • 5：配置界面
  • F1：管理员模式解锁/锁定
  • F2：显示/隐藏侧边栏
  • Esc：退出、关闭弹窗或取消编辑
  • Q：打开退出菜单

项目结构

  • src/main.rs：终端初始化、事件循环、键盘/鼠标分发
  • src/app.rs：应用状态、通道状态、统计、端口扫描、交互处理
  • src/ui.rs：主布局和 Tab 路由
  • src/ui/serial.rs：串口调试界面和快捷命令面板
  • src/ui/plotter.rs：遥测绘图界面
  • src/ui/widgets/：组件仪表盘界面和组件实现
  • src/ui/channels.rs：批量烧录设备表和产线看板
  • src/ui/config.rs：项目配置和产线参数配置
  • src/worker.rs：后台烧录任务和串口监视任务
  • src/nvs.rs：ESP32 NVS 身份数据生成

当前状态说明

PioPulse 当前已经实现 TUI 串口调试、串口监视、命令发送、时间线录制/回放、VOFA+ 数据解析、TUI 遥测绘图、组件仪表盘、ESP32 串口烧录、MAC 读取、SN/NVS 生成写入和批量烧录看板。

MES 上传、标签打印、Secure Boot eFuse 锁定、Flash Encryption 实际启用、完整硬件 QA 脚本等能力已经进入配置和流程状态，但还需要按具体工厂环境继续接入真实后端或设备接口。