# 用 TRAIN 训练机械臂位置

- 网址:https://unchainedlabs.help/product/stuntman/resources/train-guide

**用 Stuntman TRAIN 训练机械臂位置 参考点、三个角点、Z 高度和核对**

TRAIN 是 Stuntman 软件里训练机械臂位置的程序。做法是把真实的机械臂点动到真实的位置，再点 Save 记下坐标。

它有两个标签页。Reference 训练每条机械臂的参考点；Deck 训练台面上每个 substrate 的位置，substrate 指板、样品架、天平等。内容依据原厂 TRAIN、RUN 用户指南和安全指南（Rev A）。

## 新系统出厂已训练好，以下情况才需要动

新交付的 Stuntman，机械臂和台面位置都已训练过。原厂把位置维护分给两个程序。TRAIN 做成批的引导式训练；RUN 里的 Substrate Management 查看和微调单个位置。

> | 情况 | 用什么 |
> | --- | --- |
> | 系统调试启用，或要刷新一大批台面位置 | TRAIN |
> | 加装的硬件需要引导式训练 | TRAIN |
> | 新加了 substrate，或在 RUN 里改了板高、瓶高这类尺寸值 | 先点 Deck 标签页的 Refresh All 重算，通常不必逐个重训 |
> | 从属臂的位置看起来偏了 | 重训它跟随的主臂；从属臂没有单独的训练入口 |
> | 单个位置要微调，或要靠肉眼直接对准 | RUN 的 Substrate Management → Manual Train |
> | 整机在安装后被挪动过 | 先由 Unchained Labs 服务工程师重新确认后再用 |

需要直接对准的位置，RUN 指南举的例子有 PDT 分液工具、SV 粉末工具、清洗站、天平防风罩开关位置和过滤组件。安全指南提醒，为清洁去挪动或倾斜整机，精密运动会失准，需要服务上门才能恢复。

各软件程序的分工见 Stuntman 软件总览。

## 开始前关掉 RUN，先训参考点再训台面

- TRAIN 和 RUN 读写同一份台面和 substrate 配置，两个程序不要同时开。
- TRAIN 同一时间只能开一个。再开一个会提示 “Application is already running.” 并自动关闭。
- 板高（Plate Height）、瓶高（Vial Height）、夹爪偏移（Gripper Offset）等尺寸值在 RUN 里填。TRAIN 只负责点动和保存。
- 先训每条臂的参考点。这条臂上其他位置都以参考点为基准。
- 本次会话第一次点 Train 按钮时，软件提示机械臂未初始化，点 OK 让所有机械臂回原点。这个检查每次会话只出现一次。
- TRAIN 可以在模拟模式下运行，但它不能模拟硬件。设备的模拟开关在 TECH TOOL 里。

## 在 Reference 标签页训练参考点

参考点是一个共用的 X/Y/Z 坐标。双臂系统靠它把两条臂、或一条臂上的几种工具对到同一个物理位置。每种臂只有一个固定的参考点，由硬件决定，不能自己选。

- 在左侧树里选中机械臂，点 Train Reference Point。
- Mount Training Tool：按图装上训练工具，工具和机械臂之间不能留缝。工具已装好时这一步自动跳过。
- Training Plate Placement：把参考板放到图中高亮的台面位置。本次会话放过一次后不再提示。
- Reference Training Point：说明参考点在工具上的哪个位置，这一步没有操作，点 Next。
- Train Arm：把工具上的参考点点动到参考板上指定的位置，点 Save，再点 Test。
- 点 Finish 关闭向导。树里这条臂出现绿勾。

*图:Mount Training Tool 步骤给出该装哪个训练工具的照片。图取自原厂用户指南。*

*图:图中这条臂的参考点对准参考板中心的 Center Point。图取自原厂用户指南。*

### 主臂、从属臂和工具偏移

共用一套运动机构的几条臂，指定其中一条为主臂（primary arm），其余是从属臂（sibling arm）。从属臂通常是装在同一安装点上的另一种工具。

树里只有主臂能点训练。从属臂列在主臂下面，只作显示。TRAIN 用主臂的参考点，加上为每条从属臂配置的 X、Y、Z 工具偏移，算出从属臂的参考点。

RUN 指南的例子：Arm - Dispense Head 是主臂，Arm - 25 mL Hopper 和 Arm - 100 µL PDT 是从属臂。臂的具体名字随配置不同。

