Open Source Robotics

精選高品質的開源機器人專案、工具與軟體,推動機器人社群向前發展。

Hex 組裝指南

開源、可 3D 列印的六足機器人平台;Hex3 為目前版本

授權條款

  • Hex3 CAD and PCBs: the maker's own non-commercial terms
  • Hex3 code: GPL 3.0
  • Hex1 and Hex2: MIT

依世代與部分授權。Hex3 的 CAD 與 PCB 採用 Open Community License:個人可以使用、複製與修改,衍生作品必須以相同授權分享;企業可為內部用途使用與修改本產品,但未取得另外的授權,不得為任何商業目的複製或仿製。Hex3 的程式碼採用 GPL-3.0。Hex1 與 Hex2 採用 MIT。查核日期:2026 年 11 月 2 日。

組裝指南

1. 本指南涵蓋哪一代

本指南依據目前的版本 Hex3。Hex2 與 Hex1 是較舊、已淘汰的世代,這裡不作說明。

1.1 確認你要組裝的是 Hex3

Hex3 是目前的版本;其零件、配線、韌體與 Raspberry Pi 設定都與 Hex2 不同,因此不要混用兩者的文件。

  1. 原專案 README 表示,目前的 Hexapod 版本是 Hex3,Hex4 正在開發中,目標發布時間為 2027 年年中至下半年。
  2. Hex3 頁面將此平台描述為穩定狀態:它已不再積極開發,原專案希望任何修改都以 pull request(透過其 Discord 審查)或公開的 fork 提出。
  3. 原專案列出的 Hex3 重點:10kg(約 22lb)負載能力;可用 Xbox 控制器操控;機身與腿部完全 3D 列印;18 個自由度(每條腿 3 個);以直流減速馬達與 AS5600 磁性編碼器製成的低成本客製伺服機;附位置感測器的彈簧式腳尖;每條腿一塊 Seeed Xiao RP2350;Pi 與各腿控制器透過共用的 CAN 匯流排通訊;Raspberry Pi 5 上執行 ROS2。
  4. 原專案給出的 Hex3 價位約為 $2,000 USD。
  5. 原專案的 Hex3 頁面分為六個階段:3D 列印、PCB 組裝、電子設定、機械組裝、即時韌體與 Raspberry Pi 設定。先開始列印,讓列印在你進行其他階段時同時進行。

1.2 如果你手上已有 Hex2

Hex2(模型伺服機與 Teensy 4.1)已於 2025 年 7 月棄用,原專案沒有公開它的組裝方式。

  1. 原專案表示,Hex2 已於 2025 年 7 月棄用,不再積極支援,但儲存庫仍保有組裝與控制它所需的資料。歡迎 fork 此儲存庫以繼續開發。
  2. 原專案指出 Hex2 的兩大限制:業餘級伺服機可能過熱,使連續運作時間只有幾分鐘;最大負載也只有幾磅。
  3. 原專案為 Hex2 公開了:電氣與機械物料清單(兩者日期皆為 2025 年 7 月 22 日)、熱熔螺帽圖面(2024 年 11 月 5 日)、Fusion 360 組件(2025-07-22_assembly.f3z)、主板與腿部板的電子檔案、控制器按鍵對應圖、Raspberry Pi 5 入門頁面,以及位於另一個 Hex2 儲存庫中的 Teensy 與 Raspberry Pi 程式碼。
  4. 原專案沒有公開 Hex2 的組裝步驟、線束文件或校正程序。電氣物料清單中有一行「Main to Leg Connections <TBD>」。因此本指南不描述 Hex2 的組裝、配線或校正;請直接使用上述 Hex2 文件。
  5. 本指南中的導線長度、編碼器、馬達與飛行時間感測器纜線、校正方法與 CAN 設定僅適用於 Hex3。使用業餘級伺服機的 Hex2 沒有需要製作的編碼器或獨立馬達線束。

1.3 備齊工具與材料

開始之前,你需要兩支六角扳手(2.00 mm 與 2.5 mm)、焊接與壓接工具、三用電錶,以及齒輪潤滑脂。

  1. 原專案的完整物料清單是 HEX3 Bill-Of-Materials 試算表(分頁:Mechanical BOM、Electrical BOM、一份列印件清單與一份 PCB 訂購範例)。
  2. 工具:2.00mm 六角扳手(用於 Raspberry Pi 與光達(LiDAR));2.5mm 六角扳手(其他所有五金都使用 2.5mm 六角;原專案建議也使用 2.5mm 起子頭,因為手動鎖緊所有螺絲是一項艱鉅的工作);烙鐵與焊接配件;助焊劑與焊錫;烙鐵用熱熔螺帽烙鐵頭;用於導通與極性檢查的三用電錶;PCB 夾座或虎鉗(建議用於 PCB 組裝);剪線鉗;適用導線長度表中線徑的剝線鉗;夾具(非必要但強烈建議用於壓入配合);JST 壓接工具;端子壓接工具(強烈建議但非必要,因為這些連接也可以直接焊接);用於移除支撐材的鉗子、鑷子等工具。
  3. 另需材料:齒輪用多用途合成潤滑脂。

2. 3D 列印

列印 Hex3 的機身與腿部零件。原專案公開了列印設定與零件數量,但沒有各零件的列印擺放方向。

2.1 列印機身與腿部零件

