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 檔案、列印指南與 BOM)採用 CERN-OHL-W 2.0,並附有一份附錄,聲明使用者須對安裝或使用所造成的任何傷害、損壞或損失承擔全部責任。PCB 儲存庫(nhnifong/stringman-pcbs)沒有授權檔案,因此 KiCad 專案與 Gerber 雖已公開,但沒有任何開源授權:預設保留所有權利。查核日期:2026-08-07。

組裝指南

1. 列印零件

完整系統約需 80 小時列印。除非零件另有說明,否則套用 Print Guide 的預設值:PLA、2 層外牆、15% 網格填充、每個零件各一件、僅在列印平台上加樹狀支撐,XY 距離 0.5 mm。

1.1 設定預設列印設定檔

除了下面特別列出的零件,其餘全部使用同一個設定檔列印。

  1. 材料 PLA、2 層牆、15% 網格填充,除非零件另有說明,每個零件各一個。
  2. 樹狀支撐、僅從列印平台生成,與零件的 XY 距離 0.5 mm。
  3. 一般軸承座、滑環座與太陽眼鏡列印時不加支撐:這三個是例外。
  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. 太陽眼鏡 2 個,不加支撐,4 層牆厚、30% 立方填充。外部看得到,因此使用與錨點外蓋相同的白色 PLA。
  8. 傾斜轉接件 2 個,PLA 任何顏色,以 0.16 mm 層高列印非常精細的細節。較早的列印指南列出 22、26 與 30 度的固定轉接件各一個:角度是攝影機中心線在水平線以下的傾斜角,天花板高時較大,天花板低時較小。
  9. Odd spacer 2,2 個,預設設定。每個錨點一個:它為 DC 圓形插孔提供背面支撐。

1.3 列印線孔零件

兩個線孔承接四條線中兩條線的遠端。

  1. 本體螺柱座:以奇特的斜向旗形面朝下列印,比以背面朝下列印更牢固。100% 填充,PET-GF15,顏色配合牆面。
  2. Eyelet vice block 1 個:用來固定孔眼的治具,讓你可以用鑽床將本體、環與固定環壓在一起。
  3. 固定件:配合另一個導線環零件的顏色。
  4. Anchor Build Guide 要你製作兩個導線環,因此列印兩個本體與兩個固定件。

1.4 列印夾爪零件

驅動齒輪是決定夾爪能否運作的零件;它是整個系統中唯一使用非標準噴嘴溫度的列印件。

  1. 背板、相機支架、機構上蓋與馬達支架:預設設定,顏色幾乎無所謂,不過手指張開時小零件會露出來。較舊的兩件式 ABS 桿需要一個列印的連接件,列印指南已不再列出。
  2. Flat marker 1 個:若可多色列印,請使用 flat_marker_colored.3mf,否則以白色列印並貼上貼紙。2 層牆,15% 網格填充。另外用黑色 PLA 列印 hang bar 1 個,這是平面標記的輔助零件。較早的設計是標記盒(平台盒),以白色列印加貼紙或以多色列印。
  3. 驅動齒輪 1 個:100% 填充、3 層牆。一般塑膠的強度不足以製作這個零件,套件出貨時附的是樹脂列印的齒輪。次佳選擇是 PCTG,噴嘴溫度 265 °C,高於這種線材的一般溫度。PET 會吱吱叫,PLA 會斷,PETG 太軟。若你能列印尼龍與 ABS,大概也沒問題。
  4. Face Back 與 Face Front:外觀件,請刻意挑選顏色。在切片軟體中將兩者合併,開口面相對列印,讓它們共用樹狀支撐。
  5. 手指 2 個、左齒輪槓桿與右齒輪槓桿:外觀件,其餘為預設設定。
  6. 連桿 2 個:它是手指的一部分。
  7. 間隔件 7 個,預設設定。三個用於夾爪,每個錨點各用兩個。
  8. 手腕桿螺旋齒輪、手腕拆卸塊與手腕伺服機螺旋齒輪:預設設定,顏色無所謂。

