Open Source Robotics

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

Zeroth Bot 組裝指南

用於模擬到現實(sim-to-real)強化學習的低成本 3D 列印人形機器人平台

授權條款

MIT

zeroth-bot 儲存庫與 ksim-gym-zbot 採用 MIT。zeroth-robotics/hardware 儲存庫(PCB 檔案)與 kos-zbot 沒有授權檔案,因此其條款未載明。查核日期:2026 年 11 月 2 日。

組裝指南

1. 請先閱讀

原專案為 Zeroth-01 組裝公開了什麼,以及組裝者手上可能有的兩種控制器與軟體版本。

1.1 原專案公開的內容

一份以圖片為主的組裝文件、一個物料清單頁面,以及軟體儲存庫。

  1. 原專案發布了一份組裝文件,名為 Zeroth Bot Assembly Document。這是一份 61 頁的共享文件,大部分步驟都是圖片,旁邊標示螺絲數量。
  2. 本指南依照該文件本身的順序。文件中某個步驟沒有文字時,本指南也不提供,請依照文件中的圖片操作。
  3. 文件開頭表示,有幾個步驟的順序很重要,標註之處也需要注意細節,並要求你先通讀一遍再動手。
  4. 文件本身的物料清單一節寫著「之後補上細節」。本指南的零件清單取自 K-Scale 文件的 Bill of Materials 頁面。
  5. 文件沒有提供伺服機 ID 對照表、列印設定或軟體步驟。軟體部分在最後一節,依據原專案發布的儲存庫說明。

1.2 確認你手上的控制器

組裝文件使用 Milk-V 板;目前的軟體儲存庫則以 Raspberry Pi 4B 為準。

  1. 組裝文件的電子部分以裝在 Milk hat 上的 Milk 板為核心,其電子概覽圖將控制器標示為「Brain (MilkV)」。
  2. 目前的軟體儲存庫 kos-zbot 將 Raspberry Pi 4B 與 Raspberry Pi OS 64-bit 列為先決條件。它沒有提到 Milk-V 板或 Milk hat。
  3. 原專案沒有發布任何文件,將組裝文件中的 Milk-V 硬體與目前的 kos-zbot 軟體連結起來。
  4. 2024 年 11 月至 2025 年 2 月間的成品使用 Milk-V 方式:SD 卡上的 OpenLCH 映像檔與 openlch Python 函式庫。這種較舊的方式列在軟體一節中,並標示為較舊版本。
  5. 依照任一種軟體方式操作之前,請先確認你手上的是哪一種控制器。

2. 工具與零件

組裝文件要求的工具、K-Scale 物料清單上的零件與扣件,以及列印零件。

2.1 備齊工具

2.5 mm 與 1.5 mm 六角起子、一支烙鐵,以及移除支撐的工具。

  1. 準備一組六角工具。文件表示,維修工具組很適合用於此。
  2. 2.5 mm 六角起子頭,用於 M3 內六角頭螺絲,要夠長(最好 15 mm 以上)。
  3. 1.5 mm 六角起子頭,用於 M3 內六角頭螺絲,要夠長(最好 15 mm 以上)。
  4. 最好再準備一支電動起子。
  5. 用來去除零件支撐材的工具。
  6. 一支烙鐵,用來將嵌件熱壓入塑膠零件。

2.2 備齊電子元件與伺服機

16 顆 STS3250 伺服機、Milk-V 控制器、伺服機驅動板,以及所列的感測器與音訊零件。

  1. 串列匯流排伺服機:x16,STS3250 50KG。物料清單表示,STS3215 45RPM 伺服機已無法滿足腿部的速度需求,請使用 STS3250。
  2. 控制器:Milk-V,x1(物料清單連結的是 Duo S)。
  3. 伺服機驅動板:Waveshare Bus Servo Adapter,x1。
  4. LCD IMU:RP2040 MCU Board,x1。
  5. IMU:9-DOF IMU,x1。
  6. 攝影機:Milk-V CAM-GC2083,x1。
  7. 電池:RC Lipos,x1(連結的商品是 1200mAh 電池組)。
  8. 12V 轉 5V:12V to 5V,3 amp 容量(可能需要接頭),x1。
  9. 麥克風:Electret Microphone,x1。喇叭:3 Watt Speaker,x1。放大器:LM386 Mono Audio Amplifier,x1。
  10. 組裝文件本身的清單還列出訂製 PCB 與線材:2 條 150 mm 3 pin PH-2 mm 間距的線,以及隨附的伺服馬達線(資料線與電源線已絞合)。