以 ABS 或 ASA 列印 Hex3 腿部與底座零件,base_core 與腳趾以 12 層以上的外壁列印。

  1. 原專案表示可以使用 PETG,但建議使用 ABS 或 ASA,以獲得更好的強度與耐熱性。
  2. 所有結構件都在 PrusaSlicer 中以 0.2mm STRUCTURAL 列印設定檔切片,並以 Prusa Core ONE 列印。預設(多數零件):4 層牆、30% 三角形填充、依需要加支撐。base_core 與腳尖:12 層以上的牆、30% 三角形填充、依需要加支撐。
  3. base_core 承受最高的結構負荷,因此以 12 層以上的牆列印,使其實際上成為實心,而不是依賴填充。腳尖會隨時間磨損,因此也以這些設定列印。
  4. 六條腿所需的數量,取自物料清單的列印件分頁:s0 6、s0_gear_cover 6、s0_gear_cover_spacer 6、s1 6、s1_bearing_holder 12、s1_encoder_cover 6、s1_motor_bearing_holder 6、s1_motor_bearing_mount 6、s1_motor_cover 6、s2_bearing_screw_mount 6、s2_bearing_side 6、s2_connector_long 6、s2_connector_short 6、s2_gear_side 6、s2_magnet_mount 6、s3_bearing_side 6、s3_gear_mount 6、s3_gear_side 6、s3_magnet_mount 6、spring_aligner 6、toe 6、toe_tip 6。
  5. 同一分頁中的底座零件:relay_mount_bracket 1、base_flat 12、base_lower 1、base_upper 1、fan_shield_print_wo_top_or_bottom_layers 1、base_electronics_mount 1、base_electronics_guard 1。
  6. 列印前請注意:列印頁面提到 base_core,release 資料夾中也有 base_core.3mf,但列印件分頁沒有列出它。請依列印頁面的指示列印 base_core。
  7. 檔案位於儲存庫的 Hex3_resources/cad(完整的 Fusion 360 組件、一個 STEP 檔、底座與腿部零件的 release 3mf 檔,以及 .f3d 與 .step 格式的 encoder_insertion_tool),也位於原專案的 Hex3 Printables 專案中。原專案表示零件外觀可能與圖片略有不同,並請一律使用 GitHub 上的最新版本。
  8. 編碼器插入工具用於機械組裝。原專案公開了它的 CAD,但沒有提供列印設定。

3. PCB 組裝

焊接六片腿部 PCB 與一片主 PCB。腿部 PCB 版本 V2.0 或 V3.2 會改變零件、一顆電容的極性,以及一項必要的修正;下單前請先選定。

3.1 選擇腿部 PCB 版本

Hex3 有兩種腿部 PCB 版本,V2.0 與 V3.2,兩者功能完整;主 PCB 為 V2.1。

  1. 原專案表示兩個版本都能組裝出完整的 Hex3。主要差異在於組裝方式、散熱管理、PCB 成本,以及 XIAO RP2350 能否重複使用。
  2. Leg V2.0:使用需手工焊接的插件式二極體;DRV8871 馬達驅動晶片沒有額外散熱(仍可加裝外部散熱片,但佈局並非為散熱而設計);XIAO RP2350 直接焊在 PCB 上,因此無法重複使用。
  3. Leg V3.2:使用表面黏著二極體(訂購時請將它加入你的組裝零件清單);非常重視 DRV8871 晶片的散熱,採用 2 oz 內層鋪銅(這會讓價格提高不少)以及 GND 平面的過孔縫合;XIAO RP2350 有 POGO pin 選項,可重複使用,不過 pogo pin 的間距很敏感,需要特定的公母排針。
  4. 原專案 PCB readme 列出的 V3.2 其他變更:移除 CAN 匯流排電路中的分離式終端;絲印上的編碼器標籤改為從零開始編號;編碼器接頭互換,使 S0 最靠近電路板頂端。
  5. 主板:OpenSauce 2026 只使用了 V2.1。兩種腿部板版本都用在 OpenSauce 2026 的六足機器人上。
  6. 檔案位於 Hex3_resources/electronics:leg_board/V2.0、leg_board/V3.2 與 main_board/V2.1。腿部與主 PCB 都設計為 4 層 PCB。原專案表示任何提供組裝服務的 PCB 廠商都可以;其最近一次訂單的 BOM 與 CPL 檔案放在 leg_board 資料夾中供參考,那是 25 片電路板的大量訂單,請自行調整數量。

3.2 焊接腿部 PCB

