Stunner API 快速操作指南

系列指南 · 快速操作指南

Stunner API 快速操作指南

Stunner 第一次接进自动化，先在 Stunner Client 软件里激活 License、配好网络；再打开 API Tester 验证脚本能远程调用仪器；最后断开 USB、给仪器断电重启一次，Stunner 就准备好接受外部脚本控制了。完整的原理和 19 个 API 命令的细节，在系列另外 6 篇正文里。

先认识几个名词

• Stunner Client — Stunner 自带的 PC 端控制软件。首次配置、激活 License、把应用传到仪器都在这里完成，通过 USB 线和仪器通信。
• API License — 让外部脚本远程调用 Stunner 的能力许可。单机模式的使用许可出厂就有，API License 不含在内，需要向 Unchained Labs 单独申请，激活码按仪器序列号生成。
• API Tester — Unchained Labs 自带的桌面工具。不接工作站也能直接对着 Stunner 把命令逐条试通，问题在接工作站之前就能暴露。
• TCP 端口 6300 — Stunner API 通信用的固定端口。外部脚本(包括 API Tester)统一通过 仪器 IP + 6300 这个组合连接。

激活与配置：Stunner Client 里的 7 步

这 7 步都在 Stunner Client 的 Automation 页面里完成。动手之前，先准备好三样东西：一根 USB 线、一段网线、一份 API License 激活码。激活码向 Unchained Labs 申请，按仪器序列号绑定。

Stunner Client 的 Automation 页面。顶部 Activation code 区域填激活码；右上 Applications & Blanks 区域有 Transfer Apps 和 Transfer Blanks 两个按钮；左下 Network Settings 配 .bin 数据的存放目录；右下 DHCP / Static IP 决定仪器拿 IP 的方式，TCP 端口固定 6300。下面 7 步就按这个版面顺序走。

关于 .bin 文件:每次 API 测量，Stunner 都会在你指定的网络共享目录里生成一个 .bin 原始数据文件。日常自动化流程用不到它，但在 Stunner Analysis 软件里看更详细的图、请 Unchained Labs 工程师协助排查，都要用这份原始数据，建议保留。

接通验证：先 API Tester，再真实驱动

7 步配完之后，Stunner 这一侧已经准备好接受外部脚本控制。接真实工作站之前，建议先用 API Tester 跑通一遍，可以避免在工作站上浪费已加样的板。

Lunatic & Stunner API Tester 主界面。顶部一排按钮一对一对应 19 个 API 命令；中间三个文本框就是实验、样品、结果三段字符串；底部 return code 和 return text 显示每一次调用的执行结果。

日常切换：API 模式 ↔ 单机模式

日常用 Stunner 有两种方式。API 模式由外部脚本通过网线远程调用。单机模式把 USB 接上 Stunner Client，人工在界面里操作。两种方式同一时刻只能开一个。USB 和网线如果都接着，仪器会同时收到两路指令，容易加载不出正确的实验参数。

从单机模式切到 API 模式：把 USB 线从 PC 上拔掉，网线保持接着，再给仪器断电重启一次。从 API 模式回到单机：把 USB 接回 PC，同样断电重启一次，再打开 Stunner Client。两个方向的重启都是 API Manual 的要求。

### 两种连接同时存在时怎么办

比如忘了拔 USB,Stunner 可能进入参数加载错误的状态。典型表现是实验定义或板布局加载不出来。可以用三种方式恢复：① 在 Stunner Client 编辑 Plate layout 的过程中，点界面上的"X"重置；② 在 API 模式下调一次 Reset() 命令；③ 最简单也最彻底的办法，是把仪器直接断电再开机。

想了解更多，去哪查

仪器能被脚本调用之后，真正写脚本、定义实验、处理错误、做合规验证，还有不少细节，可以在下面几处继续查。

• 系列正文 #01–#06 — 依次讲场景判断、装机、配置、命令、字符串和交付验证。每一篇都是独立的深度参考。
• 官方 Stunner API Manual — 文档号 M-CO-1901,RevG。19 个命令的完整签名、全部状态码、字段定义、外形图纸、PV 用的 JSON 模板，都能在这里查到。
• 官方技术支持 — 需要 Unchained Labs 工程师专门支持时，联系 support@unchainedlabs.com。带上 .bin 原始数据文件，排查会快不少。
• Stunner Software User Guide — Stunner Client 软件自身的用户手册。Performance Verification(PV)、Edit CRM 工具、空白库的详细操作流程，见 §3.5。