1.5 列印額外零件

停放用的五金件,以及校正用的列印 AprilTag 卡。

  1. 夾子或鱷魚夾 4 個,預設設定,白色。鱷魚夾版本是另一種選擇,可夾在較大的物體上。
  2. 停放掛鉤 1 個與停放支撐桿 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. 用管子割刀將直徑 10 mm 的 ABS 管切下 10 mm 長的一段。套件內含這段 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. 在 DC 插座下方塞入一個 odd spacer 2。它看起來像單凸點的 Lego 積木,用來支撐 DC 插座,讓你插入插頭時不會把 hat 壓彎。
  5. 小心拆開一個標準視角的 Camera Module 3。保留接在上面的白色(全尺寸)排線。
  6. 將相機鏡頭朝下放在柔軟的東西上以保護其自動對焦機構,依圖示用 M2x4 螺絲在四個角將它鎖到可調傾角轉接件上。
  7. 將排線另一端插入 Pi 的相機排線連接器,也就是靠近板子中央的那一個,如圖所示。排線有多餘長度,將多出的一折塞到 hat 下面。
  8. 將 Pi 鎖入框架底部的電子盒,先用兩顆 M2.5x18 螺絲,再在剩下的孔用兩顆 M2.5x6 螺絲。相機應從前方的窗口垂出。
  9. 將相機翻過來,卡在框架上的兩個凸起之間。將帶齒的臂插入框架上對應的槽。對齊兩側的螺絲孔,在轉接件兩側鎖入兩顆 M2.5x6 螺絲,將其固定到框架上。
  10. 在框架背面的槽位中安裝一個 4 線 3007 PWM 風扇,向外吹。將線穿過,插入擴充板上對應的連接埠,然後在對角用兩顆 M3x8 螺絲固定。
  11. 依照較早版本指南(截至 2026 年 10 月 19 日的擷取版本)製作的錨點,使用的是帶散熱片的 Raspberry Pi Zero 2W 與 Zero 2W 映像檔。對這些錨點,指南寫道:若 Pi 沒有排針,請焊上整組排針;拆開攝影機包裝,取下原本附帶的排線;在攝影機上裝一條 4 cm 的迷你排線,金色接點朝下對著電路板,並將較小的一端接到 Pi;壓上擴充板;在四個角放上間隔柱,插入四顆 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 螺絲將太陽眼鏡固定到框架頂部。

2.7 捲繞釣魚線線軸

捲線由腳本執行,而非手動:qa-anchor-arp 會設定馬達 ID、依線軸類型捲上正確長度,並檢查攝影機。

  1. 為錨點通電,並透過 wifi 或乙太網路轉接器將它連上網路。
  2. 以 ssh pi@<hostname or ip> 透過 SSH 登入;Stringman 原廠映像檔的密碼是 Fo0bar!!。
  3. 先更新:/opt/robot/env/bin/pip install --upgrade "nf_robot[pi]"。
  4. 執行 /opt/robot/env/bin/qa-anchor-arp,並依提示操作。
  5. 它會要求你一次插入一顆馬達並重新上電,做法是從擴充板上拔下再插回馬達插頭,而不是 DC 圓形插孔。如果連線中斷,請重新登入並再次執行腳本:它會從中斷處繼續。較早的指南(適用於 Pi Zero 2W 錨點)要求拔下再插回 DC 圓形插孔。
  6. 在纏繞釣魚線線軸之前,用 buntline 結將線端綁在線軸上的小綁結點。
  7. 在空曠處輕輕拿著供線線軸。纏繞速度很快:不要握緊。
  8. 對每個準備好要纏繞的線軸,在提示時回答 y,或回答 n 先略過。
  9. 纏繞完成後,將線端從太陽眼鏡的後方往前送出,用 palomar 結綁上登山扣。若兩種顏色都有,左側綁銀色,右側綁黑色。