將 XIAO RP2350、保險絲座、JST 與 Molex 接頭及電容焊到一塊腿部 PCB 上,再重複完成六塊。

  1. 一片腿部 PCB 的零件:1x Xiao RP2350(未焊排針);1x 3557 保險絲座;3x 4 Pin JST 板端接頭(若要使用選配的 I2C 擴充連接,就多拿第 4 個;目前的軟體不需要);1x 5 Pin JST 板端接頭;1x 4 Pin Molex 板端接頭;4x 2 Pin Molex 板端接頭;4x 22uF 徑向電容;1x 470uF 徑向電容;1x 腿部 PCB(V2.0 或 V3.2)。
  2. V2.0 另需 1x 1N5819 二極體。V3.2 可選擇另加 2x 4 Pin POGO 接頭、2x 7 Pin 短公排針與 2x 7 Pin 短母排針。
  3. 從 Xiao RP2350 開始。V3.2 可以選擇使用排針;V2.0 不支援排針。
  4. 表面黏著的 Xiao:先確認兩側間距平均、所有針腳都對準焊墊中央,再用少量焊錫點焊對角的兩個上方針腳。將 PCB 翻面,確認底部焊墊位於通孔中央;若沒有,加熱其中一角,輕輕轉動 Xiao 後重複。接著焊接所有上方針腳。底部則使用細烙鐵頭,同時加熱孔與 Xiao 焊墊,以焊錫填滿孔,並確認沒有填得過滿,也沒有與相鄰的孔短路。
  5. 排針式 Xiao(僅限 V3.2):將母排針焊到 PCB 上,再將公排針焊到 Xiao 上。若使用 Hex3 BOM 中的排針與 pogo pin,請將公排針從 Xiao 上方穿入,而不是讓 Xiao 擱在排針上,這樣 pogo pin 才能確實接觸底部的焊墊。將 pogo pin 放到 PCB 上,把 Xiao 插入母排針,確認 pogo pin 的尖端對準 Xiao 底部的焊墊;若對準了,就將 pogo pin 焊到 PCB 上。
  6. 僅限 V2.0:現在焊上二極體。二極體的陰極應位於靠近 Xiao 的一側。V3.2 請跳過此步,因為該二極體是表面黏著元件,屬於 PCB 組裝訂單的一部分。
  7. 焊接 3557 保險絲座。烙鐵要在保險絲座的針腳上停留足夠時間,讓熱量充分累積後再上錫。
  8. 焊接 JST 接頭:編碼器用的 4 pin JST、可選的第 4 個 I2C 擴充用接頭,以及腳尖感測器用的 5 pin JST。
  9. 焊接 Molex 接頭:用於主電源與連接主 PCB 之 CAN 匯流排的 4 pin Molex,以及馬達用的 2 pin Molex 接頭。
  10. 焊接電容,注意極性正確:22uF 電容的陰極應朝向 2 pin Molex 接頭。焊上 Xiao 用的 470uF 電容,同樣注意極性:V2.0 的陰極朝向保險絲座與 4 pin Molex 接頭;V3.2 改了排列方式,使所有電容方向一致,470uF 電容的陰極朝向 Xiao 的 USB。
  11. 重複以上步驟,直到完成六片腿部 PCB。

3.3 依腿部 PCB 版本套用必要的修正

V2.0 要切斷 CAN 分離式終端的走線,V3.2 則要修改 leg.cpp;原專案將此標示為 DO NOT SKIP THIS。

  1. V2.0:必須割斷分離式終端 CAN 匯流排的走線。它們位於 PCB 底面;原專案的 PCB readme 表示,測試顯示這項功能會造成問題。請在原專案 V2.0 底視圖照片所示的位置割斷走線。
  2. V3.2:新的接頭位置需要修改軟體。上傳到 Xiao 板之前,在 leg.cpp(Hex3 儲存庫中的 real_time/xiao_code/lib/HexapodController/src/leg.cpp)中,將第 53 行從 axes[0].link(D8, D10, 5, mux); 改為 axes[0].link(D17, D18, 7, mux);,並將第 55 行從 axes[2].link(D17, D18, 7, mux); 改為 axes[2].link(D8, D10, 5, mux);。
  3. 修改後檔案內容應為:axes[0].link(D17, D18, 7, mux); axes[1].link(D11, D12, D15, D16, 6, mux); axes[2].link(D8, D10, 5, mux);

3.4 使用前檢查每塊腿部 PCB

檢查焊點,並為腿部 PCB 裝上 10A 迷你插片保險絲,再單獨通電,確認 LED 與 Xiao 正常運作。

  1. 檢查是否有焊錫橋接、冷焊與元件錯位。
  2. 電路板通電前,確認接頭方向與極性。
  3. 通電測試前,將迷你片狀保險絲插入保險絲座。原專案的腿部板使用 10A 保險絲。
  4. 一次一片地將每片腿部板接到電源供應器,確認 LED 與 Xiao 運作正常,再測試與主 PCB 的連接。
  5. 剪掉插件式徑向電容多餘的接腳長度,避免短路。

3.5 焊接主 PCB

將 XT60 接頭、保險絲座、2x40 Pi 排針座、兩個 DC-DC 降壓轉換器、接頭與電容焊到主 PCB 上。

  1. 零件:1x 3557 保險絲座;1x 10uF 徑向電容;1x 470uF 徑向電容;1x XT60 板端接頭;1x 2 pin 公排針;1x Raspberry Pi 用 2 by 40 母排針;2x DC-DC 降壓轉換器;6x 4 Pin Molex 板端接頭;2x 3 Pin JST 板端接頭。電路板在共用的 CAN 匯流排與電源連接上有最多 8 個四 pin Molex 接頭的焊接位置,因此你的 6 個可以焊在其中任何位置。
  2. Pi 連接用的選配 JST 擴充:1x LED 環用 3 Pin JST、1x PWM0 用 3 Pin JST、1x PWM1 用 3 Pin JST、3x 4 Pin JST(UART0、UART1、I2C)與 4x 5 Pin JST(5V、4、27、22、GND;5V、11、6、26、GND;5V、18、23、25、GND;SPI1)。至少必須連接散熱風扇用的兩個 3 Pin JST。
  3. 焊接 XT60 接頭。烙鐵要在針腳上停留足夠時間,讓熱量充分累積後再上錫。
  4. 焊接 3557 保險絲座,同樣先讓烙鐵在針腳上停留足夠時間,讓熱量充分累積。
  5. 焊接 2x40 母排針,讓針腳從 PCB 頂面穿出。主 PCB 插在 Pi 上並架在其上方。
  6. 焊接 DC-DC 降壓轉換器,注意極性方向正確:降壓轉換器上的方塊朝上、遠離 PCB,轉換器的電壓輸入位於電路板左側、最靠近 XT60 接頭處。
  7. 在電路板中央的位置裝上 1x2 公排針,再用跳線帽將其針腳短路。也可以直接將兩個焊墊短路,或焊上一段環狀導線。這個連接會啟用 CAN 匯流排網路上的 120 Ohm 電阻。
  8. 先焊 JST,再焊 Molex 接頭。
  9. 焊接 10uF 電容,注意極性正確:陰極朝向電路板底部,遠離 XT60、朝向 Molex 接頭。
  10. 將 470uF 電容焊在上方 DC-DC 轉換器的輸入端子之間:陰極朝向負極輸入,陽極朝向正極輸入。

