Automate the bench. Measure what matters.

Instrument Control · Automated Measurement · Data Analysis · Open Source

_{An open-source toolkit for automated laboratory measurement and instrument control.}

---

中文文档 · English Overview · 更新日志 · 仪器插件仓库

---

Warning

WaveBench 可以连接并控制真实实验设备。执行会改变仪器状态的命令前，应确认接线、输入阻抗、输出状态以及电压／电流限制。

WaveBench 是面向电子设计调试和日常实验的 Python 测量台。它将仪器操作、显式 run plan 和可复查的实验产物放在同一条工作流中：先离线检查，再连接实验台，最后执行受控实验。

适用范围

• 用信号源、示波器、电源和万用表组成可复现的实验流程。
• 用 run check 在不连接仪器的情况下检查 plan。
• 将采集包、运行记录和离线 HTML 报告保存在同一实验产物中。
• 用显式命令控制输出、采集和恢复，不在后台隐式执行 reset 或输出切换。
• 通过已安装的 instrument plugin 扩展具体仪器型号。

无硬件快速开始

以下命令只安装包、列出模板并打印一个示例 plan；不会连接仪器或打开输出。

git clone https://github.com/Scaxlibur/WaveBench.git
cd WaveBench
python3 -m venv .venv
.venv/bin/python -m pip install -e .
.venv/bin/python -m wavebench run template --list
.venv/bin/python -m wavebench run template source-scope-sine --print
.venv/bin/python -m wavebench run check --plan plans/closure_sine_1k.toml

最后一条命令以 safety_limits=ok / 安全上限=通过 结束时，表示示例 plan 已通过离线检查。完整的预期结果、Windows 命令和下一步见无硬件快速开始。

支持范围

类别	Core 提供的通用能力	精确型号状态
示波器	读取、采集、截图和受 capability 约束的控制	由内建或已安装插件 descriptor 声明
信号源／RF 信号源	显式配置、输出控制、run plan 和安全预检	由对应插件的 profile 与 evidence 声明
电源／万用表	状态、设定、读数与 run plan 集成	由对应插件 descriptor 声明
插件	发现、安装和公开插件 API	具体型号、SCPI、quirk 和限制见仪器插件仓库

用文档首页按任务进入正确页面；精确命令、字段和 capability 以程序输出、schema 与 descriptor 为准，而不是以本页摘要为准。

安全摘要

• run schema、run template、run check 和 run report 不连接仪器。
• doctor 与 run verify 会查询真实设备；先确认资源与接线。
• run plan、输出控制、采集和部分 TUI 操作可能改变仪器状态。
• WaveBench 不自动执行 *RST，也不会因设置电压、幅度或频率而自动开启输出。

开始真实实验前，请阅读执行一次实验和配置实验台。

文档与贡献

• 文档首页
• 示例计划及硬件边界
• 管理仪器插件
• 插件开发
• 更新日志

WaveBench 使用 MIT 许可证。感谢 Linux DO 社区提供交流和支持。