sensor-bench/README.md

Sensor Bench

Sensor Bench 是一款用于触觉传感器测试的 Windows 桌面工具。它基于 Orisys SDK，可预览原始相机画面、显示处理后的传感器图像、录制原始视频，并在各测试步骤中监控 FN / FX / FY 力曲线。

界面示意

应用默认使用简体中文界面，可在语言选择器中切换到英文。

功能

• 通过左侧流程引导操作员完成检测，支持 下一步、上一步、新样品 / 重置。
• 从 config/options.json 加载可选项：传感器类型、弹性体、CMOS、标记、压头、平台。
• 默认使用 DDJX01 Orisys 采集：原始画面 1920x1080 @ 30 FPS，处理后输出约 365x365。
• 显示原始 sensor.frame、处理后的 Sensor.get_img()，以及实时力曲线。
• 将 SDK 原始相机帧录制为 MP4，保存到 recordings/ 或自定义文件夹。
• 界面文案存放在 config/locales/zh_CN.json 与 config/locales/en_US.json。

运行环境

推荐环境：

• Windows x64
• Python 3.10
• 从 PyPI 安装 orisys，或在开发时使用本地 orisys-sdk 源码

源码运行时安装依赖：

cd D:\repo\sensor-bench
python -m pip install numpy opencv-python PyQt5 pyqtgraph
python -m pip install orisys
$env:PYTHONPATH = "D:\repo\orisys-sdk\src;$env:PYTHONPATH"
python run.py

使用 PyPI 包时可不设置 PYTHONPATH。若存在同级目录 D:\repo\orisys-sdk\src，run.py 也会自动检测并加入路径。

运行冒烟测试：

python tests/test_smoke.py

打包 EXE

发布包使用 PyInstaller onedir 模式，并依赖 Python 3.10 的 conda 环境。

1. 创建构建环境：

.\build\create_env.bat

2. 构建可执行文件：

.\build\build_exe.bat

输出路径：

dist/SensorBench/SensorBench.exe

打包结果包含 config/、config/locales/ 和 steps/，操作员无需改代码即可编辑选项、翻译文案和工作流程。