Open Source Robotics

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

Berkeley Humanoid Lite 組裝指南

低於 5,000 美元的開源人形機器人,具 3D 列印減速箱與完整的模擬到現實(sim-to-real)流程

授權條款

MIT

組裝指南

1. 材料與零件(BOM)

備齊所有需要的元件,包括馬達、軸承、ESC、編碼器、電子元件與 3D 列印線材。確切數量與採購連結請參考官方 BOM 試算表。

1.1 採購致動器元件

訂購兩種致動器的所有零件:M6C12(高扭矩,數量 10)與 5010(中扭矩,數量 12)。

  1. 開啟官方 BOM 試算表,檢視其三個分頁:M6C12 Actuator、5010 Actuator 與 Humanoid。兩個致動器分頁列出一個致動器的零件。Humanoid 分頁列出整個機器人每種致動器需要幾個。
  2. 訂購 10 顆 MAD Components M6C12 150KV 馬達,每個 M6C12 致動器一顆。M6C12 Actuator 分頁列出每個致動器一顆「MAD Components M6C12 150KV」。Humanoid 分頁列出腿部 8 個、手臂 2 個 M6C12 致動器。論文與版本說明將它稱為 6512 致動器。
  3. 訂購 12 顆 MAD Components 5010 110KV 馬達,每個 5010 致動器一顆。5010 Actuator 分頁列出「MAD Components 5010 110KV」。Humanoid 分頁列出腿部 4 個、手臂 8 個 5010 致動器。請確認你購買的馬達 KV 值:韌體也有其他 5010 馬達的設定檔(Flashing 頁面中的 310KV 與 370KV,以及 2025-09-07 加入韌體的 200KV 設定檔),但 BOM 中的馬達是 110KV。
  4. 向 Digikey 或同類供應商訂購 B-G431B-ESC1 馬達控制器(共 22 個)。
  5. 訂購 AS5600 磁性編碼器(數量 22),搭配徑向充磁磁鐵。
  6. 訂購每個致動器分頁上列出的軸承。M6C12 致動器,每個致動器:13 顆 MR106-2RS、2 顆 6701-2RS 與 2 顆 6811ZZ。5010 致動器,每個致動器:13 顆 MR106-2RS、2 顆 6701-2RS 與 2 顆 6809ZZ。Humanoid 分頁另列出 6 顆 6803-2RS,說明為「Bearing between the linkage on the pitch actuators on legs」(腿部俯仰致動器連桿之間的軸承)。版本紀錄指出,Humanoid 分頁在 2025 年 5 月 29 日之前缺少 6803 軸承與一個 M2 埋入件,且 MR106-2RS 與 6701-2RS 的說明在 2025 年 5 月 23 日之前互相對調;若你是依較舊的副本購買,請查看目前的表格。
  7. 依 BOM 數量訂購 M3 螺絲、M2/M3 螺紋埋入件與 M4 六角支撐柱。

1.2 採購電子與結構元件

訂購主要電子元件(電腦、IMU、CAN 轉接器)與結構材料。

  1. 訂購一台 Intel N95 Mini PC(或同等級產品)作為機上運算。
  2. 向 Hiwonder 訂購 BNO085 9 軸 IMU 或 IM10A IMU 模組。文件強烈建議使用 IM10A,因為它可以直接透過 USB 連接。原本的 BNO085 版本使用 Arduino Nano 將 IMU 連接到電腦,而 BOM 沒有列出 Arduino Nano。
  3. 訂購 4 個 USB-CAN 轉接器(1 Mbps)與 2 個 USB 集線器。
  4. 訂購一顆 6S LiPo 電池。BOM 列出「LiPo battery 6S」,論文中機器人的電池為 6S 4000 mAh。
  5. Humanoid 分頁還列出整個機器人所需的以下零件:24V to 12V regulator(1)、12V to 5V regulator(1)、Voltage monitor(1)、Current monitor(1)、Circuit breaker(1)、Aluminum extrusion 250 mm(2)、200 mm(4)、150 mm(2)與 100 mm(3)、Aluminum inner bracket(24)、Servo motor claw(2)。它還列出一列 3D 列印線材,腿部與手臂各 1。
  6. LiPo 安全事項,取自作者的實驗室筆記(不屬於組裝指南):充電中的電池絕不可無人看管。確認充電器上設定的電芯類型、電芯數與最大充電電流與電池標籤相符。最大充電電流等於容量除以一小時,例如 2200 mAh 即為 2.2 A。帶載時絕不可讓 LiPo 放電到 3 V 以下。若電池膨脹,請立即停止使用並妥善處置。
  7. 訂購 PLA 線材:建議 Bambu Lab PLA Basic 或 Hatchbox PLA。
  8. 訂購配線材料:14 AWG 電源線、30 AWG 訊號線、XT60 與 XT30 連接器、WAGO 連接器。