2.3 備齊扣件

M3 與 M2 圓頭及內六角承窩頭螺絲與熱熔螺帽,數量依原專案所列。

  1. 圓頭內六角螺絲,M3,長 10 mm,數量 14,用於結構接合處。
  2. 圓頭內六角螺絲,M3,長 4.5 mm,數量 129,用於馬達輸出端與馬達軸。
  3. 圓頭內六角螺絲,M2,長 5 mm,數量 80,用於馬達外殼。
  4. 內六角圓柱頭螺絲,M2,長 5 mm,數量 12,用於電路板固定座。
  5. 熱熔嵌件,M3,數量 13,用於軀幹與其他零件。
  6. 熱熔嵌件,M2,數量 14,用於電子元件托架。
  7. 物料清單表示,所有馬達輸出端都使用 M3 螺絲,所有馬達外殼都使用 M2 螺絲,皆為標準粗牙螺距。
  8. 組裝文件還要求使用彈簧墊圈,以及 M2 x 4、M2 x 6 與 M3 x 5 螺絲。這些尺寸不在物料清單上;請參閱衝突說明。
  9. 對於金屬與金屬之間的螺絲接合,物料清單建議使用低強度、可拆卸的螺絲固定劑(Loctite Purple)。它表示,由於扣件很小,中強度可能在拆卸時造成問題,並應避免使用高強度。
  10. 以上數量以鋁合金機身的 STS3250 伺服機為準。STS3215 伺服機採用塑膠外殼,大部分孔都沒有預先攻牙;使用自攻螺絲會讓組裝比較容易,而非驅動側的軸螺絲孔不會攻牙。

2.4 取得列印件

列印件來自 CAD 模型;組裝文件說明它們是以 Bambu 列印盤列印的。

  1. 組裝文件將列印件列為「透過 bambu 列印板」,沒有提供列印設定。
  2. K-Scale 文件的 Links 頁面指向一份 OnShape CAD 文件作為 CAD。
  3. 一份較舊的原專案文件(2024 年 12 月)提供了 Bambu 印表機的列印設定:process 0.16mm、wall loops 5、support type tree (auto)。它也依名稱列出零件,包括 hip_yaw、hip_roll、knee_pitch、ankle_pitch、foot、torso、electronics mount、head、neck 與 mounting back plate。這些設定來自較舊的版本,目前的文件沒有重複。
  4. 左右兩側的零件不同。組裝文件要求注意分清楚哪一側是哪一側。

3. 準備列印零件

在裝入任何馬達之前,先去除支撐並裝上熱熔螺帽。

3.1 移除支撐

清除每個列印件上的支撐,尤其是馬達外殼與轉子座。

  1. 去除所有零件上的支撐材。
  2. 特別注意馬達裝入的內側殼體,以及轉子連接的位置(如文件右側的圖片所示)。

3.2 裝入熱熔螺帽

以熱熔方式將 M3 熱熔螺帽裝入軀幹、頸部與髖部,將 M2 熱熔螺帽裝入電子元件座、頸部轉接件與頭部外殼。

  1. 用烙鐵將嵌件熱壓入塑膠零件。
  2. 軀幹:M3 熱熔嵌件(文件未說明數量)。
  3. 頸部:文件印的是「headset M3」(未說明數量)。
  4. 髖部熱熔嵌件:4 x M3。文件表示,這些嵌件應儘量垂直,而這在之後非常重要。
  5. 電子元件座:14 x M2。
  6. 頸部轉接件:4 x M2。
  7. 頭部外殼:4 x M2。
  8. 物料清單總計列出 13 個 M3 嵌件與 14 個 M2 嵌件。文件中的 M2 嵌件加起來是 22 個;請參閱衝突說明。

