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 软件总览。
参考点是一个共用的 X/Y/Z 坐标。双臂系统靠它把两条臂、或一条臂上的几种工具对到同一个物理位置。每种臂只有一个固定的参考点,由硬件决定,不能自己选。
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 时软件会打开夹爪、收回机械臂并重新初始化。
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 标签页的树按台面位置列出,展开能看到每个位置上可放的器皿。点台面图上的某个槽位,树里会选中对应的位置。选好后点 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 参考面。每个 substrate 都有四个内置 Z 属性,单位 mm,都相对这个参考面填写。位置在 RUN → Utilities → Substrate Management,选中 substrate 后在右侧表格里改。
针尖停在训练位置时的高度就是 Z Start。Z Travel 在上方,Z Dispense 和 Z Max 在下方。图取自原厂用户指南。
在 Substrates 顶层节点加一次,下面所有 substrate 都会多出这一栏。已配置好的系统里常见:
点该 substrate 的顶层,再点右侧 User Values 栏里的小方框,在弹窗里填名称和数值。例子有 Plate Height、Vial Height、Vial Internal Height、X Touch Off、Max Tip Spread (mm)。
取放高度由容器自身高度加一个固定偏移算出。偏移按 substrate 类型定:
所以同一个架子换高一点或矮一点的瓶,只要改瓶高,不用重训。
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” 数值
Test 把机械臂送回刚保存的点。软件先弹出提示,确认后才移动。点动时看着对的位置,用 Test 走一遍才能发现偏差。
Test 不是直线走过去。机械臂先回缩,再从回缩位置接近训练点,和正式运行时的到达路径相同。所以 Test 也可以用来检查重复性。
训好的位置在 RUN 执行实验时使用,执行过程见 用 RUN 执行实验、用 SHOW 看结果。