Open Source Robotics

精选高质量开源机器人项目、工具和软件,推动机器人社区发展。

Stringman 组装指南

由四根墙角固定绳索悬吊的家用起重机器人

许可证

  • software: Apache 2.0
  • hardware: CERN-OHL-W 2.0 (weakly reciprocal)
  • pcb: no licence (all rights reserved)
  • documentation: CC BY-SA 4.0

分别授权。固件(nhnifong/cranebot3-firmware)采用 Apache-2.0。硬件设计(CAD 文档、STL 文件、Print Guide 和 BOM)采用 CERN-OHL-W 2.0,并附有补充条款,声明用户须对因安装或使用而导致的任何伤害、损坏或损失承担全部责任。PCB 仓库(nhnifong/stringman-pcbs)没有许可证文件,因此其中的 KiCad 项目和 Gerber 文件在未授予开源许可的情况下发布——默认保留所有权利。核查日期:2026-08-07。

组装指南

1. 打印零件

整套系统约需 80 小时打印。除非某个零件另有说明,否则采用打印指南的默认设置:PLA、2 层壁、15% 网格填充、每个零件各打印一件,树状支撑仅限打印板,XY 间距 0.5 毫米。

1.1 设置默认打印配置

除下文单独说明的零件外,其余全部用同一套配置打印。

  1. 材料 PLA、2 层壁、15% 网格填充,除非零件另有说明,每种各打印一件。
  2. 树状支撑,仅限打印板,与零件的 XY 间距 0.5 毫米。
  3. 普通轴承块、滑环块和「sunglasses」不加支撑打印——这三件是例外。
  4. 任何齿轮都不要用 PET。上游的理由很直白:会吱吱响。
  5. 外壳、面板、手指、齿杆、连杆和停放挂钩在成品上都看得见,因此这些零件的颜色要有意选择。其余零件的颜色无所谓。
  6. 如果不想逐件设置参数,整套打印也已发布为 Bambu 3MF 工程文件。

1.2 打印锚座零件

共两个锚座,因此多数锚座零件要打印两份。框架是唯一不能用 PLA 的零件。

  1. Cover(外壳)2 件。它外露可见,因此请选与墙面或天花线条相配的颜色。以底面着板打印,这是它唯一一个大平面。2026 年 10 月 18 日之前的打印指南则把它分为 cover top 和 cover bottom 两件:上盖倒扣打印,两半用氰基丙烯酸酯胶粘合。
  2. 框架 2 件,用 PCTG 或 PETG-CF,不能用 PLA。此零件需要强度和耐热性。
  3. 框架设置:2 层壁、22% 自适应立方填充、树状支撑仅限打印板且仅关键区域、XY 间距 0.5 mm。建议使用 Bambu super cool tack 打印板。
  4. 普通轴承块 1 件、滑环块 1 件,不加支撑,以侧面着板打印。
  5. Spool A Power 1 件、Spool A Regular 3 件、Spool B 4 件。凹孔处使用树状支撑,每个 A 与一个 B 粘合成完整绕线盘。
  6. Stud mount(墙柱底座)2 件:5 层壁、30% 立方填充。取下锚座时它可能外露,因此白色 PET-GF15 是很好的选择。在底部的孔中加装一个 1/4 英寸粗牙螺纹嵌件,即可改作三脚架使用。之前的打印指南给出的是 3 层壁、100% 填充。
  7. Sunglasses 2 件,不加支撑,4 层壁、30% 立方填充。外部可见,因此使用与锚座外壳相同的白色 PLA。
  8. Tilt adapter(倾角适配器)2 件,PLA 颜色不限,细节非常精细,用 0.16 mm 层高。之前的打印指南列出的是 22、26、30 度的固定适配器各一件:角度指相机中心线低于水平面的俯角,天花板高则取大,天花板低则取小。
  9. Odd spacer 2 共 2 件,默认设置。每个锚座一件:它从背后支撑圆头电源插座。

1.3 打印导环零件

两个导环承接四根绳中两根的远端。

  1. Body stud mount(导环本体,墙柱安装款):以那个特殊的倾斜旗形面着板打印,比背面着板更结实。100% 填充,PET-GF15,与墙面颜色一致。
  2. Eyelet vice block(导环压紧治具)1 件:用于固定导环的治具,以便用台钻把本体、圆环和 retainer 压合在一起。
  3. 压环:与导环另一零件颜色一致。
  4. 锚座装配指南要求制作两个导环,因此本体和压环各打印两件。

1.4 打印夹爪零件

驱动齿轮决定夹爪能否正常工作——它是整套系统中唯一需要非常规喷嘴温度的打印件。

  1. Back plate(背板)、camera mount(相机支架)、mechanism lid(机构盖)和 motor bracket(电机支架):默认设置,颜色基本无所谓,不过手指张开时会露出一些小零件。旧款两段式 ABS 杆需要一个打印的连接套(coupler),打印指南已不再列出它。
  2. Flat marker(扁平标记板)1 件:如果能多色打印,使用 flat_marker_colored.3mf,否则用白色打印后贴上贴纸。2 层壁、15% 网格填充。另外用黑色 PLA 打印 hang bar(挂杆)1 件,它是扁平标记板的辅助零件。早期设计是标记盒(platform box),用白色打印后贴贴纸,或多色打印。
  3. Drive gear(驱动齿轮)1 件:100% 填充、3 层壁。普通塑料对这个零件来说强度不够,套件随附的是树脂打印的齿轮。PCTG 以 265 °C 喷嘴温度打印(高于该耗材的常规温度)是次优选择。PET 会吱吱作响,PLA 会断,PETG 太软。如果你能打印尼龙和 ABS,它们大概也可以。
  4. 面板后件与面板前件:外部可见,颜色要有意选择。在切片软件中合并,开口面相对打印,以共用树状支撑。
  5. Finger(手指)2 件、geared lever left 和 geared lever right:外部可见的零件,其余按默认设置。
  6. 连杆 2 件——属于手指部分。
  7. Spacer(垫片)7 件,默认设置。三件用于夹爪,每个锚座各用两件。
  8. 腕杆斜齿轮、腕部拆卸块和腕部舵机斜齿轮:默认设置,颜色无所谓。

