Open Source Robotics

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

Open Duck Mini V2 組裝指南

受 Disney BDX 機器人啟發、可自行 3D 列印並打造的開源迷你鴨子機器人

授權條款

Apache-2.0

組裝指南

1. 準備與馬達設定

為所有 Feetech STS3215 伺服馬達設定正確的 ID、裝上伺服機擺臂,並 3D 列印所有需要的 PLA 與 TPU 零件。

1.1 設定所有伺服機

使用 Open Duck Mini Runtime 的 configure_motor.py 腳本,將 14 顆 STS3215 伺服機各設為正確的 ID(左腿:20-24、右腿:10-14、頭部/頸部:30-33),並將它們移到零點位置。

  1. 從 GitHub(github.com/apirrone/Open_Duck_Mini_Runtime)下載並安裝 Open Duck Mini Runtime。
  2. 透過 USB 一次一顆地將每顆 Feetech STS3215 伺服機接到伺服機驅動板。
  3. 對每顆伺服機執行馬達設定腳本:python configure_motor.py --id <ID>。組裝前,每顆伺服機都必須指定唯一的 ID。
  4. 將左腿伺服機設定為以下 ID:hip_yaw=20、hip_roll=21、hip_pitch=22、knee=23、ankle=24。
  5. 將右腿伺服機設定為以下 ID:hip_yaw=10、hip_roll=11、hip_pitch=12、knee=13、ankle=14。
  6. 將頭部/頸部伺服機設定為以下 ID:neck_pitch=30、head_pitch=31、head_yaw=32、head_roll=33。
  7. 用膠帶或麥克筆在每顆設定好的伺服機上標示其 ID 編號,避免組裝時混淆。

1.2 安裝伺服機舵盤

在每顆馬達都位於零點位置時,小心對齊並將舵盤(palonnier)裝到輸出軸上。在零點位置正確對齊,對關節角度是否正確至關重要。

  1. 用隨附的五金將合適的伺服機舵盤裝到每顆 STS3215 伺服機上。
  2. 裝上舵盤之前,確認每顆伺服機都在其零點/中心位置。零點位置對關節正確對位至關重要。
  3. 在每顆馬達上確實鎖緊伺服機舵盤的中心螺絲。

1.3 3D 列印所有零件

以 PLA 列印全部 35 個以上的零件(建議 15% 填充),腳底以 TPU 列印(40% 填充)。用溫度合適的烙鐵,在所有指定孔位裝入 M3 熱熔螺帽。

  1. 從 GitHub 上的 Open Duck Mini V2 列印目錄下載所有 STL 檔案。
  2. 以標準設定、15% 填充列印所有 PLA 零件。
  3. 以 TPU 線材、40% 填充列印 foot_bottom_tpu.stl 零件(x2),讓腳底具備抓地力與彈性。
  4. 對稱零件列印 x2:foot_top、foot_side、foot_bottom_pla、foot_bottom_tpu、roll_motor_bottom、roll_motor_top。
  5. 以下零件列印 x4:knee_to_ankle_left_sheet、knee_to_ankle_right_sheet、leg_spacer。
  6. 其餘所有機身、頭部、軀幹與配件零件列印 x1(約 24 種不同零件)。
  7. 移除支撐並修平邊緣,清理所有列印件。

2. 腿部組裝

由下往上組裝兩條腿:附接觸開關的腳掌、小腿、大腿,以及正確安裝軸承的髖部組件。

2.1 組裝腳部

將 foot_bottom_tpu 與 foot_bottom_pla 組合,在 foot_top 中安裝腳踝伺服機,加上用於偵測觸地的腳部接觸開關,並以 M3x6 螺絲固定。

  1. 在每隻腳上將 foot_bottom_tpu 組裝到 foot_bottom_pla 上。
  2. 用烙鐵將 M3 熱熔螺帽裝入 foot_bottom_pla 上的指定孔中。
  3. 每隻腳用 2x M3x6 螺絲將 foot_bottom_pla 固定到 foot_top。
  4. 在 foot_top 中再裝入 M3 熱熔螺帽,用於安裝馬達。
  5. 將腳踝伺服馬達裝到 foot_top 上,驅動側朝外。
  6. 將腳部接觸開關壓入每隻腳上的槽位。這些開關偵測觸地,提供平衡回饋。
  7. 將腳部開關導線與伺服機線沿腿部走線槽往上佈線。
  8. 為第二隻腳重複整個流程,兩隻腳完全相同。

