用 TRAIN 训练机械臂位置

用 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 里训完一个位置,先初始化机械臂或把它移到安全位置,再训下一个或开始运行。