1.5 打印附件

停放用配件以及标定所用的打印 AprilTag 卡片。

  1. Clip 或 alligator clip(夹子),4 件,默认设置,白色。鳄鱼夹版本是一种替代方案,可夹在较大的物体上。
  2. Parking hook(停放挂钩)1 件和 parking support bar(停放支撑杆)1 件:外部可见的零件,因此与墙面颜色一致。2 层壁、11% 立方填充。
  3. all_cards.3mf:使用 Bambu 多色配置打印。这就是稍后铺在地面上的标定卡片。

2. 制作锚座

整节内容重复两遍,每个锚座一遍。上游给出的数据是每个锚座 40 小时打印、1.5 小时装配。2026 年 6 月 26 日之后在 neufangled.com 购买的套件无需焊接;自行采购的零件可能需要。

2.1 准备工具

两份装配指南开头都是同一份简短的工具清单。

  1. 迷你螺丝刀及批头套装,手动或电动均可。
  2. 交叉自锁镊子。
  3. 强力胶——上游推荐 Loctite Super Glue Professional Liquid。
  4. 备一个懒人沙发很值得:两份指南都建议用它在拧螺丝时以任意角度托住组件。

2.2 粘合绕线盘

整套系统需要三个绕钓线的普通绕线盘和一个走电缆的电源绕线盘。

  1. 每个绕线盘由两个打印半件组成:把 A 面与 B 面粘合。
  2. 电源绕线盘的 A 面不同——中心孔更大。请单独放置。

2.3 装配三个普通绕线盘

过程很直接:绕线盘装到电机上,另一侧再装一个轴承。

  1. 把干燥的绕线盘压到电机上直至完全到位,然后旋转到孔位对齐。
  2. 用三颗 M3x8 螺丝固定。
  3. 把一颗 M4x12 螺丝穿过 4x13x5 轴承,再穿过两片 M4 垫圈,然后点一滴强力胶或 loctite,拧入绕线盘中心的 4 mm 孔。

2.4 装配电源绕线盘

这个绕线盘通过一根同时收放的绳索给夹爪供 24 V,因此中心装有滑环。

  1. 在滑环的固定端焊上 JST ZH 母头护套。
  2. 用 imp 割管器截取 10 mm 长、直径 10 mm 的 ABS 管。套件中附带这段 1 cm 的管子。
  3. 把管子粘入电源绕线盘 A 面的孔中。用硬币压入很顺手。
  4. 待干后,在管上装一片 3/8 x 7/8 不锈钢垫圈,再装一个 10x15x4 轴承。
  5. 把滑环放入滑环块,在三个可触及的孔中选两个,用两颗 M3x8 螺丝各配一片 M4 垫圈固定。
  6. 把旋转端导线穿入绕线盘的管中约一半,再从绕线盘侧面的过线孔穿出。先不要收紧——给电机螺丝留出空间。
  7. 把电机压入绕线盘,对齐孔位,用三颗 M3x8 螺丝固定。
  8. 轻轻抽拉导线,使滑环完全贴合到绕线盘侧面。

2.5 装配锚座电子件

一块 Pi 3A+、Stringman Anchor Hat,以及装在可调倾角适配器上的 Camera Module 3,另加一个风扇。早期的锚座使用 Pi Zero 2W;参见本步骤的最后几条。

  1. 为 Raspberry Pi 3A+ 装上烧录了 Stringman 镜像的 SD 卡,并在 Broadcom 芯片上贴一片散热片。3A+ 的镜像与 Zero 2W 的镜像不同。
  2. 把一块 Stringman Anchor Hat 压到 Pi 上。
  3. 在两块板之间的四角放入圆柱形垫柱,并在角上的孔中插入两颗 M2.5x18 螺丝,穿过 hat、垫柱和 Pi。
  4. 在圆头电源插座下方塞入一个 odd spacer 2。它看起来像只有一个凸点的乐高积木,用来支撑圆头电源插座,这样你往里插插头时,插座就不会把 hat 压弯。
  5. 小心拆开一只标准视场(FOV)的 Camera Module 3。保留已连接的白色(全尺寸)排线。
  6. 把相机正面朝下放在柔软的东西上,以保护其自动对焦机构,然后如图所示,用 M2x4 螺丝在四个角把它拧到可调倾角适配器上。
  7. 如图所示,把排线的另一端插入 Pi 的相机排线接口,即靠近板子中央的那个。排线有富余长度,因此把多出的一折塞到 hat 下面。
  8. 把 Pi 拧进框架底部的电子仓,先用那两颗 M2.5x18 螺丝,再在其余孔中用两颗 M2.5x6 螺丝。相机应从前窗探出。
  9. 把相机翻过来,卡进框架上的两个凸起之间。把带齿的臂插入框架上对应的槽。对齐两侧的螺丝孔,在适配器两侧拧入两颗 M2.5x6 螺丝,把它固定到框架上。
  10. 在框架背面的槽中安装一个 4 线 3007 PWM 风扇,向外吹风。把导线穿过去,插到 hat 上对应的接口,然后用两颗 M3x8 螺丝在对角处把风扇固定。
  11. 按旧版指南(截至 2026 年 10 月 19 日的存档)制作的锚座,使用的是带一片散热片的 Raspberry Pi Zero 2W 和 Zero 2W 镜像。对于这些锚座,指南的说法是:如果 Pi 没有排针,焊上整排;拆开相机,取下随附的排线;在相机上安装 4 cm 迷你排线,金手指朝下对着电路板,再把较小的一端接到 Pi 上;把 hat 压上去;在四角放入垫柱并插入四颗 M2.5x18 螺丝;把 Pi 拧到电子仓里的锥形柱上。
  12. 在那个早期版本中,相机安装在一个打印的固定相机角度支架上:以排线接口朝上看向镜头时位于右前方,下俯角为相对水平面 22、26 或 30 度,按让地面保持在画面中央的原则选择。之后可以更换,但必须在配置中告知新的俯角。支架用一颗 M2.5x6 螺丝装到框架上,它的小凸起决定最终角度,且只有一种装法。