2.2 組裝小腿

以 M3 熱熔螺帽安裝 leg_spacer,將腳踝馬達纜線從側板間穿過,再用 4 片側板鎖合小腿子組件。

  1. 在每個 leg_spacer 中裝入 4 顆 M3 熱熔螺帽(兩側)。
  2. 將腳部組件的馬達線穿過 right_sheet 零件。
  3. 將 leg_spacer 夾在左右兩片 sheet 零件(knee_to_ankle_left_sheet 與 knee_to_ankle_right_sheet)之間。
  4. 用 M3x10 螺絲穿過 sheet 鎖入間隔件的熱熔螺帽,固定小腿組件。
  5. 將膝部伺服機裝在小腿組件頂端。
  6. 為第二個小腿組件重複相同步驟。

2.3 組裝大腿

組裝方式與小腿相同,但要以正確的零點方向安裝 hip_pitch 伺服機。確認纜線走線不會干涉關節動作。

  1. 以與小腿組件相同的方式,用 sheet 與間隔件組裝大腿。
  2. 以零點位置的正確方向安裝 hip_pitch 伺服馬達。請特別注意,位置錯誤會影響行走步態。
  3. 透過膝部伺服機舵盤將大腿子組件接到小腿頂端。
  4. 為第二個大腿組件重複相同步驟。

2.4 組裝髖部

安裝 roll_to_pitch 轉接件,以 roll_motor_top 安裝 hip_yaw 伺服機,裝上 hip_roll 支架,並連接整個腿部子組件。兩條腿以鏡像配置重複此步驟。

  1. 將 left_roll_to_pitch(或 right_roll_to_pitch)裝到 hip_roll 伺服機上。這兩個零件互為鏡像,每條腿要使用正確的那一側。
  2. 將 roll_motor_top 裝到 hip_yaw 伺服機上,從底部鎖入螺絲。
  3. 裝上 hip_roll 零件,完成髖關節組件。
  4. 將完成的腿部子組件裝入髖部機構。
  5. 用伺服機套件隨附的塑膠螺絲固定。
  6. 為第二條腿重複整個髖部組裝流程。
  7. 在所有金屬對金屬的螺絲接合處塗上 Loctite Threadlocker Blue 243。鎖入塑膠的螺絲不要使用螺絲固定劑。

3. 主幹與軀幹組裝

以軸承與熱熔螺帽組裝中央主幹結構,裝上兩組已完成的腿部組件,再安裝機身面板。

3.1 組裝軀幹

在 trunk_bottom 中放入軸承,裝入 M3 熱熔螺帽,以 M3x10 螺絲裝上 trunk_top,並以塑膠伺服機螺絲安裝中間的滾轉馬達。

  1. 將軸承壓入 trunk_bottom 上的軸承孔。
  2. 將 M3 熱熔螺帽裝入 trunk_bottom 底部的軸承孔與 4 個安裝孔。
  3. 將 trunk_top 放到 trunk_bottom 上,並用 2x M3x10 螺絲固定。
  4. 用伺服機套件的塑膠螺絲安裝中間馬達(軀幹旋轉)。
  5. 將 roll_motor_bottom 零件裝入軀幹組件。

3.2 安裝兩組腿部組件

用 roll_motor_bottom 連接件,將完成的左右腿組件裝到軀幹上。在金屬對金屬的螺絲連接處塗上 Loctite 螺絲膠。

  1. 將左腿髖部組件裝到軀幹左側。
  2. 利用 roll_motor_bottom 的安裝點將 hip_yaw 伺服機固定到軀幹中。
  3. 將所有左腿伺服機線穿過軀幹的走線槽。
  4. 在軀幹右側為右腿組件重複相同步驟。
  5. 確認兩條腿都能自由走完整個活動範圍,不受線材干擾。