3.6 連接 Pi 之前檢查主 PCB

在連接 Raspberry Pi 之前,裝上 20A 迷你插片保險絲,並以電源供應器為主 PCB 供電。

  1. 確認所有接頭都以正確方向安裝,並檢查電源路徑與穩壓器周圍是否有短路。
  2. 通電測試前,將迷你片狀保險絲插入保險絲座。原專案的主板使用 20A 保險絲。
  3. 先將主 PCB 接到電源供應器,確認 Pi 的 5V 輸入與 4 Pin Molex 接頭的 24V 線路都有正確電壓。原專案強烈建議在連接 Raspberry Pi 之前先做這項測試。
  4. 接著將主板接到一片腿部板,確認主板通電時腿部板也有供電。
  5. 剪掉插件式徑向電容多餘的接腳長度,避免短路。

4. 電子設定

為電池、繼電器與開關配線,製作每條腿的線束,並為編碼器與馬達配線。

4.1 電池、繼電器與自鎖開關配線

一顆 5Ah Milwaukee M18 電池透過 JD2914 繼電器為主 PCB 供電,由自鎖開關控制繼電器的開關。

  1. 電源來自 5Ah 的 Milwaukee M18 電池,送到主 PCB 後再由主 PCB 分配。繼電器透過自鎖式電源開關控制六足機器人的開關機。
  2. 連接方式:M18 電池(+)接到 WAGO,再接到繼電器 pin 30 與自鎖開關的輸入。M18 電池(-)接到 WAGO,再接到繼電器 pin 85 與機器人接地。自鎖開關的輸入為電池 +。自鎖開關的輸出接到繼電器 pin 86。六足機器人電源(+)為繼電器 pin 87。六足機器人接地(-)為電池 -。
  3. JD2914 繼電器腳位:pin 30 為共用端(COM),接電池,建議用紅色導線,是來自 M18 電池的主電源輸入。Pin 87 為常開(NO),接機器人電源 +,紅色,繼電器激磁時與 pin 30 導通。Pin 87a 為常閉(NC):不連接,保持未使用並做好絕緣。Pin 85 為線圈(-),接電池 -,黑色,是繼電器線圈的接地。Pin 86 為線圈(+),接自鎖電源開關的輸出,紅色,開關切到 ON 時使繼電器激磁。
  4. 頁面上本節附有原專案的電源電路圖與電源配線照片。

4.2 規劃 Raspberry Pi 的開機順序

Raspberry Pi 5 必須在六足機器人通電之後才開機,這由 Pi 上的一個瞬時電源按鈕處理。

  1. 由於降壓轉換器與繼電器組合產生的雜訊,Raspberry Pi 5 必須在六足機器人通電之後再開機。
  2. 原專案表示,這個斷電重開可以利用 Pi 5 內建的電源按鈕過孔處理。它建議使用直角排針,並接上一顆瞬時型電源按鈕來觸發重新開機;Hex3 的上蓋有一個孔可安裝瞬時型電源開關。
  3. 請參考 Raspberry Pi 文件中關於自行加裝電源按鈕的章節。

4.3 製作線束

依所列長度裁切並壓接 24 AWG 四芯編碼器線與飛行時間感測器線、18 AWG 雙芯馬達線,以及主板到腿部的主幹線。

  1. S0 編碼器至腿部 PCB:120 mm,4 芯 24 AWG,數量 6。第 1 端無接頭;第 2 端為 4 Pin JST XH 母座外殼。
  2. S0 馬達至腿部 PCB:130 mm,2 芯 18 AWG,數量 6。第 1 端無接頭;第 2 端為 2 Pin Molex Microfit 3.0 插頭。
  3. S1 編碼器至腿部 PCB:250 mm,4 芯 24 AWG,數量 6。第 1 端無接頭;第 2 端為 4 Pin JST XH 母座外殼。
  4. S1 馬達至腿部 PCB:265 mm,2 芯 18 AWG,數量 6。第 1 端無接頭;第 2 端為 2 Pin Molex Microfit 3.0 插頭。
  5. S2 編碼器至腿部 PCB:405 mm,4 芯 24 AWG,數量 6。第 1 端無接頭;第 2 端為 4 Pin JST XH 母座外殼。
  6. S2 馬達至腿部 PCB:365 mm,2 芯 18 AWG,數量 6。第 1 端無接頭;第 2 端為 2 Pin Molex Microfit 3.0 插頭。
  7. 飛行時間(腳尖)感測器至腿部 PCB:450 mm,4 芯 24 AWG,數量 6。第 1 端為 4 Pin JST XH 母座外殼;第 2 端為 5 Pin JST XH 母座外殼。腳尖感測器為選配且屬實驗性質:原專案表示目前軟體尚未實作。
  8. 主 PCB 至腿部 PCB:185 mm,2 芯 18 AWG 加 2 芯 24 AWG 雙絞線,數量 5。兩端皆為 4 Pin Molex Microfit 3.0 插頭。
  9. 主 PCB 至腿部 PCB:250 mm,導線與接頭相同,數量 1。原專案表示這條用於電池接頭後方的那條腿。
  10. 完成電子階段後,你應該至少有 1 組電源組件、18 個編碼器與 6 個腳尖飛行時間感測器(這些感測器屬實驗性功能)。