4. 馬達如何組合

文件對伺服機、其轉子板與外殼的概述,之後的每個步驟都以此為基礎。

4.1 閱讀馬達總覽

伺服機的正面、側面與背面視圖,標示鋁製轉子板與纜線插頭的位置。

  1. 轉子正面:裝上鋁製轉子板。
  2. 側視圖:正面有齒輪式轉子介面,背面有與轉子板相接的滑動介面。
  3. 背視圖:文件標示了線材插頭的位置。
  4. 轉子安裝是指裝上位於馬達軸兩側的兩片金屬板。
  5. 文件接著只以圖片說明外殼組裝。

5. 腿部

髖部偏航、髖部、膝部、大腿、小腿與腳掌,依文件給出的順序。文件指出這些是順序上最關鍵的步驟。

5.1 將馬達接入髖部偏航組件

髖部偏航零件,每個各裝一顆馬達,加上兩片轉子板、一條長的絞線與一條標準短線。

  1. 依文件圖片所示,將馬達裝入每個髖部偏航零件。
  2. 裝上轉子第 1 側,再裝上轉子第 2 側。
  3. 連接線材:長的絞合線各用一條,再加一條標準短線。

5.2 接到髖部

髖部零件、馬達纜線,以及四顆附彈簧墊圈的 M2 螺絲。

  1. 找出髖部零件。
  2. 將線材穿過髖部,長線從上方穿過,較短的線從側面穿過。
  3. 將馬達放入插座中。它們應該能輕鬆滑入。
  4. 進行標準的外殼固定:4 x M2 螺絲搭配彈簧墊圈。
  5. 文件中的警告:鎖到左上方那顆 M2 可能是整個組裝中最棘手的部分。M2 應能穿過這些孔並鎖入馬達本體。

5.3 膝部

膝部零件,轉子兩側都已鎖緊,並加上兩條短線。

  1. 找出膝部零件。
  2. 固定轉子的兩側。
  3. 加上 2 x 短線。
  4. 確認你現在已有文件圖片中所示的組裝件。

5.4 大腿

大腿零件、膝部零件與 M2 螺絲:上方穿入 2 顆,下方穿入 4 顆。

  1. 找出大腿零件。左右有分別。可以從上方的文字分辨:版本號正向讀的是機器人的右側,反向讀的是機器人的左側。
  2. 將膝部零件滑入大腿零件的外殼中,只讓一條線從背面滑出,另一條線從側面拉出。文件表示,其照片錯誤地顯示兩條線都從背面穿出。
  3. 文件中的注意事項:確認右膝接在右大腿上。
  4. 用 2 x M2 螺絲從上方、4 x M2 螺絲從下方,將馬達固定到本體中。
  5. 文件表示,步驟 1 至 4 的組裝順序最關鍵。其餘部分不必在意順序,但它仍建議依照所給的順序。

5.5 小腿

小腿零件、兩顆馬達、M2 螺絲:前方 8 顆、後方 4 顆,以及馬達之間的一條纜線。

  1. 找出小腿零件。它們的形狀與手臂支架相同,但長度不同。若零件上的 SHIN 字樣看不清楚,兩支小腿都比手臂支架長。
  2. 裝上兩顆馬達,兩側各一顆。
  3. 正面:鎖上 8 x M2 螺絲。
  4. 背面:鎖上 4 顆螺絲。文件印的是「4 X Ms」,沒有說明尺寸。
  5. 在兩顆馬達之間接一條線。忽略圖中的轉子;它們在下一步才裝上。
  6. 繼續之前,確認你已有文件圖片中所示的零件。

5.6 腳掌

腳掌零件,轉子裝在小腿塊的下半部。

  1. 找出腳部零件。
  2. 如同所有零件,較大的轉子接頭位於內側。
  3. 確認轉子已裝到小腿塊的下半部。
  4. 將小腿塊滑入並滑到定位。
  5. 圖片顯示內側與外側的轉子連接。

5.7 將小腿與腳掌塊接到膝部塊

