Open Source Robotics

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

TienKung 3.0 組裝指南

X-Humanoid 推出的開源全尺寸人形機器人平台,具備進階的全身控制。

授權條款

  • TienKung_URDF and TienKung_Docs: OpenAtom Open Hardware License 1.0
  • TienKung-Lab and Deploy_Tienkung: BSD 3-Clause
  • xhumanoid_sdk: Apache 2.0

依儲存庫分別授權。TienKung_URDF(URDF 檔案、網格與 CAD 連結)與 TienKung_Docs(手冊與 SDK 文件)採用 OpenAtom Open Hardware License v1.0:散布時必須一併提供授權、保留聲明並標示你的修改。TienKung-Lab 與 Deploy_Tienkung 採用 BSD-3-Clause,xhumanoid_sdk 採用 Apache-2.0。TienKung-Lab 需要 NVIDIA Isaac Sim,而它有自己的授權。查核日期:2026 年 11 月 2 日。

組裝指南

1. 原專案公開了什麼,以及涵蓋哪一款機器人

原專案販售的 TienKung 是組裝完成、裝在航空箱中並附使用手冊的成品。它沒有公開以零件組裝機器人的說明。因此本指南提供手冊所提供的內容:開箱、開機、站立、緊急停止、關機與保養。手冊描述的是 Lite(20 自由度)與 Pro(42 自由度),日期都是 2025 年 5 月。手冊中沒有提到 TienKung 3.0,在原專案的儲存庫中也找不到 3.0 的使用手冊。第 2 至 7 節依照 Lite 手冊,第 8 節列出 Pro 的不同之處,第 9 節是選配的模擬設置。

1.1 了解機器人出貨時已組裝完成,不可拆解

Lite 手冊列出一具組裝完成的機器人本體,連同電源轉接器、遙控器、安全繩與產品手冊,並禁止未經授權的拆解。

  1. 裝箱清單列出:機器人本體 x1、電源轉接器 x1、遙控器 x1、安全繩 x1、產品手冊 x1。
  2. 手冊表示,如需維修應聯絡官方售後服務,且不建議使用者自行拆解機器人。
  3. 手冊寫道:未經授權,請勿改裝或拆解機器人或其零件。
  4. 保固條款表示,使用者若未經授權改裝、拆解或維修機器人,即視為放棄保固,且供應商不授權任何第三方進行維修。
  5. 手冊沒有組裝章節。原專案的 TienKung_URDF 儲存庫描述了 STEP 格式的完整組裝圖,分別為 Lite(檔案 TG10-00)與 Pro(檔案 TG11-00),可從原專案網站下載。這些檔案約 453 MB 與 824 MB,未經閱讀。原專案沒有發布依這些檔案組裝的步驟清單。

1.2 了解這些文件描述的是哪一款機器人

這些文件適用於 TienKung Lite 與 Pro;原專案的 3.0 SDK 範例屬於另一個平台。

  1. Lite,依 Lite 手冊:身高 1630mm,淨重 43kg,20 個整合式關節(每支手臂 4 個 x2,每條腿 6 個 x2),Intel x86 運動控制電腦,2 台 RGBD 攝影機(頭部、胸部),在 Ubuntu22.04.4 LTS 上執行 ROS 1。
  2. Pro,依 Pro 手冊:身高 1630mm,淨重 56kg,總計 42 個自由度,4 台 RGBD 攝影機(頭部、胸部、腰部、背部),2 台 Orin AGX 64 開發電腦,在 Ubuntu22.04.4 LTS 上執行 ROS 1。
  3. 原專案的 xhumanoid_sdk 儲存庫適用於它稱為 Embodied TienKung 3.0(Thor)的機器人。它需要機器人上安裝 Ubuntu 24.04 與 ROS 2 Jazzy,以 ssh [email protected] 登入,並將 Livox LiDAR 點雲範例列為標準硬體。這是一個 SDK 範例儲存庫,沒有提供開箱或開機步驟。
  4. 不要假設第 2 至 8 節的步驟適用於 3.0 機器人。這些步驟僅取自 Lite 與 Pro 手冊。

2. Lite 手冊中的安全規則

在把機器人從箱中抬出之前請先閱讀。這些是手冊本身的規則,保留其編號。

2.1 遵守誰可以使用機器人以及如何使用的規定