4.4 編碼器配線

以跳線將每個編碼器的 DIR 針腳接地,再將四芯線束接到編碼器板及其 JST 接頭。

  1. 編碼器的 DIR 腳位必須接地。直接在編碼器板上用一小段跳線連接 DIR 與 GND;這與 4 芯線束是分開的。
  2. 若使用原專案的 4 芯線束,原專案建議以下配線,以與電路板上的接頭順序一致:紅色為 VCC,接 JST pin 1;黑色為 GND,接 pin 2;藍色為 SCL,接 pin 3;綠色為 SDA,接 pin 4。
  3. 將編碼器導線直接焊到 S0、S1 與 S2 編碼器板上時,焊點要盡量與電路板齊平。凸起的焊錫可能比旁邊的電容還高,使編碼器安裝後無法平貼;在機械組裝中,編碼器必須完全平貼安裝。

4.5 馬達配線

馬達極性沒有影響,但要保持一致,因為它決定 config.hpp 中的軸反向常數。

  1. 馬達配線的極性無所謂,但要保持一致。
  2. 極性的選擇會影響 config.hpp(位於 Hex3 韌體的 lib/HexapodController/src 中)裡的軸反轉常數。若將馬達的負極端子接到 Molex 接頭的 pin 1,軸反轉值就會是 {true, false, false}。

4.6 腿部到主 PCB 的纜線配線

將四芯主幹線依紫、紅、黑、白的順序接到 Molex 第 1 至 4 腳。

  1. 若使用原專案的線束,原專案建議:紫色為 GND,接 Molex pin 1;紅色為 VCC,接 pin 2;黑色為 CAN LOW,接 pin 3;白色為 CAN HIGH,接 pin 4。

5. 機構組裝

準備列印零件,從 S0 到 S3 組裝每條腿,然後把腿、PCB 與 Raspberry Pi 安裝到底座上。

5.1 在腿部零件中裝入熱熔螺帽

組裝前,將 M3 與 M4 銅質熱熔螺帽壓入 S0、S1、S2 與 S3 零件。

  1. 原專案表示,熱熔螺帽可以一次裝一個零件、一次裝一條腿的所有零件,或一次裝所有腿的所有零件。本說明以每條腿為單位。若任何螺絲、熱熔螺帽或其他零件的位置不清楚,請參考 CAD;所有五金都在 Fusion360 組件中。
  2. M3 熱熔螺帽:S0 4x 用於編碼器座。S1 4x 用於編碼器座、6x 用於 base upper 與 base lower 的連接、2x 用於馬達蓋。S2 3x 裝在 S2 gear side 上、4x 用於編碼器座、2x 用於編碼器磁鐵座。S3 2x 用於編碼器磁鐵座。
  3. M4 熱熔螺帽:S1 4x 用於 hub gear 連接。S2 4x 用於 hub gear 連接、6x 用於 S2 長連接件。S3 4x 用於 hub gear 連接、4x 裝在 S3 gear side 上以連接各件,以及 2x 裝在腳尖件中。

5.2 壓入磁鐵與軸承

將編碼器磁鐵平整壓入,再將小型 6mmx10mmx3mm 與大型 25x32x4mm 軸承壓入腿部零件。

  1. 壓入編碼器磁鐵。磁鐵必須完全齊平,不能歪斜安裝。S1:1x 直接裝在零件上。S2:1x 裝在可拆式磁鐵座上。S3:1x 裝在可拆式磁鐵座上。然後將 S2 與 S3 的磁鐵座裝到對應零件上。
  2. 壓入小型馬達軸承(6mmx10mmx3mm),它們裝在所有與馬達軸配合的零件上:S0 1x 裝在 S0 齒輪蓋上;S1 2x 裝在 S1 馬達軸承座上;S2 1x 裝在 S2 短連接件上。
  3. 壓入大型軸承(25x32x4mm):S1 2x 裝在 S1 中、1x 裝在 S1 馬達軸承安裝座中;S2 1x 裝在 S2 bearing side 上、1x 裝在 S2 gear side 上。

5.3 安裝編碼器