小腿與腳掌塊接到膝部塊;文件只提供圖片。

  1. 依 Block 1 與 Block 2 的圖示,將小腿與腳部塊接到膝部塊上。
  2. 圖片顯示外側與內側的轉子連接。
  3. 文件除了這些圖說之外沒有其他文字。

5.8 將馬達裝入髖部偏航外殼

將一顆馬達滑入髖部偏航外殼,以 M2 螺絲固定:前方 4 顆、後方 2 顆。

  1. 將馬達滑入髖部偏航外殼中。
  2. 馬達外殼固定:正面 4 x M2 螺絲,背面 2 x M2 螺絲。

5.9 將髖部偏航馬達鎖入腿部塊

軀幹塊與兩個腿部塊,每一側的前後各組裝一個轉子。

  1. 依圖示將軀幹塊、腿部塊 1 與腿部塊 2 組合在一起。
  2. 在每一側,組裝正面的轉子與背面的轉子。
  3. 插入所有線材,直到形成兩條線材鏈,每條腿一條。
  4. 文件在此處標示腿部已完成。

6. 軀幹

將軀幹裝到髖部上,並放入肩部馬達。

6.1 將軀幹裝到髖部

將軀幹裝在髖部上,纜線從底座拉出,並以四顆螺絲鎖入黑色髖部座。

  1. 找出軀幹。
  2. 將它裝到髖部上,讓軀幹的凸緣突出於髖部前方。
  3. 將線材從底座拉出。
  4. 文件中的注意事項:從本體腔體上方使用 4 x M10's 固定到黑色髖部座上。文件寫的是「M10's」;請參閱衝突說明。

6.2 將肩部馬達裝到軀幹

先放入未裝前後轉子的肩部馬達,再在朝外的一面裝上轉子並鎖上 M2 螺絲。

  1. 放入馬達,不裝前後轉子。
  2. 只在朝外的那一面加裝轉子。
  3. 本體外殼固定:4 x M2 螺絲,背面另加 2 x M2 螺絲。
  4. 俯視圖:在以黃色框標示的位置,可以在上蓋與馬達之間放一個墊圈。因為這顆馬達是從上方裝入的,所以有空間。

7. 手臂與手部

肩部零件、肘部支架、手部與手臂。文件以 12、13、15、14 的順序印出這些步驟,本指南維持相同順序。

7.1 將肩部零件裝到軀幹

將肩部零件裝在軀幹上,轉子凹口朝向機器人前方。

  1. 依圖示將肩部零件裝到軀幹上。
  2. 文件中的註記:轉子介面周圍的缺口朝外,朝向機器人的前方。
  3. 馬達轉子連接:僅一側。

7.2 組裝手肘支架

手肘支架以 M2 螺絲固定:前方 8 顆、後方 4 顆。

  1. 正面:鎖上 8 x M2 螺絲。
  2. 背面:鎖上 4 顆螺絲。文件印的是「4 X Ms」,沒有說明尺寸。
  3. 確認成果與文件的圖片相符。

7.3 將手部裝到手肘支架

將左右手部裝到手肘支架上,前後各有轉子。

  1. 依圖示將左右手裝到肘部支架上。
  2. 圖片顯示正面與背面的轉子連接。

7.4 將手臂裝到肩部

將完成的手臂接到肩部,前後都有轉子連接。

  1. 依 Block 1 與 Block 2 的圖示,將手臂接到肩部。
  2. 圖片顯示正面與背面的轉子連接。
  3. 文件接著以一張圖片顯示機器人應有的樣子。

8. 電子元件

先在電子元件安裝座上裝好機身電子元件,再裝頭部電子元件,最後是電池與最終裝配。

8.1 閱讀電子元件總覽