手冊限制了使用者、工作條件與搬運方式,並要求讓人員遠離手臂與腿部可觸及的範圍。

  1. 本機器人僅供 18 歲以上人士使用。
  2. 手冊不建議感官或認知能力受限、或沒有經驗的使用者在無人協助下單獨使用機器人。
  3. 請正確使用機器人零件與配件。未經授權請勿改裝或拆解。
  4. 手指、頭髮與衣物應遠離關節、縫隙與活動部位,以免被夾住或纏繞。
  5. 機器人運轉時請勿觸碰馬達表面,以免燙傷。
  6. 請勿遮蓋感測器區域(軀幹、頭部等),以免影響感測與控制。
  7. 避免在潮濕、高溫或強磁場的場所使用機器人。第 2.2 節列出的正常工作溫度為 0 至 30°C,濕度低於 80% RH。第 6.2.1 節列出的工作溫度為 0 至 40°C,相對濕度 25 至 80% RH。手冊沒有說明兩組數字的差異。
  8. 機器人通電時,或電池尚未進入休眠狀態前,請勿搬運或運送機器人。
  9. 機器人執行動作時,人員必須保持距離,並遠離手臂與腿部可及的範圍,以免遭碰撞受傷。
  10. 移動機器人請使用專用的移動機具。絕不可由一個人徒手搬運或拖拉。

2.2 了解在沒有保護架時,哪些動作可能讓機器人跌倒

如果機器人沒有被保護架撐住,有四種遙控器與按鈕操作可能使機器人跌落並損壞。

  1. 在沒有防護架支撐機器人的情況下,進行以下動作時請小心,否則機器人可能跌倒並損壞:按 'A' 鍵讓它以運行模式站立;按 'D' 鍵讓它回零;將 'E' 撥桿往下拉並按 'B' 鍵以停用關節;按下緊急停止按鈕。
  2. 讓機器人長時間待機前,請先將它固定在防護架上,以免低電量自動關機時跌倒。
  3. 電池電量很低時,請及時停止並關閉機器人,以防跌倒與損壞。

2.3 遵守充電規定

手冊列出八條充電規定,包括只能使用原廠充電器,以及冒煙時該怎麼做。

  1. 充電前請關閉機器人,並確認它已斷電。
  2. 電池充滿後請立即拔除充電器。請勿長時間連接。
  3. 充電環境必須為 0 至 45°C,濕度低於 75% RH。
  4. 僅可使用供應商隨附的原廠專用充電器充電。禁止使用第三方電源設備。
  5. 手冊建議在機器人冷卻至室溫後再開始充電。
  6. 充電時若出現冒煙、異味、過熱或變形,請立即拔除充電器並停止使用機器人。
  7. 如果電解液進入眼睛,請立即以清水沖洗,並儘快就醫。
  8. 充電需要 4 小時(Lite 規格,第 5.1 節)。手冊的文字沒有說明充電插座的位置。

3. 檢查箱子並將機器人抬出

機器人以航空箱運送。手冊的開箱照片是早期的 Lite,但手冊表示程序完全相同。

3.1 檢查箱子並核對內容物

打開航空箱側面的兩個方形鎖扣,將箱內物品與裝箱清單比對。

  1. 機器人裝在航空箱中出貨。
  2. 機器人送達現場時,請檢查箱子是否完好。若有損壞,請儘快聯絡物流公司與你所在地區的供應商。
  3. 若箱子完好,轉動蝶形鎖片,打開側面的兩個方形鎖扣。
  4. 打開箱子,依照裝箱清單核對內容物:機器人本體 x1、電源轉接器 x1、遙控器 x1、安全繩 x1、產品手冊 x1。若有缺少,請儘快聯絡售後服務補寄。

3.2 準備好保護架

原專案不提供保護架,但建議你自行配備一個,後續步驟也需要用到。

  1. 手冊的註記翻譯如下:建議你自行為機器人配備防護架。註記附有商店連結,此處不轉載。
  2. 接下來的步驟會用安全繩將機器人吊掛在防護架上,而手冊多次要求在進行某些動作前,必須先將機器人固定在防護架上。

3.3 將機器人從箱中吊出