### 板夹爪另有一个向导

带板/瓶夹爪的臂多一个 Train Plate Gripper 按钮。夹爪本次会话还没初始化时，软件先提示取下夹着的训练针，再把臂移到能初始化夹爪的位置。

训练页除了点动，还有 Rotate Left / Rotate Right（按固定小角度旋转）和 Open / Close（开合夹爪）。点 Finish 时软件会打开夹爪、收回机械臂并重新初始化。

## 点动：远处连续走，最后几毫米按 Ctrl 单步

*图:Train Arm 页：左边是点动控制和实时坐标，右边是已保存的坐标和 Save、Test。图取自原厂用户指南。*

> | 操作 | 作用 |
> | --- | --- |
> | 方向键 | 移动 X、Y，对应屏幕上的 Left、Right、Back、Forward |
> | Page Up / Page Down | 移动 Z |
> | 按住 Ctrl 再按方向键 | 只走一步，步长由 Single Step Size (mm) 设定 |
> | Arm Speed 滑块 | Slow 到 Fast。接近目标时调慢，大范围移动时调快 |
> | Current (mm) | 实时显示机械臂的 X/Y/Z |
> | Stop 或 Escape | 立即停下所有运动。Stop 在向导底部工具栏上 |

训练页上要先点过 Save 或 Test，Next（最后一页是 Finish）才能点。Previous 不受限制。动作看着不对就按 Stop，再从停下的位置接着点动。

## 在 Deck 标签页训练台面位置：板和架子训三个角

Deck 标签页的树按台面位置列出，展开能看到每个位置上可放的器皿。点台面图上的某个槽位，树里会选中对应的位置。选好后点 Train Substrate Points 打开向导。

*图:Deck 标签页。位置按「台面编号 + 类型」命名，器皿按「网格 + 容量」命名，如 Rack 8x12 1.2mL Vial。图取自原厂用户指南。*

向导要训几个点，取决于 substrate 的形状：

> | substrate | 点数 | 训练页名称 |
> | --- | --- | --- |
> | 矩形网格的板或样品架 | 3 | Front Left、Back Left、Front Right |
> | 加盖站（capping station） | 3 | Front、Back Left、Back Right |
> | 较简单的两点 substrate | 2 | Front、Back |
> | 单点 substrate，如天平、Imaging Station | 1 | Single Point |

*图:网格类 substrate 的三个角：Back Left、Front Left、Front Right。图取自原厂用户指南。*

### 三个角点怎样算出整块板

三个角训好后，其余每个孔的位置由这三个点和网格的行数、列数插值算出。孔再多，也只训三个角。行数、列数和孔间距在 RUN 里该 substrate 的属性中设定。

在 RUN 里手动训练时，三个角取第一行的首孔和末孔，加最后一行的首孔。常见的例子是 A1、A12 和 H1。

只有一个角不准时，重新打开向导，用 Previous / Next 翻到那一页重训即可，另外两个角不用重做。最后一页的 Next 变成 Finish，点完软件收回机械臂、关上为此打开的台面门，树里出现绿勾。

### 树里缺了某个位置

Deck 树显示哪些位置，由 RUN 的 Substrates 编辑器决定。那里要有一个名字正好叫 “Training” 的 substrate，可训练的位置定义在它下面。有些位置在 RUN 里被排除在训练之外，有些专用位置只能在 RUN 里配置。找不到时先问配置系统的人。

## Z 高度和用户值在 RUN 里填

训练位置时确定了一个 Z 参考面。每个 substrate 都有四个内置 Z 属性，单位 mm，都相对这个参考面填写。位置在 RUN → Utilities → Substrate Management，选中 substrate 后在右侧表格里改。

- Z Start：训练时对准的高度。密封板的例子里，它对准板的上表面。
- Z Travel：移动时的高度，在 Z Start 上方，填正数。
- Z Dispense：加液高度，在 Z Start 下方，填负数。
- Z Max：吸液高度，在 Z Start 下方，填负数。

*图:针尖停在训练位置时的高度就是 Z Start。Z Travel 在上方，Z Dispense 和 Z Max 在下方。图取自原厂用户指南。*

### User Z Heights：所有 substrate 共用的 Z 值

在 Substrates 顶层节点加一次，下面所有 substrate 都会多出这一栏。已配置好的系统里常见：