使用編碼器安裝工具將 S0、S1 與 S2 編碼器平整裝入,然後取下其螺絲。

  1. 用編碼器輔助工具(Hex3_resources/cad 中的 encoder_insertion_tool)安裝編碼器,確認它們完全平貼零件。安裝時小心不要刮傷 PCB。編碼器裝好後,拆下編碼器上的螺絲。
  2. S0:裝上 1x 編碼器。S1:裝上 1x 編碼器與其外蓋(2 顆螺絲保留穿過外蓋)。S2:在 bearing side 上裝上 1x 編碼器。

5.4 組裝 S0

用兩顆 M3x08 螺絲裝上 S0 馬達,再用兩顆 M3x18 螺絲裝上 15 齒齒輪與 S0 齒輪蓋。

  1. 15 齒齒輪(小的那個)上止付螺絲的位置非常關鍵,且每顆馬達不同,請參考 CAD 確認。原專案也建議將齒輪裝到馬達軸上時,在止付螺絲上塗一些藍色 Loctite。
  2. 用兩顆 M3x08 螺絲將馬達裝到 S0。
  3. 裝入 S0 齒輪蓋間隔件。
  4. 將 15 齒齒輪裝到 S0 馬達軸上,止付螺絲最靠近馬達。
  5. 用兩顆 M3x18 螺絲裝上 S0 齒輪蓋。
  6. 其餘組裝留待後續步驟。

5.5 組裝 S1

將兩顆馬達各以三顆螺絲裝入 S1,各加上一個 15 齒齒輪,以四顆 M4 螺絲裝上輪轂齒輪,再以兩顆 M3 螺絲裝上馬達蓋。

  1. 將兩顆馬達裝入 S1,每顆馬達只使用最靠近編碼器的 3 顆螺絲。將導線從 S1 背面引出。
  2. 將編碼器導線從 S1 背面引出,穿過兩顆馬達之間。
  3. 裝入 S1 馬達軸承座。
  4. 在每根 S1 馬達軸上裝一個 15 齒齒輪,止付螺絲較靠近馬達底部。
  5. 用四顆 M4 螺絲安裝 hub gear。
  6. 用兩顆 M3 螺絲安裝 S1 馬達蓋。
  7. 其餘組裝留待後續步驟。

5.6 組裝 S2

以六顆 M3x08 螺絲將 S2 馬達穿過 S2 短件與長件固定,加上 15 齒齒輪,再以四顆 M4 螺絲裝上輪轂齒輪。

  1. 將 S2 馬達穿過 S2 short 與 S2 long 兩件安裝。用 6 顆 M3x08 螺絲連接。
  2. 將 15 齒齒輪裝到 S2 馬達軸上,止付螺絲離馬達較遠。
  3. 用 4x M4 螺絲安裝 hub gear。
  4. 其餘組裝留待後續步驟。

5.7 組裝 S3

以 M4x60 螺絲組裝彈簧腳趾,再以兩顆 M4x30 與兩顆 M4x35 螺絲合上 S3。

  1. 將 hub gear 與 S3 gear mount 一起安裝。
  2. 用 M4x60 螺絲將彈簧、彈簧對位件與腳尖組合在一起。
  3. 將腳尖組件放入 S3。
  4. 可選擇加裝腳尖距離用的飛行時間感測器。這是實驗性元件:原專案表示在撰寫時,該感測器尚未在軟體中完整實作。
  5. 用四顆 M4 螺絲封閉組件(兩顆 M4x30、兩顆 M4x35)。
  6. 其餘組裝留待後續步驟。

5.8 將 S1、S2 與 S3 組成一條腿

將 S1、S2 與 S3 組件壓合在一起,並以三顆 M4 螺絲鎖定。

  1. 將 S2 的軸承連接件插入 S1,把 S2 gear side 裝到 S1 上。
  2. 裝上 S2 馬達軸承安裝座與 S1 馬達齒輪座,將 S2 gear side 與 S1 鎖在一起。
  3. 用 3 顆 M4 螺絲連接 S2 bearing side 與 S2 馬達組件。
  4. 將 S1/S2 gear side 組件、S3 組件與 S2 加馬達組件夾合在一起。它們應全部壓入配合,並用 3 顆 M4 螺絲鎖定。
  5. 腿部組件完成。六條腿都重複相同步驟;下一步會將腿部裝到 S0 與底座上。

5.9 準備並組裝底座

裝上腿部 PCB、S0、繼電器與 PCB 安裝座、HDMI 與 USB 接頭、下底座、腿部、Raspberry Pi 與上底座。

  1. 依照 Fusion360 組件裝上所有 M3 與 M4 熱熔螺帽。將所有軸承壓入 leg flat,並在每個 leg flat 裝上 S1 軸承座。
  2. 將六片腿部 PCB 分別裝到六足機器人底座的各側。
  3. 用 leg flat 上的 2-4 顆 M4 螺絲裝上 S0。
  4. 安裝繼電器、PCB 座與 PCB 護蓋。原專案的機械頁面指向其電子頁面說明這些零件,但該頁面並沒有描述,因此請參考 Fusion360 組件。
  5. 將 HDMI 接頭與 USB 接頭裝到 base lower 上。
  6. 用 M4 螺絲裝上 base lower。長 M3 螺絲應穿過 base lower 鎖入 S0 的連接處。
  7. 小心地將腿部組件裝入六足機器人的各側,讓每條腿的 S1 hub gear 與 S0 從動齒輪嚙合(若齒輪對位不清楚,請參考 CAD),並注意對齊 base upper 與 base lower 上的 3 顆 M3 螺絲。
  8. 安裝 Raspberry Pi,並將電源開關接線到 base upper 上。將 base upper 裝到定位。
  9. 原專案表示,此時組裝即告完成,六條腿都可以進行校正。