將安全繩掛到頸部後下方的吊環上,升起保護架,讓雙腳靠在箱緣上,再將箱子推開。

  1. 將安全繩的安全鉤扣在機器人頸部後方下側的固定環上,並將安全繩連接到防護架。
  2. 操控防護架緩慢上升,將機器人吊起。
  3. 用手將機器人的雙腳放在航空箱的邊緣。
  4. 輕輕將箱子往前推,讓機器人平順地被吊到防護架上。
  5. 機器人取出後,請勿丟棄運輸箱。它是專為運送機器人及其配件而製作的。

4. 準備場地並檢查機器人

開啟電源之前,先檢查地面、房間、機器人與遙控器。

4.1 檢查場地

地面必須平整乾燥,至少有 4m 的淨空空間,房間內不得有易燃液體、氣體與強烈干擾。

  1. 地面必須平整且不濕滑。手冊不建議在不平的地面、陡坡、泥地、鬆散材料或濕滑的地面上使用。建議四周至少保留 4m 的淨空。
  2. 環境:工作溫度 0 至 40°C,相對濕度 25 至 80% RH(第 2.2 節列出的不同數字請見第 2 節)。
  3. 附近不得有易燃或腐蝕性的液體或氣體,也不得有強烈的電子雜訊源或磁場。

4.2 檢查機器人與遙控器

確認機器人吊掛在保護架上,檢查是否有鬆脫或損壞的零件,並打開遙控器、讀取其電量指示燈。

  1. 確認機器人懸掛在框架上。
  2. 檢查每個零件是否鬆動或損壞,並確認動作順暢、不會卡住。
  3. 要確認機器人電池電量充足,請先確定機器人已開機(開機步驟見第 5 節),再到診斷網頁的 7.1 機器人狀態頁面,讀取右上角的電池電量。手冊的文字沒有提供該網頁的位址。
  4. 開啟遙控器:先短按電源鍵,再長按。遙控器下方中央的指示燈會由左至右亮起,顯示其電量。亮起 1、2、3、4 顆燈分別代表 25%、50%、75% 與 100%。

5. 開機、連線並啟動程式

以下步驟適用於 Lite。它的登入密碼不在手冊中:手冊表示請洽客服。

5.1 啟動機器人電源

按下電池開關,按一次主控制開關,然後將緊急停止按鈕順時針旋轉,直到它彈起。

  1. 按下電池開關鍵。電池開關指示燈變紅,主控開關指示燈變藍。
  2. 短按主控開關鍵一次。主控開關指示燈變紅。
  3. 順時針旋轉緊急停止按鈕直到彈起。主控開關指示燈變綠。

5.2 連線到運動控制電腦並設定 Wi-Fi

將機器人背面的除錯乙太網路埠接到你的電腦,將電腦設為 192.168.41.xx,再以 ssh [email protected] 登入。

  1. 手冊的註記:本章的登入密碼必須向客服索取。
  2. 機器人最多有三塊主控板。預設:運動控制 x86,使用者名稱 ubuntu,固定位址 192.168.41.1。選配:大模型 Orin,使用者名稱 nvidia,位址 192.168.41.2。選配:導航 Orin,使用者名稱 nvidia,位址 192.168.41.3。每塊板子都有自己的 Wi-Fi,可分別設定。以下步驟使用 x86。
  3. 用乙太網路線連接機器人背面的除錯乙太網路埠與你的電腦。
  4. 將電腦的乙太網路位址設為 192.168.41.xx,子網路遮罩為 255.255.255.0。
  5. 在終端機中輸入 ping 192.168.41.1。有回應即表示與 x86 的網路連線正常。
  6. 輸入 ssh [email protected],接著輸入 yes,再輸入登入密碼。
  7. 列出可用的 Wi-Fi 熱點,記下要加入的 SSID:sudo nmcli device wifi list
  8. 加入 Wi-Fi 網路:sudo nmcli device wifi connect 'Wi-Fi SSID' password 'Wi-Fi password'
  9. 用 ifconfig 檢查無線介面的狀態。連線後,Wi-Fi 設定即完成,可以拔掉網路線。Lite SDK 文件在這項檢查中使用 iwconfig。
  10. Wi-Fi 設定好之後,往後在機器人上執行 ifconfig,讀取介面 'wlan0/wlp2s0' 的 IP 位址,再從電腦輸入 ssh [email protected],接著輸入 yes 與密碼。

5.3 啟動本體驅動程式與運動控制程式