2.6 把电机装入框架

先装下绕线盘。两台电机都从框架外侧拧固。

  1. 把框架翻回正面朝上。将插头向下穿过下绕线盘一侧的矩形孔。
  2. 避免电机螺丝错牙:先反向旋转,确认螺纹咬合的是金属而不只是塑料。
  3. 可能需要把轴承座从绕线盘旁推开。它不应碰到绕线盘。如果碰到了,用扁平物体把它撬回 2 mm。绕线盘应能自由转动。
  4. 调整电机轴,使缺口朝下、平面竖直,然后滑入卡槽,边推边把导线拉过去。
  5. 使其在卡槽和另一侧轴承座中牢固就位。转动一下,确认没有歪斜。
  6. 从框架外侧用三颗 M3x8 螺丝固定电机。
  7. 若上绕线盘是普通绕线盘,请打印为普通绕线盘设计的滑环块变体,并压到绕线盘凸出的轴承上。
  8. 若上绕线盘是电源绕线盘,它已带有轴承块:把导线用力抽紧,直到滑环无法再靠近绕线盘为止。
  9. 穿好插头,对齐电机轴,对齐另一侧的轴承块,然后从外侧用三颗 M3x8 螺丝固定电机,再用两颗 M3x8 螺丝固定轴承块。
  10. 用四颗 M3x8 螺丝把「sunglasses」固定到框架顶部。

2.7 给钓线绕线盘绕线

绕线由脚本完成而非手工:qa-anchor-arp 会设定电机 ID、按绕线盘类型绕入正确长度并检查相机。

  1. 给锚座上电,通过 Wi-Fi 或以太网适配器接入网络。
  2. 用 ssh pi@<主机名或 IP> 登录;Stringman 原始镜像的密码是 Fo0bar!!。
  3. 先更新:/opt/robot/env/bin/pip install --upgrade "nf_robot[pi]"。
  4. 运行 /opt/robot/env/bin/qa-anchor-arp 并按提示操作。
  5. 它会要求你逐个接入电机并给它们重新上电,方法是在 hat 上拔下再插回电机插头,而不是圆头电源插头。若连接中断,重新登录并再次运行脚本:它会从上次中断处继续。之前针对 Pi Zero 2W 锚座的指南说的是拔插圆头电源插头。
  6. 给钓线绕线盘绕线前,先用水手结(buntline hitch)把线头系在绕线盘的小系线点上。
  7. 在空旷处松松地托住供线盘。绕线很快——不要抓紧。
  8. 对准备绕线的每个绕线盘在提示处回答 y,暂不绕线则回答 n。
  9. 绕线完成后,把线头从后向前经 sunglasses 引出,用帕洛马结(palomar knot)系上一个登山扣。如果两种颜色都有,左侧系银色,右侧系黑色。

2.8 给电源绕线盘绕线并接线

这是唯一一处出错就会赔上电缆的步骤:受力必须由绳结承担,而不是接头。

  1. 若拿到的是已按长度裁好的电缆,现在就把一个登山扣从裸线端穿入,经登山扣的小孔,一直送到另一端的 JST 插头处——稍后要在那里用到。
  2. 把电缆的裸线端从「sunglasses」前方送入,拉出足够余量,再从锚座背面向前穿过绕线盘的系线孔。
  3. 从系线孔再拉出一些余量,打一个简单的平结。先不要收紧。
  4. 把绕线盘向前转动,修剪滑环导线,使其绕绕线盘约三分之二圈且不到达系线点。这个长度很重要。
  5. 用焊锡和热缩管把灰色电源线与滑环导线接在一起:棕接红、蓝接黑。上游表示,最牢固的接法是把每根线末端裸露的导线与对应导线互相钩住、捏紧、焊好,再套上热缩管。之前的指南改用一对焊锡密封接头(solder-seal),并先套上热缩管。
  6. 用 18 AWG 刃口剥电缆外皮,用较小剥线钳的 28 AWG 刃口剥线芯。
  7. 收紧平结的余量,使包好的接头位于绕线盘根部,但不要收到让接头承重——真到受力时,应由绳结承担。
  8. 在脚本中对上绕线盘回答 y,按回车开始绕线。
  9. 用水手结把先前穿好的登山扣系在末端,使绳结承重,末端的接头不受任何机械应力。

2.9 完成锚座并制作导环