文件的總覽圖中關於頭部、軀幹空腔與 Milk hat 的內容。

  1. 頭部容納攝影機、一塊標示為「PCB 1: 5 V IMU + Display」並附麥克風的電路板,以及喇叭。
  2. 軀幹腔體容納 Milk 板擴充板(「PCB 2: Milk Board Hat」),上面裝有 Brain (MilkV),並以虛線畫出一個 12 轉 5 升壓模組與一個放大器。腔體內還有馬達驅動器、一個「3.3 V IMU」與電池。
  3. Milk hat 上畫有一排六個伺服機接頭。圖中將左邊一對與右邊一對標示為「To any 2/4 servo chains (recommended an arm and leg)」,中間的接頭標示為「Servo connection cables to servo driver」。文字沒有解釋「2/4」的意思。
  4. 擴充板上還有兩個標示 5 V power 與 3.3 V logic 的 I2C 連接、一個標示 3.3 V power 與 3.3 V logic 的 I2C 連接、標示 TX、RX 與 GND 的馬達板邏輯接頭、一個麥克風輸入、一個喇叭接頭、一個音量微調器與一個攝影機插頭。
  5. 文件沒有任何關於電池連接或極性的文字;請依照其圖片。

8.2 機身電子元件

以 M2 x 4 螺絲與彈簧墊圈將 Milk 板、Milk hat、伺服機驅動板與喇叭裝在電子元件座上。

  1. 準備 Milk hat、Milk 板、伺服機驅動器、喇叭與電子元件座。
  2. 只將 Milk 板用 M2 x 4 螺絲與彈簧墊圈鎖到電子元件座上。
  3. 用 M2 x 4 螺絲與彈簧墊圈裝上 Milk hat。
  4. 用 M2 x 4 螺絲與彈簧墊圈裝上馬達伺服機板。
  5. 用 2 x M2 x 4 螺絲裝上喇叭,面朝上。
  6. 將邏輯線接在 Milk hat 上標示「motor connection cable」的接頭,與文件稱為「wavestride」的板子上的邏輯針腳之間。請依照文件中的連接圖。
  7. 對照文件的側視圖與正視圖圖片進行檢查。

8.3 頭部電子元件

顯示器 IMU、麥克風、3 pin 與 4 pin PH-2 纜線、攝影機與頭部安裝板。

  1. 找出顯示器 IMU、麥克風,以及 3 pin 與 4 pin 的 PH-2 線。
  2. 依照文件圖片所示連接它們。
  3. 將線材穿過線孔。
  4. 用 M2 x 4 螺絲與彈簧墊圈將電子元件裝到頭部安裝板上:IMU 座連同其線材,以及攝影機連同其線材。

8.4 組合頭部元件

以一顆 M3 x 5 螺絲與一片彈簧墊圈將頭部裝到頸部,並以四顆 M2 x 6 螺絲鎖上頭蓋。

  1. 用 1 x(M3 x 5 螺絲搭配彈簧墊圈)將頭部裝到頸部上。
  2. 套上頭部外蓋。
  3. 在背面用 4 x M2 x 6 螺絲搭配彈簧墊圈固定。

8.5 將電子元件裝入機身

將電池放入機身空腔,再以兩顆 M3 x 10 螺絲固定電子元件座。

  1. 將電池放入本體腔體中。文件中的註記:應有 4 條伺服機線露出,而不是兩條。
  2. 沿著本體內部右側的長走線路徑穿線。
  3. 用 2 x(M3 x 10)螺絲將電子元件座裝入本體中。
  4. 將頭部組件移到附近並連接所有線材。
  5. 鎖上頸部。
  6. 鎖上背包。
  7. 最後三個動作在文件中只是附圖片的標題。

9. 軟體

原專案公開的兩種軟體做法:目前適用於 Raspberry Pi 4B 的 kos-zbot,以及較舊的 Milk-V 做法。請使用與你的控制器相符的那一種。

9.1 目前做法:在 Raspberry Pi 4B 上安裝 kos-zbot

在 Raspberry Pi OS 64-bit 上安裝 Python 3.12 環境與 kos-zbot。此做法不適用於 Milk-V 控制器。

  1. 先決條件:Raspberry Pi 4B、Raspberry Pi OS 64-bit、Python 3.12 或更新版本(建議使用 Miniforge 或 Miniconda)。所需硬體列為 Feetech 伺服機、BNO055 IMU、I2S 音訊等。
  2. 安裝系統相依套件:sudo apt install portaudio19-dev python3-dev
  3. 為 kinfer 安裝 Rust:sudo apt install rustc -y,然後 rustup default stable
  4. 可選擇安裝 Miniforge 並建立環境:conda create -n kos python=3.12 -y,然後 conda activate kos
  5. 安裝 kos-zbot:cd ~、git clone https://github.com/kscalelabs/kos-zbot、cd kos-zbot、pip install -e .、pip install -r requirements.txt