2.8 捲繞並接續電源線線軸

這是唯一一個出錯就會毀掉纜線的步驟:受力的必須是繩結,而不是接續處。

  1. 若你收到的是預先剪好長度的線,現在就將一個登山扣從裸露端穿入,穿過登山扣的小孔,一路送到 JST 插頭那端:之後在那裡會用到。
  2. 將線的裸露端從太陽眼鏡的前方送入,拉出足夠的餘量,再從錨點的後方往前穿過線軸的綁結孔。
  3. 從綁結孔再拉出一些餘量,打一個簡單的平結。先不要拉緊。
  4. 將線軸向前轉,修剪滑環的線,讓它們繞線軸約三分之二圈,但不到綁結點。這個長度很重要。
  5. 用焊錫與熱縮套管將灰色電源線與滑環的線接在一起:棕接紅,藍接黑。原專案表示,最牢固的接法是將每條線末端裸露的導線勾住對應的線,捏緊、焊接,再用熱縮套管包覆。較早的指南改用一對焊錫密封接頭,並先套上熱縮套管。
  6. 用剝線鉗的 18 AWG 刃口剝線外皮,再用較小剝線鉗的 28 AWG 刃口剝芯線。
  7. 收緊平結的餘量,直到包覆的接線處位於線軸根部,但不要收到讓接線處承受任何重量:真的受力時應由結來承受。
  8. 在腳本中對上方線軸回答 y,按 Enter 開始纏繞。
  9. 用 buntline 結將預先穿好的登山扣綁在線端,讓結承受重量,並保護末端的接線處不受機械應力。

2.9 完成錨座並組裝線孔

兩個線孔承接兩條線的遠端;它們是系統中最簡單的列印組件。

  1. 腳本會提示你量測馬達的摩擦。回答 yes 之前,在登山扣與孔之間拉出 30 cm 的餘量,讓線自由垂下,然後執行摩擦量測。最後腳本會提示進行相機畫面測試,然後結束。執行 sudo shutdown now,並在燈熄滅時拔掉電源,以關閉錨點。先前的指南只說直接拔掉電源。
  2. 確認黑色馬達線已妥善收進錨點下方的空腔。
  3. 每個導線環都壓入一個 20 號 Alconite 環到環槽中。
  4. 在剩下的空間滴一滴瞬間膠,用一枚硬幣和可以夾壓的工具(例如鑽床或虎鉗)壓上固定環。最牢固的方式是用壓床:將孔眼本體放入列印的孔眼虎鉗塊,讓小箭頭落在對應的槽中,使環與治具背面平行,然後依序疊放本體、膠、環、膠、固定環、硬幣。將整疊壓緊,並在硬幣黏住之前取下。較早的指南使用一枚硬幣和一把鉗子。
  5. 製作兩個。然後為第二個錨點重複整個段落。

3. 組裝夾爪

每台機器人一個夾爪。原專案估計需 20 小時列印與 2 小時組裝。全篇反覆出現的指示是:把尼龍防鬆螺帽鎖緊到沒有鬆動,再回鬆到關節能自由擺動為止。

3.1 備齊額外工具

夾爪需要錨座用到的所有工具,再加上兩種切割工具。

  1. 迷你螺絲起子與起子頭組、交叉自鎖鑷子與瞬間膠,與錨點相同。
  2. 一把美工刀或筆刀,用來修剪止滑膠帶。
  3. 平口斜口鉗,用於壓力感測器連接器。

3.2 組裝手指

手指沒有左右之分:叉件與指墊都是對稱的。

  1. 將一個叉形件裝到指墊背面,將一顆 M3x25 螺栓從上方孔穿過兩個零件,另一側鎖上 M3 防鬆螺帽。
  2. 鎖緊尼龍防鬆螺帽直到沒有間隙,再稍微退鬆,直到桿子能擺動。另一根手指重複此步驟。
  3. 將一個齒輪槓桿滑入手指組件,讓其平面與手指的平面共面。
  4. 將一顆 M3x25 螺栓穿過組件,另一側鎖上 M3 防鬆螺帽,鎖緊後再退鬆,剛好讓機構能自由活動。另一根手指重複此步驟。