6. 即時韌體與校正

以 PlatformIO 為每條腿建置並燒錄 Xiao RP2350 韌體,然後校正每條腿。

6.1 安裝工具並開啟韌體專案

安裝 VS Code 與 PlatformIO IDE 擴充功能,並開啟 Hex3 儲存庫中的 real_time/xiao_code。

  1. 需求:安裝 PlatformIO IDE 擴充功能的 VS Code,以及透過 USB 連接的 Seeed Xiao RP2350。原專案表示函式庫相依項目(RP2040_PWM、PID、RP2040PIO_CAN 與 Adafruit VL6180X 腳尖感測器驅動程式)已在 platformio.ini 中宣告,會自動安裝。
  2. 韌體位於 Hex3 儲存庫的 real_time/xiao_code;原專案的 Hex3 頁面在其專案詞彙表中連到該儲存庫。韌體頁面沒有提供下載指令。
  3. 在 VS Code 中使用 Open Folder 並選擇 real_time/xiao_code。PlatformIO 會讀取 platformio.ini,其目標環境為 seeed_xiao_rp2350。

6.2 為每條腿建立 user_config.hpp

將 TEMPLATE_user_config.hpp 複製為 src/user_config.hpp,並為每塊板子設定 0 到 5 之間不重複的 LEG_NUMBER。

  1. user_config.hpp 因為存放各電路板的設定,刻意不納入 git,因此在韌體能編譯之前,請先建立你自己的副本。
  2. 將 lib/HexapodController/TEMPLATE_user_config.hpp 複製為 lib/HexapodController/src/user_config.hpp。
  3. 將 LEG_NUMBER 設為這塊電路板所裝的腿(0 到 5)。每條腿的值都必須唯一。它也會設定電路板的 CAN 節點 ID:來自 Pi 的指令為 0x100 + LEG_NUMBER,回覆為 0x180 + LEG_NUMBER,Pi 的 can ROS2 節點就是以此定址每條腿。
  4. 設定 LOG_LEVEL 與 TELEMETRY_LOGGING_SPACE,決定除錯時要輸出多少序列遙測資料。
  5. 在 lib/HexapodController/src/config.hpp 中為這條腿新增或選擇一個 #ifdef <YOUR_NAME> ... #endif 校正區塊,並用下方的校正步驟產生 ZERO_POINTS 的值。
  6. 若你使用 V3.2 腿部 PCB,請在上傳前完成 PCB 組裝階段所述的 leg.cpp 修改。

6.3 建置並上傳韌體

以 seeed_xiao_rp2350 環境建置並上傳,再以 115200 baud 的序列埠監控視窗確認板子已開機。

  1. 在 PlatformIO 中選擇 seeed_xiao_rp2350 環境後,執行 build 編譯韌體。
  2. 在 Xiao 透過 USB 連接時上傳。
  3. 以 115200 baud 開啟 PlatformIO Serial Monitor,確認電路板能開機,並印出其 CAN tx/rx 節點 ID,以及關節位置、速度與加速度遙測資料。

6.4 校正每條腿

將 ZERO_POINTS 設為 0.0,在六足機器人關閉時將腿保持在校正姿勢,從序列埠監控視窗讀取關節位置,並為該腿輸入這些數值。

  1. 在 config.hpp 檔案(不是 config.cpp)中建立使用者設定檔。其格式為:#ifdef USER,接著 #define STEP_THRESHOLD 40、#define FIFO_IDLE_THRESHOLD 100,然後 #define ZERO_POINTS 為六列(每條腿一列)、每列三個值,每個值寫成一個數字加上 CALIBRATION_OFFSET_A0、CALIBRATION_OFFSET_A1 或 CALIBRATION_OFFSET_A2,最後是 #endif。
  2. 校正時,將設定值與校正偏移量都設為 0.0,使每個項目都寫成 0.0 + 0.0。
  3. 關閉六足機器人,將腿移到校正位置,並將 Xiao RP2350 插到主板上。校正位置為:S1 與六足機器人的側板平行;S2 盡量往下,通往 S1 的 3 條導線平貼排列(S1 與 S2 之間的距離正好是 1 條導線的直徑);S3 盡量往上(S2 與 S3 之間的距離正好是 1 條導線的直徑)。原專案的校正說明圖片顯示了這個姿勢。
  4. 上傳 main.cpp 並開啟序列埠監控視窗。你應該會看到類似這樣的值:{"Joint": {"pos": [0.547631, -0.836020, 2.787243], "vel": [0.000049, 0.006216, 0.000052], "acc": [-0.001082, 4.619407, -0.000955], "duty": [80.000000, -80.000000, -80.000000]}, "voltage": 0.730000, "toe": 0.000000}
  5. 將程式碼加到你正在校正的腿。例如 Leg0 的 ZERO_POINTS 第一列變為 0.547631 + CALIBRATION_OFFSET_A0、-0.836020 + CALIBRATION_OFFSET_A1、2.787243 + CALIBRATION_OFFSET_A2,其他五列維持 0.0 + 0.0。
  6. 將程式碼上傳到該腿,並確認它處於站立姿勢。在 user_config.hpp 中確認你設定了正確的 LEG_NUMBER。
  7. 全部 6 條腿都重複相同步驟。

