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 设置默认打印配置
除下文单独说明的零件外,其余全部用同一套配置打印。
- 材料 PLA、2 层壁、15% 网格填充,除非零件另有说明,每种各打印一件。
- 树状支撑,仅限打印板,与零件的 XY 间距 0.5 毫米。
- 普通轴承块、滑环块和「sunglasses」不加支撑打印——这三件是例外。
- 任何齿轮都不要用 PET。上游的理由很直白:会吱吱响。
- 外壳、面板、手指、齿杆、连杆和停放挂钩在成品上都看得见,因此这些零件的颜色要有意选择。其余零件的颜色无所谓。
- 如果不想逐件设置参数,整套打印也已发布为 Bambu 3MF 工程文件。
1.2 打印锚座零件
共两个锚座,因此多数锚座零件要打印两份。框架是唯一不能用 PLA 的零件。
- Cover(外壳)2 件。它外露可见,因此请选与墙面或天花线条相配的颜色。以底面着板打印,这是它唯一一个大平面。2026 年 10 月 18 日之前的打印指南则把它分为 cover top 和 cover bottom 两件:上盖倒扣打印,两半用氰基丙烯酸酯胶粘合。
- 框架 2 件,用 PCTG 或 PETG-CF,不能用 PLA。此零件需要强度和耐热性。
- 框架设置:2 层壁、22% 自适应立方填充、树状支撑仅限打印板且仅关键区域、XY 间距 0.5 mm。建议使用 Bambu super cool tack 打印板。
- 普通轴承块 1 件、滑环块 1 件,不加支撑,以侧面着板打印。
- Spool A Power 1 件、Spool A Regular 3 件、Spool B 4 件。凹孔处使用树状支撑,每个 A 与一个 B 粘合成完整绕线盘。
- Stud mount(墙柱底座)2 件:5 层壁、30% 立方填充。取下锚座时它可能外露,因此白色 PET-GF15 是很好的选择。在底部的孔中加装一个 1/4 英寸粗牙螺纹嵌件,即可改作三脚架使用。之前的打印指南给出的是 3 层壁、100% 填充。
- Sunglasses 2 件,不加支撑,4 层壁、30% 立方填充。外部可见,因此使用与锚座外壳相同的白色 PLA。
- Tilt adapter(倾角适配器)2 件,PLA 颜色不限,细节非常精细,用 0.16 mm 层高。之前的打印指南列出的是 22、26、30 度的固定适配器各一件:角度指相机中心线低于水平面的俯角,天花板高则取大,天花板低则取小。
- Odd spacer 2 共 2 件,默认设置。每个锚座一件:它从背后支撑圆头电源插座。
1.3 打印导环零件
两个导环承接四根绳中两根的远端。
- Body stud mount(导环本体,墙柱安装款):以那个特殊的倾斜旗形面着板打印,比背面着板更结实。100% 填充,PET-GF15,与墙面颜色一致。
- Eyelet vice block(导环压紧治具)1 件:用于固定导环的治具,以便用台钻把本体、圆环和 retainer 压合在一起。
- 压环:与导环另一零件颜色一致。
- 锚座装配指南要求制作两个导环,因此本体和压环各打印两件。
1.4 打印夹爪零件
驱动齿轮决定夹爪能否正常工作——它是整套系统中唯一需要非常规喷嘴温度的打印件。
- Back plate(背板)、camera mount(相机支架)、mechanism lid(机构盖)和 motor bracket(电机支架):默认设置,颜色基本无所谓,不过手指张开时会露出一些小零件。旧款两段式 ABS 杆需要一个打印的连接套(coupler),打印指南已不再列出它。
- Flat marker(扁平标记板)1 件:如果能多色打印,使用 flat_marker_colored.3mf,否则用白色打印后贴上贴纸。2 层壁、15% 网格填充。另外用黑色 PLA 打印 hang bar(挂杆)1 件,它是扁平标记板的辅助零件。早期设计是标记盒(platform box),用白色打印后贴贴纸,或多色打印。
- Drive gear(驱动齿轮)1 件:100% 填充、3 层壁。普通塑料对这个零件来说强度不够,套件随附的是树脂打印的齿轮。PCTG 以 265 °C 喷嘴温度打印(高于该耗材的常规温度)是次优选择。PET 会吱吱作响,PLA 会断,PETG 太软。如果你能打印尼龙和 ABS,它们大概也可以。
- 面板后件与面板前件:外部可见,颜色要有意选择。在切片软件中合并,开口面相对打印,以共用树状支撑。
- Finger(手指)2 件、geared lever left 和 geared lever right:外部可见的零件,其余按默认设置。
- 连杆 2 件——属于手指部分。
- Spacer(垫片)7 件,默认设置。三件用于夹爪,每个锚座各用两件。
- 腕杆斜齿轮、腕部拆卸块和腕部舵机斜齿轮:默认设置,颜色无所谓。
1.5 打印附件
停放用配件以及标定所用的打印 AprilTag 卡片。
- Clip 或 alligator clip(夹子),4 件,默认设置,白色。鳄鱼夹版本是一种替代方案,可夹在较大的物体上。
- Parking hook(停放挂钩)1 件和 parking support bar(停放支撑杆)1 件:外部可见的零件,因此与墙面颜色一致。2 层壁、11% 立方填充。
- all_cards.3mf:使用 Bambu 多色配置打印。这就是稍后铺在地面上的标定卡片。
2. 制作锚座
整节内容重复两遍,每个锚座一遍。上游给出的数据是每个锚座 40 小时打印、1.5 小时装配。2026 年 6 月 26 日之后在 neufangled.com 购买的套件无需焊接;自行采购的零件可能需要。
2.1 准备工具
两份装配指南开头都是同一份简短的工具清单。
- 迷你螺丝刀及批头套装,手动或电动均可。
- 交叉自锁镊子。
- 强力胶——上游推荐 Loctite Super Glue Professional Liquid。
- 备一个懒人沙发很值得:两份指南都建议用它在拧螺丝时以任意角度托住组件。
2.2 粘合绕线盘
整套系统需要三个绕钓线的普通绕线盘和一个走电缆的电源绕线盘。
- 每个绕线盘由两个打印半件组成:把 A 面与 B 面粘合。
- 电源绕线盘的 A 面不同——中心孔更大。请单独放置。
2.3 装配三个普通绕线盘
过程很直接:绕线盘装到电机上,另一侧再装一个轴承。
- 把干燥的绕线盘压到电机上直至完全到位,然后旋转到孔位对齐。
- 用三颗 M3x8 螺丝固定。
- 把一颗 M4x12 螺丝穿过 4x13x5 轴承,再穿过两片 M4 垫圈,然后点一滴强力胶或 loctite,拧入绕线盘中心的 4 mm 孔。
2.4 装配电源绕线盘
这个绕线盘通过一根同时收放的绳索给夹爪供 24 V,因此中心装有滑环。
- 在滑环的固定端焊上 JST ZH 母头护套。
- 用 imp 割管器截取 10 mm 长、直径 10 mm 的 ABS 管。套件中附带这段 1 cm 的管子。
- 把管子粘入电源绕线盘 A 面的孔中。用硬币压入很顺手。
- 待干后,在管上装一片 3/8 x 7/8 不锈钢垫圈,再装一个 10x15x4 轴承。
- 把滑环放入滑环块,在三个可触及的孔中选两个,用两颗 M3x8 螺丝各配一片 M4 垫圈固定。
- 把旋转端导线穿入绕线盘的管中约一半,再从绕线盘侧面的过线孔穿出。先不要收紧——给电机螺丝留出空间。
- 把电机压入绕线盘,对齐孔位,用三颗 M3x8 螺丝固定。
- 轻轻抽拉导线,使滑环完全贴合到绕线盘侧面。
2.5 装配锚座电子件
一块 Pi 3A+、Stringman Anchor Hat,以及装在可调倾角适配器上的 Camera Module 3,另加一个风扇。早期的锚座使用 Pi Zero 2W;参见本步骤的最后几条。
- 为 Raspberry Pi 3A+ 装上烧录了 Stringman 镜像的 SD 卡,并在 Broadcom 芯片上贴一片散热片。3A+ 的镜像与 Zero 2W 的镜像不同。
- 把一块 Stringman Anchor Hat 压到 Pi 上。
- 在两块板之间的四角放入圆柱形垫柱,并在角上的孔中插入两颗 M2.5x18 螺丝,穿过 hat、垫柱和 Pi。
- 在圆头电源插座下方塞入一个 odd spacer 2。它看起来像只有一个凸点的乐高积木,用来支撑圆头电源插座,这样你往里插插头时,插座就不会把 hat 压弯。
- 小心拆开一只标准视场(FOV)的 Camera Module 3。保留已连接的白色(全尺寸)排线。
- 把相机正面朝下放在柔软的东西上,以保护其自动对焦机构,然后如图所示,用 M2x4 螺丝在四个角把它拧到可调倾角适配器上。
- 如图所示,把排线的另一端插入 Pi 的相机排线接口,即靠近板子中央的那个。排线有富余长度,因此把多出的一折塞到 hat 下面。
- 把 Pi 拧进框架底部的电子仓,先用那两颗 M2.5x18 螺丝,再在其余孔中用两颗 M2.5x6 螺丝。相机应从前窗探出。
- 把相机翻过来,卡进框架上的两个凸起之间。把带齿的臂插入框架上对应的槽。对齐两侧的螺丝孔,在适配器两侧拧入两颗 M2.5x6 螺丝,把它固定到框架上。
- 在框架背面的槽中安装一个 4 线 3007 PWM 风扇,向外吹风。把导线穿过去,插到 hat 上对应的接口,然后用两颗 M3x8 螺丝在对角处把风扇固定。
- 按旧版指南(截至 2026 年 10 月 19 日的存档)制作的锚座,使用的是带一片散热片的 Raspberry Pi Zero 2W 和 Zero 2W 镜像。对于这些锚座,指南的说法是:如果 Pi 没有排针,焊上整排;拆开相机,取下随附的排线;在相机上安装 4 cm 迷你排线,金手指朝下对着电路板,再把较小的一端接到 Pi 上;把 hat 压上去;在四角放入垫柱并插入四颗 M2.5x18 螺丝;把 Pi 拧到电子仓里的锥形柱上。
- 在那个早期版本中,相机安装在一个打印的固定相机角度支架上:以排线接口朝上看向镜头时位于右前方,下俯角为相对水平面 22、26 或 30 度,按让地面保持在画面中央的原则选择。之后可以更换,但必须在配置中告知新的俯角。支架用一颗 M2.5x6 螺丝装到框架上,它的小凸起决定最终角度,且只有一种装法。
2.6 把电机装入框架
先装下绕线盘。两台电机都从框架外侧拧固。
- 把框架翻回正面朝上。将插头向下穿过下绕线盘一侧的矩形孔。
- 避免电机螺丝错牙:先反向旋转,确认螺纹咬合的是金属而不只是塑料。
- 可能需要把轴承座从绕线盘旁推开。它不应碰到绕线盘。如果碰到了,用扁平物体把它撬回 2 mm。绕线盘应能自由转动。
- 调整电机轴,使缺口朝下、平面竖直,然后滑入卡槽,边推边把导线拉过去。
- 使其在卡槽和另一侧轴承座中牢固就位。转动一下,确认没有歪斜。
- 从框架外侧用三颗 M3x8 螺丝固定电机。
- 若上绕线盘是普通绕线盘,请打印为普通绕线盘设计的滑环块变体,并压到绕线盘凸出的轴承上。
- 若上绕线盘是电源绕线盘,它已带有轴承块:把导线用力抽紧,直到滑环无法再靠近绕线盘为止。
- 穿好插头,对齐电机轴,对齐另一侧的轴承块,然后从外侧用三颗 M3x8 螺丝固定电机,再用两颗 M3x8 螺丝固定轴承块。
- 用四颗 M3x8 螺丝把「sunglasses」固定到框架顶部。
2.7 给钓线绕线盘绕线
绕线由脚本完成而非手工:qa-anchor-arp 会设定电机 ID、按绕线盘类型绕入正确长度并检查相机。
- 给锚座上电,通过 Wi-Fi 或以太网适配器接入网络。
- 用 ssh pi@<主机名或 IP> 登录;Stringman 原始镜像的密码是 Fo0bar!!。
- 先更新:/opt/robot/env/bin/pip install --upgrade "nf_robot[pi]"。
- 运行 /opt/robot/env/bin/qa-anchor-arp 并按提示操作。
- 它会要求你逐个接入电机并给它们重新上电,方法是在 hat 上拔下再插回电机插头,而不是圆头电源插头。若连接中断,重新登录并再次运行脚本:它会从上次中断处继续。之前针对 Pi Zero 2W 锚座的指南说的是拔插圆头电源插头。
- 给钓线绕线盘绕线前,先用水手结(buntline hitch)把线头系在绕线盘的小系线点上。
- 在空旷处松松地托住供线盘。绕线很快——不要抓紧。
- 对准备绕线的每个绕线盘在提示处回答 y,暂不绕线则回答 n。
- 绕线完成后,把线头从后向前经 sunglasses 引出,用帕洛马结(palomar knot)系上一个登山扣。如果两种颜色都有,左侧系银色,右侧系黑色。
2.8 给电源绕线盘绕线并接线
这是唯一一处出错就会赔上电缆的步骤:受力必须由绳结承担,而不是接头。
- 若拿到的是已按长度裁好的电缆,现在就把一个登山扣从裸线端穿入,经登山扣的小孔,一直送到另一端的 JST 插头处——稍后要在那里用到。
- 把电缆的裸线端从「sunglasses」前方送入,拉出足够余量,再从锚座背面向前穿过绕线盘的系线孔。
- 从系线孔再拉出一些余量,打一个简单的平结。先不要收紧。
- 把绕线盘向前转动,修剪滑环导线,使其绕绕线盘约三分之二圈且不到达系线点。这个长度很重要。
- 用焊锡和热缩管把灰色电源线与滑环导线接在一起:棕接红、蓝接黑。上游表示,最牢固的接法是把每根线末端裸露的导线与对应导线互相钩住、捏紧、焊好,再套上热缩管。之前的指南改用一对焊锡密封接头(solder-seal),并先套上热缩管。
- 用 18 AWG 刃口剥电缆外皮,用较小剥线钳的 28 AWG 刃口剥线芯。
- 收紧平结的余量,使包好的接头位于绕线盘根部,但不要收到让接头承重——真到受力时,应由绳结承担。
- 在脚本中对上绕线盘回答 y,按回车开始绕线。
- 用水手结把先前穿好的登山扣系在末端,使绳结承重,末端的接头不受任何机械应力。
2.9 完成锚座并制作导环
两个导环承接两根绳的远端;它们是整套系统中最简单的打印组件。
- 脚本会提示你测量电机的摩擦力。在回答 yes 之前,先在登山扣和孔之间拉出 30 cm 的余量,让绳子自由垂下,然后运行摩擦力测量。最后脚本会提示进行相机画面测试,然后结束。运行 sudo shutdown now,等指示灯熄灭后拔掉电源,以关闭锚座。之前的指南只说直接拔掉电源。
- 确认黑色电机线缆已妥善收进锚座底部的空腔内。
- 每个导环各把一枚 20 号 Alconite 环压入环槽。
- 在剩余空隙滴一滴强力胶,用一枚硬币和可施压的工具(如台钻或台虎钳)把 retainer(压环)压上去。最牢固的方法是用压具:把导环本体放进打印的 eyelet vice block,使小箭头落入对应的槽中,这样圆环就与治具背面平行,然后按本体、胶、圆环、胶、压环、硬币的顺序叠放。把整叠压紧,并在硬币粘住之前取下。之前的指南用的是一枚硬币和一把钳子。
- 制作两个。然后为第二个锚座重复本节全部内容。
3. 制作夹爪
每台机器人一个夹爪。上游给出的数据是 20 小时打印、2 小时装配。全过程反复出现的要领是:把尼龙锁紧螺母拧到没有间隙,再回松到关节能自由转动为止。
3.1 准备额外工具
夹爪需要锚座用到的全部工具,另加两件切割工具。
- 迷你螺丝刀及批头套装、交叉自锁镊子和强力胶,与锚座相同。
- 用于修剪防滑胶带的美工刀或模型刀。
- 用于压力传感器接头的齐平剪线钳。
3.2 装配手指
没有左右手指之分——叉件和指垫都是对称的。
- 把叉件装到指垫背面,用一颗 M3x25 螺栓穿过上方孔位、贯穿两件,另一侧配 M3 锁紧螺母。
- 把尼龙锁紧螺母拧到没有间隙,再回松到杆件能够摆动。另一个手指同样处理。
- 把带齿杠杆滑入手指组件,使其平面与手指平面共面。
- 用一颗 M3x25 螺栓穿过组件,另一侧配 M3 锁紧螺母,拧紧后回松到机构恰好能自由活动。另一个手指同样处理。
3.3 安装压力传感器
其中一个手指负责感知接触力。套件中此部分已预装。
- 找到压力传感接头:2 针、1.00 毫米间距的 JST-SH 公头,带 20 厘米引线。
- 把热缩管套到导线上,焊接到力敏电阻上。极性无所谓。
- 用齐平剪线钳剪掉 JST-SH 接头的翼片,使其能穿过线槽。
- 选择内部带线槽的那个手指,把插头穿过线槽,再把电阻贴片粘到手指上。
3.4 贴防滑胶带
真正抓住物体的是指板防滑胶带。共四条,每个手指两条。
- 准备至少四条 110x37 毫米的指板防滑胶带。
- 把手指正面朝上放置,使指垫与带齿杠杆的平面共面,用连杆作支撑。
- 沿长度方向贴第一条,从靠近齿轮的上边缘开始;另一端会多出约 10 毫米——把它折过棱边。
- 把手指平压在桌面上,使泡棉各处贴牢。
- 再横向在指尖处贴第二片,两侧各折入 10 毫米。
- 用模型刀修去多余部分。
- 把手指翻成正面朝上,沿两块手指件相互滑动的缝隙把泡棉划开,然后活动关节,检查有无翘边。
- 另一个手指同样处理。
3.5 准备舵机与驱动齿轮
两台 STS3215 智能舵机:一台驱动手指,一台驱动腕部。
- 用随附的 M3x6 中心螺丝把铝制舵盘装到两台电机上——使用内侧带凸纹的那种舵盘。
- 把电机附带的两颗 M3x6 螺丝从侧面卡入手指驱动齿轮。
- 把驱动齿轮牢牢拧到其中一台电机的铝制舵盘上。
- 套件随附的驱动齿轮是树脂打印的。如果你自己打印,PCTG 以 265 °C 喷嘴温度打印是次优选择,PLA 会断。
- 给每台电机插上三线 SPOX 线缆——即电机盒内附带的那根。
3.6 装配夹爪主体
带齿的杠杆在整个装配过程中必须始终保持啮合。此处用橡皮筋当第三只手完全合理。
- 掰掉机构盖打印件上的耳片,用锋利工具清理牺牲桥所在的位置。
- 用电机附带的四颗最小螺丝,把手指电机装在机构盖外侧。
- 从下方把两颗 M3x25 螺栓插入背板,放下时按住它们,并各套上一片 M3 垫圈。
- 让两根齿杆在闭合位置啮合,检查对位。它们必须保持啮合——必要时用橡皮筋固定。
- 把压力传感接头穿过背板上的笑脸形槽口,然后同时把两个手指装到螺栓上,保持啮合,并注意不要压到传感器导线。
- 在每颗螺栓从齿杆孔中露出的位置各套一片 M3 垫圈。
- 在接下来的操作中,用胶带固定或用手指按住 M3x25 螺栓,防止它们从背面脱出。然后轻轻晃动,把机构盖与手指电机组件放到背板上:两颗 M3x25 螺栓穿过盖板,驱动齿轮与手指齿轮啮合。两侧的对位凸片应当对齐。若装不进去,把螺栓退回手指内,先让齿轮啮合,再把螺栓推过去。
- 把两颗 M3 锁紧螺母放入六角槽,从背面拧紧螺栓,再回松到齿杆能自由活动。如果你之前用胶带固定了螺栓,直接用工具捅穿胶带,不必费力先把它撕掉。
- 在背板中心孔拧入一颗 M4x12——它能稳定手指驱动齿轮。
- 用四颗 M3x8 螺丝沿边缘固定盖板。
- 把两根叉形连杆向上摆入各自的槽位,在机构盖一侧用两颗 M3x14 螺丝固定。背面稍后再固定。
3.7 安装夹爪电子件
Pi Zero 2W、Stringman Gripper Hat 和广角相机。四角中只有三处上螺丝。
- 选一块 Pi Zero 2W,可以是带完整排针的版本,也可以是在每排前六个位置焊了针脚的无排针版本。如果 Pi 没有排针,焊上整排。如有需要,上游提供了 MakerWorld 上可打印焊接治具的链接。
- 在黑色芯片(SOC)和银色芯片(射频模块)上各贴一片散热片。把板子翻过来,在背面芯片下方再贴两片散热片。然后把 Stringman Gripper Hat 压到 Pi 上。
- 拆开两端均为 JST ZH 公头的 64 cm 线缆。把它从夹爪顶部的孔穿进去,直到从 Pi 附近的机体中穿出。把它插到 Gripper Hat 上标有 24v/GND 的插座,并把这根线约 10 cm 的余量绕成一圈塞进其他线中间。这样它的长度正好适合之后装上的杆。
- 在两板之间放入垫柱,用 M2.5x16 螺丝穿过板与垫柱,只固定三个角——第四个角要走排线。
- 拆开一只广角 Camera Module 3,安装 8 厘米迷你排线,宽的一端接相机。
- 轻轻拉出 Pi 排线接口两侧的黑色卡扣,把排线黑色面朝上插入卡扣下方,再把卡扣推回。若卡扣脱落,用镊子一侧一侧地装回。
- 用两颗 M2x4 螺丝在对角处把相机拧到相机支架上,按上游图示折叠排线,再把板组固定到支架上有螺丝孔的三个角。
- 张开夹爪手指,用一颗 M3x6 沉头螺丝把相机支架组件固定到背板上。
- 在既固定电子件支架又锁住此前未固定一侧叉件的孔位,拧入两颗 M3x14 螺丝。
- 把压力传感线插入 Gripper Hat 上标有 pressure 的插座。
- 按 Raspberry Pi 设置指南烧录一张 SD 卡并插入。
3.8 安装激光测距仪
一只 VL53L1 飞行时间传感器越过手指向下观测。
- 若测距仪是自行采购的,请焊上直排针——六个引脚全焊,或只焊标有 VIN、GND、SCL 和 SDA 的四个。
- 把 4 针矩形杜邦插头接到测距仪上,红线位于外侧边缘。
- 把 4 芯测距仪线缆穿过框架边缘的孔。
- 把它插到 Gripper Hat 短边上的对应插座。
- 用两颗 M2x4 螺丝把测距仪固定在其座位中。
3.9 安装腕部电机
第二台 STS3215 通过一对斜齿轮,使整个夹爪在杆件下方旋转。
- 用电机盒中的四颗小自攻螺丝,按上游图示方向把支架装到剩下的那台电机上。
- 用舵机附带的两颗 M3x6 螺丝,把三孔腕部斜齿轮装到舵盘上。
- 用两颗 M3x8 螺丝把电机支架固定到夹爪上。
- 把手指电机插入 Gripper Hat 的电机接口。腕部电机暂时不接:两个舵机出厂时 ID 都是 1,因此必须逐个接入来设置 ID。
3.10 安装风扇
在夹爪上装一个 30 mm 风扇,并插到 Gripper Hat 的 FAN 接口上。
- 安装一个 30 mm 风扇,向内朝 Pi 吹风,在底部用两颗 M3x10 螺丝固定。之前的指南是用两颗 M3x8 螺丝在对角处把它装到机构盖上,气流朝外。
- 把风扇插到 Gripper Hat 上标有 FAN 的 4 针 JST-SH 接口。板上有两个 4 针 JST-SH 接口:FAN 位于板子的长边,另一个用于测距仪。之前的指南说的是标有 FAN 的 5 V 插座。
3.11 制作标记盒与杆件
标记板是被动件:它在四根绳汇合的位置承载 AprilTag。旧文档称之为 gantry。2026 年 8 月 8 日之前从 Neufangled 购买的套件,配的是截成两段的 50 cm ABS 杆,更早的版本还配有标记盒:本步骤最后几条介绍这些情况。
- 标记板通过一根 27 cm 长、直径 10 mm 的碳纤维管与夹爪相连。可以用钢锯或切割锯慢慢截到所需长度。切勿吸入粉尘。
- 在管上装一个 10x15x4 轴承,再装一片 3/8 x 7/8 不锈钢垫圈。
- 把斜齿轮推压并旋转套到管上,直到管子伸出约 2 cm。这不是最终位置,只是留出空间。
- 为获得更耐用的效果,用多色打印标记板,使用 STL 下载包中 Bambu 多色打印文件里的 flat_marker_colored.3mf;或者用白色 PLA 打印后贴上贴纸。用黑色 PLA 打印挂杆(hang bar)。
- 如果用贴纸,把标记图像无边距打印在贴纸上,沿两条灰线裁开,得到两张各含两个标记的矩形贴纸。这个零件用的是名为 gantry 的那张贴纸。
- 在每张贴纸背面的一个角上划出一个三角形。这样更容易揭下底纸。
- 每张贴纸都要跨过一个角粘贴,使每个面上各有一个标记。注意方向:树干朝下。
- 准备好 JB-Weld PlasticWeld 环氧胶、一个纸盘、一根搅拌棒、已装好齿轮的杆、标记板、挂杆,以及一个设为 5 mm 的测量工具。按说明调配少量环氧胶。
- 在齿轮下方的碳纤维管上涂环氧胶。把齿轮向下滑,直到只剩 5 mm 的管子。把最后一片钢垫圈放到管端,粘在挤出的环氧胶上。擦净多余的环氧胶。
- 在管子另一端顶部 3 cm 处涂环氧胶。把它推入标记板底部的孔中,直到完全插到位。擦净多余的环氧胶。
- 如图所示,把挂杆圆角朝下插入标记板的开口。先推入大部分,在接合处涂一些环氧胶,再完全推到底。
- 让这些胶接处固化 24 小时。
- 把夹爪的电源插头沿杆向上穿,直到从顶端露出。如果在管内卡住,来回转动管子。把齿轮和轴承放入腕部座(转角无所谓,之后由标定确定),压入齿轮直到齿啮合且轴承完全到位,再把腕部块向下压入腔体,用三颗 M2.5x6 螺丝固定。
- 用四颗 M2.5x6 螺丝装上夹爪的前盖和后盖。确保每个盖子都完全压到位,以免挡住相机的观察孔。
- 旧套件:2026 年 8 月 8 日之前从 Neufangled 购买的套件,配的是一根截成两段的 50 cm 长、直径 10 mm 的 ABS 杆。用打印的连接套把它重新接好:在一段管子末端 1 cm 的范围涂上 JB-Weld PlasticWeld 环氧胶,压入连接套,然后另一侧同样处理。如果你的杆是整根的,跳过这一步。2026 年 6 月 6 日的指南则是在连接套一侧内壁涂一圈氰基丙烯酸酯胶,一鼓作气把一段杆插进去;这种接头可承受约 5 kg。
- 带标记盒的旧套件:标记盒多色打印更耐用,或用白色打印后贴贴纸。在 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+。若购买的是整机,可跳过此步。
- 下载 Raspberry Pi Imager 并插入一张 microSD 卡。
- 设备处,夹爪选择 Raspberry Pi Zero 2 W,锚座选择 Raspberry Pi 3A+。
- 下载对应该 Pi 的 Stringman Raspberry Pi 镜像(每个 1.6 GB):夹爪用 stringman-zero2w.img,锚座用 stringman-pi3aplus.img。操作系统处选择自定义镜像,并使用下载的文件。
- 选择该卡,点击写入并确认。
- 把烧好的卡插入部件的 Pi 并开机。
4.2 运行部件自检
它负责设定电机 ID,并留下决定服务下次启动时执行哪种行为的文件。
- 用 SSH 登录部件,先停止服务:sudo systemctl stop cranebot.service。
- 更新软件包:/opt/robot/env/bin/pip install --upgrade "nf_robot[pi]"。
- 锚座运行 /opt/robot/env/bin/qa-anchor-arp,并做好绕线时高速运动的准备——不要抓紧供线盘。
- 夹爪运行 /opt/robot/env/bin/qa-gripper-arp。
- 若手指接触测试始终检测不到压力,请微调电路板上的电位器,直到能检测为止。
- 最后的视频测试既可以按提示的命令在主机上打开视频流来完成,也可以用 ctrl-c 结束。
4.3 让每个部件接入 Wi-Fi
墙上锚座里的 Pi Zero 没有键盘:部件用自己的相机从二维码读取 Wi-Fi 凭据。
- 开机后约 10 秒内,连不上已保存网络的部件会开始用其相机寻找 Wi-Fi 分享二维码。
- 用手机的 Wi-Fi 分享界面生成二维码,或用 qifi.org 生成传统的方块二维码,后者在较远距离更易识别。
- 把二维码对准每个相机(包括夹爪的相机)各约十秒。5 厘米大的方块二维码在约 1.5 米外即可识别。
- 成功会以物理方式提示:锚座会让电机发出蜂鸣,夹爪会摆动手指。锚座连上网络后还会开始保持位置。
- iPhone 的二维码没有问题;Android 的分享二维码只是装饰性的,必须凑得很近才能识别。
- 如果二维码配网在你的情况下行不通,把该部件的 SD 卡插入电脑,确认它挂载在 /media/$USER/rootfs,然后在 cranebot3-firmware 仓库中运行 sudo ./add_wifi_config.sh "SSID" "password"。该脚本位于 src/nf_robot/scripts/add_wifi_config.sh。
- 快速连按指垫五次,即可清除夹爪中保存的 Wi-Fi 凭据。
4.4 可选:加强 Pi 的安全性
原始镜像带有一个公开已知的密码,除了方便排查故障之外别无用处。
- Stringman 镜像的默认用户是 pi,密码为 Fo0bar!!。
- 自动方式:在固件仓库中激活虚拟环境后运行 python experiments/deploy_ssh_keys.py <robot conf.json>。它只有在验证密钥登录可用之后才会关闭密码登录,因此不会把你锁在门外。
- 手动方式:用 passwd 修改密码,用 ssh-keygen -t ed25519 和 ssh-copy-id pi@<部件> 配置密钥登录。
- 确认无需密码即可登录后,在 /etc/ssh/sshd_config 中设置 PasswordAuthentication no 与 ChallengeResponseAuthentication no,并重启 ssh。
- 三个部件逐一重复。
5. 在房间中安装并标定
上游把这一步比作挂窗帘杆:不受打扰的情况下约一小时,另加至少 30 分钟调试。工具为人字梯、电钻/起子机、M1.5 内六角批头和 T20 梅花批头(均随附)。
5.1 规划工作区域
四个安装点决定了机器人的全部工作空间,因此这是最难更改的一项决定。
- 为锚座选择对角两个墙角;另外两个墙角安装导环。这四点围成的空间就是工作区域。
- 在保持无障碍的前提下尽量扩大该区域。
- 锚座必须固定在墙后的木质龙骨上,或用绑带固定在结构柱上。石膏板住宅的墙角背后至少有一根龙骨,只要有一侧打中龙骨就足够。
- 不要用胶粘或磁吸方式安装。标称 5 公斤的免钉胶条是按垂直向下受力标定的,而 Stringman 会在多个方向上横向拉扯。
- 不要固定在吊顶的 T 型龙骨上——即使安装件不脱落,龙骨变形也会改变锚座朝向,毁掉标定和消摆效果。
- 若房间有吊扇,把锚座装在扇叶高度或更低处,机器人就够不到扇叶。
- 工作区域内有高低床是可以接受的,但由于未实现避障,请预期偶尔需要手动干预。
- 若没有可用的龙骨,就需要在房间的结构件上加装一块背板。
5.2 重新接合夹爪与标记盒
两者分开发货以便使用更小的包装箱。这一步是夹爪装配最后一步的逆过程。
- 用随附的 1.5 mm 迷你螺丝刀批头,拧下固定夹爪后盖的两颗螺丝,上下各一颗。你的夹爪发货时可能已经拆下了这两颗螺丝,这种情况下它们在配件袋里。
- 拧下固定腕部拆卸块的三颗螺丝(它是背面上方带矩形孔的那个零件),把它拔出来。配合刻意做得很紧。如果太紧,用螺丝刀把它撬出来。
- 把夹爪的电源插头沿标记板的杆向上穿,直到从顶端露出。如果在管内卡住,来回转动管子。
- 把齿轮和轴承装入腕部座——旋转角度无所谓,稍后由标定确定。
- 压入齿轮直到轮齿啮合、轴承完全到位,然后把腕部块压回腔中,用三颗螺丝固定。
- 用先前拆下的两颗螺丝装回后盖。
5.3 安装锚座
高度取三者中最低的一个:天花板、顶角线或吊扇扇叶。
- 在墙角天花板下方 13 厘米(5 英寸)处做标记。若有顶角线,从顶角线量起;若有吊扇,标记扇叶高度。取三者中最低者。
- 把蝶形墙面底座贴在墙上,其上边缘对准标记。
- 在墙角安装时,使用水平居中的两个孔:划线、透过零件预钻,然后拧入两颗 76 毫米(3 英寸)木螺丝。
- 在平墙上安装时,使用同一侧的一对竖直孔,使底座朝向房间中央,并用探测仪或从石膏板螺丝位置找出龙骨。
- 很多住宅的墙面并不方正。若拧紧时底座变形,请回松螺丝直至变形最小,否则锚座将无法滑入。
- 把锚座举到接近天花板处,沿底座竖直向下滑动,直到锁紧到位。
- 趁梯子还在,插上一根白色圆头插头延长线并让它垂下。
- 把锚座的两根绳都拉到不用梯子就能够到的高度,然后在对角处重复上述步骤。
- 装着外壳拿锚座可能不太好拿。最简单的方法是用双手从上下两侧夹住它;也可以在地面上先取下装饰外壳,不带外壳安装锚座,之后再装上外壳。这样多一个步骤,但可能更安全。
5.4 安装导环与停放挂钩
导环把四根绳中的两根经其余两个墙角转向。
- 在其余每个墙角,用一颗木螺丝把导环固定到龙骨上,小指针朝上。
- 面向墙角时,它应位于右侧墙面上;若该墙角处是平墙,只要固定在龙骨上,怎么装都可以。
- 面向导环,看向你右侧的锚座。取下其左侧绳上的登山扣,从后向前穿过导环,再拉到可及的高度。
- 把停放挂钩钩尖朝上装在靠近某个锚座的墙面龙骨上,位置在上游图片中用蓝色轮廓标出的区域内,使标记板正好位于挂钩前方时,其标记能被锚座相机看到。它可以装在锚座的任意一侧;装在左侧时,必须把挂钩的爪翻过来,使其朝锚座方向张开。不要装得离锚座太近,否则绳子会妨碍正常运动。螺丝略微斜打,以便工具有空间操作。
- 挂钩要装得足够高,让人在机器人停放时能从绳子下方轻松走过。如果装得太高,停放会变得非常困难,因为越靠近天花板精度会呈指数级下降。
- 如有需要,也可以把挂钩装在该区域之外,但这样就无法自动停放,因为锚座看不到标记板。之前的指南描述过一个打印在窄搁板上的 AprilTag,安装在停放状态下夹爪手指下方两英寸处,用来辅助自动停放。当前指南已不再提及它。
- 记录停放位置:给系统上电,手动把夹爪开到挂钩附近,运行 Half cal (2) 以确保位置定位准确,开进挂钩并向下移动,直到挂钩承受住重量,在 run 菜单中选择 Parking > Set Parking Location,等待运动停止。然后选择 Unpark,确认它能顺利离开挂钩,再把它开到房间里的某个位置并选择 Park,测试自动停放。若自动停放效果不好,重新记录一次。如果仍然不好,可能是房间的标定不够好,或者光线太暗,锚座在停放时看不到标记板。
- 你也可以在登山扣处把夹爪从绳上取下,运行调试命令 stow,把所有绳收回,直到感觉有些张力。在此之前,标记哪个挂钩是电源线的挂钩,以便按标定时的方式重新挂好一切。之前的指南建议手动停放:移到挂钩附近,扶住机器人,用遥控器关闭电机电源,然后挂上去。
- 2026 年 10 月之前生产的导环用的是沉头螺丝(锥形头)。如果你的是这种,切勿拧得过紧,否则可能把导环劈成两半。只需拧到感觉结构已牢固地固定在墙上即可。
5.5 上电并连接
在把绳索系上之前完成这一步,此时一切仍触手可及。
- 把夹爪插到灰色电源线上。之前的指南说的是把夹爪靠在某个锚座的灰色电源线附近的墙上,并在标记板顶端插上它的 JST-ZH 线缆。
- 把 24 V 5 A 电源接到锚座,并通过随附的遥控插座接入墙上插座。
- 务必先插圆头电源插头,再接交流电,并且最后才接通交流电(或用插座遥控器开机)。如果圆头电源插头没有在交流电之前插好,锚座可能会永久损坏。
- 在主机上启动运动控制器(参见 Usage Guide):pip install "nf_robot[host]",然后运行 stringman-headless。它会开始在网络中搜索部件。
- 这一步网络中只能有一台完整的 Stringman——请关闭其他机器,以便发现流程判断哪些部件属于这台机器人。
- 用遥控插座给所有部件上电;若尚未配网,给每个相机出示 Wi-Fi 二维码。
- 确认控制面板已发现两个锚座和一个夹爪。若没有,全部断电后重来。
- 访客网络不可用:它禁止客户端之间相互发现。
- 全部连接后,运行 Calibration and Maintenance > Update Firmware On Components,等待三个部件全部确认完成。更新从不会自动推送。
5.6 系上绳索
四个登山扣、四个环,互不交叉。
- 关闭整个系统。
- 把夹爪放到房间中央,把四根绳都拉到中央。
- 把锚座的黑色登山扣扣到黑色挂杆上,把导环的银色登山扣扣到标记板的白色角上,使锚座始终正面看到标记板。绳子之间不得交叉。之前的指南(标记盒)说的是把每个登山扣扣到白色标记盒上对应的环上。
- 若尚未接上,从灰色绳末端接通夹爪电源。
- 重新上电,等待控制面板发现全部部件。
- 选择 Tension Lines(D-Left,或键盘上的 2)——四根绳都应绷紧。
- 按住 E 一到两秒即可离地。更复杂的动作需要先完成完整标定。
5.7 执行完整标定
标定依据地面上的四张打印卡片确定锚座和导环的位置。之后的一切——直线运动、消摆、停放——都依赖于它。
- 把四张大纸卡放到地面上,标有「origin」的放在中央,其余随意摆放在周围。
- 小塑料卡片不属于标定内容——它们用于在日常使用中标注放置点。
- 把夹爪放在房间中央附近并接触地面,然后选择 Calibration and Maintenance > Full Calibration。
- 标定过程中部分绳索松弛属正常现象,这正是确定导环位置的方式。
- 若有卡片移动,按 STOP 并重新开始。
- 从三方面判断结果:界面中的房间形状应与实际安装一致;WASD 应产生直线运动;消摆功能应抑制摆动而非放大摆动。
- 向前的横移(W,或左摇杆向上)应朝夹爪鼻端所指的方向移动,因为默认采用夹爪视角。
- 若结果不佳,把标定卡片摆得更开一些,并让夹爪回到房间中央附近的地面上重试。
- 清除房间中散落的 AprilTag 或 ArUco 标记,包括相机可见的电脑屏幕上的标记,并使用可用的最强照明。
- 如果两台相机在地面上的重叠区域太小,无法在两者视野内同时放下几张卡片,请调整相机倾角。取下锚座外壳,按压相机倾角机构的上边缘或下边缘,每次调一格。重新运行标定(较慢),或直接在部件的右键菜单中输入已知角度,在合成图像中检查重叠是否改善。标定会自动找出相机的真实角度。
- 使用旧款固定适配器(22、26 或 30 度,出厂装的是 26 度)的锚座:取下白色外壳,做好接地以防静电放电,从侧面拧下相机支架。把相机翻起,拆下把它固定在支架上的两颗螺丝。装上角度更合适的支架,高而窄的房间用 30 度,较宽的房间或低天花板用 22 度,把它压入框架上的凹槽,再从侧面拧回。螺丝必须完全拧到位,支架必须紧贴框架,否则它可能停在不确定的方向上。