3.3 安裝壓力感測器

其中一根手指能感測接觸力。在組裝套件中,這個零件出貨時已預先組好。

  1. 找出壓力感測連接器:2-pin、1.00 mm 間距的公頭 JST-SH,帶 20 cm 線端。
  2. 將熱縮套管套到線上,再將線焊到力感測電阻上。極性無關。
  3. 用平口斜口鉗剪掉 JST-SH 連接器的翼片,讓它放得進線槽。
  4. 選擇內部有線槽的那根手指,將插頭穿過線槽,再將電阻片貼到手指上。

3.4 貼上止滑膠帶

真正抓住物體的是指板止滑膠帶。共四條,每根手指兩條。

  1. 準備至少四條 110x37 mm 的指板止滑膠帶。
  2. 將手指面朝上放好,指墊與齒輪槓桿的平面共面,以連桿作為支撐。
  3. 從最靠近齒輪的上緣開始,縱向貼上一片;遠端約有 10 mm 會超出:將它折過邊緣。
  4. 將手指壓平在桌面上,讓泡棉處處貼牢。
  5. 在指尖上垂直貼上第二片,兩側各折 10 mm 包覆。
  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 cm 迷你排線,寬的那端插入相機。
  6. 輕輕拉出 Pi 排線接頭上黑色固定夾的兩側,將排線黑色面朝上插入固定夾下方,再將固定夾推回。若固定夾掉出來,請用鑷子一次裝回一側。
  7. 在對角以兩顆 M2x4 螺栓將相機鎖到相機支架上,依原專案圖示折好排線,然後在可鎖螺絲的三個角將電路板堆疊鎖到支架上。
  8. 張開夾爪手指,以一顆 M3x6 沉頭螺絲將相機支架組件裝到背板上。
  9. 將兩顆 M3x14 螺絲鎖入那兩個孔,既固定電子元件支架,也固定先前未鎖的那一側叉形件。
  10. 將壓力感測線插到 Gripper Hat 上標示 pressure 的插座。
  11. 依 Raspberry Pi Setup 指南燒錄 SD 卡並插入。

3.8 安裝雷射測距儀

一顆 VL53L1 飛時測距感測器越過手指朝下量測。

  1. 若測距儀是你自己採購的,焊上直排針:六根針腳全焊,或只焊標示 VIN、GND、SCL 與 SDA 的四根。
  2. 將 4-pin 矩形杜邦插頭插到測距儀上,紅線在外側。
  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. 用底部兩顆 M3x10 螺絲安裝一個 30 mm 風扇,向內朝 Pi 吹。較早的指南是在對角用兩顆 M3x8 螺絲將它裝到機構蓋上,氣流朝外。
  2. 將風扇插到 Gripper Hat 上標示 FAN 的 4-pin JST-SH 連接器。板上有兩個 4-pin 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 列印。
  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 購買的套件附有一根直徑 10 mm、50 cm 的 ABS 桿,已切成兩段。用列印的聯結件將它接回:在其中一根管子末端 1 cm 的範圍塗上 JB-Weld PlasticWeld 環氧樹脂,壓入聯結件,另一側重複此步驟。若你拿到的是完整的桿子,請略過此步驟。2026 年 6 月 6 日的指南則是在聯結件一側的內圈塗一圈瞬間膠,並以一個快速的動作將一段桿子塞進去;這種接合大約可承受 5 kg。
  16. 附標記盒的較舊套件:標記盒以多色列印(較耐用),或以白色列印再貼上貼紙。將軸承與一個 3/8 x 7/8 鋼墊圈套到 ABS 管上,用麥克筆在距管端 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. 選擇記憶卡,按 Write 並確認。
  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 讓每個元件連上 wifi