两个导环承接两根绳的远端;它们是整套系统中最简单的打印组件。

  1. 脚本会提示你测量电机的摩擦力。在回答 yes 之前,先在登山扣和孔之间拉出 30 cm 的余量,让绳子自由垂下,然后运行摩擦力测量。最后脚本会提示进行相机画面测试,然后结束。运行 sudo shutdown now,等指示灯熄灭后拔掉电源,以关闭锚座。之前的指南只说直接拔掉电源。
  2. 确认黑色电机线缆已妥善收进锚座底部的空腔内。
  3. 每个导环各把一枚 20 号 Alconite 环压入环槽。
  4. 在剩余空隙滴一滴强力胶,用一枚硬币和可施压的工具(如台钻或台虎钳)把 retainer(压环)压上去。最牢固的方法是用压具:把导环本体放进打印的 eyelet vice block,使小箭头落入对应的槽中,这样圆环就与治具背面平行,然后按本体、胶、圆环、胶、压环、硬币的顺序叠放。把整叠压紧,并在硬币粘住之前取下。之前的指南用的是一枚硬币和一把钳子。
  5. 制作两个。然后为第二个锚座重复本节全部内容。

3. 制作夹爪

每台机器人一个夹爪。上游给出的数据是 20 小时打印、2 小时装配。全过程反复出现的要领是:把尼龙锁紧螺母拧到没有间隙,再回松到关节能自由转动为止。

3.1 准备额外工具

夹爪需要锚座用到的全部工具,另加两件切割工具。

  1. 迷你螺丝刀及批头套装、交叉自锁镊子和强力胶,与锚座相同。
  2. 用于修剪防滑胶带的美工刀或模型刀。
  3. 用于压力传感器接头的齐平剪线钳。

3.2 装配手指

没有左右手指之分——叉件和指垫都是对称的。

  1. 把叉件装到指垫背面,用一颗 M3x25 螺栓穿过上方孔位、贯穿两件,另一侧配 M3 锁紧螺母。
  2. 把尼龙锁紧螺母拧到没有间隙,再回松到杆件能够摆动。另一个手指同样处理。
  3. 把带齿杠杆滑入手指组件,使其平面与手指平面共面。
  4. 用一颗 M3x25 螺栓穿过组件,另一侧配 M3 锁紧螺母,拧紧后回松到机构恰好能自由活动。另一个手指同样处理。

3.3 安装压力传感器

其中一个手指负责感知接触力。套件中此部分已预装。

  1. 找到压力传感接头:2 针、1.00 毫米间距的 JST-SH 公头,带 20 厘米引线。
  2. 把热缩管套到导线上,焊接到力敏电阻上。极性无所谓。
  3. 用齐平剪线钳剪掉 JST-SH 接头的翼片,使其能穿过线槽。
  4. 选择内部带线槽的那个手指,把插头穿过线槽,再把电阻贴片粘到手指上。

3.4 贴防滑胶带

真正抓住物体的是指板防滑胶带。共四条,每个手指两条。

  1. 准备至少四条 110x37 毫米的指板防滑胶带。
  2. 把手指正面朝上放置,使指垫与带齿杠杆的平面共面,用连杆作支撑。
  3. 沿长度方向贴第一条,从靠近齿轮的上边缘开始;另一端会多出约 10 毫米——把它折过棱边。
  4. 把手指平压在桌面上,使泡棉各处贴牢。
  5. 再横向在指尖处贴第二片,两侧各折入 10 毫米。
  6. 用模型刀修去多余部分。
  7. 把手指翻成正面朝上,沿两块手指件相互滑动的缝隙把泡棉划开,然后活动关节,检查有无翘边。
  8. 另一个手指同样处理。

3.5 准备舵机与驱动齿轮

两台 STS3215 智能舵机:一台驱动手指,一台驱动腕部。

  1. 用随附的 M3x6 中心螺丝把铝制舵盘装到两台电机上——使用内侧带凸纹的那种舵盘。
  2. 把电机附带的两颗 M3x6 螺丝从侧面卡入手指驱动齿轮。
  3. 把驱动齿轮牢牢拧到其中一台电机的铝制舵盘上。
  4. 套件随附的驱动齿轮是树脂打印的。如果你自己打印,PCTG 以 265 °C 喷嘴温度打印是次优选择,PLA 会断。
  5. 给每台电机插上三线 SPOX 线缆——即电机盒内附带的那根。

3.6 装配夹爪主体

带齿的杠杆在整个装配过程中必须始终保持啮合。此处用橡皮筋当第三只手完全合理。

  1. 掰掉机构盖打印件上的耳片,用锋利工具清理牺牲桥所在的位置。
  2. 用电机附带的四颗最小螺丝,把手指电机装在机构盖外侧。
  3. 从下方把两颗 M3x25 螺栓插入背板,放下时按住它们,并各套上一片 M3 垫圈。
  4. 让两根齿杆在闭合位置啮合,检查对位。它们必须保持啮合——必要时用橡皮筋固定。
  5. 把压力传感接头穿过背板上的笑脸形槽口,然后同时把两个手指装到螺栓上,保持啮合,并注意不要压到传感器导线。
  6. 在每颗螺栓从齿杆孔中露出的位置各套一片 M3 垫圈。
  7. 在接下来的操作中,用胶带固定或用手指按住 M3x25 螺栓,防止它们从背面脱出。然后轻轻晃动,把机构盖与手指电机组件放到背板上:两颗 M3x25 螺栓穿过盖板,驱动齿轮与手指齿轮啮合。两侧的对位凸片应当对齐。若装不进去,把螺栓退回手指内,先让齿轮啮合,再把螺栓推过去。
  8. 把两颗 M3 锁紧螺母放入六角槽,从背面拧紧螺栓,再回松到齿杆能自由活动。如果你之前用胶带固定了螺栓,直接用工具捅穿胶带,不必费力先把它撕掉。
  9. 在背板中心孔拧入一颗 M4x12——它能稳定手指驱动齿轮。
  10. 用四颗 M3x8 螺丝沿边缘固定盖板。
  11. 把两根叉形连杆向上摆入各自的槽位,在机构盖一侧用两颗 M3x14 螺丝固定。背面稍后再固定。