在兩個終端機中各執行一個程式,只有在每個 current pos 值的絕對值都小於 1 時才輸入 1。

  1. 在第一個終端機中依序啟動本體驅動程式:cd rosws;sudo -s(輸入密碼);source install_isolated/setup.bash;roslaunch body_control motion_simple.launch
  2. 在第二個終端機中啟動運動控制程式:cd rosws;source install_isolated/setup.bash;roslaunch rl_control_new rl.launch
  3. 出現提示(enter 1:)時,須先確認每個 current pos 的絕對值都小於 1,才輸入 1。
  4. 若任何伺服機參數 current pos 的絕對值大於 1,請按 control+C 結束程式,並檢查是否有馬達的位置誤差過大。
  5. 若 .ros 目錄的設定檔被誤刪,導致機器人動作異常,請從 /home/ubuntu/rosws/data/ 目錄重新複製設定檔 rl_0426_4nets_opt.pt。

6. 站立、行走、跑步與停止

在保護架上使用機器人。按鍵字母以 Lite 遙控器為準。

6.1 讓機器人站在地面上

機器人仍在保護架上時以 D 歸零,將它放低,等待 30 秒,然後在 F 搖桿位於中間位置時按下 A。

  1. 按遙控器上的 'D' 鍵,讓機器人回到初始狀態。按 'D' 鍵之前,機器人必須固定在防護架上。
  2. 緩慢降下防護架,讓機器人站在地面上,並保持直立 30 秒。
  3. 在遙控器的 F 撥桿位於初始中間零位時,按 'A' 鍵讓機器人站立。站立後,觀察它是否平衡,沒有晃動,也沒有前傾或後仰。若不平衡,請重複上述步驟。

6.2 原地踏步、跑步、移動與轉向

將 F 搖桿往下拉可原地踏步,將 H 搖桿往右推可原地跑步。

  1. 手冊建議在防護架支撐下使用機器人。
  2. 啟動踏步模式:確認機器人已站立,然後將 F 撥桿往下拉。機器人會原地踏步。
  3. 切換到跑步模式:在機器人穩定踏步時,將 H 撥桿往右撥。機器人會原地跑步。
  4. 在踏步或跑步模式下,搖桿用於移動與轉動機器人,推動幅度決定速度。左搖桿上下:前進或後退。左搖桿左右:橫向移動。右搖桿左右:逆時針或順時針轉向。

6.3 停止並回到站立

將 F 搖桿回到中間並按下 A,但絕不可直接從跑步模式這樣做。

  1. 在踏步模式下:將 F 撥桿回到中間零位並按 'A' 鍵。機器人會停止移動並回到站立。
  2. 在跑步模式下:先將 F 撥桿往下拉,切回踏步模式,再將 F 撥桿回到中間零位並按 'A' 鍵。
  3. 手冊中的警告:在跑步模式下,絕不可直接將 F 撥桿回到中間零位並按 'A' 鍵。

6.4 了解遙控器按鍵

手冊列出 Lite 遙控器的十項功能。

  1. 1 回零:D。
  2. 2 凍結(僵直停止):C。
  3. 3 cmd_vel 控制模式:F 撥桿往上。
  4. 4 站立:F 撥桿置中,加上 A。
  5. 5 行走:F 撥桿往下。
  6. 6 跑步:H 撥桿往右。
  7. 7 左右移動:X1,左搖桿左右。
  8. 8 前後移動:Y1,左搖桿上下。
  9. 9 順時針或逆時針轉向:X2,右搖桿左右。
  10. 10 停用關節:E 撥桿往下加上 B。
  11. Lite SDK 文件補充,只有在 F 撥桿往上時,機器人才會依 cmd_vel 動作;否則由遙控器控制。

7. 緊急停止、關機、保養與故障

共有三種緊急停止,效果各不相同。在讓機器人站到地面上之前,先熟悉它們。

7.1 使用正確的緊急停止方式