7. Raspberry Pi 設定

燒錄 Raspberry Pi OS、安裝 Docker、啟用 CAN 介面、配對手把,並建置 ROS2 容器。

7.1 燒錄 SD 卡

以 Raspberry Pi Imager 將 Raspberry Pi OS(64-bit)燒錄到 64GB 以上的 micro SD 卡。

  1. 需求:Raspberry Pi 5;micro SD 卡(建議 64GB 以上);micro HDMI 轉 HDMI 線;USB 鍵盤;USB 滑鼠。
  2. 下載 Raspberry Pi Imager。選擇 Raspberry Pi 5 作為電路板,並選擇 Raspberry Pi OS(64-bit)。選擇你的 micro SD 卡。
  3. 選擇你的設定。建議:主機名稱 hexapod-<last_name>;使用者 hexapod<last_name>;透過驗證啟用 SSH。
  4. 點選儲存並等待。燒錄完成後,將記憶卡插入 Pi 並接上周邊裝置。

7.2 安裝 Docker

以 get.docker.com 腳本安裝 Docker,並將你的使用者加入 docker 群組。

  1. 更新系統:sudo apt update && sudo apt full-upgrade -y
  2. 下載 Docker 安裝腳本:curl -fsSL https://get.docker.com -o get-docker.sh
  3. 安裝 Docker:sudo sh get-docker.sh
  4. 將你的使用者加入 docker 群組:sudo usermod -aG docker $USER
  5. 登出再登入,或重新開機,讓群組變更生效:sudo reboot
  6. 確認安裝:docker --version、docker compose version、docker run hello-world

7.3 加入 CAN 設定覆寫

在 /boot/firmware/config.txt 中加入 dtparam=spi=on 與 mcp2515-can0 overlay。

  1. 開啟設定檔:sudo nano /boot/firmware/config.txt
  2. 在檔案末尾加入以下幾行:dtparam=spi=on 與 dtoverlay=mcp2515-can0,oscillator=16000000,interrupt=25

7.4 設定 CAN 介面服務

安裝 can-utils,並建立一個 canbus.service systemd 單元,以 500000 bit/s 啟用 can0。

  1. 安裝 can-utils:sudo apt install can-utils
  2. 用以下指令取得 ip 的路徑:which ip。原專案的範例結果為 /usr/sbin/ip。
  3. 建立 /etc/systemd/system/canbus.service,內容為:[Unit] Description=CAN Bus Interface;[Service] ExecStart=/usr/sbin/ip link set can0 up type can bitrate 500000、Type=oneshot、RemainAfterExit=yes;[Install] WantedBy=multi-user.target。請使用上一個指令得到的路徑。
  4. 啟動服務:sudo systemctl start canbus.service

7.5 配對 Xbox 控制器

透過 Raspberry Pi OS 的藍牙介面或終端機配對 Xbox Core 控制器。

  1. 使用 Raspberry Pi OS 的藍牙介面或終端機連接 Xbox Core(Series S、X 等)控制器。

7.6 設定機器人名稱並建置 ROS2 節點

將六足機器人的名稱寫入 robot_name.local.txt,為它指定不重複的 ROS_DOMAIN_ID,並在 dev container 中執行 colcon build。

  1. Pi 與 ROS2 程式碼位於 Hex3 儲存庫的 non_real_time 資料夾,原專案的 Hex3 頁面有連結。Raspberry Pi 頁面沒有提供下載指令。
  2. 開啟 non_real_time/container/src/ros2_ws/src/hexapod_manager/config/robot_name.local.txt,加入你的六足機器人名稱。這應該是檔案中唯一的文字。
  3. 確認 non_real_time/container/src/ros2_ws/src/hexapod_manager/launch/hexapod.launch.py 中有此機器人名稱,並設有唯一的 ROS_DOMAIN_ID。
  4. 在 non_real_time/container 中,用 ./init_dev.sh 初始化開發容器,用 ./new_dev_shell.sh 開啟新的 shell,然後用 colcon build 編譯 ROS2 節點。
  5. 下次重新啟動 Pi 時,變更就會生效。若想更早測試,也可以執行:docker compose -f docker-compose-prod.yml up

7.7 啟動行走軟體堆疊

先讓六足機器人通電、Pi 開機並連接控制器,再在 dev container 中啟動 hexapod.launch.py。

  1. 如電子階段所述,先開啟六足機器人的電源,再啟動 Pi 5。
  2. 啟動之前,先打開 Xbox 控制器並透過藍牙將它連到 Pi。
  3. 在開發容器內執行:ros2 launch hexapod_manager hexapod.launch.py。這會一次啟動 control、joy、inverse_kinematics、can_interface 與 tripod_gait,是原專案啟動六足機器人、以 Xbox 控制行走的標準方式。
  4. 選用:ros2 run hexapod_manager led_controller 會驅動六足機器人底部的 LED 環。ros2 run hexapod_tester hexapod_tester 可在沒有控制器的情況下掃描機身姿態與足端目標,此時 launch 檔要在另一個 shell 中執行。
  5. CAN 除錯指令,在 Pi 的終端機中執行,不是在 docker 容器中;通常不需要,因為有服務會啟動 CAN:sudo ip link set can0 down; sudo ip link set can0 type can bitrate 500000; sudo ip link set can0 up; candump can0; cansend can0 123#DEADBEEF

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