3.7 安装夹爪电子件

Pi Zero 2W、Stringman Gripper Hat 和广角相机。四角中只有三处上螺丝。

  1. 选一块 Pi Zero 2W,可以是带完整排针的版本,也可以是在每排前六个位置焊了针脚的无排针版本。如果 Pi 没有排针,焊上整排。如有需要,上游提供了 MakerWorld 上可打印焊接治具的链接。
  2. 在黑色芯片(SOC)和银色芯片(射频模块)上各贴一片散热片。把板子翻过来,在背面芯片下方再贴两片散热片。然后把 Stringman Gripper Hat 压到 Pi 上。
  3. 拆开两端均为 JST ZH 公头的 64 cm 线缆。把它从夹爪顶部的孔穿进去,直到从 Pi 附近的机体中穿出。把它插到 Gripper Hat 上标有 24v/GND 的插座,并把这根线约 10 cm 的余量绕成一圈塞进其他线中间。这样它的长度正好适合之后装上的杆。
  4. 在两板之间放入垫柱,用 M2.5x16 螺丝穿过板与垫柱,只固定三个角——第四个角要走排线。
  5. 拆开一只广角 Camera Module 3,安装 8 厘米迷你排线,宽的一端接相机。
  6. 轻轻拉出 Pi 排线接口两侧的黑色卡扣,把排线黑色面朝上插入卡扣下方,再把卡扣推回。若卡扣脱落,用镊子一侧一侧地装回。
  7. 用两颗 M2x4 螺丝在对角处把相机拧到相机支架上,按上游图示折叠排线,再把板组固定到支架上有螺丝孔的三个角。
  8. 张开夹爪手指,用一颗 M3x6 沉头螺丝把相机支架组件固定到背板上。
  9. 在既固定电子件支架又锁住此前未固定一侧叉件的孔位,拧入两颗 M3x14 螺丝。
  10. 把压力传感线插入 Gripper Hat 上标有 pressure 的插座。
  11. 按 Raspberry Pi 设置指南烧录一张 SD 卡并插入。

3.8 安装激光测距仪

一只 VL53L1 飞行时间传感器越过手指向下观测。

  1. 若测距仪是自行采购的,请焊上直排针——六个引脚全焊,或只焊标有 VIN、GND、SCL 和 SDA 的四个。
  2. 把 4 针矩形杜邦插头接到测距仪上,红线位于外侧边缘。
  3. 把 4 芯测距仪线缆穿过框架边缘的孔。
  4. 把它插到 Gripper Hat 短边上的对应插座。
  5. 用两颗 M2x4 螺丝把测距仪固定在其座位中。

3.9 安装腕部电机

第二台 STS3215 通过一对斜齿轮,使整个夹爪在杆件下方旋转。

  1. 用电机盒中的四颗小自攻螺丝,按上游图示方向把支架装到剩下的那台电机上。
  2. 用舵机附带的两颗 M3x6 螺丝,把三孔腕部斜齿轮装到舵盘上。
  3. 用两颗 M3x8 螺丝把电机支架固定到夹爪上。
  4. 把手指电机插入 Gripper Hat 的电机接口。腕部电机暂时不接:两个舵机出厂时 ID 都是 1,因此必须逐个接入来设置 ID。

3.10 安装风扇

在夹爪上装一个 30 mm 风扇,并插到 Gripper Hat 的 FAN 接口上。

  1. 安装一个 30 mm 风扇,向内朝 Pi 吹风,在底部用两颗 M3x10 螺丝固定。之前的指南是用两颗 M3x8 螺丝在对角处把它装到机构盖上,气流朝外。
  2. 把风扇插到 Gripper Hat 上标有 FAN 的 4 针 JST-SH 接口。板上有两个 4 针 JST-SH 接口:FAN 位于板子的长边,另一个用于测距仪。之前的指南说的是标有 FAN 的 5 V 插座。

3.11 制作标记盒与杆件

