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 不同,因此不要混用兩者的文件。
- 原專案 README 表示,目前的 Hexapod 版本是 Hex3,Hex4 正在開發中,目標發布時間為 2027 年年中至下半年。
- Hex3 頁面將此平台描述為穩定狀態:它已不再積極開發,原專案希望任何修改都以 pull request(透過其 Discord 審查)或公開的 fork 提出。
- 原專案列出的 Hex3 重點:10kg(約 22lb)負載能力;可用 Xbox 控制器操控;機身與腿部完全 3D 列印;18 個自由度(每條腿 3 個);以直流減速馬達與 AS5600 磁性編碼器製成的低成本客製伺服機;附位置感測器的彈簧式腳尖;每條腿一塊 Seeed Xiao RP2350;Pi 與各腿控制器透過共用的 CAN 匯流排通訊;Raspberry Pi 5 上執行 ROS2。
- 原專案給出的 Hex3 價位約為 $2,000 USD。
- 原專案的 Hex3 頁面分為六個階段:3D 列印、PCB 組裝、電子設定、機械組裝、即時韌體與 Raspberry Pi 設定。先開始列印,讓列印在你進行其他階段時同時進行。
1.2 如果你手上已有 Hex2
Hex2(模型伺服機與 Teensy 4.1)已於 2025 年 7 月棄用,原專案沒有公開它的組裝方式。
- 原專案表示,Hex2 已於 2025 年 7 月棄用,不再積極支援,但儲存庫仍保有組裝與控制它所需的資料。歡迎 fork 此儲存庫以繼續開發。
- 原專案指出 Hex2 的兩大限制:業餘級伺服機可能過熱,使連續運作時間只有幾分鐘;最大負載也只有幾磅。
- 原專案為 Hex2 公開了:電氣與機械物料清單(兩者日期皆為 2025 年 7 月 22 日)、熱熔螺帽圖面(2024 年 11 月 5 日)、Fusion 360 組件(2025-07-22_assembly.f3z)、主板與腿部板的電子檔案、控制器按鍵對應圖、Raspberry Pi 5 入門頁面,以及位於另一個 Hex2 儲存庫中的 Teensy 與 Raspberry Pi 程式碼。
- 原專案沒有公開 Hex2 的組裝步驟、線束文件或校正程序。電氣物料清單中有一行「Main to Leg Connections <TBD>」。因此本指南不描述 Hex2 的組裝、配線或校正;請直接使用上述 Hex2 文件。
- 本指南中的導線長度、編碼器、馬達與飛行時間感測器纜線、校正方法與 CAN 設定僅適用於 Hex3。使用業餘級伺服機的 Hex2 沒有需要製作的編碼器或獨立馬達線束。
1.3 備齊工具與材料
開始之前,你需要兩支六角扳手(2.00 mm 與 2.5 mm)、焊接與壓接工具、三用電錶,以及齒輪潤滑脂。
- 原專案的完整物料清單是 HEX3 Bill-Of-Materials 試算表(分頁:Mechanical BOM、Electrical BOM、一份列印件清單與一份 PCB 訂購範例)。
- 工具:2.00mm 六角扳手(用於 Raspberry Pi 與光達(LiDAR));2.5mm 六角扳手(其他所有五金都使用 2.5mm 六角;原專案建議也使用 2.5mm 起子頭,因為手動鎖緊所有螺絲是一項艱鉅的工作);烙鐵與焊接配件;助焊劑與焊錫;烙鐵用熱熔螺帽烙鐵頭;用於導通與極性檢查的三用電錶;PCB 夾座或虎鉗(建議用於 PCB 組裝);剪線鉗;適用導線長度表中線徑的剝線鉗;夾具(非必要但強烈建議用於壓入配合);JST 壓接工具;端子壓接工具(強烈建議但非必要,因為這些連接也可以直接焊接);用於移除支撐材的鉗子、鑷子等工具。
- 另需材料:齒輪用多用途合成潤滑脂。
2. 3D 列印
列印 Hex3 的機身與腿部零件。原專案公開了列印設定與零件數量,但沒有各零件的列印擺放方向。
2.1 列印機身與腿部零件
以 ABS 或 ASA 列印 Hex3 腿部與底座零件,base_core 與腳趾以 12 層以上的外壁列印。
- 原專案表示可以使用 PETG,但建議使用 ABS 或 ASA,以獲得更好的強度與耐熱性。
- 所有結構件都在 PrusaSlicer 中以 0.2mm STRUCTURAL 列印設定檔切片,並以 Prusa Core ONE 列印。預設(多數零件):4 層牆、30% 三角形填充、依需要加支撐。base_core 與腳尖:12 層以上的牆、30% 三角形填充、依需要加支撐。
- base_core 承受最高的結構負荷,因此以 12 層以上的牆列印,使其實際上成為實心,而不是依賴填充。腳尖會隨時間磨損,因此也以這些設定列印。
- 六條腿所需的數量,取自物料清單的列印件分頁: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。
- 同一分頁中的底座零件: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。
- 列印前請注意:列印頁面提到 base_core,release 資料夾中也有 base_core.3mf,但列印件分頁沒有列出它。請依列印頁面的指示列印 base_core。
- 檔案位於儲存庫的 Hex3_resources/cad(完整的 Fusion 360 組件、一個 STEP 檔、底座與腿部零件的 release 3mf 檔,以及 .f3d 與 .step 格式的 encoder_insertion_tool),也位於原專案的 Hex3 Printables 專案中。原專案表示零件外觀可能與圖片略有不同,並請一律使用 GitHub 上的最新版本。
- 編碼器插入工具用於機械組裝。原專案公開了它的 CAD,但沒有提供列印設定。
3. PCB 組裝
焊接六片腿部 PCB 與一片主 PCB。腿部 PCB 版本 V2.0 或 V3.2 會改變零件、一顆電容的極性,以及一項必要的修正;下單前請先選定。
3.1 選擇腿部 PCB 版本
Hex3 有兩種腿部 PCB 版本,V2.0 與 V3.2,兩者功能完整;主 PCB 為 V2.1。
- 原專案表示兩個版本都能組裝出完整的 Hex3。主要差異在於組裝方式、散熱管理、PCB 成本,以及 XIAO RP2350 能否重複使用。
- Leg V2.0:使用需手工焊接的插件式二極體;DRV8871 馬達驅動晶片沒有額外散熱(仍可加裝外部散熱片,但佈局並非為散熱而設計);XIAO RP2350 直接焊在 PCB 上,因此無法重複使用。
- Leg V3.2:使用表面黏著二極體(訂購時請將它加入你的組裝零件清單);非常重視 DRV8871 晶片的散熱,採用 2 oz 內層鋪銅(這會讓價格提高不少)以及 GND 平面的過孔縫合;XIAO RP2350 有 POGO pin 選項,可重複使用,不過 pogo pin 的間距很敏感,需要特定的公母排針。
- 原專案 PCB readme 列出的 V3.2 其他變更:移除 CAN 匯流排電路中的分離式終端;絲印上的編碼器標籤改為從零開始編號;編碼器接頭互換,使 S0 最靠近電路板頂端。
- 主板:OpenSauce 2026 只使用了 V2.1。兩種腿部板版本都用在 OpenSauce 2026 的六足機器人上。
- 檔案位於 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 上,再重複完成六塊。
- 一片腿部 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)。
- V2.0 另需 1x 1N5819 二極體。V3.2 可選擇另加 2x 4 Pin POGO 接頭、2x 7 Pin 短公排針與 2x 7 Pin 短母排針。
- 從 Xiao RP2350 開始。V3.2 可以選擇使用排針;V2.0 不支援排針。
- 表面黏著的 Xiao:先確認兩側間距平均、所有針腳都對準焊墊中央,再用少量焊錫點焊對角的兩個上方針腳。將 PCB 翻面,確認底部焊墊位於通孔中央;若沒有,加熱其中一角,輕輕轉動 Xiao 後重複。接著焊接所有上方針腳。底部則使用細烙鐵頭,同時加熱孔與 Xiao 焊墊,以焊錫填滿孔,並確認沒有填得過滿,也沒有與相鄰的孔短路。
- 排針式 Xiao(僅限 V3.2):將母排針焊到 PCB 上,再將公排針焊到 Xiao 上。若使用 Hex3 BOM 中的排針與 pogo pin,請將公排針從 Xiao 上方穿入,而不是讓 Xiao 擱在排針上,這樣 pogo pin 才能確實接觸底部的焊墊。將 pogo pin 放到 PCB 上,把 Xiao 插入母排針,確認 pogo pin 的尖端對準 Xiao 底部的焊墊;若對準了,就將 pogo pin 焊到 PCB 上。
- 僅限 V2.0:現在焊上二極體。二極體的陰極應位於靠近 Xiao 的一側。V3.2 請跳過此步,因為該二極體是表面黏著元件,屬於 PCB 組裝訂單的一部分。
- 焊接 3557 保險絲座。烙鐵要在保險絲座的針腳上停留足夠時間,讓熱量充分累積後再上錫。
- 焊接 JST 接頭:編碼器用的 4 pin JST、可選的第 4 個 I2C 擴充用接頭,以及腳尖感測器用的 5 pin JST。
- 焊接 Molex 接頭:用於主電源與連接主 PCB 之 CAN 匯流排的 4 pin Molex,以及馬達用的 2 pin Molex 接頭。
- 焊接電容,注意極性正確:22uF 電容的陰極應朝向 2 pin Molex 接頭。焊上 Xiao 用的 470uF 電容,同樣注意極性:V2.0 的陰極朝向保險絲座與 4 pin Molex 接頭;V3.2 改了排列方式,使所有電容方向一致,470uF 電容的陰極朝向 Xiao 的 USB。
- 重複以上步驟,直到完成六片腿部 PCB。
3.3 依腿部 PCB 版本套用必要的修正
V2.0 要切斷 CAN 分離式終端的走線,V3.2 則要修改 leg.cpp;原專案將此標示為 DO NOT SKIP THIS。
- V2.0:必須割斷分離式終端 CAN 匯流排的走線。它們位於 PCB 底面;原專案的 PCB readme 表示,測試顯示這項功能會造成問題。請在原專案 V2.0 底視圖照片所示的位置割斷走線。
- 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);。
- 修改後檔案內容應為: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 正常運作。
- 檢查是否有焊錫橋接、冷焊與元件錯位。
- 電路板通電前,確認接頭方向與極性。
- 通電測試前,將迷你片狀保險絲插入保險絲座。原專案的腿部板使用 10A 保險絲。
- 一次一片地將每片腿部板接到電源供應器,確認 LED 與 Xiao 運作正常,再測試與主 PCB 的連接。
- 剪掉插件式徑向電容多餘的接腳長度,避免短路。
3.5 焊接主 PCB
將 XT60 接頭、保險絲座、2x40 Pi 排針座、兩個 DC-DC 降壓轉換器、接頭與電容焊到主 PCB 上。
- 零件: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 個可以焊在其中任何位置。
- 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。
- 焊接 XT60 接頭。烙鐵要在針腳上停留足夠時間,讓熱量充分累積後再上錫。
- 焊接 3557 保險絲座,同樣先讓烙鐵在針腳上停留足夠時間,讓熱量充分累積。
- 焊接 2x40 母排針,讓針腳從 PCB 頂面穿出。主 PCB 插在 Pi 上並架在其上方。
- 焊接 DC-DC 降壓轉換器,注意極性方向正確:降壓轉換器上的方塊朝上、遠離 PCB,轉換器的電壓輸入位於電路板左側、最靠近 XT60 接頭處。
- 在電路板中央的位置裝上 1x2 公排針,再用跳線帽將其針腳短路。也可以直接將兩個焊墊短路,或焊上一段環狀導線。這個連接會啟用 CAN 匯流排網路上的 120 Ohm 電阻。
- 先焊 JST,再焊 Molex 接頭。
- 焊接 10uF 電容,注意極性正確:陰極朝向電路板底部,遠離 XT60、朝向 Molex 接頭。
- 將 470uF 電容焊在上方 DC-DC 轉換器的輸入端子之間:陰極朝向負極輸入,陽極朝向正極輸入。
3.6 連接 Pi 之前檢查主 PCB
在連接 Raspberry Pi 之前,裝上 20A 迷你插片保險絲,並以電源供應器為主 PCB 供電。
- 確認所有接頭都以正確方向安裝,並檢查電源路徑與穩壓器周圍是否有短路。
- 通電測試前,將迷你片狀保險絲插入保險絲座。原專案的主板使用 20A 保險絲。
- 先將主 PCB 接到電源供應器,確認 Pi 的 5V 輸入與 4 Pin Molex 接頭的 24V 線路都有正確電壓。原專案強烈建議在連接 Raspberry Pi 之前先做這項測試。
- 接著將主板接到一片腿部板,確認主板通電時腿部板也有供電。
- 剪掉插件式徑向電容多餘的接腳長度,避免短路。
4. 電子設定
為電池、繼電器與開關配線,製作每條腿的線束,並為編碼器與馬達配線。
4.1 電池、繼電器與自鎖開關配線
一顆 5Ah Milwaukee M18 電池透過 JD2914 繼電器為主 PCB 供電,由自鎖開關控制繼電器的開關。
- 電源來自 5Ah 的 Milwaukee M18 電池,送到主 PCB 後再由主 PCB 分配。繼電器透過自鎖式電源開關控制六足機器人的開關機。
- 連接方式:M18 電池(+)接到 WAGO,再接到繼電器 pin 30 與自鎖開關的輸入。M18 電池(-)接到 WAGO,再接到繼電器 pin 85 與機器人接地。自鎖開關的輸入為電池 +。自鎖開關的輸出接到繼電器 pin 86。六足機器人電源(+)為繼電器 pin 87。六足機器人接地(-)為電池 -。
- JD2914 繼電器腳位:pin 30 為共用端(COM),接電池,建議用紅色導線,是來自 M18 電池的主電源輸入。Pin 87 為常開(NO),接機器人電源 +,紅色,繼電器激磁時與 pin 30 導通。Pin 87a 為常閉(NC):不連接,保持未使用並做好絕緣。Pin 85 為線圈(-),接電池 -,黑色,是繼電器線圈的接地。Pin 86 為線圈(+),接自鎖電源開關的輸出,紅色,開關切到 ON 時使繼電器激磁。
- 頁面上本節附有原專案的電源電路圖與電源配線照片。
4.2 規劃 Raspberry Pi 的開機順序
Raspberry Pi 5 必須在六足機器人通電之後才開機,這由 Pi 上的一個瞬時電源按鈕處理。
- 由於降壓轉換器與繼電器組合產生的雜訊,Raspberry Pi 5 必須在六足機器人通電之後再開機。
- 原專案表示,這個斷電重開可以利用 Pi 5 內建的電源按鈕過孔處理。它建議使用直角排針,並接上一顆瞬時型電源按鈕來觸發重新開機;Hex3 的上蓋有一個孔可安裝瞬時型電源開關。
- 請參考 Raspberry Pi 文件中關於自行加裝電源按鈕的章節。
4.3 製作線束
依所列長度裁切並壓接 24 AWG 四芯編碼器線與飛行時間感測器線、18 AWG 雙芯馬達線,以及主板到腿部的主幹線。
- S0 編碼器至腿部 PCB:120 mm,4 芯 24 AWG,數量 6。第 1 端無接頭;第 2 端為 4 Pin JST XH 母座外殼。
- S0 馬達至腿部 PCB:130 mm,2 芯 18 AWG,數量 6。第 1 端無接頭;第 2 端為 2 Pin Molex Microfit 3.0 插頭。
- S1 編碼器至腿部 PCB:250 mm,4 芯 24 AWG,數量 6。第 1 端無接頭;第 2 端為 4 Pin JST XH 母座外殼。
- S1 馬達至腿部 PCB:265 mm,2 芯 18 AWG,數量 6。第 1 端無接頭;第 2 端為 2 Pin Molex Microfit 3.0 插頭。
- S2 編碼器至腿部 PCB:405 mm,4 芯 24 AWG,數量 6。第 1 端無接頭;第 2 端為 4 Pin JST XH 母座外殼。
- S2 馬達至腿部 PCB:365 mm,2 芯 18 AWG,數量 6。第 1 端無接頭;第 2 端為 2 Pin Molex Microfit 3.0 插頭。
- 飛行時間(腳尖)感測器至腿部 PCB:450 mm,4 芯 24 AWG,數量 6。第 1 端為 4 Pin JST XH 母座外殼;第 2 端為 5 Pin JST XH 母座外殼。腳尖感測器為選配且屬實驗性質:原專案表示目前軟體尚未實作。
- 主 PCB 至腿部 PCB:185 mm,2 芯 18 AWG 加 2 芯 24 AWG 雙絞線,數量 5。兩端皆為 4 Pin Molex Microfit 3.0 插頭。
- 主 PCB 至腿部 PCB:250 mm,導線與接頭相同,數量 1。原專案表示這條用於電池接頭後方的那條腿。
- 完成電子階段後,你應該至少有 1 組電源組件、18 個編碼器與 6 個腳尖飛行時間感測器(這些感測器屬實驗性功能)。
4.4 編碼器配線
以跳線將每個編碼器的 DIR 針腳接地,再將四芯線束接到編碼器板及其 JST 接頭。
- 編碼器的 DIR 腳位必須接地。直接在編碼器板上用一小段跳線連接 DIR 與 GND;這與 4 芯線束是分開的。
- 若使用原專案的 4 芯線束,原專案建議以下配線,以與電路板上的接頭順序一致:紅色為 VCC,接 JST pin 1;黑色為 GND,接 pin 2;藍色為 SCL,接 pin 3;綠色為 SDA,接 pin 4。
- 將編碼器導線直接焊到 S0、S1 與 S2 編碼器板上時,焊點要盡量與電路板齊平。凸起的焊錫可能比旁邊的電容還高,使編碼器安裝後無法平貼;在機械組裝中,編碼器必須完全平貼安裝。
4.5 馬達配線
馬達極性沒有影響,但要保持一致,因為它決定 config.hpp 中的軸反向常數。
- 馬達配線的極性無所謂,但要保持一致。
- 極性的選擇會影響 config.hpp(位於 Hex3 韌體的 lib/HexapodController/src 中)裡的軸反轉常數。若將馬達的負極端子接到 Molex 接頭的 pin 1,軸反轉值就會是 {true, false, false}。
4.6 腿部到主 PCB 的纜線配線
將四芯主幹線依紫、紅、黑、白的順序接到 Molex 第 1 至 4 腳。
- 若使用原專案的線束,原專案建議:紫色為 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 零件。
- 原專案表示,熱熔螺帽可以一次裝一個零件、一次裝一條腿的所有零件,或一次裝所有腿的所有零件。本說明以每條腿為單位。若任何螺絲、熱熔螺帽或其他零件的位置不清楚,請參考 CAD;所有五金都在 Fusion360 組件中。
- M3 熱熔螺帽:S0 4x 用於編碼器座。S1 4x 用於編碼器座、6x 用於 base upper 與 base lower 的連接、2x 用於馬達蓋。S2 3x 裝在 S2 gear side 上、4x 用於編碼器座、2x 用於編碼器磁鐵座。S3 2x 用於編碼器磁鐵座。
- M4 熱熔螺帽:S1 4x 用於 hub gear 連接。S2 4x 用於 hub gear 連接、6x 用於 S2 長連接件。S3 4x 用於 hub gear 連接、4x 裝在 S3 gear side 上以連接各件,以及 2x 裝在腳尖件中。
5.2 壓入磁鐵與軸承
將編碼器磁鐵平整壓入,再將小型 6mmx10mmx3mm 與大型 25x32x4mm 軸承壓入腿部零件。
- 壓入編碼器磁鐵。磁鐵必須完全齊平,不能歪斜安裝。S1:1x 直接裝在零件上。S2:1x 裝在可拆式磁鐵座上。S3:1x 裝在可拆式磁鐵座上。然後將 S2 與 S3 的磁鐵座裝到對應零件上。
- 壓入小型馬達軸承(6mmx10mmx3mm),它們裝在所有與馬達軸配合的零件上:S0 1x 裝在 S0 齒輪蓋上;S1 2x 裝在 S1 馬達軸承座上;S2 1x 裝在 S2 短連接件上。
- 壓入大型軸承(25x32x4mm):S1 2x 裝在 S1 中、1x 裝在 S1 馬達軸承安裝座中;S2 1x 裝在 S2 bearing side 上、1x 裝在 S2 gear side 上。
5.3 安裝編碼器
使用編碼器安裝工具將 S0、S1 與 S2 編碼器平整裝入,然後取下其螺絲。
- 用編碼器輔助工具(Hex3_resources/cad 中的 encoder_insertion_tool)安裝編碼器,確認它們完全平貼零件。安裝時小心不要刮傷 PCB。編碼器裝好後,拆下編碼器上的螺絲。
- S0:裝上 1x 編碼器。S1:裝上 1x 編碼器與其外蓋(2 顆螺絲保留穿過外蓋)。S2:在 bearing side 上裝上 1x 編碼器。
5.4 組裝 S0
用兩顆 M3x08 螺絲裝上 S0 馬達,再用兩顆 M3x18 螺絲裝上 15 齒齒輪與 S0 齒輪蓋。
- 15 齒齒輪(小的那個)上止付螺絲的位置非常關鍵,且每顆馬達不同,請參考 CAD 確認。原專案也建議將齒輪裝到馬達軸上時,在止付螺絲上塗一些藍色 Loctite。
- 用兩顆 M3x08 螺絲將馬達裝到 S0。
- 裝入 S0 齒輪蓋間隔件。
- 將 15 齒齒輪裝到 S0 馬達軸上,止付螺絲最靠近馬達。
- 用兩顆 M3x18 螺絲裝上 S0 齒輪蓋。
- 其餘組裝留待後續步驟。
5.5 組裝 S1
將兩顆馬達各以三顆螺絲裝入 S1,各加上一個 15 齒齒輪,以四顆 M4 螺絲裝上輪轂齒輪,再以兩顆 M3 螺絲裝上馬達蓋。
- 將兩顆馬達裝入 S1,每顆馬達只使用最靠近編碼器的 3 顆螺絲。將導線從 S1 背面引出。
- 將編碼器導線從 S1 背面引出,穿過兩顆馬達之間。
- 裝入 S1 馬達軸承座。
- 在每根 S1 馬達軸上裝一個 15 齒齒輪,止付螺絲較靠近馬達底部。
- 用四顆 M4 螺絲安裝 hub gear。
- 用兩顆 M3 螺絲安裝 S1 馬達蓋。
- 其餘組裝留待後續步驟。
5.6 組裝 S2
以六顆 M3x08 螺絲將 S2 馬達穿過 S2 短件與長件固定,加上 15 齒齒輪,再以四顆 M4 螺絲裝上輪轂齒輪。
- 將 S2 馬達穿過 S2 short 與 S2 long 兩件安裝。用 6 顆 M3x08 螺絲連接。
- 將 15 齒齒輪裝到 S2 馬達軸上,止付螺絲離馬達較遠。
- 用 4x M4 螺絲安裝 hub gear。
- 其餘組裝留待後續步驟。
5.7 組裝 S3
以 M4x60 螺絲組裝彈簧腳趾,再以兩顆 M4x30 與兩顆 M4x35 螺絲合上 S3。
- 將 hub gear 與 S3 gear mount 一起安裝。
- 用 M4x60 螺絲將彈簧、彈簧對位件與腳尖組合在一起。
- 將腳尖組件放入 S3。
- 可選擇加裝腳尖距離用的飛行時間感測器。這是實驗性元件:原專案表示在撰寫時,該感測器尚未在軟體中完整實作。
- 用四顆 M4 螺絲封閉組件(兩顆 M4x30、兩顆 M4x35)。
- 其餘組裝留待後續步驟。
5.8 將 S1、S2 與 S3 組成一條腿
將 S1、S2 與 S3 組件壓合在一起,並以三顆 M4 螺絲鎖定。
- 將 S2 的軸承連接件插入 S1,把 S2 gear side 裝到 S1 上。
- 裝上 S2 馬達軸承安裝座與 S1 馬達齒輪座,將 S2 gear side 與 S1 鎖在一起。
- 用 3 顆 M4 螺絲連接 S2 bearing side 與 S2 馬達組件。
- 將 S1/S2 gear side 組件、S3 組件與 S2 加馬達組件夾合在一起。它們應全部壓入配合,並用 3 顆 M4 螺絲鎖定。
- 腿部組件完成。六條腿都重複相同步驟;下一步會將腿部裝到 S0 與底座上。
5.9 準備並組裝底座
裝上腿部 PCB、S0、繼電器與 PCB 安裝座、HDMI 與 USB 接頭、下底座、腿部、Raspberry Pi 與上底座。
- 依照 Fusion360 組件裝上所有 M3 與 M4 熱熔螺帽。將所有軸承壓入 leg flat,並在每個 leg flat 裝上 S1 軸承座。
- 將六片腿部 PCB 分別裝到六足機器人底座的各側。
- 用 leg flat 上的 2-4 顆 M4 螺絲裝上 S0。
- 安裝繼電器、PCB 座與 PCB 護蓋。原專案的機械頁面指向其電子頁面說明這些零件,但該頁面並沒有描述,因此請參考 Fusion360 組件。
- 將 HDMI 接頭與 USB 接頭裝到 base lower 上。
- 用 M4 螺絲裝上 base lower。長 M3 螺絲應穿過 base lower 鎖入 S0 的連接處。
- 小心地將腿部組件裝入六足機器人的各側,讓每條腿的 S1 hub gear 與 S0 從動齒輪嚙合(若齒輪對位不清楚,請參考 CAD),並注意對齊 base upper 與 base lower 上的 3 顆 M3 螺絲。
- 安裝 Raspberry Pi,並將電源開關接線到 base upper 上。將 base upper 裝到定位。
- 原專案表示,此時組裝即告完成,六條腿都可以進行校正。
6. 即時韌體與校正
以 PlatformIO 為每條腿建置並燒錄 Xiao RP2350 韌體,然後校正每條腿。
6.1 安裝工具並開啟韌體專案
安裝 VS Code 與 PlatformIO IDE 擴充功能,並開啟 Hex3 儲存庫中的 real_time/xiao_code。
- 需求:安裝 PlatformIO IDE 擴充功能的 VS Code,以及透過 USB 連接的 Seeed Xiao RP2350。原專案表示函式庫相依項目(RP2040_PWM、PID、RP2040PIO_CAN 與 Adafruit VL6180X 腳尖感測器驅動程式)已在 platformio.ini 中宣告,會自動安裝。
- 韌體位於 Hex3 儲存庫的 real_time/xiao_code;原專案的 Hex3 頁面在其專案詞彙表中連到該儲存庫。韌體頁面沒有提供下載指令。
- 在 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。
- user_config.hpp 因為存放各電路板的設定,刻意不納入 git,因此在韌體能編譯之前,請先建立你自己的副本。
- 將 lib/HexapodController/TEMPLATE_user_config.hpp 複製為 lib/HexapodController/src/user_config.hpp。
- 將 LEG_NUMBER 設為這塊電路板所裝的腿(0 到 5)。每條腿的值都必須唯一。它也會設定電路板的 CAN 節點 ID:來自 Pi 的指令為 0x100 + LEG_NUMBER,回覆為 0x180 + LEG_NUMBER,Pi 的 can ROS2 節點就是以此定址每條腿。
- 設定 LOG_LEVEL 與 TELEMETRY_LOGGING_SPACE,決定除錯時要輸出多少序列遙測資料。
- 在 lib/HexapodController/src/config.hpp 中為這條腿新增或選擇一個 #ifdef <YOUR_NAME> ... #endif 校正區塊,並用下方的校正步驟產生 ZERO_POINTS 的值。
- 若你使用 V3.2 腿部 PCB,請在上傳前完成 PCB 組裝階段所述的 leg.cpp 修改。
6.3 建置並上傳韌體
以 seeed_xiao_rp2350 環境建置並上傳,再以 115200 baud 的序列埠監控視窗確認板子已開機。
- 在 PlatformIO 中選擇 seeed_xiao_rp2350 環境後,執行 build 編譯韌體。
- 在 Xiao 透過 USB 連接時上傳。
- 以 115200 baud 開啟 PlatformIO Serial Monitor,確認電路板能開機,並印出其 CAN tx/rx 節點 ID,以及關節位置、速度與加速度遙測資料。
6.4 校正每條腿
將 ZERO_POINTS 設為 0.0,在六足機器人關閉時將腿保持在校正姿勢,從序列埠監控視窗讀取關節位置,並為該腿輸入這些數值。
- 在 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。
- 校正時,將設定值與校正偏移量都設為 0.0,使每個項目都寫成 0.0 + 0.0。
- 關閉六足機器人,將腿移到校正位置,並將 Xiao RP2350 插到主板上。校正位置為:S1 與六足機器人的側板平行;S2 盡量往下,通往 S1 的 3 條導線平貼排列(S1 與 S2 之間的距離正好是 1 條導線的直徑);S3 盡量往上(S2 與 S3 之間的距離正好是 1 條導線的直徑)。原專案的校正說明圖片顯示了這個姿勢。
- 上傳 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}
- 將程式碼加到你正在校正的腿。例如 Leg0 的 ZERO_POINTS 第一列變為 0.547631 + CALIBRATION_OFFSET_A0、-0.836020 + CALIBRATION_OFFSET_A1、2.787243 + CALIBRATION_OFFSET_A2,其他五列維持 0.0 + 0.0。
- 將程式碼上傳到該腿,並確認它處於站立姿勢。在 user_config.hpp 中確認你設定了正確的 LEG_NUMBER。
- 全部 6 條腿都重複相同步驟。
7. Raspberry Pi 設定
燒錄 Raspberry Pi OS、安裝 Docker、啟用 CAN 介面、配對手把,並建置 ROS2 容器。
7.1 燒錄 SD 卡
以 Raspberry Pi Imager 將 Raspberry Pi OS(64-bit)燒錄到 64GB 以上的 micro SD 卡。
- 需求:Raspberry Pi 5;micro SD 卡(建議 64GB 以上);micro HDMI 轉 HDMI 線;USB 鍵盤;USB 滑鼠。
- 下載 Raspberry Pi Imager。選擇 Raspberry Pi 5 作為電路板,並選擇 Raspberry Pi OS(64-bit)。選擇你的 micro SD 卡。
- 選擇你的設定。建議:主機名稱 hexapod-<last_name>;使用者 hexapod<last_name>;透過驗證啟用 SSH。
- 點選儲存並等待。燒錄完成後,將記憶卡插入 Pi 並接上周邊裝置。
7.2 安裝 Docker
以 get.docker.com 腳本安裝 Docker,並將你的使用者加入 docker 群組。
- 更新系統:sudo apt update && sudo apt full-upgrade -y
- 下載 Docker 安裝腳本:curl -fsSL https://get.docker.com -o get-docker.sh
- 安裝 Docker:sudo sh get-docker.sh
- 將你的使用者加入 docker 群組:sudo usermod -aG docker $USER
- 登出再登入,或重新開機,讓群組變更生效:sudo reboot
- 確認安裝:docker --version、docker compose version、docker run hello-world
7.3 加入 CAN 設定覆寫
在 /boot/firmware/config.txt 中加入 dtparam=spi=on 與 mcp2515-can0 overlay。
- 開啟設定檔:sudo nano /boot/firmware/config.txt
- 在檔案末尾加入以下幾行:dtparam=spi=on 與 dtoverlay=mcp2515-can0,oscillator=16000000,interrupt=25
7.4 設定 CAN 介面服務
安裝 can-utils,並建立一個 canbus.service systemd 單元,以 500000 bit/s 啟用 can0。
- 安裝 can-utils:sudo apt install can-utils
- 用以下指令取得 ip 的路徑:which ip。原專案的範例結果為 /usr/sbin/ip。
- 建立 /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。請使用上一個指令得到的路徑。
- 啟動服務:sudo systemctl start canbus.service
7.5 配對 Xbox 控制器
透過 Raspberry Pi OS 的藍牙介面或終端機配對 Xbox Core 控制器。
- 使用 Raspberry Pi OS 的藍牙介面或終端機連接 Xbox Core(Series S、X 等)控制器。
7.6 設定機器人名稱並建置 ROS2 節點
將六足機器人的名稱寫入 robot_name.local.txt,為它指定不重複的 ROS_DOMAIN_ID,並在 dev container 中執行 colcon build。
- Pi 與 ROS2 程式碼位於 Hex3 儲存庫的 non_real_time 資料夾,原專案的 Hex3 頁面有連結。Raspberry Pi 頁面沒有提供下載指令。
- 開啟 non_real_time/container/src/ros2_ws/src/hexapod_manager/config/robot_name.local.txt,加入你的六足機器人名稱。這應該是檔案中唯一的文字。
- 確認 non_real_time/container/src/ros2_ws/src/hexapod_manager/launch/hexapod.launch.py 中有此機器人名稱,並設有唯一的 ROS_DOMAIN_ID。
- 在 non_real_time/container 中,用 ./init_dev.sh 初始化開發容器,用 ./new_dev_shell.sh 開啟新的 shell,然後用 colcon build 編譯 ROS2 節點。
- 下次重新啟動 Pi 時,變更就會生效。若想更早測試,也可以執行:docker compose -f docker-compose-prod.yml up
7.7 啟動行走軟體堆疊
先讓六足機器人通電、Pi 開機並連接控制器,再在 dev container 中啟動 hexapod.launch.py。
- 如電子階段所述,先開啟六足機器人的電源,再啟動 Pi 5。
- 啟動之前,先打開 Xbox 控制器並透過藍牙將它連到 Pi。
- 在開發容器內執行:ros2 launch hexapod_manager hexapod.launch.py。這會一次啟動 control、joy、inverse_kinematics、can_interface 與 tripod_gait,是原專案啟動六足機器人、以 Xbox 控制行走的標準方式。
- 選用:ros2 run hexapod_manager led_controller 會驅動六足機器人底部的 LED 環。ros2 run hexapod_tester hexapod_tester 可在沒有控制器的情況下掃描機身姿態與足端目標,此時 launch 檔要在另一個 shell 中執行。
- 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