C 會鎖定關節,E 往下再按 B 會切斷關節電源,背面的紅色按鈕則會切斷電源。

  1. 若機器人失控,請立即按遙控器上的 'C' 鍵,讓所有關節僵直,並儘快採取保護措施。若來不及生效,請迅速按下機器人背部的緊急停止按鈕以切斷電源。
  2. 凍結,'C' 鍵:當機器人動作異常(例如速度或方向錯誤),或預見有風險(例如機器人即將碰到障礙物或人而無法及時停下)時,請立即按下。所有關節會立即凍結,本體無法維持平衡,因此需要防跌保護,並應儘快扶住機器人。
  3. 停用關節,'E' 撥桿往下並同時按 'B' 鍵:用於突發故障,例如可能造成更大損害的感測器或電子零件故障,或在不安全的位置或角度下姿態不穩。關節會斷電,機器人會立即癱軟倒下。執行前,機器人必須固定在防護架上。
  4. 機器人背部的緊急停止按鈕:立即按下,然後按主控開關與電源開關以切斷所有電源,並聯絡供應商的售後服務。適用情況:冒煙或有燒焦味;機器人進水或有異物;遙控器或其他方式都無法停止的失控;可能造成進一步危險的損壞;緊急避險,例如在高處或危險場所失控;以及周遭環境突變,例如地震或火災。機器人無法維持任何姿態,會立即癱軟倒下。按下按鈕前,機器人必須固定在防護架上。

7.2 關閉機器人

依序停止程式,執行 poweroff,再依序操作各開關與遙控器。

  1. 確認機器人已停止並回到站立。
  2. 按遙控器上的 'C' 鍵凍結機器人。
  3. 將機器人固定在防護架上並吊起。
  4. 在為這些程式開啟的終端機中,先按 control+C 停止運動控制程式,再按 control+C 停止本體驅動程式。
  5. 兩個程式都停止後,在本體驅動程式的終端機中輸入指令 poweroff。
  6. 按下緊急停止按鈕。主控開關指示燈變紅。
  7. 按住主控開關鍵 6 秒。主控開關指示燈變藍。較新的 Lite SDK 文件只寫「按主控開關鍵」,沒有提到時間。
  8. 按下電池開關鍵。
  9. 在遙控器上先短按電源鍵,再長按,以關閉遙控器。

7.3 進行日常檢查、搬運與清潔

檢查外殼、電池接頭、感測器、馬達、燈號與遙控器;只有在機器人關機時才能搬運與清潔。

  1. 每日檢查:外殼是否損壞、變形或鬆動;電池及其接頭是否牢固;感測器是否乾淨;馬達是否運轉正常、沒有異常晃動或噪音;指示燈是否持續亮著;以及遙控器是否正常運作。
  2. 搬運:機器人以專為它及其配件訂製的航空箱搬運。搬運機器人前,請完全關機並切斷電源,並確認緊急停止按鈕已彈起。關節可能夾到手指與其他身體部位,或捲入寬鬆衣物與長髮,請格外小心。
  3. 清潔:請先完全關機並切斷電源,確認緊急停止按鈕已彈起,且未接上充電器。不要讓噴霧、含酒精的溶液或水柱直接接觸機器人。用柔軟的乾布擦拭外殼與感測器區域,尤其是攝影機。

7.4 照顧電池並存放機器人

避免過度充電與過度放電,以 50% 電量存放,並每 3 個月補充一次電量。

  1. 避免過度充電與過度放電。使用後請及時切斷電源。不建議長時間插著充電器。
  2. 長期不使用時,存放前將電池充到 50% 電量,並每 3 個月補充一次電量,以免深度放電導致容量快速下降並縮短循環壽命。
  3. 若電池老化、膨脹或續航力大幅下降,請儘快聯絡技術支援更換。
  4. 存放於乾燥、通風、無塵的場所。建議溫度為 -4 至 45°C。遠離腐蝕性氣體、易燃物與強電磁源。建議存放在原本的運輸箱中。

7.5 從站姿不穩中恢復,並了解保固條款

站立不穩代表需要重新平衡 IMU:鎖定、吊起、歸零、直立等待 2 分鐘,再重新站立。

  1. 機器人無法開機:電池可能沒電,請檢查電量。
  2. 機器人站立或行走不穩(IMU 積分資料需要平衡校正):按 'C' 凍結;升起防護架吊起機器人;按 'D' 回零;降下防護架讓機器人站在地面並保持直立 2 分鐘,使 IMU 資料恢復平衡;將 F 撥桿回到中間零位並按 'A' 站立,檢查是否恢復平衡。若沒有,請重複。
  3. 零位姿態不正確(零位校正資料遺失,或運行或搬運時受撞擊導致零位偏移):請聯絡售後工程師進行零位校正。
  4. 保固:自收貨日起算,僅涵蓋非人為造成的效能故障。主機機器人及其零件、關節馬達,以及電池與電源轉接器保固 1 年。外殼等保護性零件不在保固範圍內。因使用不當、誤操作、摔落、進水或撞擊,以及未經授權拆解或維修所造成的損壞,不在保固範圍內。退回產品時由使用者支付運費。維修可能導致資料遺失,請先備份。