标记板是被动件:它在四根绳汇合的位置承载 AprilTag。旧文档称之为 gantry。2026 年 8 月 8 日之前从 Neufangled 购买的套件,配的是截成两段的 50 cm ABS 杆,更早的版本还配有标记盒:本步骤最后几条介绍这些情况。

  1. 标记板通过一根 27 cm 长、直径 10 mm 的碳纤维管与夹爪相连。可以用钢锯或切割锯慢慢截到所需长度。切勿吸入粉尘。
  2. 在管上装一个 10x15x4 轴承,再装一片 3/8 x 7/8 不锈钢垫圈。
  3. 把斜齿轮推压并旋转套到管上,直到管子伸出约 2 cm。这不是最终位置,只是留出空间。
  4. 为获得更耐用的效果,用多色打印标记板,使用 STL 下载包中 Bambu 多色打印文件里的 flat_marker_colored.3mf;或者用白色 PLA 打印后贴上贴纸。用黑色 PLA 打印挂杆(hang bar)。
  5. 如果用贴纸,把标记图像无边距打印在贴纸上,沿两条灰线裁开,得到两张各含两个标记的矩形贴纸。这个零件用的是名为 gantry 的那张贴纸。
  6. 在每张贴纸背面的一个角上划出一个三角形。这样更容易揭下底纸。
  7. 每张贴纸都要跨过一个角粘贴,使每个面上各有一个标记。注意方向:树干朝下。
  8. 准备好 JB-Weld PlasticWeld 环氧胶、一个纸盘、一根搅拌棒、已装好齿轮的杆、标记板、挂杆,以及一个设为 5 mm 的测量工具。按说明调配少量环氧胶。
  9. 在齿轮下方的碳纤维管上涂环氧胶。把齿轮向下滑,直到只剩 5 mm 的管子。把最后一片钢垫圈放到管端,粘在挤出的环氧胶上。擦净多余的环氧胶。
  10. 在管子另一端顶部 3 cm 处涂环氧胶。把它推入标记板底部的孔中,直到完全插到位。擦净多余的环氧胶。
  11. 如图所示,把挂杆圆角朝下插入标记板的开口。先推入大部分,在接合处涂一些环氧胶,再完全推到底。
  12. 让这些胶接处固化 24 小时。
  13. 把夹爪的电源插头沿杆向上穿,直到从顶端露出。如果在管内卡住,来回转动管子。把齿轮和轴承放入腕部座(转角无所谓,之后由标定确定),压入齿轮直到齿啮合且轴承完全到位,再把腕部块向下压入腔体,用三颗 M2.5x6 螺丝固定。
  14. 用四颗 M2.5x6 螺丝装上夹爪的前盖和后盖。确保每个盖子都完全压到位,以免挡住相机的观察孔。
  15. 旧套件:2026 年 8 月 8 日之前从 Neufangled 购买的套件,配的是一根截成两段的 50 cm 长、直径 10 mm 的 ABS 杆。用打印的连接套把它重新接好:在一段管子末端 1 cm 的范围涂上 JB-Weld PlasticWeld 环氧胶,压入连接套,然后另一侧同样处理。如果你的杆是整根的,跳过这一步。2026 年 6 月 6 日的指南则是在连接套一侧内壁涂一圈氰基丙烯酸酯胶,一鼓作气把一段杆插进去;这种接头可承受约 5 kg。
  16. 带标记盒的旧套件:标记盒多色打印更耐用,或用白色打印后贴贴纸。在 ABS 管上装上轴承和一片 3/8 x 7/8 钢垫圈,用记号笔(Sharpie)在距管端 5 mm 处做标记,用力把斜齿轮旋到管上,直到有 6 mm 管子伸出齿轮之外,在齿轮与管子接触处滴几滴氰基丙烯酸酯胶,再压上一片垫圈将其粘牢。用力把杆的另一端(没有轴承的一端)旋入盒中直到到底,再从下方滴一滴氰基丙烯酸酯胶。标记应位于塑料齿轮的边缘,而不是垫圈边缘。然后在轴承下方的管上再装一片钢垫圈,把带齿轮的一端滑入夹爪顶部的槽中,直到牢固就位。

4. 烧录并检查 Raspberry Pi

每个部件一张 SD 卡。镜像取决于 Pi:夹爪用 Zero 2W 镜像,锚座用 3A+ 镜像。随后自检脚本会写入一个文件,告诉部件它承担哪种角色。

4.1 烧录 SD 卡

共三张卡:两个锚座和一个夹爪。镜像取决于 Pi:夹爪用 Zero 2W,锚座用 3A+。若购买的是整机,可跳过此步。

  1. 下载 Raspberry Pi Imager 并插入一张 microSD 卡。
  2. 设备处,夹爪选择 Raspberry Pi Zero 2 W,锚座选择 Raspberry Pi 3A+。
  3. 下载对应该 Pi 的 Stringman Raspberry Pi 镜像(每个 1.6 GB):夹爪用 stringman-zero2w.img,锚座用 stringman-pi3aplus.img。操作系统处选择自定义镜像,并使用下载的文件。
  4. 选择该卡,点击写入并确认。
  5. 把烧好的卡插入部件的 Pi 并开机。

4.2 运行部件自检

它负责设定电机 ID,并留下决定服务下次启动时执行哪种行为的文件。

  1. 用 SSH 登录部件,先停止服务:sudo systemctl stop cranebot.service。
  2. 更新软件包:/opt/robot/env/bin/pip install --upgrade "nf_robot[pi]"。
  3. 锚座运行 /opt/robot/env/bin/qa-anchor-arp,并做好绕线时高速运动的准备——不要抓紧供线盘。
  4. 夹爪运行 /opt/robot/env/bin/qa-gripper-arp。
  5. 若手指接触测试始终检测不到压力,请微调电路板上的电位器,直到能检测为止。
  6. 最后的视频测试既可以按提示的命令在主机上打开视频流来完成,也可以用 ctrl-c 结束。

4.3 让每个部件接入 Wi-Fi

墙上锚座里的 Pi Zero 没有键盘:部件用自己的相机从二维码读取 Wi-Fi 凭据。

  1. 开机后约 10 秒内,连不上已保存网络的部件会开始用其相机寻找 Wi-Fi 分享二维码。
  2. 用手机的 Wi-Fi 分享界面生成二维码,或用 qifi.org 生成传统的方块二维码,后者在较远距离更易识别。
  3. 把二维码对准每个相机(包括夹爪的相机)各约十秒。5 厘米大的方块二维码在约 1.5 米外即可识别。
  4. 成功会以物理方式提示:锚座会让电机发出蜂鸣,夹爪会摆动手指。锚座连上网络后还会开始保持位置。
  5. iPhone 的二维码没有问题;Android 的分享二维码只是装饰性的,必须凑得很近才能识别。
  6. 如果二维码配网在你的情况下行不通,把该部件的 SD 卡插入电脑,确认它挂载在 /media/$USER/rootfs,然后在 cranebot3-firmware 仓库中运行 sudo ./add_wifi_config.sh "SSID" "password"。该脚本位于 src/nf_robot/scripts/add_wifi_config.sh。
  7. 快速连按指垫五次,即可清除夹爪中保存的 Wi-Fi 凭据。

4.4 可选:加强 Pi 的安全性