2. 準備工具

開始組裝前,先把所有需要的工具在工作區準備好。

2.1 準備 3D 印表機與工作空間

確認你的 3D 印表機符合需求,且工作空間已準備好進行組裝。

  1. 確認你的 3D 印表機成型體積至少有 200 x 200 x 200 mm。建議使用 Bambu Lab X1C Carbon。Creality Ender-3 V3 SE 也已測試成功。
  2. 準備一個焊接站,使用 SUGON A9 210 或同等級的烙鐵。
  3. 準備一個熱壓埋入架,用來將螺紋埋入件裝入 3D 列印件。
  4. 準備好熱熔膠槍,用來將磁鐵固定到馬達軸上。
  5. 準備六角扳手組:M2、M2.5、M3、M4 與 M6 尺寸。
  6. 準備一把十字(+)與一把一字(-)螺絲起子。購買的元件中通常就有附。

3. 3D 列印

使用提供的 STL 檔,以及 Releases 頁面上建議的列印設定檔,列印所有結構件。

3.1 列印致動器元件

使用 Actuator Housing 與 Actuator Shaft 列印設定檔,列印所有擺線減速機外殼、軸與馬達外殼。

  1. 從 Releases 頁面下載 3D 列印檔案(附有 Bambu Lab MakerWorld 連結)。
  2. 外殼、輸出軸與馬達殼使用 Actuator Housing Profile。設定檔的各項設定以截圖形式列在 3D Printing Instructions 頁面上(分頁 Quality、Strength、Speed、Support、Others)。
  3. 版本紀錄,2025-05-21:原專案修正了 MakerWorld 上 6512 致動器的 .3mf 檔案。版本紀錄,2025-08-23:原專案修正了 MakerWorld 上的 3D 列印檔案,「更換錯誤的 5010-5010 外殼零件,並加入缺少的限位擋塊零件」,並新增了將磁鐵安裝到馬達軸上的說明。若你在這些日期之前下載或列印了致動器零件,請與目前的檔案比對。
  4. 擺線盤、輸入軸、馬達軸與間隔環使用 Actuator Shaft Profile:這些零件需要較高精度。
  5. 列印設定檔是針對 Bambu Lab X1C 調校。若使用其他印表機,請調整設定。
  6. 列印 10 套完整的 M6C12 致動器零件與 12 套完整的 5010 致動器零件。

3.2 列印機身結構零件

列印上半身、下半身與所有結構框架元件。

  1. 列印上半身零件:每個零件都需要列印兩次,第二份沿 X 軸鏡像。
  2. 列印下半身零件:與上半身相同的鏡像要求。
  3. 結構件可以用較快的速度設定列印,因為精度沒那麼關鍵。
  4. BOM 將夾爪列為外購件「Servo motor claw」,在 Humanoid 分頁上數量為 2。3D Printing Instructions 頁面沒有描述如何列印夾爪。
  5. 組裝前清理列印件。M6C12 致動器影片的第一章就是「Clean up parts」。
  6. 用熱壓埋入架與烙鐵,將 M2 與 M3 螺紋埋入件裝入所有指定的孔。

4. 組裝致動器

依照影片指南,組裝全部 22 個擺線致動器(10 個 M6C12 高扭矩、12 個 5010 中扭矩)。

4.1 準備磁性編碼器

