ykcheungab
69 lines
2.0 KiB
Markdown
69 lines
2.0 KiB
Markdown
# 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` 源码
|
||
|
||
源码运行时安装依赖：
|
||
|
||
```powershell
|
||
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` 也会自动检测并加入路径。
|
||
|
||
运行冒烟测试：
|
||
|
||
```powershell
|
||
python tests/test_smoke.py
|
||
```
|
||
|
||
## 打包 EXE
|
||
|
||
发布包使用 PyInstaller `onedir` 模式，并依赖 Python 3.10 的 conda 环境。
|
||
|
||
1. 创建构建环境：
|
||
|
||
```bat
|
||
.\build\create_env.bat
|
||
```
|
||
|
||
2. 构建可执行文件：
|
||
|
||
```bat
|
||
.\build\build_exe.bat
|
||
```
|
||
|
||
输出路径：
|
||
|
||
```text
|
||
dist/SensorBench/SensorBench.exe
|
||
```
|
||
|
||
打包结果包含 `config/`、`config/locales/` 和 `steps/`，操作员无需改代码即可编辑选项、翻译文案和工作流程。
|