牆面錨座裡的 Pi Zero 沒有鍵盤:各元件用自己的攝影機從 QR 碼讀取 wifi 帳密。

  1. 開機後約 10 秒內,無法連上已儲存網路的元件會開始透過其攝影機尋找 Wi-Fi 分享 QR code。
  2. 從手機的 wifi 分享畫面產生一個條碼,或使用 qifi.org 產生傳統的方塊碼,遠距離較容易讀取。
  3. 將條碼拿到每台相機(包括夾爪的相機)看得到的位置,各約十秒。5 cm 的方塊碼約在 1.5 m 外可讀取。
  4. 成功會以實體動作表示:錨點會讓馬達嗡嗡響,夾爪會擺動手指。錨點連線後也會開始保持位置。
  5. iPhone 的條碼沒問題;Android 的分享條碼是裝飾性的,只有拿得很近才讀得到。
  6. 若 QR 設定在你的情況下無法使用,請將元件的 SD 卡插入電腦,確認它掛載在 /media/$USER/rootfs,然後從 cranebot3-firmware 儲存庫執行 sudo ./add_wifi_config.sh "SSID" "password"。腳本位於 src/nf_robot/scripts/add_wifi_config.sh。
  7. 快速握壓指墊五次,即可清除夾爪中的 Wifi 憑證。

4.4 選配:鎖定各台 Pi

原廠映像檔附有一組公開已知的密碼,除了方便排除故障之外沒有其他好處。

  1. Stringman 原廠映像檔的預設使用者為 pi,密碼為 Fo0bar!!。
  2. 自動方式:在韌體儲存庫中啟用 venv 後,執行 python experiments/deploy_ssh_keys.py <robot conf.json>。它只會在確認金鑰驗證可用後才停用密碼驗證,因此不會把你鎖在外面。
  3. 手動方式:用 passwd 更改密碼,用 ssh-keygen -t ed25519 與 ssh-copy-id pi@<component> 設定金鑰驗證。
  4. 確認你可以不用密碼登入後,在 /etc/ssh/sshd_config 中設定 PasswordAuthentication no 與 ChallengeResponseAuthentication no,並重新啟動 ssh。
  5. 對三個元件逐一重複此步驟。

5. 安裝到室內並校正

原專案把這比作安裝窗簾桿:不中斷約需一小時,另加至少 30 分鐘的設定。工具為一把折梯、一台電鑽/起子機、M1.5 六角起子頭與 T20 星型起子頭(兩者皆隨附)。

5.1 規劃工作範圍

四個安裝點決定了機器人的整個工作範圍,因此這是改起來代價最高的選擇。

  1. 選兩個相對的角落放錨點;另外兩個角落放導線環。這四個點所圍出的空間就是工作範圍。
  2. 在保持沒有障礙物的前提下,讓範圍盡可能大。
  3. 錨點必須鎖入牆後的木立柱,或用綁帶固定在結構柱上。在石膏板牆的住宅中,牆角後方一定至少有一根立柱,而只要一側鎖到立柱就足夠。
  4. 不要用黏膠或磁鐵安裝。標示承重 5 kg 的無痕掛條是指垂直向下的承重,而 Stringman 會從好幾個方向側向拉扯。
  5. 不要裝在輕鋼架天花板的 T 型龍骨上:即使支架撐得住,龍骨彎曲也會改變錨點的方向,破壞校正與擺盪抵消。
  6. 若房間有吊扇,安裝在扇葉高度或更低的位置,機器人就碰不到扇葉。
  7. 工作範圍內有雙層床是可以的,但沒有實作避障,因此預期偶爾需要手動介入。
  8. 若沒有可用的立柱,你需要一塊固定在房間結構元件上的背板。

5.2 重新接合夾爪與標記盒