改裝 AS5600 磁性編碼器板,以便整合進致動器外殼。

  1. 依照 AS5600 Encoder Modification 影片指南(-T.K.- 製作)操作。
  2. 使用 AS5600 編碼器附帶的徑向充磁磁鐵:不要換成一般磁鐵。
  3. 依相同程序改裝全部 22 片編碼器板。
  4. 更多細節請參考外部教學 notes.tk233.xyz/electrical/as5600-modification。
  5. 改裝方式是更換板上的電阻。AS5600 Modification 頁面列出以下選項:要在 VCC 埠使用 5V,請移除 R1。要讓 PGO 恢復正常運作,請移除 R4。要逆時針旋轉,將 DIR 接到 VDD;可用 0R 跳線將 DIR 焊墊接到 R1 的上端,該處與 VCC 相連(靠近 'R1' 文字的那一側)。
  6. 移動電阻之後,也要將 VCC、GND、SDA 與 SCL 線焊到對應的焊墊上。

4.2 準備馬達

在馬達軸上安裝磁鐵,並準備好馬達以整合進致動器。

  1. 用一點熱熔膠將磁鐵黏在馬達轉子的軸上。頁面以 5010 馬達為例,其軸上有一個扣環。M6C12 馬達則是在軸端有一顆螺絲,但磁鐵的安裝方式相同。
  2. 準備全部 10 顆 M6C12 馬達與 12 顆 5010 馬達。

4.3 組裝 M6C12 致動器

以擺線減速機、軸承與編碼器組裝高扭矩致動器。

  1. 依照 -T.K.- 的「Assembling the M6C12 Actuator」影片指南操作。
  2. 依 BOM 的描述安裝軸承。MR106-2RS:裝在輸入軸與擺線盤之間,以及輸入軸與輸出軸之間。6701-2RS:裝在擺線盤與輸出軸之間。6811ZZ:裝在輸出軸與外殼之間。
  3. 用列印的擺線盤與輸入軸組裝 15:1 擺線減速機。
  4. 將 M6C12 馬達裝入馬達殼,並接到減速機。
  5. 將改裝過的 AS5600 編碼器裝在你黏在馬達轉子軸上的磁鐵上方(影片章節「Attach encoder」)。編碼器讀取的是馬達軸。原專案指出,關節致動器只在馬達軸上有一個編碼器。
  6. 對全部 10 個 M6C12 致動器重複此步驟。

4.4 組裝 5010 致動器

以相同流程搭配 5010 專用零件,組裝中扭矩致動器。

  1. 原專案只公開了 M6C12 致動器的組裝影片,沒有另外公開 5010 的組裝影片或文字。5010 致動器的資料是其 BOM 分頁、Onshape CAD 與 MakerWorld 列印檔,全部可從 Releases 頁面連結取得。
  2. 5010 致動器較小,但採用相同的擺線減速機原理。
  3. 安裝 5010 Actuator 分頁上列出的軸承:MR106-2RS、6701-2RS 與 6809ZZ。
  4. 對全部 12 個 5010 致動器重複此步驟。

4.5 焊接 ESC 連線

在所有 B-G431B-ESC1 馬達控制器上焊接電源、CAN 匯流排與訊號線。

  1. 電源線使用 14 AWG 線(正極=白色/紅色,接地=黑色)。
  2. CAN 線請使用 30 AWG 多股矽膠線。顏色規則:黃色用於 CAN-H 與 SDA,綠色用於 CAN-L 與 SCL。
  3. 警告:ESC 上的 CAN 埠焊墊非常脆弱,很容易從 FR4 基層剝落。焊接與拿取電路板時請格外小心。不要對線材與焊墊施加過大的力。
  4. 焊接全部 22 片 ESC 板,顏色標示保持一致。
  5. 編碼器與 CAN 的焊墊不好焊。原專案建議多加助焊劑,較容易焊出牢固的焊點。
  6. 依照 Building the Actuator 頁面上的配線圖,連接編碼器、馬達與馬達控制器。該配線圖是一張圖片,此處不轉載。

5. 燒錄馬達控制器

將韌體燒錄到所有 B-G431B-ESC1 馬達控制器,並校正每個致動器。

5.1 使用 STM32CubeIDE 燒錄韌體

