Zem-MotorControl
Zem 样品台 XY 轴电机测试工具
在 VS Code / Cursor 中连接样品台，完成点动、基础测试、随机坐标精度测试，并一键导出 Word 分析报告。
主要功能
| 功能 |
说明 |
| 设备连接 |
扫描串口、连接 / 断开设备 |
| 基础功能 |
点动、查看位置与速度 |
| 基础测试 |
按流程做基础功能测试 |
| 随机坐标测试 |
在行程内随机跳转，评估重复定位精度 |
| Word 报告 |
自动生成场图、误差分布与统计表 |
快速开始
- 按
Ctrl+Shift+P，选择 「Zem-MotorControl: 打开电机测试面板」
- 在 设备连接 页扫描串口并连接设备
- 进入 随机坐标测试：
- 确认单位与行程（可自动探测或加载上次行程）
- 选择测试范围（整行程，或在图上框选区域）
- 生成预览点，确认后点击 开始测试
- 测试结束后，可在历史记录中查看，或 导出 Word 报告
随机坐标测试说明
测试编号
每次完成的测试会自动编号，例如：RCT-20260710-001
单位
界面顶部可设置：
| 参数 |
说明 |
| 读取单位 |
设备读数单位（μm 或脉冲） |
| 转换系数 |
读数与显示单位之间的换算关系 |
| 测试单位 |
界面、场图、报告统一使用的单位 |
测试进行中不可修改。一般按现场标定填写即可。
行程与范围
| 项目 |
说明 |
| 行程 |
自动探测、加载上次结果，或手动输入 X/Y 范围 |
| 整行程 |
在整个有效行程内测试 |
| 自定义区域 |
在场图上框选圆 / 矩形 / 正方形区域 |
运行方式
| 方式 |
说明 |
| 全局 |
在全部预览点中随机跳转，按总时长结束 |
| 分区 |
按区域依次测试，每个区域有各自时长 |
场图含义
- 紫色点：计划要去的目标位置
- 蓝色点：实际到位位置
- 支持滚轮缩放、拖动平移；区域可右键移动、调整大小或删除
常用参数
| 参数 |
说明 |
| 测试分辨率 |
预览点之间的大致间距 |
| 分布点数 |
生成多少个预览点 |
| 时长 |
全局总时长，或各分区时长（分钟） |
| 分布 |
全随机，或中心更密（高斯） |
Word 报告里有什么
| 章节 |
内容 |
| 一、测试配置 |
行程、采样参数、区域说明、场图 |
| 二、误差分布 |
误差分布图与统计表（均值、标准差、最小 / 最大等） |
| 三、统计直方图 |
点被选中次数、跳转距离等分布 |
说明：
- 误差 = 目标位置 − 实际位置
- 报告不包含每一次跳转的明细列表；完整记录保存在本机，可按需另行导出
图上若出现 「X 宽」「Y 高」，表示该方向误差分布的集中程度（半高全宽）：数值越小，说明该方向到位越集中、越稳定。
数据保存在哪里
| 内容 |
默认位置 |
| 测试记录 |
%APPDATA%\motor-control\ |
| 运行日志 |
%APPDATA%\motor-control\logs\ |
| Word 报告 |
文档\Zem-MotorControl\随机坐标测试\ |
系统要求
- Windows
- VS Code 1.85+ 或 Cursor
- 样品台经 串口 连接
安装
- 扩展市场搜索 Zem-MotorControl
- 或：扩展面板 →
··· → 从 VSIX 安装 → 选择对应的 .vsix 文件
版本
当前版本：0.2.5
| |