9.2 目前做法:設定 Raspberry Pi

依 Installation.md 所述,設定即時 Python、使用者群組、開機設定與 USB gadget 網路。

  1. 允許 Python 使用即時優先權:sudo setcap cap_sys_nice=eip $(readlink -f $(which python))
  2. 以 watch -n 0.2 cat /proc/interrupts 檢查中斷,並再次確認 uart_pl011 位於 IRQ 36。
  3. 將 uart_pl011 的 IRQ 固定到 cpu1,因為伺服機控制迴圈也固定在 cpu1:sudo sh -c 'echo 2 > /proc/irq/36/smp_affinity'
  4. 若要永久生效,請在 /etc/udev/rules.d/80-irq-affinity.rules 中加入一條 udev 規則:ACTION=="add", SUBSYSTEM=="irq", KERNEL=="36", ATTR{smp_affinity}="2"
  5. 以 sudo udevadm control --reload 重新載入 udev,然後以 cat /proc/irq/36/smp_affinity 驗證。
  6. 用 sudo usermod -aG 將你的使用者加入 dialout、i2c、audio 與 video 群組,然後登出再重新登入。
  7. 編輯 /boot/firmware/config.txt 的 [all] 區段,加入或確認 Installation.md 中列出的設定行:gadget 模式(dtoverlay=dwc2)、SPI 顯示器(dtparam=spi=on)、IMU(dtparam=i2c_arm=on、dtparam=i2c_arm_baudrate=400000、dtoverlay=i2c6,pins_22_23)、音訊(dtparam=i2s=on、dtparam=audio=on、dtoverlay=max98357a、gpio=26=op,dh、gpio=16=op,dl)、相機(camera_auto_detect=1、display_auto_detect=1、dtoverlay=imx219)、麥克風(dtoverlay=googlevoicehat-soundcard、gpio=24=op,dh)、顯示器背光(gpio=17=op,dh)以及伺服控制器(enable_uart=1、auto_initramfs=1、dtoverlay=vc4-kms-v3d、max_framebuffers=2、dtoverlay=disable-bt、dtoverlay=uart5,txd5_pin=12,rxd5_pin=13、disable_fw_kms_setup=1、arm_64bit=1、disable_overscan=1、arm_boost=1)。
  8. 若要使用 USB 乙太網路 gadget 模式,請在 /boot/firmware/cmdline.txt 的核心命令列中加入 modules-load=dwc2,g_ether(全部寫在同一行)。
  9. 建立 /etc/systemd/network/usb0.network,在 [Match] 下寫入 Name=usb0,在 [Network] 下寫入 Address=192.168.42.1/24,然後執行 sudo systemctl enable systemd-networkd 與 sudo systemctl start systemd-networkd。
  10. 安裝 dnsmasq,並在 /etc/dnsmasq.d/usb0.conf 中寫入 interface=usb0 與 dhcp-range=192.168.42.2,192.168.42.20,255.255.255.0,24h,然後執行 sudo systemctl restart dnsmasq。
  11. WiFi:先執行 nmcli connection show,再執行 sudo nmcli device wifi connect "SSID" password "PASSWORD"
  12. 喇叭與麥克風使用「Google voiceHat soundcard」。用 aplay -l 確認它有出現,再用 aplay -D hw:sndrpigooglevoi filename.wav 測試播放
  13. 攝影機:透過 raspi-config 啟用,並安裝 Installation.md 中列出的 Gstreamer 套件。
  14. 顯示器(SPI):在目前的 Bookworm 系統上,依 Installation.md 所列安裝 lgpio。

9.3 目前做法:啟動 KOS 服務並移動伺服機