- Z Pickup / Z Dropoff：瓶夹爪取放无盖瓶的深度。Z Dropoff 通常比 Z Pickup 高 3–4 mm。
- Z Pickup Cap / Z Dropoff Cap：取放带盖瓶的深度。Z Dropoff Cap 通常比 Z Pickup Cap 高 3–4 mm。
- Z Touchoff：刮掉多余液体的深度，常用于 PDT 分配黏稠液体。
- Z Probe：pH、黏度、电导等探头测量的深度。

### User Values：只属于某一类 substrate 的参数

点该 substrate 的顶层，再点右侧 User Values 栏里的小方框，在弹窗里填名称和数值。例子有 Plate Height、Vial Height、Vial Internal Height、X Touch Off、Max Tip Spread (mm)。

取放高度由容器自身高度加一个固定偏移算出。偏移按 substrate 类型定：

- 普通板或样品架：25.4 mm
- PDT 参考板或枪头架：15.0 mm
- Imaging Station（参考圆柱）：32.5 mm

所以同一个架子换高一点或矮一点的瓶，只要改瓶高，不用重训。

### 改了尺寸后点 Refresh All

Refresh All 按当前数据重算所有 substrate 的位置，不动机械臂，也不用装训练工具。点之前会弹出确认框。

归 TRAIN 管的位置，RUN 里的 Stuntman TRAIN 属性为 True。要保留手动训练结果的位置，把这个属性设为 False，Refresh All 就不会重算它。所以在 RUN 里手动改位置之前，先看这个属性。

Refresh All 或向导里的 Save 报错，多半是 RUN 里缺了某个用户值。在 RUN 里给对应 substrate 补上，再重试：

> | 报错 | 要补的值 |
> | --- | --- |
> | Unable to find Gripper Offset for [position] | Plate Gripper 上与位置后缀对应的 “[后缀] Gripper Offset” 数值。例如后缀为 DSC 的位置要有 “DSC Gripper Offset” |
> | 'Spacer Height' 只找到数值或只找到文本 | Spacer Height 数值和文本要成对。文本写它适用的位置类型，用逗号分隔 |
> | 'Plate Height' 或 'Vial Height' could not be found | 几乎所有板和样品架都必须有这两个数值 |
> | Unable to find Capping Station / Imaging Station Z Pickup，或 Balance offsets | 对应 substrate 上该瓶或该位置的 “[名称] Z Pickup” 数值 |

## 每次 Save 之后都点 Test 核对

Test 把机械臂送回刚保存的点。软件先弹出提示，确认后才移动。点动时看着对的位置，用 Test 走一遍才能发现偏差。

Test 不是直线走过去。机械臂先回缩，再从回缩位置接近训练点，和正式运行时的到达路径相同。所以 Test 也可以用来检查重复性。

- 点 Save 的那一刻坐标就已存进系统，关掉 TRAIN 不会丢。
- 还没 Save 就点 Finish，会问是否放弃未保存的更改。选 Yes，这个点什么都不记录。
- 树里的绿勾只表示本次会话训过。重开 TRAIN 后绿勾全部清空，但训练结果还在。
- 在 RUN 的 Manual Train 里，可以点 Trained 下的 Move 回到已保存的位置核对。

训好的位置在 RUN 执行实验时使用，执行过程见 用 RUN 执行实验、用 SHOW 看结果。

## TRAIN 不检查碰撞，路径要自己盯

- TRAIN 不判断点动的目标会不会撞到另一条臂或台面上的模块。双臂系统尤其要自己看着。
- 动作不对就按 Stop 或 Escape。机械臂可能和其他设备相撞时，随时准备按急停（EMO）。
- 只用向导指定的训练工具。换用别的工具，训出的位置和实际运行用的工具对不上。
- 手、工具和其他物品远离运动中的机械臂。通电时不要用手推动自动机构。
- 训练和维护时可由受过培训的操作人员用旁路钥匙旁路光幕。此时龙门降速运行，Y 轴灯变黄。拔下钥匙后恢复正常，Y 轴灯变白。
- RUN 的 Substrate Management 在实验或队列运行时不锁定，可以点动机械臂。点动和训练放在两次运行之间做，不要碰当前实验正在用的臂。
- 在 RUN 里训完一个位置，先初始化机械臂或把它移到安全位置，再训下一个或开始运行。