安裝 Recoil Motor Controller 韌體,並燒錄到每個 ESC。

  1. 在電腦上安裝 STM32CubeIDE。
  2. 以下列指令下載韌體:git clone https://github.com/T-K-233/Recoil-Motor-Controller-BESC.git
  3. 開啟 Core/Inc/motor_controller_conf.h,將 FIRST_TIME_BOOTUP 旗標設為 1。這會設定 Flash 保護,因為 STM32 的內部 Flash 儲存馬達的設定參數。
  4. 透過控制板上的 Micro USB 埠將馬達控制器連接到電腦。STM32CubeIDE 應該會偵測到新裝置。點選 Run 按鈕。全新的板子會提示更新 ST-LINK 除錯器韌體:接受更新並依照其指示操作,然後再點選一次 Run。
  5. 拔下再插回 USB 線,讓板子重新上電。然後將 FIRST_TIME_BOOTUP 旗標改回 0。
  6. 依照「Flashing the Motor Controller Firmware」影片指南操作。
  7. 燒錄全部 22 片 ESC 板。

5.2 設定致動器參數

為每個致動器在 motor_controller_conf.h 中設定 CAN ID 並選擇馬達設定檔,然後燒錄。

  1. M6C12 致動器請取消註解 #define MOTORPROFILE_MAD_M6C12_150KV。請使用目前的韌體:M6C12 設定檔已於 2025-09-07 重新量測(扭矩常數 0.08958,先前為 0.0919)。
  2. 5010 致動器請取消註解 #define MOTORPROFILE_MAD_5010_110KV,因為 BOM 中的馬達是 MAD Components 5010 110KV。不要使用 MOTORPROFILE_MAD_5010_310KV 或 MOTORPROFILE_MAD_5010_370KV:在韌體中,這兩個設定檔的 MOTOR_TORQUE_CONSTANT 行被註解掉了。機器人已儲存的關節設定中,5010 關節的扭矩常數為 0.1176,也就是 110KV 設定檔的值。
  3. 依照 Joint ID Mapping 頁面,在 motor_controller_conf.h 中設定 DEVICE_CAN_ID。ID 在每條 CAN 匯流排上是唯一的,而不是在整個機器人上唯一。左臂(CAN0):1、3、5、7、9。右臂(CAN1):2、4、6、8、10。左腿(CAN2):髖部滾轉 1、髖部偏航 3、髖部俯仰 5、膝部俯仰 7、踝部俯仰 11、踝部滾轉 13。右腿(CAN3):髖部滾轉 2、髖部偏航 4、髖部俯仰 6、膝部俯仰 8、踝部俯仰 12、踝部滾轉 14。韌體接受 1 至 63 的值。
  4. 在同一個檔案中往下捲動,將 LOAD_ID_FROM_FLASH 與 LOAD_CONFIG_FROM_FLASH 設為 0,讓程式覆寫 Flash 中預設的隨機值。點選 Run。接著拔下再插回 USB 線,確認 flash 選項已載入。LED 應以約 1 Hz 閃爍,表示程式已載入並在執行中。
  5. 將 LOAD_ID_FROM_FLASH 與 LOAD_CONFIG_FROM_FLASH 改回 1,點選 Run 進行最後一次燒錄。此時 Run 按鈕已按過四次,韌體與設定參數都已載入。

5.3 校正所有致動器

使用提供的 Python 腳本,透過 CAN 匯流排在每個致動器上執行校正程序。

  1. 透過 USB-CAN 轉接器將致動器的 CAN 匯流排接到電腦,然後為致動器通電。以下列指令啟動 CAN 傳輸:sudo ip link set can0 up type can bitrate 1000000
  2. 檢查連線:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1(-c 參數是 CAN 傳輸介面,-i 參數是 CAN ID)。腳本應印出 'Motor is online'。若印出 'Motor is offline',請檢查訊號線連接、電源與 CAN ID 設定。
  3. 確認致動器上沒有裝任何東西,且可以自由轉動。執行:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/calibrate_electrical_offset.py -c can0 -i 1。原專案的警告:馬達會轉動並汲取相當大的電流(電源供應器約 1 A)。請確認電源線連接正確,且致動器可以自由轉動。馬達會緩慢增加保持扭矩,直到相電流達到目標值,接著逆時針轉一整圈機械旋轉,再順時針轉回一圈。
  4. 若旋轉方向相反(先順時針,再逆時針),請將三條馬達相線中的任意兩條對調,或將韌體中的 MOTOR_PHASE_ORDER 改為 -1。版本紀錄於 2025-07-07 加入這項註記。
  5. 依照「Motor Calibration」影片中的正確程序操作。
  6. 要檢查致動器,執行:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/move_actuator.py -c can0 -i 1。它會讓致動器沿正弦位置曲線運動。原專案的提醒:馬達會轉動。先從較小的 kP、kD 與扭矩上限值開始。若發生任何非預期情況,按 Ctrl+C 停止程式與致動器。
  7. 校正全部 22 個致動器。