3.3 安裝機身面板

安裝 body_middle_bottom、body_middle_top 與 body_front 面板。在機身面板之間安裝電池組座。

  1. 將 body_middle_bottom 鎖到軀幹框架上。
  2. 在 body_middle_bottom 與 body_middle_top 中都裝入 M3 熱熔螺帽。
  3. 將 body_middle_top 裝到組件上。請在完成頭部之前裝入,以免之後還要拆開。
  4. 將 body_front 面板裝到機器人前方。
  5. 裝上 body_back 面板,完成軀幹外殼。

4. 頭頸部組裝

組裝頸部機構與頭部俯仰/偏航/滾轉組件,並安裝頭部元件,包括 Raspberry Pi Zero 2W 與天線馬達。

4.1 組裝頸部

以頸部俯仰伺服機連接 neck_left_sheet 與 neck_right_sheet。確認纜線走線正確,避免干涉。

  1. 將 neck_left_sheet 與 neck_right_sheet 裝到 neck_pitch 伺服機上。
  2. 將頸部組件裝到軀幹框架頂端。
  3. 確認頸部伺服機線在機身內佈線整齊。

4.2 組裝頭部機構

安裝 head_pitch_to_yaw 轉接件,再裝上 head_yaw_to_roll 與 head_roll_mount,組成 3 自由度的頭部雲台機構。

  1. 將 head_pitch_to_yaw 裝到頸部組件的輸出端。
  2. 裝上 head_yaw 伺服機與 head_yaw_to_roll 零件。
  3. 將 head_roll_mount 裝到 head_roll 伺服機上,完成 3 自由度頭部機構。
  4. 確認頭部可以俯仰、偏航與滾轉,沒有卡滯或線材干擾。

4.3 安裝頭部元件

在頭殼內安裝 Raspberry Pi Zero 2W、天線耳朵伺服機(SG90)、攝影機、喇叭與 LED。將組好的頭部裝到雲台機構上。

  1. 在頭殼的所有安裝孔中裝入 M3 熱熔螺帽。
  2. 壓入頭部旋轉用的軸承。
  3. 安裝兩顆 SG90 微型伺服機,用於天線耳朵的動作。
  4. 將 left_antenna_holder 與 right_antenna_holder 裝到 SG90 伺服機上。
  5. 用 M3 螺絲將 Raspberry Pi Zero 2W 裝在頭部內。
  6. 將眼睛照明用的 LED 裝入 left_eye 與 right_eye 零件。
  7. 用 speaker_interface 與 speaker_stand 安裝 MAX98357A 擴大機與小喇叭。
  8. 將完成的頭殼裝到頭部機構上。
  9. 將頭部接到頸部組件。

5. 電子元件與配線

安裝電池組、伺服機驅動板、BNO055 慣性量測單元(IMU),將所有伺服機接上串列匯流排,並連接感測器與周邊裝置。

5.1 組裝電池組

將兩顆電壓相符的 18650 電芯放入電池座,經由 2S BMS 連接,並接上電源開關與 USB-C 充電模組。

  1. 將兩顆 18650 鋰離子電池裝入 2S 電池座。裝入前確認兩顆電池都充到相同電壓。
  2. 將 2S BMS(電池管理系統)接到電池座。
  3. 將 USB-C 充電模組接到 BMS,提供充電功能。
  4. 將電源開關串接在電池正極導線上。
  5. 將完成的電池組放入 battery_pack_lid 外殼。
  6. 將電池組裝在機身內部空間中。

5.2 伺服機匯流排配線

以菊鏈方式將全部 14 顆 STS3215 伺服機接到 Feetech SCServo 控制板。將控制板安裝在軀幹中。

  1. 將 Feetech 伺服機控制板裝在機身內。
  2. 將所有 STS3215 伺服機線以菊鏈方式接到伺服機控制板。STS3215 伺服機使用串列匯流排。
  3. 透過 USB 將伺服機控制板接到 Raspberry Pi。
  4. 將兩顆 SG90 天線伺服機接到 Raspberry Pi 的 GPIO 腳位。