• activate · 激活与配置：7 步
• swap · 日常切换：API ↔ 单机
• Stunner Client · Stunner 自带的 PC 端控制软件。首次配置、激活 License、把应用传到仪器都在这里完成，通过 USB 线和仪器通信。
• API License · 让外部脚本远程调用 Stunner 的能力许可。单机模式的使用许可出厂就有，API License 不含在内，需要向 Unchained Labs 单独申请，激活码按仪器序列号生成。
• API Tester · Unchained Labs 自带的桌面工具。不接工作站也能直接对着 Stunner 把命令逐条试通，问题在接工作站之前就能暴露。
• TCP 端口 6300 · Stunner API 通信用的固定端口。外部脚本(包括 API Tester)统一通过 仪器 IP + 6300 这个组合连接。
• 接好两根线，进 Automation 页面 · 先用 USB 线把 Stunner 连到一台装了 Stunner Client 的 PC;同时把网线接到仪器背面的网口。打开 Stunner Client，点左上角三横线菜单按钮，进 Automation 页面。
• 填激活码 · 在 Activation code 区域，把激活码分别填进四个输入框。激活码是一串 32 个十六进制字符，分成 4 段，每段 8 个字符，中间用短横线分隔。点 Add Activation Code。激活成功之后，API/DropControl 旁边会出现一个绿色对勾。判断是否激活，以这个对勾为准；按钮颜色是否变化不能用来判断。
• 把应用传到仪器(Transfer Apps) · 点右上的 Transfer Apps,Stunner 会把所有应用、可测物质(Analytes)和缓冲液参数(Buffers)一起传到仪器上。传完之后，按钮左侧的应用数量数字会更新成和电脑端一致，看一眼就能确认传到位。以后每次更新应用或升级 Stunner Client 软件，都要回到这里再传一次。
• 把空白传到仪器(Transfer Blanks，可选) · 如果想把 Stunner Client 里已经测过、可以复用的空白存到仪器本地，点 Transfer Blanks。在弹出的对话框里选要传的空白实验。不打算复用空白，这一步可以跳过。
• 配 Network Settings · 在左下角 Network Settings 区域，把 Folder / Domain / User / Password 四个字段填齐，点 Save Changes。Folder 要以 \\IP 地址\路径 的格式开头(必须是网络共享目录，不能是本地盘)。这里填的 User / Password 是 Stunner 仪器以后访问这个共享目录用的账号(不是你的登录账号)。不配的话，Stunner 每次 API 测量生成的 .bin 原始数据文件没有地方存放，这份数据就丢了。
• 选 DHCP 或静态 IP · 右下角 DHCP / Static IP 区域二选一。DHCP 让路由器自动分配 IP，适合临时调试；静态 IP 需要手动填地址、子网掩码、默认网关，IP 从此固定不变。自动化产线更推荐用静态 IP，以免重启路由器后 IP 改了，脚本连不上。
• 记下 IP，断开 USB · 回到 Stunner Client 左侧菜单的 Instrument 页面，确认这里显示了一个 IP 地址(而不是"No connection")。把这个 IP 记下来，后面写脚本要用。然后关闭 Stunner Client。把 USB 线从 PC 上拔下来，再给仪器断电重启一次(API Manual 要求模式切换时断电重启)。后面进入 API 模式，USB 就不再需要接着。
• 先用 API Tester 单机试通 · 安装并启动 API Tester，选择 Stunner。把左上角默认的 "localhost" 改成上一步记下的仪器 IP。然后依次点几条命令：Request_Access → Get_Instrument_Serial_Number(确认返回的序列号就是这台仪器)→ Open_Tray → Close_Tray(看托盘真的能开能关)。可选：装板跑一次完整实验。最后点 Release_Access。如果每一条都返回 0、25、50 这一类正常状态码，API 通路就验证好了。
• 再用真实驱动跑一遍 · 把客户脚本，或者第三方工作站自带的 Stunner 驱动接上，按同样的顺序再走一遍。如果结果和 API Tester 一致，集成这一侧就可以交付。剩下的工作是把脚本嵌进自动化调度流程里。
• 系列正文 #01–#06 · 依次讲场景判断、装机、配置、命令、字符串和交付验证。每一篇都是独立的深度参考。
• 官方 Stunner API Manual · 文档号 M-CO-1901,RevG。19 个命令的完整签名、全部状态码、字段定义、外形图纸、PV 用的 JSON 模板，都能在这里查到。
• 官方技术支持 · 需要 Unchained Labs 工程师专门支持时，联系 support@unchainedlabs.com。带上 .bin 原始数据文件，排查会快不少。
• Stunner Software User Guide · Stunner Client 软件自身的用户手册。Performance Verification(PV)、Edit CRM 工具、空白库的详细操作流程，见 §3.5。