兩者分開出貨,以便裝進較小的箱子。這是最後一個夾爪組裝步驟的反向操作。

  1. 用附帶的 1.5 mm 迷你螺絲起子頭,拆下固定夾爪背蓋的兩顆螺絲,一顆在上、一顆在下。你的夾爪出貨時可能已拆下這兩顆螺絲,這種情況下螺絲在配件袋中。
  2. 鬆開固定手腕拆卸塊的三顆螺絲,也就是背面頂端帶矩形孔的那個零件,然後將它拉出。它刻意做得很緊。若太緊,就用螺絲起子撬出來。
  3. 將夾爪的電源插頭從標記筆的桿子內部往上送,直到從頂端出來。若在管內卡住,來回轉動管子。
  4. 將齒輪與軸承放入手腕座:轉角無所謂,之後由校正決定。
  5. 將齒輪壓入直到齒嚙合、軸承完全就位,再將手腕塊壓入空腔,並以那三顆螺絲固定。
  6. 用你拆下的兩顆螺絲裝回背蓋。

5.3 安裝錨座

高度以最低者為準:天花板、天花板飾條或風扇葉片。

  1. 在角落天花板下方 13 cm(5 in)處做記號。若有天花板飾條,從飾條量起;若有吊扇,標出扇葉高度。取三者中最低的位置。
  2. 將蝴蝶形立柱支架貼在牆上,上緣對齊你的記號。
  3. 在角落處,使用水平置中的兩個孔:做記號、穿過零件預鑽孔,然後鎖入兩根 76 mm(3 in)木螺絲。
  4. 在平牆上,使用同一側的一對垂直孔,讓支架朝向房間中央,並用立柱探測器或找出石膏板螺絲來確定立柱位置。
  5. 許多住宅的牆角並不是直角。若鎖緊時立柱支架變形,將螺絲退鬆到變形最小,否則錨點滑不進去。
  6. 將錨點拿到靠近天花板處,筆直向下滑入支架,直到卡住。
  7. 梯子還在的時候,插上一條白色 DC 插座延長線,讓它垂著。
  8. 將兩條線從錨點拉下到不用梯子也搆得到的高度,然後在對面角落重複此步驟。
  9. 裝著外蓋時要拿穩錨點可能不太容易。最簡單的方式是用雙手從上下夾住,或者在地面上先取下裝飾外蓋,不裝外蓋安裝錨點,之後再裝上外蓋。這樣多了一個步驟,但可能比較安全。

5.4 安裝線孔與停放掛鉤

線孔讓四條線中的兩條轉向,經過其餘兩個角落。

  1. 在剩下的每個角落,將一根木螺絲穿過導線環鎖入立柱,小指標朝上。
  2. 面對角落時,它應位於右手邊的牆上;若工作範圍的那個角落是平的,只要鎖在立柱上,怎麼裝都可以。
  3. 面對導線環,看向你右手邊的錨點。取下其左側線上的登山扣,從後往前穿過導線環,再拉下到搆得到的高度。
  4. 將停靠掛鉤(尖叉朝上)鎖到靠近某個錨點的牆上立柱,位置在原專案圖片中以藍色框標出的區域內,讓標記剛好在掛鉤前方時,其標籤能被錨點攝影機看見。它可以裝在錨點的任一側;裝在左側時,必須翻轉掛鉤的指部,讓它們朝錨點張開。不要裝得離錨點太近,否則線會干擾正常移動。螺絲請稍微斜鎖,以留出工具空間。
  5. 將掛鉤設得夠高,讓機器人停放時你能舒適地從線下走過。若裝得太高,停放會變得非常困難,因為越靠近天花板精度會以指數方式變差。
  6. 必要時可以把掛鉤裝在該區域之外,但這樣就無法自動停靠,因為錨點看不到標記。較早的指南描述了一個放在窄架上的列印 AprilTag,安裝在停靠位置時夾爪指下方兩英寸處,用來輔助自動停靠。目前的指南已不再提到它。
  7. 記錄停靠位置:開啟系統電源,手動操控夾爪靠近掛鉤,執行 Half cal (2) 以確保定位準確,駛入掛鉤並往下移動,直到掛鉤承受重量,從執行選單選擇 Parking > Set Parking Location,等待動作停止。接著選擇 Unpark,確認它能順利脫離掛鉤,再飛到房間某處並選擇 Park,測試自動停靠。若自動停靠效果不好,請重新記錄。若仍然不佳,可能是房間的校正不夠好,或停靠時光線太暗,錨點看不到標記。
  8. 你也可以利用登山扣將夾爪從線上解開,並執行除錯指令 stow 將所有線收回,直到感覺到一些張力。這麼做之前,請標記哪個掛鉤是電源線的掛鉤,以便依照校正時的方式重新裝回所有東西。較早的指南建議手動停靠:移到掛鉤附近,扶住機器人,用遙控器關閉馬達電源,然後把它掛上。
  9. 2026 年 10 月之前製作的孔眼使用沉頭螺絲(錐形頭)。若你的是這種,請勿鎖得過緊,否則可能把孔眼裂成兩半。只要鎖到結構感覺牢固地固定在牆上即可。