8. 如果你手上是 Pro:不同之處

Pro 手冊依循 Lite 的程序,並有以下變更。它的開箱照片是 Lite,並表示程序完全相同。當 Pro 手冊與 Pro SDK 文件的按鍵字母不一致時,本指南以手冊為準,其遙控器上沒有 C 鍵。

8.1 了解 Pro 遙控器及其限制

Pro 遙控器以 A 歸零、B 鎖定、X 站立、Y 行走。

  1. Pro 遙控器按鍵:1 回零,A;2 凍結(僵直停止),B;3 站立,X;4 行走,Y;5 前後左右移動,左搖桿;6 順時針或逆時針轉向,右搖桿。
  2. 機器人失控:立即按 'B' 鍵凍結所有關節,並採取保護措施。若來不及生效,請按下機器人背部的緊急停止按鈕。
  3. 沒有防護架時,按 'A' 鍵回零與按下緊急停止按鈕都要小心,否則機器人可能跌倒並損壞。Pro 手冊的清單中沒有停用關節的動作。
  4. Pro 手冊重複了 Lite 的使用與充電規則(18 歲以上;充電時 0 至 45°C、濕度低於 75% RH;僅限原廠充電器),以及相同的裝箱清單。

8.2 了解 Pro 電池

Pro 手冊提供電池規格表:標稱 48V,工作範圍 39 至 54.6V,15Ah。

  1. 類型:三元鋰。標稱電壓 48V。工作電壓範圍 39 至 54.6V,其中 39V 與 54.6V 分別為放電截止與充電截止電壓。額定容量 15Ah。
  2. 充電模式 CC/CV(定電流、定電壓)。充電電流 2 至 10A。最大放電電流為連續 60A,峰值 90A 持續 1 秒。
  3. 重量約 3.1kg。充電溫度 0 至 45°C。放電溫度 -20 至 60°C。
  4. 存放溫度:-20 至 60°C 可存放 1 個月;-20 至 40°C 可存放 3 個月;-20 至 25°C 可存放 1 年。循環壽命 250 次以上。內阻低於 160 毫歐姆。

8.3 以 SMART BMS app 檢查 Pro 電池並打開遙控器

Pro 電池的狀態是透過藍牙在 SMART BMS app 中讀取,而不是在診斷頁面上。

  1. 確認機器人吊掛在防護架上,並檢查各部位是否鬆動或損壞,以及動作是否順暢。
  2. 機器人開機狀態下(Pro 的開機步驟見下方):下載 SMART BMS app 並開啟手機藍牙。開啟 app,點選 'local monitoring',再點選 'single group'。在機器人本體上找到電池編號,在清單中找到它並點選 '+' 連線。開啟已連線的電池:錶盤下方的數字即為電量。要讀取另一顆電池,請先點選 '-' 中斷連線。
  3. 遙控器關機充電時:Home 燈會以不同顏色呼吸閃爍:紅色 0 至 25%,橙色 25 至 50%,黃色 50 至 75%,綠色 75 至 90%,綠色 2 秒後熄滅為 90 至 100%。按住 Home 鍵 1 至 3 秒即可開機。

8.4 啟動 Pro 電源並打開背板以使用網路埠

按下電池開關,再按下主控制開關,然後解除緊急停止;依 Pro 手冊,要使用除錯乙太網路埠,需拆下背板上的六顆螺絲。

  1. 按下電池開關鍵。按下主控開關鍵。順時針旋轉緊急停止按鈕直到彈起。
  2. 主控板:運動控制 x86(ubuntu,192.168.41.1)、大模型 Orin(nvidia,192.168.41.2)、導航 Orin(nvidia,192.168.41.3)。Pro 手冊表示,登入密碼須向客服索取。
  3. 設定 Wi-Fi 時,Pro 手冊要求你卸下機器人背板上的六顆螺絲並取下背板,然後依照 Lite 的網路步驟操作(網路線接到除錯乙太網路埠、電腦設為 192.168.41.xx / 255.255.255.0、ping、ssh、nmcli、ifconfig)。這是手冊中唯一要求你打開機器人的地方。

8.5 啟動 Pro 的三個程式

