ToddlerBot 組裝指南
用於可擴展策略學習與模擬到現實(sim-to-real)的開源 30 自由度人形機器人平台
授權條款
MIT
組裝指南
1. 原專案公開了什麼,以及需要購買什麼
原專案沒有公開書面的逐步組裝說明:它的方式是逐零件影片、一份 11 頁的圖解手冊、Onshape CAD,以及一份本指南無法讀取的互動式手冊,因此本指南只陳述這些文件以文字提供的內容。
1.1 了解原專案提供哪些資料
原專案的組裝資料包括一系列 YouTube 影片、一份組裝手冊 PDF、一份 Onshape 文件,以及 tnkr.ai 上的互動式手冊。
- 原專案沒有發布書面的逐步組裝文字。組裝頁面為機器人的每個部分提供一支 YouTube 影片(手臂、腿部、攝影機線材、喇叭線材、頭部、腰部、軀幹、馬達 ID 設定、配線、電源板、Jetson 電源線、電源供應器線材、站立測試,以及選配的平行夾爪),另外還有 2.0 概覽影片。
- 組裝手冊是一份 11 頁的 PDF,日期為 2025 年 2 月 6 日。內容包括硬體清單、圖面,以及每個部分的簡短註記。它沒有書面的步驟說明。
- 這份 PDF 是為 ToddlerBot 1.0 製作的。2.0 文件寫道:「我們正在與 tnkr.ai 合作製作互動式組裝手冊。在新的組裝手冊完成之前,請參考 2.0 概覽影片、onshape 文件以及下方現有的資源。」它還寫道:「如果你對任何步驟不確定,請參考組裝影片或 Onshape 文件。」
- PDF 本身表示,腰部連桿的幾何形狀在手冊製作後有更新,但組裝步驟不變。2.0 版也更改了手臂、腿部與骨盆。若你製作的是 2.0,請將 PDF 圖面當作順序與五金零件的參考,並以影片與 Onshape 文件為目前零件的依據。
- 因此本指南只提供原專案以文字說明的內容:零件清單、電路板訂購、列印、PDF 中的五金清單與註記、馬達 ID 與配線鏈、Jetson 設定、電池,以及校正指令。至於零件如何組合,請觀看每個步驟中指名的影片。
- 原專案的零件清單也提供完整組裝好的 ToddlerBot 2.0,售價 4,299 美元,並附有免責聲明:「我們與這家公司沒有任何關係,也不以任何方式背書。我們沒有測試或驗證過該產品。」
1.2 選擇 2XC 或 2XM 版本
ToddlerBot 有 toddlerbot_2xc(建議)與 toddlerbot_2xm 兩種版本,差別在於馬達。
- 原專案寫道:「有兩個版本:toddlerbot_2xc 與 toddlerbot_2xm。toddlerbot_2xc 是建議的預設版本,但如果預算允許,你可以考慮功能更強的 toddlerbot_2xm。」
- 2.0 的變更紀錄表示,toddlerbot_2xc「與 v1.0.0 使用相同的馬達」,toddlerbot_2xm 則「升級了髖部與手臂馬達」。
- 若你已擁有 1.0 機器人,原專案表示:「購買 BOM 中標示醒目顏色的項目。」csv 匯出檔看不到醒目標示,請直接查看試算表本身。
1.3 購買前先核對馬達清單
馬達混用多種 Dynamixel 型號,BOM 中針對 2XC 與 2XM 版本列出不同的數量。
- 機器人有 30 個馬達 ID,在手冊的圖中編號為 0 至 29。這些馬達並非都是同一型號。每個 2X 馬達都是雙軸單元,會顯示兩個 ID。
- 2XC 版本的 BOM 數量:2 x DYNAMIXEL 2XC430-W250-T、6 x DYNAMIXEL 2XL430-W250-T、6 x DYNAMIXEL XC330-T288-T、4 x DYNAMIXEL XC430-T240BB-T、4 x DYNAMIXEL XM430-W210-T、0 x DYNAMIXEL XM430-W350-T、10 x DYNAMIXEL HN11-I101 Set、4 x DYNAMIXEL HN12-I101 Set。
- 2XM 版本的 BOM 數量:6 x DYNAMIXEL 2XC430-W250-T、0 x DYNAMIXEL 2XL430-W250-T、6 x DYNAMIXEL XC330-T288-T、4 x DYNAMIXEL XC430-T240BB-T、4 x DYNAMIXEL XM430-W210-T、4 x DYNAMIXEL XM430-W350-T、8 x DYNAMIXEL HN11-I101 Set、6 x DYNAMIXEL HN12-I101 Set。
- 選配的平行夾爪需要再加 2 個 DYNAMIXEL XC330-T288-T。
- BOM 將 Jetson 列為「Jetson Orin NX 16G」,並註明「預算有限時可改用 Jetson Orin Nano」。
1.4 開始前先閱讀手冊的規則
手冊第一頁訂定了清點五金件、螺絲長度、起子尺寸與螺絲膠的規則。
- 將所有五金零件分類、清點,並分格存放。完成後檢查是否有剩餘零件,這是確認組裝完整的一種方法。
- 開始之前,先閱讀每個步驟中以星號標示的註記。
- 若關節感覺卡住,很可能是螺絲太長。請檢查螺絲長度。避免過度用力:將螺絲稍微鬆開,再試一次。
- 具體細節一律參閱手冊,不要憑記憶。若有疑問,請先觀看影片再繼續。
- 大部分工作請使用電動起子。所有十字頭螺絲都使用 PH1 尺寸的起子。有些步驟需要事先焊接。
- 以黃色標示的螺絲建議使用螺絲固定劑。這不是必要的,但能明顯降低螺絲鬆脫的機率。需要螺絲固定劑的螺絲總計約 100 顆。手冊要求盡可能使用 Vibra-TITE VC-3 Threadlocker。BOM 也列出 M2*6 預塗膠螺絲,並註明建議將所有使用此類螺絲的位置都換成預塗膠螺絲,否則就必須使用螺絲固定劑。
- 關於 Dynamixel 惰輪組 HN11-i101 與 HN12-i101,手冊表示請參考 Dynamixel 官方網站的安裝說明。
- Getting Started 還表示,M3 與 M4 螺絲使用扭力較大的電動起子,M2 螺絲則使用扭力較小的。
1.5 訂購零件,先訂電路板
依 BOM 訂購,先買必要零件,並及早下電路板的訂單。
- 原專案表示,BOM「包含製作 Toddlerbot 所需的所有零件」,若你在採購任何零件時遇到困難或發現缺漏,請開一個 GitHub issue。
- 原專案建議先購買必備品那一區,以防計畫需要變更。BOM 不包含 PCB 檔案。
- 先訂購 PCB。PCB 從下單到送達通常需要約 10 天。PCB 只在組裝的最後一步才需要,因此其他零件到貨後就可以開始列印與組裝。
- 可以的話請使用 Bambu Lab 3D 印表機:原專案表示它們價格實惠,並能在零件公差方面省下時間與麻煩。
2. 訂購電路板
8 通道 TTL 電源與通訊板(TTLPowerBoardV8)由 JLC PCB 依原專案的檔案組裝,因此你只需下單,不必自己焊接電路板。
2.1 上傳電路板檔案
將 TTLPowerBoardV8.zip 拖放到 JLC PCB 的訂購頁面,訂購選項保持不變。
- 原專案建議使用 Chrome 下單,因為 Safari 有時會出問題。
- 登入 JLC PCB,並放入 PCB ZIP 檔 TTLPowerBoardV8.zip。
- 原專案寫道:「PCB 訂單選項中不需要更改任何設定。」你可以更改顏色。若不想在 PCB 上印訂單編號,可以移除該標記。
2.2 選擇組裝選項
選擇 Standard PCBA、雙面組裝、5 片。
- 依原專案圖片所示選擇組裝選項:Standard PCBA、兩面組裝,並訂購 5 pcs,以便有一些備品。
- 原專案表示,預算有限時可以訂 2 pcs,但最終價格差異不大,因為大部分是設定費用。
2.3 上傳 BOM 與貼片位置檔
組裝 BOM 與 CPL 上傳分別使用 bom_v8.csv 與 positions_v8.csv。
- 出現提示時,上傳 BOM 檔案(bom.csv,在儲存庫中為 bom_v8.csv)與 CPL 檔案(positions.csv,在儲存庫中為 positions_v8.csv)。兩者也都包含在 ZIP 檔中。
2.4 確認每個零件及其貼片位置
在 Select 欄中勾選每個零件,並以原專案列出的料號替換任何缺貨的零件。
- 原專案警告:「務必勾選 Seelct 欄中的所有零件。」未勾選的零件不會被組裝。
- 若零件缺貨,請選擇類似的零件。原專案的例子:JST EH 插頭可改用 C160259;2x06P 排母常見的替代品是 C2902689;端子台可使用任何 2 pin、5mm 間距的端子台,例如 C5188440(在 JLC 上搜尋「terminal block 5mm」)。
- 接著零件在板子上的位置必須與原專案的正面與背面配置圖完全一致。若不一致,請修正,使所有零件都放置正確。
2.5 完成訂單
確認價格並付款。
- 原專案指出,價格可能因關稅而與其圖片中的價格相差很多。
- 完成訂單。你會看到最終價格,然後可以進行付款。
3. 3D 列印
以原專案的 MakerWorld 列印盤列印零件,最好使用 Bambu Lab 印表機。
3.1 以 MakerWorld 的列印盤列印零件
原專案為 Bambu Lab 印表機提供已切片的列印盤,並為其他印表機提供 3MF 檔案。
- 原專案表示強烈推薦 Bambu Lab 印表機。Bambu Lab 使用者可以直接將已切片的列印板送出列印。
- 其他印表機請從 MakerWorld release 下載 3MF 檔案,檢查每個零件的列印方向與設定檔。原專案表示,正確的方向與設定檔對列印件的強度與耐用度至關重要。
- 在 Bambu X1C 上,每個列印板約需 10 小時。若使用較慢的印表機,請考慮將列印板拆成較小的批次,以提高成功率。
- 若需要自訂修改或單一零件,CAD 檔案在 Onshape 文件中。
- 開始組裝每個列印件之前,先去除其支撐材(手冊在每一頁組裝頁面都這樣寫)。
- 在參閱的文件中,原專案沒有說明整個機器人的填充率、層高或列印時間。BOM 列出的材料為 2 x PLA-CF 1KG 與 1 x PLA 1KG。
- 反覆鎖上與鬆開螺絲可能讓列印的孔滑牙;原專案表示,只要重新列印該零件即可。至於腰部齒輪,原專案表示使用 PLA-CF 並增加牆層數可以延長其壽命。
4. 手臂
組裝兩支相同的手臂(手冊中每支 6 個步驟),從這裡開始,因為原專案說手臂是最簡單的部分。
4.1 組裝第一支手臂
每支手臂使用 3 x 2XL430、1 x XC430 與 3 組 HN11-I101,以及手冊中列出的扣件與軸承。
- 原專案的組裝順序是手臂,接著腿部,然後頭部、腰部與軀幹直到軀幹步驟 8,接著 Jetson 設定,最後是 PCB 與電池。它表示先從手臂開始,因為手臂最簡單,也是很好的練習。
- 觀看手臂組裝影片(YouTube 4s4Mopyyyr4),並依照手冊第 2 頁「Arm assembly in 6 steps」操作。
- 手冊列出的五金零件:軸承 axk0414(2)、軸承 684(4)、M2 螺帽(7)、M2 墊圈(12)、M2x4(8)、M2x6(12)以及另外的 M2x6(未印出數量)、M2x8(18)、M2.5x10(8)、M3x8 螺柱(4)、M3x10 螺柱(8)、M4 螺帽(3)、M4x8(2)、M4x20(*2)。
- 列出的其他零件:2XL430(3)、XC430(1)、HN11-I101 set(3)。在手冊的黃色標示中,M2x4(8)、M2x6(12)與 M4x20(2)標示為需使用螺絲固定劑。
- 手冊中的註記:將 M4 螺帽放在板子下方;有一個子步驟要重複 3 次;確認螺柱與表面齊平或略低於表面(教學中所有螺柱都一樣);有一個齒輪看影片比較容易組裝;先插上惰輪那一側的線。
- 開始之前,先去除列印件上的支撐材。
4.2 組裝第二支手臂
左右手臂完全相同,因此重複第一支手臂的步驟即可。
- 手冊寫道:「左右兩支手臂完全相同!」請用相同的零件與註記製作第二支手臂。
5. 腿部
組裝左腿(手冊中 9 個步驟),再以鏡像方式組裝右腿。
5.1 備齊腿部零件並閱讀注意事項
每條腿使用 2 x XM430、1 x XC430、1 x 2XC430、1 x XC330、2 組 HN11-I101 與 1 組 HN12-I101。
- 觀看腿部組裝影片(YouTube xGX_YkVmZvQ),並依照手冊第 3 至 5 頁「Leg assembly in 9 steps」操作。
- 手冊列出的五金零件:軸承 axk0414(3)、軸承 683(4)、軸承 684(1)、XM430 附的 M2.5x4(14)、M2x4(4)、M2x6(20)+ M2x6(8)、M2x10(4)、M2 墊圈(16)、XC430 附的 M2.5x5 自攻螺絲(8)、M3x6(2)、M3x8(2)、M3x10(2)、M3x10 螺柱(4)、M3x12 平頭(3)、M4x25(1)、M4x30(1)、M4 螺帽(2)、M4 墊圈(*1)。
- 列出的其他零件:XM430(2)、XC430(1)、2XC430(1)、XC330(1)、HN11-I101 set(2)、HN12-I101 set(1)。
- 手冊指出,Dynamixel 隨附的螺絲袋中 M2 與 M2.5 螺絲是混在一起的。若螺絲不夠,可以略過標示為 1 的虛線項目。
- 手冊中的腿部圖是左腿。右腿與左腿完全鏡像,第 5 頁的圖顯示所有馬達的方向。
5.2 組裝左腿
依照手冊的九個步驟與注意事項組裝左腿。
- 惰輪包含墊圈與板片。
- 腿部頁面的註記:某些步驟需要內六角扳手;步驟 1 的螺絲請使用較有力的起子或內六角扳手,並確認其接合的兩個零件之間沒有可見的縫隙;步驟 5 需要扳手或鉗子。
- 左髖滾轉的 2XC430,致動側朝後放置。右髖滾轉的則朝前放置。
- 注意 XC330 的方向。
5.3 以鏡像方式組裝右腿
將右腿組裝為左腿的鏡像,髖部滾轉的 2XC430 朝前。
- 手冊寫道:「右腿請鏡像。」所有馬達的方向請參考第 5 頁的圖。
- 2.0 的變更紀錄列出了腿部的變更(縮短 30mm、簡化膝部、以軸承為基礎的馬達惰輪、髖部馬達可選 2XC430 或 2XM430-W350)。PDF 的腿部頁面來自 1.0,因此 2.0 的腿部請查看腿部影片與 Onshape 文件。
6. 頭部、攝影機纜線與喇叭纜線
以 2 顆魚眼攝影機、喇叭與 1 x XC330 組裝頭部(手冊中 5 個步驟)。
6.1 組裝頭部
頭部使用 1 x XC330、2 台附纜線的魚眼攝影機、一個附 1.5 英尺 USB-A 轉 micro USB 纜線的喇叭,以及 2 條 Dynamixel 纜線。
- 觀看頭部組裝影片(YouTube FU-npUvBt00)、攝影機線材影片(kzG2ModXqfc)與喇叭線材影片(lukhqvumUzQ)。依照手冊第 6 頁「Head Assembly in 5 steps」操作。
- 手冊列出的五金零件:軸承 683(4)、軸承 684(1)、M2x6(4)、XC330 附的 M2x8(4)自攻螺絲、M2.5x6(8)、M3x4(1)、M3x6(10)、M3x10(3)、M3x10 螺柱(*1)。
- 列出的其他零件:附線材的魚眼攝影機(2)、附 1.5 英尺 USB-A 轉 micro USB 線的喇叭(1)、雙面膠帶、XC330(1)、Dynamixel 線(2)。
- 在手冊標示的步驟之後,插上兩側馬達的線。在攝影機步驟之後,插上攝影機的線。
- 將麥克風放入外殼之前,先插上它的線。PCB 上的 micro USB 埠很脆弱、容易斷,請格外小心。
7. 腰部
以 2 x XC330 與 2 x HN11-I101 組件組裝腰部(手冊中 4 個步驟);需要先完成 2 條腿。
7.1 組裝腰部
腰部使用 2 x XC330、2 組 HN11-I101、軸承、M2 與 M4 扣件,以及 2 條組裝完成的腿。
- 觀看腰部組裝影片(YouTube oJEtc8Vn6mM),並依照手冊第 7 頁「Waist assembly in 4 steps」操作。你需要 2 條完整組裝好的腿。
- 手冊列出的五金零件:軸承 axk0414(4)、軸承 684(2)、M2x6(16)、M2x10(8)、M2 墊圈(16)、M4x55(1)、M4 螺帽(*1)。黃色標示的螺絲建議使用螺絲固定劑。
- 列出的其他零件:XC330(2)、HN11-I101 set(2)。
- 若步驟 1 中有東西很難取下,請試著突然用力一下,或觀看影片。確認那顆螺絲已鎖緊。
- 確認馬達方向與圖相符。腰部連桿必須有彈性才能插入馬達。
- 中間的 8 顆螺絲需要用內六角扳手。它們不需要鎖得很緊。
- 你可能會發現一邊放零件一邊鎖螺絲比較容易。
- 手冊表示,腰部連桿的幾何形狀在手冊製作後有更新,但組裝步驟不變。
8. 軀幹,步驟 1 至 6
以 1 x XC330、BNO085 慣性量測單元(IMU)與 Dynamixel 五金組裝軀幹(手冊中 10 個步驟)。
8.1 備齊軀幹零件
軀幹使用 1 x XC330、一顆 IMU BNO085、跳線、Jetson Orin NX、一個 Dynamixel 電源集線器、一個 Dynamixel U2D2 與一條電源線。
- 觀看軀幹組裝影片(YouTube hHZQepIfq6o),並依照手冊第 8 至 10 頁「Torso assembly in 10 steps」操作。
- 手冊列出的五金零件:軸承 axk0414(4)、M2x6(4)、M2x10(4)、M2.5x4(4)、XC430 附的 M2.5x5 自攻螺絲(8)、M2.5x10(3)、M3x4(4)、M3x6 平頭(2)、M3x8 平頭(5)、M3x10(2)、M4x12(1)、M4x20(2)。
- 列出的其他零件:XC330(*1)、IMU BNO085、跳線、Jetson Orin NX、Dynamixel power hub、Dynamixel U2D2、電源線。開始之前,先去除列印件上的支撐材。
- 2.0 的變更紀錄表示,新的通訊板取消了 U2D2。這一頁手冊是為 1.0 製作的,仍然列出它;下面的 ID 步驟也需要它。
8.2 軀幹步驟 1 至 6
軀幹步驟 1 至 6 使用此處列出的扣件與注意事項,圖示在手冊第 8 與 9 頁。
- 步驟 1 使用 M2x6(4)與 M2x10(4)。在此步驟之前,插上兩側馬達的線。
- 步驟 2 使用 M4x20 搭配軸承 axk0414(2)、M4x12 與 M3x10(2)。這部分的步驟 1 需要內六角扳手;握住內六角扳手轉動頸部連桿比較容易。在步驟 3 中將螺絲稍微鬆開,讓轉動順暢。
- 步驟 3 使用 M2.5x4(4)與 M3x6 平頭(2)。在此步驟之前,插上 IMU 的線。這條線是 4 條用膠帶綁在一起的跳線。針腳對應見手冊第 8 頁的圖(使用 Jetson 40-pin 排針與 Adafruit BNO085 的針腳配置);範例請看影片。
- 步驟 4 使用 M3x4(4)與 M3x8 平頭(3)。
- 步驟 5 使用 M3x8 平頭(2)、軸承 axk0414(2)與 M4x20(*1)。第三個標示的項目 M4x20 需要內六角扳手。手冊寫道:「確認這顆螺絲牢牢鎖緊,因為它很可能是整個組裝中最關鍵的一顆螺絲。」
- 步驟 6 使用 XC430 附的 M2.5x5 自攻螺絲(*8)。在此步驟之前,插上 XC430 的線。
9. 設定馬達 ID
使用 Dynamixel Wizard 2.0,以 2M 鮑率一次一顆為每顆馬達設定各自的 ID。
9.1 設定每顆馬達的 ID 與鮑率
每次將一顆馬達連接到 Dynamixel 電源集線器與 U2D2,並在 Dynamixel Wizard 2.0 中設定其 ID。
- 觀看「ID the Motors」影片(YouTube q3mCdYYJPNY),並依照手冊第 9 頁的軀幹步驟 7 操作。
- 一次只為一顆馬達設定 ID,否則 ID 可能會衝突。手冊的圖中 ID 編號為 0 至 29,並顯示機器人上每顆馬達的 ID。
- 將鮑率設為 2M。原專案的提示表示,在目前的通訊配置下,Dynamixel XC330 無法維持 4Mbps,因此所有馬達都使用 2Mbps。
- 2X 馬達會出現兩個 ID。要分辨它們,請移動關節並觀察哪個位置讀數有變化。
- 你需要 Dynamixel power hub、U2D2、一個 12V 電源轉接器,以及一台安裝了 Dynamixel Wizard 2.0 的電腦。確認 power hub 的開關已打開;power hub 的燈就是指示燈。
10. 為馬達配線
依手冊所示的四條串鏈,將馬達串接到通訊板,然後確認 Dynamixel Wizard 能偵測到每顆馬達。
10.1 將馬達串接線路接到主板
依下列串接方式將馬達接到主板(root):root-23-24、25-26、27-28;root-0-1-16-17、18-19、20-21;root-2-5、4-6-7-9-8;root-3-11、10-12-13-15-14。
- 觀看「Power Board」影片(YouTube C4dC8QYalOA)了解如何準備電源板,以及「Wiring」影片(gDMCFXmWQb8)。依照手冊第 10 頁的軀幹步驟 8 操作。
- 手冊標示的鏈為:root-23-24、25-26、27-28;root-0-1-16-17、18-19、20-21;root-2-5、4-6-7-9-8;root-3-11、10-12-13-15-14。數字是馬達 ID。
- root-2 與 root-3 請使用較長的線,搭配 BOM 中的 JST EH 預壓接線與 JST EH 外殼。
- 手冊表示,這種配線並非唯一的做法,但要注意線材如何穿過軀幹上的孔來整理。確認馬達可以不受限制地移動。
- 將線接到電源板時,請依照手冊的插槽配置圖(插槽標示為 root-0、root-2、root-3、root-23 與 U2D2),平衡分配到背面每個降壓轉換器的電流。
- 完成此步驟後,將末端馬達接到 power hub,並在 Dynamixel Wizard 中確認所有馬達都被偵測到。
- 若問題時有時無,請檢查所有配線。原專案的提示描述了一個案例:腳踝附近有一條鬆脫的線,動作時會斷線,讓 Dynamixel Wizard 失去馬達。
- 插槽圖來自 1.0 手冊,上面有 U2D2 插槽。2.0 V8 板被描述為取消 U2D2 的 8 通道板,因此請將 Power Board 影片與你的板子對照。
11. 設置 Jetson Orin NX
在裝進軀幹之前,先燒錄 Jetson Orin NX 16GB,並安裝即時核心與機器人所需的套件。
11.1 暫停以設定 Jetson
手冊在軀幹步驟 8 之後暫停,直到 Jetson 設定完成。
- 手冊寫道:「重要:該休息一下了!繼續之前,請依照我們文件中的步驟,確認 Jetson 已設定好。」Getting Started 表示,將 Jetson 裝入軀幹之前先完成設定。
- 原專案表示,Jetson 執行 Ubuntu 22.04,並基於成本效益推薦 Jetson Orin NX 16GB。
11.2 燒錄 Jetson
依照 Seeed Studio reComputer J4012 的說明燒錄 JetPack,並為 Orin NX 16GB 選擇 JP6.1 映像檔。
- 依照 Seeed Studio reComputer J4012 頁面燒錄 JetPack。若頁面上的 GIF 不清楚,請參考原專案的照片找出強制復原針腳。
- 點選 JP6.1 分頁,下載適用於 Jetson Orin NX 16GB 的映像檔。原專案表示下載花了大約一小時。強烈建議使用 JetPack 6.1 或更新版本,因為它包含 TensorRT 10.3+;立體深度估計只支援 TensorRT 10+。
- 燒錄後,拔下電源線、USB-C 線與跳線。重新插上電源線、HDMI 線、鍵盤與滑鼠。系統應該會開機。
- 輸入使用者名稱與密碼。將 APP Partition 設為最大容量。不需要安裝 Chromium 瀏覽器。
- 關閉 Jetson 電源,依照原專案的照片安裝 Wi-Fi 網卡。開機並連上 Wi-Fi。
- 以 Ctrl + Alt + T 開啟終端機,執行 ifconfig,記下 IP 位址與主機名稱(例如 toddy@toddy-desktop)。
- 將右上角的電源模式設為 0:MAXN。然後拔下 HDMI 線、鍵盤與滑鼠;之後都使用 SSH。
- Jetson 上的 USB-C 埠僅用於燒錄;無法透過它傳輸資料。
11.3 安裝即時核心
以 SSH 登入並安裝 NVIDIA 的即時核心,然後檢查核心版本。
- 以 SSH 連入 Jetson:ssh [email protected]
- 依照 NVIDIA 的即時核心 OTA 更新說明(Jetson Developer Guide r36.3)操作。原專案發現 nvidia-l4t-rt-kernel 及相關套件的 dpkg 錯誤可以忽略,但若遇到任何問題,請開一個 GitHub issue。
- 重新開機後,檢查 uname -r。應該是 5.15.136-rt-tegra;數字可能不同,但應該要有 -rt-tegra。
11.4 安裝儲存庫與 Python 套件
複製儲存庫、建立 toddlerbot conda 環境,並安裝對應你 JetPack 版本的 torch。
- 複製儲存庫:mkdir ~/projects,接著 cd ~/projects,然後 git clone [email protected]:hshi74/toddlerbot.git
- 安裝 Miniforge(不要用 sudo 執行其安裝腳本;所有選項都回答 yes),然後執行 source ~/.bashrc。
- 建立環境:conda create --name toddlerbot python=3.10,接著 conda activate toddlerbot,然後 pip install -e ".[jetson]"。若 pyaudio 安裝失敗,請執行 sudo apt-get install -y portaudio19-dev python3-dev build-essential 後再安裝一次。
- 從 NVIDIA 為你的 JetPack 版本提供的 wheel 安裝 torch 與 torchvision(原專案使用的是適用於 JetPack 6.1、L4T R36.4、CUDA 12.6 的 PyTorch v2.5.0 wheel)。安裝 torch 時不要安裝 numpy,因為它會帶入 numpy 2.x 並造成衝突。
- 檢查 jax 與 torch 的版本是否相容:python examples/test_jax_torch.py --platform jetson
11.5 安裝主板驅動程式與系統套件
安裝 8 通道通訊板的 ch9344ser 驅動程式、GPIO 與群組設定,以及攝影機與音訊套件。
- 為 8 通道通訊板安裝 ch9344ser 驅動程式:git clone [email protected]:WCHSoftGroup/ch9344ser_linux.git,然後在 ch9344ser_linux/driver/ 中執行 make 與 sudo make install。
- 設定 Jetson.GPIO:sudo groupadd -f -r gpio;sudo usermod -aG gpio $USER;sudo chown root.gpio /dev/gpiochip0;sudo chmod 660 /dev/gpiochip0。接著在啟用 toddlerbot 環境的情況下,將 Jetson GPIO 套件中的 99-gpio.rules 複製到 /etc/udev/rules.d/,並執行 sudo udevadm control --reload-rules && sudo udevadm trigger。
- 為 IMU 與 Dynamixel 馬達將使用者加入 i2c 與 dialout 群組:sudo usermod -aG i2c $USER 與 sudo usermod -aG dialout $USER。重新開機後執行 groups,確認列出 i2c、dialout 與 gpio。
- 魚眼攝影機:sudo apt install v4l-utils ffmpeg。喇叭與麥克風:sudo apt install portaudio19-dev flac。
- 網路時間同步方面,原專案安裝 ntp 與 ntpdate,並將 ntp 指向遠端控制器的位址;若你使用遠端操作或網路記錄,請依照 Jetson Orin 頁面操作。
12. 電池
以 BOM 中的 2000 mAh LiPo 電池,或原專案選配的 DIY 4S 電池組(四顆 21700 電芯)為機器人供電。
12.1 了解原專案對電池的說明
BOM 列出一顆 2000 mAh Lipo Battery,附電壓測試器與平衡充電器;選配的 DIY 電池組為 4S。
- BOM 列出:2000 mAh Lipo Battery(1)、Lipo Battery Voltage Tester(1)與 Lipo Battery Balance Charger(1)。參閱的文件沒有說明這顆原廠電池的電芯數或電壓,購買前請查看其商品資訊。
- 以電池供電運轉機器人時,請使用電壓測試器,以免電池過度放電。原專案將此標示為 IMPORTANT,以防損壞電池。
- 若機器人顯示 'Voltage too low. Please check the power supply or charge the batteries.',請立即停止機器人並檢查電源。
- 原專案表示,DIY 電池組不是必要的,但在相同重量下可提供兩倍的續航力。它適合有焊接與處理電子元件經驗的進階使用者。
- 原專案的 DIY 電池組為:「完成的電池組應具備:4S 配置(標稱 14.8V,充飽 16.8V);主電源輸出使用 XT30 接頭,最大額定放電電流 25A;用於安全充電的 5-pin 平衡接頭。」
12.2 選配:自製 DIY 4S 電池組
DIY 電池組使用 4 x 21700 電芯,裝在 3D 列印支架上的電池座中,另有一個 XT30 接頭與一個 5-pin JST-XH 平衡接頭。
- 安全第一:在通風良好的地方作業,並知道最近的滅火器在哪裡。連接前再次確認極性。絕不可讓電池端子短路。讓電池遠離金屬物品。絕不可用金屬物品撬出電芯;請使用側邊的塑膠拉片。
- 電池或電源端應使用母接頭,以防意外短路,被動端則使用公接頭。正極使用紅線,負極使用黑線。若不確定,請量測電壓。
- 元件:4 x 21700 電池座(或 2 x 2 節電池座)、1 x 3D 列印電池支架、1 x 預焊線材的 XT30 接頭(母)、1 x JST-XH 平衡接頭套件、4 x M3x4 平頭螺絲、電工膠帶或熱縮套管、焊接設備與焊錫。
- 平衡接頭:1 x 黑線(接地)、4 x 黃線(每節電芯的電壓監測各一條)與 1 x 5-pin JST-XH 接頭。
- 將每個電池座的一個極片彎折:正極側 2 個、負極側 2 個,彎 90 度,不要有凸出的邊緣。用 M3x4 平頭螺絲將電池座鎖到支架上,正極側在左上方,負極側在右上方,背面也是相同順序。
- 用一小段 18awg 矽膠線將電池座焊成 4S 串聯,並確認電池組看起來與原專案的圖片完全相同。確認下方兩個極片之間有焊錫。確認各框架形成單一串聯,沒有短路或並聯:每個正極都接到下一節電芯的負極。
- 焊接 XT30 電源線:紅線接到第一節電芯的正極端子,黑線接到最後一節電芯的負極端子。原專案使用 350-400C 與含鉛焊錫,不長時間加熱以免塑膠熔化,並建議使用風扇吸走煙霧。
- 依序焊接平衡接頭:pin 1 黑線接第一節電芯的負極;pin 2 黃線接在第 1 與第 2 節電芯之間;pin 3 黃線接在第 2 與第 3 節之間;pin 4 黃線接在第 3 與第 4 節之間;pin 5 黃線接最後一節電芯的正極。
- 絕不可略過測試。依照極性標示一次裝入一節電芯,每裝一節就檢查電壓:第一節,XT30 約 4V,且只有 pin 2 對地約 4V;兩節約 8V,pin 3 約 8V;三節約 12V,pin 4 約 12V;四節約 16V,pin 5 約 16V。四條平衡引線對地的電壓應單調遞增;若不是,請對調引線。
- 正極端子附近要小心:21700 電芯的正極非常靠近外殼,而外殼是接地的。請使用同一批次、同容量的電芯,絕不可新舊電芯混用。
- 用電工膠帶固定線材。原專案不建議使用熱縮套管,因為它需要加熱,而且會讓你無法取出電芯。
- 使用 4S LiPo 平衡充電器充電,同時連接 XT30 與平衡接頭,設定為 4S LiPo 模式,以 0.5C 至 1C 充電(2.5A 至 5A 通常都可以),並注意溫度。不使用時以每節 3.8V 存放(總計 15.2V)。
13. 完成軀幹、校正並站立
安裝 Jetson 與電源板,裝上校正裝置,執行校正腳本,然後執行站立策略。
13.1 安裝 Jetson 與纜線
將 USB 集線器與通訊板接到 Jetson Orin NX 之後,再以 M2.5x10(*3)固定 Jetson。
- 依照 Jetson Power Cables 影片(YouTube nK02RLfJBTM)與 Power Supply Cables 影片(A5iL168LYlc),以及手冊第 10 頁的軀幹步驟 9 操作。
- 軀幹步驟 9 使用 M2.5x10(*3)。手冊寫道:「在進行 Jetson 安裝之前,先將 USB 集線器與通訊板連接到 Jetson。」
- 將攝影機線與喇叭線接到 USB 集線器,並將 Dynamixel U2D2 接到 Jetson(手冊中的軀幹步驟 10)。
- 確認 Jetson Orin 的風扇沒有被衣物或布料覆蓋,以免過熱。
13.2 安裝校正治具並校正
裝上列印的校正治具,然後執行 calibrate_zero.py 記錄零點。
- 從 MakerWorld release 列印校正治具。插入時可能會因為配合很緊而感到摩擦;固定後應會喀噠一聲卡入定位並鎖住關節。若關節仍會移動,請檢查是否有線材阻擋或插入不正確。
- 手冊要求確認線材位置正確,以免干擾校正治具。膝關節的下限與零點對齊,因此以自然的止擋作為基準。
- 執行:python toddlerbot/tools/calibrate_zero.py --robot <robot_name> --parts <part_names_separated_by_space>。若沒有指定零件,腳本會校正所有關節。
- 可選擇檢查 config_motors.json 中的關節角度,然後執行:python toddlerbot/descriptions/add_configs.py --robot <robot_name>
- 儲存庫中的機器人名稱為 toddlerbot_2xc 與 toddlerbot_2xm。
13.3 安裝電源板與電池,然後執行站立測試
將電源板與電池裝入軀幹,關上前蓋,並執行站立策略。
- 依照 Standing Test 影片(YouTube U8UijFsCQRA)操作。將電源板裝到軀幹上,裝入電池,並將所有線材整理整齊。將前蓋固定到位。
- 若前蓋很難蓋上,請檢查電池盒的姿態並整理線材。
- 執行站立策略:python toddlerbot/policies/run_policy.py --policy stand --robot <robot_name> --sim real
- 在終止控制馬達的腳本或關閉電源之前,請先固定好機器人。原專案警告,機器人可能會跌倒並損壞。停止 calibrate 策略時,請扶住機器人,因為馬達會被停用,機器人會倒下。
- 若校正後機器人略微前傾或後仰,原專案的微調腳本是 python toddlerbot/policies/run_policy.py --policy calibrate --robot <robot_name> --sim real。當機器人站直時,按 Ctrl+C 停止它。
- 手冊寫道:「如果 Toddy 能穩穩站立,恭喜!!!」
14. 選配平行夾顎夾爪
以 1 x XC330 與所列扣件組裝選配的夾爪(手冊中 5 個步驟)。
14.1 組裝平行夾顎夾爪
夾爪使用 1 x XC330、一顆 684 軸承、兩個襯套,以及 M2、M3 與 M4 螺絲。
- 觀看夾爪影片(YouTube g-DO9xOXTno),並依照手冊第 11 頁「Gripper assembly in 5 steps」操作。
- 手冊列出的五金零件:軸承 684(1)、襯套 3x5x3(2)、M2x8(7)、M3x10(2)、M3x12(1)、M4x8(1)。列出的其他零件:XC330(*1)。開始之前,先去除列印件上的支撐材。
- 夾爪的零點是手冊中所示的張開位置。執行校正腳本之前,用手將手指移到這個位置。
- BOM 將襯套列為「Bushing 355 10pcs」;手冊列的是「Bushing 3x5x3 (*2)」。兩者長度不同;請查看影片與 CAD。