6. 組裝機器人

以校正好的致動器與 3D 列印結構件,組裝手臂、腿部與整個機身。

6.1 組裝手臂

組裝兩組手臂組件,包括肩關節(3 自由度)與肘關節(2 自由度:手肘俯仰與手肘偏航),然後在每支手臂上裝上夾爪。

  1. 依照 -T.K.- 的「Assembling the Arm」影片指南操作。
  2. 在肩部滾轉、肩部偏航、肘部俯仰與肘部偏航安裝 5010 致動器:每支手臂四個 5010 致動器。Humanoid 分頁列出兩支手臂用的 8 個 5010 致動器。
  3. 在肩部俯仰關節安裝 M6C12 致動器,每支手臂一個。Humanoid 分頁列出手臂用的 2 個 M6C12 致動器。原專案的文字沒有指明每個手臂關節使用哪個致動器;這顯示在 Assembling the Arm 影片中,但該影片未經觀看。此分配依照 BOM 的數量與機器人已儲存的關節設定。
  4. 將夾爪組件裝到每支手臂上。
  5. 組裝左右兩支手臂(互為鏡像的組件)。

6.2 組裝腿部

組裝兩組腿部組件,包括髖關節(3 自由度)、膝關節(1 自由度)與踝關節(2 自由度)。

  1. 依照 -T.K.- 的「Assembling the Leg」影片指南操作。
  2. 為髖部滾轉、髖部偏航、髖部俯仰與膝部俯仰安裝 M6C12 致動器:每條腿四個 M6C12 致動器。Humanoid 分頁為腿部列出 8 個 M6C12 致動器。
  3. 在踝部俯仰與踝部滾轉安裝 5010 致動器:每條腿兩個 5010 致動器。Humanoid 分頁列出腿部用的 4 個 5010 致動器。原專案的文字沒有指明每個關節使用哪個致動器;此分配依照 BOM 的數量與上面提到的檔案,Assembling the Leg 影片中可能有顯示。該影片未經觀看。
  4. Assembling the Leg 影片有以下章節:Hip Base、Hip Roll、Hip Yaw、Hip Pitch、Knee Pitch、Ankle Pitch & Roll。影片說明中的更正:「在影片中,我把髖部結構組裝錯了。髖部俯仰應該反過來裝——我把左腿和右腿弄混了。」請將髖部俯仰以與影片相反的方向安裝。
  5. Humanoid 分頁列出腿部用的 6 個 6803-2RS 軸承,說明為「腿部俯仰致動器上連桿之間的軸承」。
  6. 組裝左右兩條腿(互為鏡像的組件)。

6.3 組裝完整機身

將手臂、腿部與軀幹組合成完整的人形機器人。

  1. 依照 -T.K.- 的「Assembling the Body」影片指南操作。
  2. Assembling the Body 影片包含以下章節:Attaching the battery holder、Preparing the hip、Base structure、Attaching the base、Attach the arm。

6.4 配線與電子元件