5.3 連接感測器與周邊

將 BNO055 IMU(I2C:SDA 接 GPIO2、SCL 接 GPIO3)、腳部開關(GPIO22、GPIO27)、LED(GPIO23-25)、天線伺服機(GPIO12-13 PWM)與 MAX98357A 放大器接到 Raspberry Pi 的 GPIO 排針。

  1. 將 BNO055 慣性量測單元(IMU)感測器裝在機身內。IMU 可以任意方向安裝,軟體能夠補償,但以自然方向為佳。
  2. 將 BNO055 接到 Raspberry Pi 的 I2C 匯流排(SDA 與 SCL 腳位)。
  3. 將腳部接觸開關接到 Raspberry Pi 的 GPIO 腳位。正確的腳位分配請參考配線圖。
  4. 將眼睛 LED 接到各自指定的 GPIO 腳位。
  5. 將 MAX98357A I2S 擴大機接到 Raspberry Pi 的 I2S 腳位。

5.4 安裝穩壓器

將 UBEC 從電池接到 Raspberry Pi 的 5V 輸入。第一次通電前,先用三用電錶確認所有電壓。

  1. 將 5V UBEC 穩壓器接到電池輸出。
  2. 將 UBEC 的 5V 輸出接到 Raspberry Pi 的 5V 電源輸入。UBEC 將 7.4V 的電池電壓降到 5V。
  3. 將伺服機電源線直接接到電池(7.4V),伺服機不經過 UBEC。
  4. 通電前用三用電錶確認所有電源連接。再次檢查所有連接的極性。
  5. 整理所有配線,並用束線帶或膠帶固定線材,避免干擾活動部件。

6. 軟體設定與校正

燒錄 Raspberry Pi OS、安裝 Open Duck Mini Runtime 軟體、校正伺服機,並載入行走策略進行測試。

6.1 燒錄 Raspberry Pi OS

在 SD 卡上安裝 Raspberry Pi OS Lite,並在 raspi-config 中啟用 I2C、SPI 與 I2S 介面。

  1. 從 Raspberry Pi 官方網站下載 Raspberry Pi OS Lite(64-bit)。
  2. 使用 Raspberry Pi Imager 將作業系統映像檔燒錄到 microSD 卡(16GB 或更大)。
  3. 在 Raspberry Pi Imager 的進階設定中啟用 SSH 並設定 WiFi 帳密。
  4. 將 microSD 卡插入 Raspberry Pi Zero 2W 並通電。
  5. 以 SSH 登入 Raspberry Pi,確認連線正常。

6.2 安裝 Open Duck Mini Runtime

複製並安裝 Open Duck Mini Runtime 儲存庫(v2 分支)。設定馬達偏移量,以補償舵盤對齊的誤差。

  1. 複製 Open Duck Mini Runtime 儲存庫:git clone https://github.com/apirrone/Open_Duck_Mini_Runtime
  2. 依照 README 說明安裝所需的 Python 相依套件。
  3. 執行伺服機辨識腳本,確認所有馬達都以正確的 ID 回應。
  4. 執行校正程序,設定伺服機的零點位置。校正期間確認機器人處於已知姿勢(雙腿伸直、頭部置中)。

6.3 載入並測試行走策略

下載預先訓練好的 ONNX 行走策略,執行 walk 腳本,確認機器人能保持平衡並踏出第一步。視需要微調馬達偏移量。

  1. 將預先訓練好的行走策略 ONNX 檔複製到 Raspberry Pi。提供了兩個策略:BEST_WALK_ONNX.onnx 與 BEST_WALK_ONNX_2.onnx
  2. 將機器人懸空拿在桌面上方,執行行走策略以確認馬達動作。先在空中測試。
  3. 將機器人放在平坦表面上,執行行走策略。
  4. 若步態看起來不對稱,請在設定中調整伺服機偏移量。
  5. 可選擇使用 Open Duck Playground 模擬器(github.com/apirrone/Open_Duck_Playground)訓練自訂策略。

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