原始镜像带有一个公开已知的密码,除了方便排查故障之外别无用处。

  1. Stringman 镜像的默认用户是 pi,密码为 Fo0bar!!。
  2. 自动方式:在固件仓库中激活虚拟环境后运行 python experiments/deploy_ssh_keys.py <robot conf.json>。它只有在验证密钥登录可用之后才会关闭密码登录,因此不会把你锁在门外。
  3. 手动方式:用 passwd 修改密码,用 ssh-keygen -t ed25519 和 ssh-copy-id pi@<部件> 配置密钥登录。
  4. 确认无需密码即可登录后,在 /etc/ssh/sshd_config 中设置 PasswordAuthentication no 与 ChallengeResponseAuthentication no,并重启 ssh。
  5. 三个部件逐一重复。

5. 在房间中安装并标定

上游把这一步比作挂窗帘杆:不受打扰的情况下约一小时,另加至少 30 分钟调试。工具为人字梯、电钻/起子机、M1.5 内六角批头和 T20 梅花批头(均随附)。

5.1 规划工作区域

四个安装点决定了机器人的全部工作空间,因此这是最难更改的一项决定。

  1. 为锚座选择对角两个墙角;另外两个墙角安装导环。这四点围成的空间就是工作区域。
  2. 在保持无障碍的前提下尽量扩大该区域。
  3. 锚座必须固定在墙后的木质龙骨上,或用绑带固定在结构柱上。石膏板住宅的墙角背后至少有一根龙骨,只要有一侧打中龙骨就足够。
  4. 不要用胶粘或磁吸方式安装。标称 5 公斤的免钉胶条是按垂直向下受力标定的,而 Stringman 会在多个方向上横向拉扯。
  5. 不要固定在吊顶的 T 型龙骨上——即使安装件不脱落,龙骨变形也会改变锚座朝向,毁掉标定和消摆效果。
  6. 若房间有吊扇,把锚座装在扇叶高度或更低处,机器人就够不到扇叶。
  7. 工作区域内有高低床是可以接受的,但由于未实现避障,请预期偶尔需要手动干预。
  8. 若没有可用的龙骨,就需要在房间的结构件上加装一块背板。

5.2 重新接合夹爪与标记盒

两者分开发货以便使用更小的包装箱。这一步是夹爪装配最后一步的逆过程。

  1. 用随附的 1.5 mm 迷你螺丝刀批头,拧下固定夹爪后盖的两颗螺丝,上下各一颗。你的夹爪发货时可能已经拆下了这两颗螺丝,这种情况下它们在配件袋里。
  2. 拧下固定腕部拆卸块的三颗螺丝(它是背面上方带矩形孔的那个零件),把它拔出来。配合刻意做得很紧。如果太紧,用螺丝刀把它撬出来。
  3. 把夹爪的电源插头沿标记板的杆向上穿,直到从顶端露出。如果在管内卡住,来回转动管子。
  4. 把齿轮和轴承装入腕部座——旋转角度无所谓,稍后由标定确定。
  5. 压入齿轮直到轮齿啮合、轴承完全到位,然后把腕部块压回腔中,用三颗螺丝固定。
  6. 用先前拆下的两颗螺丝装回后盖。

5.3 安装锚座

高度取三者中最低的一个:天花板、顶角线或吊扇扇叶。

  1. 在墙角天花板下方 13 厘米(5 英寸)处做标记。若有顶角线,从顶角线量起;若有吊扇,标记扇叶高度。取三者中最低者。
  2. 把蝶形墙面底座贴在墙上,其上边缘对准标记。
  3. 在墙角安装时,使用水平居中的两个孔:划线、透过零件预钻,然后拧入两颗 76 毫米(3 英寸)木螺丝。
  4. 在平墙上安装时,使用同一侧的一对竖直孔,使底座朝向房间中央,并用探测仪或从石膏板螺丝位置找出龙骨。
  5. 很多住宅的墙面并不方正。若拧紧时底座变形,请回松螺丝直至变形最小,否则锚座将无法滑入。
  6. 把锚座举到接近天花板处,沿底座竖直向下滑动,直到锁紧到位。
  7. 趁梯子还在,插上一根白色圆头插头延长线并让它垂下。
  8. 把锚座的两根绳都拉到不用梯子就能够到的高度,然后在对角处重复上述步骤。
  9. 装着外壳拿锚座可能不太好拿。最简单的方法是用双手从上下两侧夹住它;也可以在地面上先取下装饰外壳,不带外壳安装锚座,之后再装上外壳。这样多一个步骤,但可能更安全。

5.4 安装导环与停放挂钩