5.5 通電並連線

在綁線之前、所有部位都還碰得到時進行這一步。

  1. 將夾爪插到灰色電源線上。先前的指南寫的是將夾爪靠在某個錨點的灰色電源線附近的牆邊,並將它的 JST-ZH 線插在標記筆頂端。
  2. 將 24 V 5 A 電源接到錨點,並透過附帶的插座遙控器插到牆上插座。
  3. 務必先插上 DC 圓形插頭,再接上交流電源,交流電源(或用插座遙控器開啟)一定最後接。若沒有在接上交流電源之前插上 DC 圓形插頭,錨點可能會永久損壞。
  4. 在主機上啟動運動控制器(參見 Usage Guide):pip install "nf_robot[host]",然後執行 stringman-headless。它會開始在網路上搜尋元件。
  5. 這個步驟中網路上只能有一台完整的 Stringman:關掉其他所有的,讓探索功能分辨哪些元件屬於這台機器人。
  6. 用插座遙控器為所有元件通電,若相機尚未完成設定,對每台相機舉起 wifi QR 碼。
  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. 從三方面判斷結果:UI 中的房間形狀應與你安裝的相符,WASD 應產生直線移動,擺盪抵消應減弱擺盪而不是放大。
  7. 向前橫向移動(W,或左搖桿向上)應朝夾爪前端所對的方向移動,因為預設是夾爪視角。
  8. 若結果不佳,將校正卡分得更開,並將夾爪放在中央附近的地板上再試一次。
  9. 移除房間內零散的 AprilTag 或 ArUco 標記,包括相機看得到的電腦螢幕上的標記,並使用最亮的照明。
  10. 若兩台攝影機在地面上的重疊區域太小,無法放置多張卡片讓兩台攝影機都看得到,請調整攝影機的傾斜角度。取下錨點外蓋,按壓攝影機傾斜機構的上緣或下緣,每次調整一格。重新執行校正(較慢),或直接在元件的右鍵選單中輸入已知角度,然後在合成影像中檢查重疊是否改善。校正會自動找出攝影機的真實角度。
  11. 使用較舊固定轉接件(22、26 或 30 度,出貨時裝的是 26 度)的錨點:取下白色外蓋,讓自己接地以防靜電放電,並從側面卸下攝影機座。將攝影機往上翻,卸下將它固定在座上的兩顆螺絲。裝上角度較合適的座,細長而高的房間用 30 度,較寬的房間或較低的天花板用 22 度,將它壓入框架上的凹槽,再從側面鎖回。螺絲必須完全鎖到底,且座要緊貼框架,否則它最後可能處於不確定的方向。

本網站需要 JavaScript 才能正常運作。請啟用 JavaScript 以瀏覽我們的開源機器人專案。