Pro 會執行本體驅動程式、手臂驅動程式與運動控制程式,各在自己的終端機中執行。

  1. 第一個終端機,本體驅動:cd rosws;sudo -s(輸入密碼);source install_isolated/setup.bash;roslaunch body_control motion_evt.launch
  2. 第二個終端機,手臂驅動:cd catkin_ws;sudo -s(輸入密碼);source install_isolated/setup.bash;roslaunch aubo_dev_plugin aubo_dev_all.launch
  3. 第三個終端機,運動控制程式:cd rosws;source install_isolated/setup.bash;roslaunch motion_control motion.launch
  4. 在第三個終端機中,須先確認每個 current pos 的絕對值都小於 1,才在提示(enter 1:)處輸入 1。若任何 current pos 的絕對值大於 1,請按 control+C 結束程式,並檢查是否有馬達的位置誤差過大。

8.6 讓 Pro 站立、行走、停止與關機

在保護架上以 A 歸零,以 X 站立,以 Y 行走,以 B 鎖定;依 Pro 的順序關機。

  1. 按 'A' 鍵回到初始狀態。按 'A' 鍵之前,機器人必須固定在防護架上。降下防護架,讓機器人保持直立 30 秒,然後按 'X' 站立,並檢查是否晃動或傾倒。若不平衡,請重複。
  2. 行走:機器人站立時按 'Y',它會原地踏步。左搖桿上下:前進或後退。左搖桿左右:橫向移動。右搖桿左右:逆時針或順時針。按 'X' 停止並回到站立。
  3. 緊急停止按鈕:用於冒煙或有燒焦味、進水或有異物、失控、損壞、緊急避險或周遭環境突變等情況,按下後再按主控與電源開關,並聯絡售後服務。機器人必須先固定在防護架上。
  4. 關機:確認機器人已站立;按 'B' 凍結;將它固定在防護架上並吊起;按 control+C 依序停止運動控制程式、手臂驅動、本體驅動;三者都停止後,在本體驅動的終端機輸入 poweroff;按下緊急停止按鈕;按主控開關鍵;按電池開關鍵;按住 Home 鍵 5 秒以關閉遙控器。
  5. 站立不穩:按 'B',吊起機器人,按 'A' 回零,放下並讓它保持直立 2 分鐘,然後按 'X' 站立。

9. 選配:TienKung-Lab 中的模擬設置

這部分不需要機器人。這是原專案為 TienKung 提供的強化學習工作流程,需要 NVIDIA Omniverse 產品 Isaac Sim。

9.1 安裝 TienKung-Lab 並確認能執行

安裝 Isaac Lab,在其目錄之外複製 TienKung-Lab,以 pip 安裝兩個套件,並執行一次簡短的行走訓練。

  1. TienKung-Lab 以 IsaacSim 4.5.0 與 IsaacLab 2.1.0 建置。
  2. 依照 Isaac Lab 的安裝指南安裝。原專案建議使用 conda 安裝,因為這樣從終端機呼叫 Python 腳本比較簡單。
  3. 將本儲存庫與 Isaac Lab 的安裝分開複製,放在 IsaacLab 目錄之外。
  4. 使用已安裝 Isaac Lab 的 Python 直譯器,執行:cd TienKung-Lab,然後 pip install -e .
  5. 安裝 rsl-rl 函式庫:cd TienKung-Lab/rsl_rl,然後 pip install -e .
  6. 檢查安裝:python legged_lab/scripts/train.py --task=walk --logger=tensorboard --headless --num_envs=64
  7. 原專案的徽章列出 Python 3.10、Linux 平台上的 Ubuntu 22.04,以及 RSL_RL 2.3.1。

9.2 在實體機器人上測試前,留意原專案的警告

原專案表示,訓練出的策略可能導致非預期或劇烈的動作。

  1. 原專案的安全注意事項,原文如下:「在真實機器人上測試有風險。RL 策略可能造成非預期或劇烈的動作,因此請確認已投保意外險,且緊急停止功能正常。」
  2. README 指向用於部署的 Deploy_Tienkung 儲存庫。該儲存庫列出 Ubuntu 22.04 LTS 與 ROS2 Humble,而 2025 年 5 月的手冊描述的是 ROS 1。原專案沒有說明部署儲存庫在哪些機器人上驗證過,因此本指南不提供部署步驟。

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