完成所有電氣連接,包括 CAN 匯流排、電源分配與機上電腦。

  1. 將 CAN 線直接接到 USB-CAN 轉接板上的螺絲端子。順序為 CAN-L、CAN-H、GND,訊號名稱也標示在 PCB 背面。機器人使用四條匯流排:CAN0 左臂、CAN1 右臂、CAN2 左腿、CAN3 右腿。
  2. 訊號線:直接焊在一起,並以熱縮套管保護接點。電源線:初次連接時,WAGO 連接器(機器人使用二、三、五孔型)不需焊接就能將每個致動器接上或拆離主電源匯流排,方便除錯。若要更持久的組裝,則將線直接焊在一起。
  3. 致動器之間的線可用 XT30 與 XT60 連接器連接。原專案用 XT60 連接主線,每個致動器再以 XT30 連接器接到主電源匯流排。
  4. 安裝 Intel N95 Mini PC並連接 USB 集線器。
  5. 將 USB-CAN 轉接器接到 USB 集線器。
  6. 安裝 IMU(建議 IM10A),以 USB 直接連到機上電腦。
  7. 將 6S LiPo 電池裝在軀幹中。
  8. 原專案首頁的警告:「這不只是一個軟體專案,其中包含高功率電子設計。它還沒有燒掉任何 UC Berkeley 的實驗室或任何人的房子,但不保證 : )」「請格外謹慎地執行每個步驟。」接上電源前檢查極性:依原專案的顏色標示,白色或紅色為正極,黑色為接地。

7. 軟體設定與測試

建立軟體環境、部署策略,並確認機器人運作正常。

7.1 設定機上電腦

在 Intel N95 Mini PC 上安裝作業系統與所需軟體。

  1. 在機上電腦安裝 Ubuntu 22.04。原專案表示 22.04 與其軟硬體堆疊相容良好,並指出電腦為 BeeLink N95 NUC。頁面上 BIOS 按鍵寫的是「XXXX」。
  2. 複製 Berkeley-Humanoid-Lite 儲存庫。
  3. 安裝頁面列出的套件:sudo apt install build-essential cmake net-tools can-utils python3-pip。指令透過 uv 執行 Python;Training Environment 頁面提供安裝 uv 的指令。工作區的 pyproject.toml 要求 Python 3.11(requires-python >=3.11,<3.12)。
  4. 原專案表示機器人上只需要 source/berkeley_humanoid_lite_lowlevel/ 的內容。
  5. 以下列指令啟動 CAN 傳輸:source ./scripts/start_can_transports.sh。它會以 bitrate 1000000 啟動 can0 至 can3。停止時執行:source ./scripts/stop_can_transports.sh

7.2 測試致動器通訊

從機上電腦確認全部 22 個致動器都能透過 CAN 匯流排正確回應。

  1. 用 ping 腳本測試一個致動器。Flashing 頁面提供的是:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1。On-board Computer 頁面提供的是較舊的路徑與參數(python ./berkeley_humanoid_lite_lowlevel/motor/ping.py --port can0 --id 1),這些在 Lowlevel 儲存庫中已不存在。連接兩支手臂與兩條腿時,CAN 埠為 can0、can1、can2 或 can3 其中之一,CAN ID 的範圍為 1 至 14。
  2. 用上一步的 move_actuator.py 腳本檢查每個關節,先從較小的 kP、kD 與扭矩上限開始。
  3. 檢查每個致動器的 CAN ID 與匯流排是否與 Joint ID Mapping 頁面相符。軟體使用的關節清單在 berkeley_humanoid_lite_lowlevel/robot/humanoid.py 中,其中列出腿部,手臂關節則被註解掉。

7.3 部署行走運動策略

載入訓練好的行走運動策略,並測試基本行走。

  1. 儲存庫在 checkpoints/ 中存有 ONNX 策略(例如 policy_humanoid.onnx 與 policy_humanoid_legs.onnx),configs/ 中有對應的 YAML 檔。訓練腳本 play.py 會將訓練好的策略匯出為 ONNX,並更新 configs/policy_latest.yaml。
  2. 要讓所有部分一起運作,請先確認 CAN 傳輸介面已啟動。執行低階程式碼有兩種方式。C 程式碼庫,行走運動建議使用,即時性保證較好:在 ./csrc/ 中執行 make,然後 ./build/real_humanoid。若 USB-CAN 轉接器跟不上通訊頻率,頁面建議使用 xanmod 即時核心。Python 程式碼庫:在 lowlevel 目錄中執行 uv run ./scripts/python/run_locomotion.py。在目前的 Lowlevel 儲存庫中,腳本是 scripts/run_locomotion.py,因此頁面上的路徑已過時。機器人的狀態轉換與 MuJoCo sim2sim 模擬中相同。

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