导环把四根绳中的两根经其余两个墙角转向。

  1. 在其余每个墙角,用一颗木螺丝把导环固定到龙骨上,小指针朝上。
  2. 面向墙角时,它应位于右侧墙面上;若该墙角处是平墙,只要固定在龙骨上,怎么装都可以。
  3. 面向导环,看向你右侧的锚座。取下其左侧绳上的登山扣,从后向前穿过导环,再拉到可及的高度。
  4. 把停放挂钩钩尖朝上装在靠近某个锚座的墙面龙骨上,位置在上游图片中用蓝色轮廓标出的区域内,使标记板正好位于挂钩前方时,其标记能被锚座相机看到。它可以装在锚座的任意一侧;装在左侧时,必须把挂钩的爪翻过来,使其朝锚座方向张开。不要装得离锚座太近,否则绳子会妨碍正常运动。螺丝略微斜打,以便工具有空间操作。
  5. 挂钩要装得足够高,让人在机器人停放时能从绳子下方轻松走过。如果装得太高,停放会变得非常困难,因为越靠近天花板精度会呈指数级下降。
  6. 如有需要,也可以把挂钩装在该区域之外,但这样就无法自动停放,因为锚座看不到标记板。之前的指南描述过一个打印在窄搁板上的 AprilTag,安装在停放状态下夹爪手指下方两英寸处,用来辅助自动停放。当前指南已不再提及它。
  7. 记录停放位置:给系统上电,手动把夹爪开到挂钩附近,运行 Half cal (2) 以确保位置定位准确,开进挂钩并向下移动,直到挂钩承受住重量,在 run 菜单中选择 Parking > Set Parking Location,等待运动停止。然后选择 Unpark,确认它能顺利离开挂钩,再把它开到房间里的某个位置并选择 Park,测试自动停放。若自动停放效果不好,重新记录一次。如果仍然不好,可能是房间的标定不够好,或者光线太暗,锚座在停放时看不到标记板。
  8. 你也可以在登山扣处把夹爪从绳上取下,运行调试命令 stow,把所有绳收回,直到感觉有些张力。在此之前,标记哪个挂钩是电源线的挂钩,以便按标定时的方式重新挂好一切。之前的指南建议手动停放:移到挂钩附近,扶住机器人,用遥控器关闭电机电源,然后挂上去。
  9. 2026 年 10 月之前生产的导环用的是沉头螺丝(锥形头)。如果你的是这种,切勿拧得过紧,否则可能把导环劈成两半。只需拧到感觉结构已牢固地固定在墙上即可。

5.5 上电并连接

在把绳索系上之前完成这一步,此时一切仍触手可及。

  1. 把夹爪插到灰色电源线上。之前的指南说的是把夹爪靠在某个锚座的灰色电源线附近的墙上,并在标记板顶端插上它的 JST-ZH 线缆。
  2. 把 24 V 5 A 电源接到锚座,并通过随附的遥控插座接入墙上插座。
  3. 务必先插圆头电源插头,再接交流电,并且最后才接通交流电(或用插座遥控器开机)。如果圆头电源插头没有在交流电之前插好,锚座可能会永久损坏。
  4. 在主机上启动运动控制器(参见 Usage Guide):pip install "nf_robot[host]",然后运行 stringman-headless。它会开始在网络中搜索部件。
  5. 这一步网络中只能有一台完整的 Stringman——请关闭其他机器,以便发现流程判断哪些部件属于这台机器人。
  6. 用遥控插座给所有部件上电;若尚未配网,给每个相机出示 Wi-Fi 二维码。
  7. 确认控制面板已发现两个锚座和一个夹爪。若没有,全部断电后重来。
  8. 访客网络不可用:它禁止客户端之间相互发现。
  9. 全部连接后,运行 Calibration and Maintenance > Update Firmware On Components,等待三个部件全部确认完成。更新从不会自动推送。

5.6 系上绳索

四个登山扣、四个环,互不交叉。

  1. 关闭整个系统。
  2. 把夹爪放到房间中央,把四根绳都拉到中央。
  3. 把锚座的黑色登山扣扣到黑色挂杆上,把导环的银色登山扣扣到标记板的白色角上,使锚座始终正面看到标记板。绳子之间不得交叉。之前的指南(标记盒)说的是把每个登山扣扣到白色标记盒上对应的环上。
  4. 若尚未接上,从灰色绳末端接通夹爪电源。
  5. 重新上电,等待控制面板发现全部部件。
  6. 选择 Tension Lines(D-Left,或键盘上的 2)——四根绳都应绷紧。
  7. 按住 E 一到两秒即可离地。更复杂的动作需要先完成完整标定。

5.7 执行完整标定

标定依据地面上的四张打印卡片确定锚座和导环的位置。之后的一切——直线运动、消摆、停放——都依赖于它。

  1. 把四张大纸卡放到地面上,标有「origin」的放在中央,其余随意摆放在周围。
  2. 小塑料卡片不属于标定内容——它们用于在日常使用中标注放置点。
  3. 把夹爪放在房间中央附近并接触地面,然后选择 Calibration and Maintenance > Full Calibration。
  4. 标定过程中部分绳索松弛属正常现象,这正是确定导环位置的方式。
  5. 若有卡片移动,按 STOP 并重新开始。
  6. 从三方面判断结果:界面中的房间形状应与实际安装一致;WASD 应产生直线运动;消摆功能应抑制摆动而非放大摆动。
  7. 向前的横移(W,或左摇杆向上)应朝夹爪鼻端所指的方向移动,因为默认采用夹爪视角。
  8. 若结果不佳,把标定卡片摆得更开一些,并让夹爪回到房间中央附近的地面上重试。
  9. 清除房间中散落的 AprilTag 或 ArUco 标记,包括相机可见的电脑屏幕上的标记,并使用可用的最强照明。
  10. 如果两台相机在地面上的重叠区域太小,无法在两者视野内同时放下几张卡片,请调整相机倾角。取下锚座外壳,按压相机倾角机构的上边缘或下边缘,每次调一格。重新运行标定(较慢),或直接在部件的右键菜单中输入已知角度,在合成图像中检查重叠是否改善。标定会自动找出相机的真实角度。
  11. 使用旧款固定适配器(22、26 或 30 度,出厂装的是 26 度)的锚座:取下白色外壳,做好接地以防静电放电,从侧面拧下相机支架。把相机翻起,拆下把它固定在支架上的两颗螺丝。装上角度更合适的支架,高而窄的房间用 30 度,较宽的房间或低天花板用 22 度,把它压入框架上的凹槽,再从侧面拧回。螺丝必须完全拧到位,支架必须紧贴框架,否则它可能停在不确定的方向上。

本网站需要 JavaScript 才能正常运行。请启用 JavaScript 以浏览我们的开源机器人项目。