kos-zbot README 中的 kos service、status、torque、zero 與 move 指令。

  1. 在執行任何致動器、策略或測試指令之前,一定要先啟動服務。執行 kos zbot 啟動機器人專用服務(它會設定伺服機增益,並依機器人中繼資料強制執行位置與速度限制),或執行 kos service 啟動通用服務(預設增益,無限制)。
  2. 機器人名稱必須與可用的機器人中繼資料相符。使用 kscale robot list 查看可用的機器人。
  3. 顯示即時狀態:kos status
  4. 啟用或停用扭矩:kos actuator torque enable 11,12,13
  5. 將致動器歸零:kos actuator zero all
  6. 移動致動器:kos actuator move --id 11,12 --pos 45 --vel 30。載入機器人中繼資料後,超出限制的指令會被限幅。
  7. 執行模型:kos zbot infer --model ./trained_policy.kinfer --action-scale 0.2。預設的 action scale 為 0.1,預設的序列裝置為 /dev/ttyAMA5,鮑率 1000000。

9.4 目前做法:伺服機 ID

雖然有變更 Feetech 伺服機 ID 的工具,但原專案沒有公開 ID 對應表或相關步驟。

  1. 儲存庫附有 kos_zbot/tools/feetech_change_id.py。它接受 --device(預設 /dev/ttyAMA5)、--baudrate(預設 1000000)、--current-id 與 --new-id(0 到 253)。
  2. README 沒有說明如何執行這個工具,也沒有列出哪個 ID 對應哪個關節。其範例使用 11、12、13 與 21 等 ID。
  3. 組裝文件中沒有設定 ID 的步驟。

9.5 訓練策略

用於訓練與轉換策略的 ksim-gym-zbot 指令。

  1. 安裝 git-lfs,從範本建立儲存庫並複製,使用 Python 3.11 或更新版本。
  2. 用 pip install -r requirements.txt 安裝;在 GPU 機器上另外執行 pip install 'jax[cuda12]'。
  3. 訓練策略:python -m train
  4. 將檢查點轉換為 kinfer 模型:python -m convert /path/to/ckpt.bin /path/to/model.kinfer
  5. README 的視覺化指令將機器人命名為 kbot,而非 zbot;請見衝突說明。

9.6 舊版做法(2024 年 11 月至 2025 年 2 月):Milk-V 搭配 OpenLCH

microSD 卡上的 OpenLCH 映像檔、透過 USB 的 SSH,以及 openlch 函式庫。只有在你手上是那段期間的 Milk-V 版本時才使用。

  1. 此途徑出自較舊的版本。目前的 kos-zbot 沒有記載它。
  2. 從 OpenLCH-buildroot 儲存庫的發行頁面下載 OpenLCH 映像檔(其最新發行版 v0.7.1 的日期為 2025 年 2 月 18 日),並用 balenaEtcher 或其他燒錄工具將它燒錄到 SD 卡。完成後取出 SD 卡再重新插入。
  3. 要在開機時設定 Wi-Fi,請在 SD 卡的 boot 資料夾中建立名為 wpa_supplicant.conf 的檔案,內容包含 ctrl_interface=/var/run/wpa_supplicant、ap_scan=1、update_config=1,以及一個含有你的 ssid、psk 與 key_mgmt=WPA-PSK 的 network 區塊。
  4. 透過 USB 連線時,板子的 IP 位址為 192.168.42.1,使用者名稱 root,密碼 milkv:ssh [email protected]。若出現金鑰問題,請執行 ssh-keygen -R 192.168.42.1。
  5. 在你的電腦上 pip install openlch。以 openlch set-wifi <ssid> <password> 設定 Wi-Fi,重新啟動機器人,再以 openlch get-ip 讀取其位址。
  6. 執行示範模型:git clone --recursive https://github.com/zeroth-robotics/zeroth-bot,建立 python=3.12 的 conda 環境(較舊的文件將它命名為 humanoid-os),pip install -r experiments/requirements.txt,ping 192.168.42.1 檢查連線,然後 python experiments/run.py。experiments 資料夾只存在於該儲存庫較舊的 commit 中,例如 195cb066。
  7. 較舊的文件警告,機器人上的策略部署當時仍在大幅開發中。目前的儲存庫中已沒有 experiments 資料夾。

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