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 手冊列出一具組裝完成的機器人本體,連同電源轉接器、遙控器、安全繩與產品手冊,並禁止未經授權的拆解。
- 裝箱清單列出:機器人本體 x1、電源轉接器 x1、遙控器 x1、安全繩 x1、產品手冊 x1。
- 手冊表示,如需維修應聯絡官方售後服務,且不建議使用者自行拆解機器人。
- 手冊寫道:未經授權,請勿改裝或拆解機器人或其零件。
- 保固條款表示,使用者若未經授權改裝、拆解或維修機器人,即視為放棄保固,且供應商不授權任何第三方進行維修。
- 手冊沒有組裝章節。原專案的 TienKung_URDF 儲存庫描述了 STEP 格式的完整組裝圖,分別為 Lite(檔案 TG10-00)與 Pro(檔案 TG11-00),可從原專案網站下載。這些檔案約 453 MB 與 824 MB,未經閱讀。原專案沒有發布依這些檔案組裝的步驟清單。
1.2 了解這些文件描述的是哪一款機器人
這些文件適用於 TienKung Lite 與 Pro;原專案的 3.0 SDK 範例屬於另一個平台。
- Lite,依 Lite 手冊:身高 1630mm,淨重 43kg,20 個整合式關節(每支手臂 4 個 x2,每條腿 6 個 x2),Intel x86 運動控制電腦,2 台 RGBD 攝影機(頭部、胸部),在 Ubuntu22.04.4 LTS 上執行 ROS 1。
- Pro,依 Pro 手冊:身高 1630mm,淨重 56kg,總計 42 個自由度,4 台 RGBD 攝影機(頭部、胸部、腰部、背部),2 台 Orin AGX 64 開發電腦,在 Ubuntu22.04.4 LTS 上執行 ROS 1。
- 原專案的 xhumanoid_sdk 儲存庫適用於它稱為 Embodied TienKung 3.0(Thor)的機器人。它需要機器人上安裝 Ubuntu 24.04 與 ROS 2 Jazzy,以 ssh [email protected] 登入,並將 Livox LiDAR 點雲範例列為標準硬體。這是一個 SDK 範例儲存庫,沒有提供開箱或開機步驟。
- 不要假設第 2 至 8 節的步驟適用於 3.0 機器人。這些步驟僅取自 Lite 與 Pro 手冊。
2. Lite 手冊中的安全規則
在把機器人從箱中抬出之前請先閱讀。這些是手冊本身的規則,保留其編號。
2.1 遵守誰可以使用機器人以及如何使用的規定
手冊限制了使用者、工作條件與搬運方式,並要求讓人員遠離手臂與腿部可觸及的範圍。
- 本機器人僅供 18 歲以上人士使用。
- 手冊不建議感官或認知能力受限、或沒有經驗的使用者在無人協助下單獨使用機器人。
- 請正確使用機器人零件與配件。未經授權請勿改裝或拆解。
- 手指、頭髮與衣物應遠離關節、縫隙與活動部位,以免被夾住或纏繞。
- 機器人運轉時請勿觸碰馬達表面,以免燙傷。
- 請勿遮蓋感測器區域(軀幹、頭部等),以免影響感測與控制。
- 避免在潮濕、高溫或強磁場的場所使用機器人。第 2.2 節列出的正常工作溫度為 0 至 30°C,濕度低於 80% RH。第 6.2.1 節列出的工作溫度為 0 至 40°C,相對濕度 25 至 80% RH。手冊沒有說明兩組數字的差異。
- 機器人通電時,或電池尚未進入休眠狀態前,請勿搬運或運送機器人。
- 機器人執行動作時,人員必須保持距離,並遠離手臂與腿部可及的範圍,以免遭碰撞受傷。
- 移動機器人請使用專用的移動機具。絕不可由一個人徒手搬運或拖拉。
2.2 了解在沒有保護架時,哪些動作可能讓機器人跌倒
如果機器人沒有被保護架撐住,有四種遙控器與按鈕操作可能使機器人跌落並損壞。
- 在沒有防護架支撐機器人的情況下,進行以下動作時請小心,否則機器人可能跌倒並損壞:按 'A' 鍵讓它以運行模式站立;按 'D' 鍵讓它回零;將 'E' 撥桿往下拉並按 'B' 鍵以停用關節;按下緊急停止按鈕。
- 讓機器人長時間待機前,請先將它固定在防護架上,以免低電量自動關機時跌倒。
- 電池電量很低時,請及時停止並關閉機器人,以防跌倒與損壞。
2.3 遵守充電規定
手冊列出八條充電規定,包括只能使用原廠充電器,以及冒煙時該怎麼做。
- 充電前請關閉機器人,並確認它已斷電。
- 電池充滿後請立即拔除充電器。請勿長時間連接。
- 充電環境必須為 0 至 45°C,濕度低於 75% RH。
- 僅可使用供應商隨附的原廠專用充電器充電。禁止使用第三方電源設備。
- 手冊建議在機器人冷卻至室溫後再開始充電。
- 充電時若出現冒煙、異味、過熱或變形,請立即拔除充電器並停止使用機器人。
- 如果電解液進入眼睛,請立即以清水沖洗,並儘快就醫。
- 充電需要 4 小時(Lite 規格,第 5.1 節)。手冊的文字沒有說明充電插座的位置。
3. 檢查箱子並將機器人抬出
機器人以航空箱運送。手冊的開箱照片是早期的 Lite,但手冊表示程序完全相同。
3.1 檢查箱子並核對內容物
打開航空箱側面的兩個方形鎖扣,將箱內物品與裝箱清單比對。
- 機器人裝在航空箱中出貨。
- 機器人送達現場時,請檢查箱子是否完好。若有損壞,請儘快聯絡物流公司與你所在地區的供應商。
- 若箱子完好,轉動蝶形鎖片,打開側面的兩個方形鎖扣。
- 打開箱子,依照裝箱清單核對內容物:機器人本體 x1、電源轉接器 x1、遙控器 x1、安全繩 x1、產品手冊 x1。若有缺少,請儘快聯絡售後服務補寄。
3.2 準備好保護架
原專案不提供保護架,但建議你自行配備一個,後續步驟也需要用到。
- 手冊的註記翻譯如下:建議你自行為機器人配備防護架。註記附有商店連結,此處不轉載。
- 接下來的步驟會用安全繩將機器人吊掛在防護架上,而手冊多次要求在進行某些動作前,必須先將機器人固定在防護架上。
3.3 將機器人從箱中吊出
將安全繩掛到頸部後下方的吊環上,升起保護架,讓雙腳靠在箱緣上,再將箱子推開。
- 將安全繩的安全鉤扣在機器人頸部後方下側的固定環上,並將安全繩連接到防護架。
- 操控防護架緩慢上升,將機器人吊起。
- 用手將機器人的雙腳放在航空箱的邊緣。
- 輕輕將箱子往前推,讓機器人平順地被吊到防護架上。
- 機器人取出後,請勿丟棄運輸箱。它是專為運送機器人及其配件而製作的。
4. 準備場地並檢查機器人
開啟電源之前,先檢查地面、房間、機器人與遙控器。
4.1 檢查場地
地面必須平整乾燥,至少有 4m 的淨空空間,房間內不得有易燃液體、氣體與強烈干擾。
- 地面必須平整且不濕滑。手冊不建議在不平的地面、陡坡、泥地、鬆散材料或濕滑的地面上使用。建議四周至少保留 4m 的淨空。
- 環境:工作溫度 0 至 40°C,相對濕度 25 至 80% RH(第 2.2 節列出的不同數字請見第 2 節)。
- 附近不得有易燃或腐蝕性的液體或氣體,也不得有強烈的電子雜訊源或磁場。
4.2 檢查機器人與遙控器
確認機器人吊掛在保護架上,檢查是否有鬆脫或損壞的零件,並打開遙控器、讀取其電量指示燈。
- 確認機器人懸掛在框架上。
- 檢查每個零件是否鬆動或損壞,並確認動作順暢、不會卡住。
- 要確認機器人電池電量充足,請先確定機器人已開機(開機步驟見第 5 節),再到診斷網頁的 7.1 機器人狀態頁面,讀取右上角的電池電量。手冊的文字沒有提供該網頁的位址。
- 開啟遙控器:先短按電源鍵,再長按。遙控器下方中央的指示燈會由左至右亮起,顯示其電量。亮起 1、2、3、4 顆燈分別代表 25%、50%、75% 與 100%。
5. 開機、連線並啟動程式
以下步驟適用於 Lite。它的登入密碼不在手冊中:手冊表示請洽客服。
5.1 啟動機器人電源
按下電池開關,按一次主控制開關,然後將緊急停止按鈕順時針旋轉,直到它彈起。
- 按下電池開關鍵。電池開關指示燈變紅,主控開關指示燈變藍。
- 短按主控開關鍵一次。主控開關指示燈變紅。
- 順時針旋轉緊急停止按鈕直到彈起。主控開關指示燈變綠。
5.2 連線到運動控制電腦並設定 Wi-Fi
將機器人背面的除錯乙太網路埠接到你的電腦,將電腦設為 192.168.41.xx,再以 ssh [email protected] 登入。
- 手冊的註記:本章的登入密碼必須向客服索取。
- 機器人最多有三塊主控板。預設:運動控制 x86,使用者名稱 ubuntu,固定位址 192.168.41.1。選配:大模型 Orin,使用者名稱 nvidia,位址 192.168.41.2。選配:導航 Orin,使用者名稱 nvidia,位址 192.168.41.3。每塊板子都有自己的 Wi-Fi,可分別設定。以下步驟使用 x86。
- 用乙太網路線連接機器人背面的除錯乙太網路埠與你的電腦。
- 將電腦的乙太網路位址設為 192.168.41.xx,子網路遮罩為 255.255.255.0。
- 在終端機中輸入 ping 192.168.41.1。有回應即表示與 x86 的網路連線正常。
- 輸入 ssh [email protected],接著輸入 yes,再輸入登入密碼。
- 列出可用的 Wi-Fi 熱點,記下要加入的 SSID:sudo nmcli device wifi list
- 加入 Wi-Fi 網路:sudo nmcli device wifi connect 'Wi-Fi SSID' password 'Wi-Fi password'
- 用 ifconfig 檢查無線介面的狀態。連線後,Wi-Fi 設定即完成,可以拔掉網路線。Lite SDK 文件在這項檢查中使用 iwconfig。
- Wi-Fi 設定好之後,往後在機器人上執行 ifconfig,讀取介面 'wlan0/wlp2s0' 的 IP 位址,再從電腦輸入 ssh [email protected],接著輸入 yes 與密碼。
5.3 啟動本體驅動程式與運動控制程式
在兩個終端機中各執行一個程式,只有在每個 current pos 值的絕對值都小於 1 時才輸入 1。
- 在第一個終端機中依序啟動本體驅動程式:cd rosws;sudo -s(輸入密碼);source install_isolated/setup.bash;roslaunch body_control motion_simple.launch
- 在第二個終端機中啟動運動控制程式:cd rosws;source install_isolated/setup.bash;roslaunch rl_control_new rl.launch
- 出現提示(enter 1:)時,須先確認每個 current pos 的絕對值都小於 1,才輸入 1。
- 若任何伺服機參數 current pos 的絕對值大於 1,請按 control+C 結束程式,並檢查是否有馬達的位置誤差過大。
- 若 .ros 目錄的設定檔被誤刪,導致機器人動作異常,請從 /home/ubuntu/rosws/data/ 目錄重新複製設定檔 rl_0426_4nets_opt.pt。
6. 站立、行走、跑步與停止
在保護架上使用機器人。按鍵字母以 Lite 遙控器為準。
6.1 讓機器人站在地面上
機器人仍在保護架上時以 D 歸零,將它放低,等待 30 秒,然後在 F 搖桿位於中間位置時按下 A。
- 按遙控器上的 'D' 鍵,讓機器人回到初始狀態。按 'D' 鍵之前,機器人必須固定在防護架上。
- 緩慢降下防護架,讓機器人站在地面上,並保持直立 30 秒。
- 在遙控器的 F 撥桿位於初始中間零位時,按 'A' 鍵讓機器人站立。站立後,觀察它是否平衡,沒有晃動,也沒有前傾或後仰。若不平衡,請重複上述步驟。
6.2 原地踏步、跑步、移動與轉向
將 F 搖桿往下拉可原地踏步,將 H 搖桿往右推可原地跑步。
- 手冊建議在防護架支撐下使用機器人。
- 啟動踏步模式:確認機器人已站立,然後將 F 撥桿往下拉。機器人會原地踏步。
- 切換到跑步模式:在機器人穩定踏步時,將 H 撥桿往右撥。機器人會原地跑步。
- 在踏步或跑步模式下,搖桿用於移動與轉動機器人,推動幅度決定速度。左搖桿上下:前進或後退。左搖桿左右:橫向移動。右搖桿左右:逆時針或順時針轉向。
6.3 停止並回到站立
將 F 搖桿回到中間並按下 A,但絕不可直接從跑步模式這樣做。
- 在踏步模式下:將 F 撥桿回到中間零位並按 'A' 鍵。機器人會停止移動並回到站立。
- 在跑步模式下:先將 F 撥桿往下拉,切回踏步模式,再將 F 撥桿回到中間零位並按 'A' 鍵。
- 手冊中的警告:在跑步模式下,絕不可直接將 F 撥桿回到中間零位並按 'A' 鍵。
6.4 了解遙控器按鍵
手冊列出 Lite 遙控器的十項功能。
- 1 回零:D。
- 2 凍結(僵直停止):C。
- 3 cmd_vel 控制模式:F 撥桿往上。
- 4 站立:F 撥桿置中,加上 A。
- 5 行走:F 撥桿往下。
- 6 跑步:H 撥桿往右。
- 7 左右移動:X1,左搖桿左右。
- 8 前後移動:Y1,左搖桿上下。
- 9 順時針或逆時針轉向:X2,右搖桿左右。
- 10 停用關節:E 撥桿往下加上 B。
- Lite SDK 文件補充,只有在 F 撥桿往上時,機器人才會依 cmd_vel 動作;否則由遙控器控制。
7. 緊急停止、關機、保養與故障
共有三種緊急停止,效果各不相同。在讓機器人站到地面上之前,先熟悉它們。
7.1 使用正確的緊急停止方式
C 會鎖定關節,E 往下再按 B 會切斷關節電源,背面的紅色按鈕則會切斷電源。
- 若機器人失控,請立即按遙控器上的 'C' 鍵,讓所有關節僵直,並儘快採取保護措施。若來不及生效,請迅速按下機器人背部的緊急停止按鈕以切斷電源。
- 凍結,'C' 鍵:當機器人動作異常(例如速度或方向錯誤),或預見有風險(例如機器人即將碰到障礙物或人而無法及時停下)時,請立即按下。所有關節會立即凍結,本體無法維持平衡,因此需要防跌保護,並應儘快扶住機器人。
- 停用關節,'E' 撥桿往下並同時按 'B' 鍵:用於突發故障,例如可能造成更大損害的感測器或電子零件故障,或在不安全的位置或角度下姿態不穩。關節會斷電,機器人會立即癱軟倒下。執行前,機器人必須固定在防護架上。
- 機器人背部的緊急停止按鈕:立即按下,然後按主控開關與電源開關以切斷所有電源,並聯絡供應商的售後服務。適用情況:冒煙或有燒焦味;機器人進水或有異物;遙控器或其他方式都無法停止的失控;可能造成進一步危險的損壞;緊急避險,例如在高處或危險場所失控;以及周遭環境突變,例如地震或火災。機器人無法維持任何姿態,會立即癱軟倒下。按下按鈕前,機器人必須固定在防護架上。
7.2 關閉機器人
依序停止程式,執行 poweroff,再依序操作各開關與遙控器。
- 確認機器人已停止並回到站立。
- 按遙控器上的 'C' 鍵凍結機器人。
- 將機器人固定在防護架上並吊起。
- 在為這些程式開啟的終端機中,先按 control+C 停止運動控制程式,再按 control+C 停止本體驅動程式。
- 兩個程式都停止後,在本體驅動程式的終端機中輸入指令 poweroff。
- 按下緊急停止按鈕。主控開關指示燈變紅。
- 按住主控開關鍵 6 秒。主控開關指示燈變藍。較新的 Lite SDK 文件只寫「按主控開關鍵」,沒有提到時間。
- 按下電池開關鍵。
- 在遙控器上先短按電源鍵,再長按,以關閉遙控器。
7.3 進行日常檢查、搬運與清潔
檢查外殼、電池接頭、感測器、馬達、燈號與遙控器;只有在機器人關機時才能搬運與清潔。
- 每日檢查:外殼是否損壞、變形或鬆動;電池及其接頭是否牢固;感測器是否乾淨;馬達是否運轉正常、沒有異常晃動或噪音;指示燈是否持續亮著;以及遙控器是否正常運作。
- 搬運:機器人以專為它及其配件訂製的航空箱搬運。搬運機器人前,請完全關機並切斷電源,並確認緊急停止按鈕已彈起。關節可能夾到手指與其他身體部位,或捲入寬鬆衣物與長髮,請格外小心。
- 清潔:請先完全關機並切斷電源,確認緊急停止按鈕已彈起,且未接上充電器。不要讓噴霧、含酒精的溶液或水柱直接接觸機器人。用柔軟的乾布擦拭外殼與感測器區域,尤其是攝影機。
7.4 照顧電池並存放機器人
避免過度充電與過度放電,以 50% 電量存放,並每 3 個月補充一次電量。
- 避免過度充電與過度放電。使用後請及時切斷電源。不建議長時間插著充電器。
- 長期不使用時,存放前將電池充到 50% 電量,並每 3 個月補充一次電量,以免深度放電導致容量快速下降並縮短循環壽命。
- 若電池老化、膨脹或續航力大幅下降,請儘快聯絡技術支援更換。
- 存放於乾燥、通風、無塵的場所。建議溫度為 -4 至 45°C。遠離腐蝕性氣體、易燃物與強電磁源。建議存放在原本的運輸箱中。
7.5 從站姿不穩中恢復,並了解保固條款
站立不穩代表需要重新平衡 IMU:鎖定、吊起、歸零、直立等待 2 分鐘,再重新站立。
- 機器人無法開機:電池可能沒電,請檢查電量。
- 機器人站立或行走不穩(IMU 積分資料需要平衡校正):按 'C' 凍結;升起防護架吊起機器人;按 'D' 回零;降下防護架讓機器人站在地面並保持直立 2 分鐘,使 IMU 資料恢復平衡;將 F 撥桿回到中間零位並按 'A' 站立,檢查是否恢復平衡。若沒有,請重複。
- 零位姿態不正確(零位校正資料遺失,或運行或搬運時受撞擊導致零位偏移):請聯絡售後工程師進行零位校正。
- 保固:自收貨日起算,僅涵蓋非人為造成的效能故障。主機機器人及其零件、關節馬達,以及電池與電源轉接器保固 1 年。外殼等保護性零件不在保固範圍內。因使用不當、誤操作、摔落、進水或撞擊,以及未經授權拆解或維修所造成的損壞,不在保固範圍內。退回產品時由使用者支付運費。維修可能導致資料遺失,請先備份。
8. 如果你手上是 Pro:不同之處
Pro 手冊依循 Lite 的程序,並有以下變更。它的開箱照片是 Lite,並表示程序完全相同。當 Pro 手冊與 Pro SDK 文件的按鍵字母不一致時,本指南以手冊為準,其遙控器上沒有 C 鍵。
8.1 了解 Pro 遙控器及其限制
Pro 遙控器以 A 歸零、B 鎖定、X 站立、Y 行走。
- Pro 遙控器按鍵:1 回零,A;2 凍結(僵直停止),B;3 站立,X;4 行走,Y;5 前後左右移動,左搖桿;6 順時針或逆時針轉向,右搖桿。
- 機器人失控:立即按 'B' 鍵凍結所有關節,並採取保護措施。若來不及生效,請按下機器人背部的緊急停止按鈕。
- 沒有防護架時,按 'A' 鍵回零與按下緊急停止按鈕都要小心,否則機器人可能跌倒並損壞。Pro 手冊的清單中沒有停用關節的動作。
- Pro 手冊重複了 Lite 的使用與充電規則(18 歲以上;充電時 0 至 45°C、濕度低於 75% RH;僅限原廠充電器),以及相同的裝箱清單。
8.2 了解 Pro 電池
Pro 手冊提供電池規格表:標稱 48V,工作範圍 39 至 54.6V,15Ah。
- 類型:三元鋰。標稱電壓 48V。工作電壓範圍 39 至 54.6V,其中 39V 與 54.6V 分別為放電截止與充電截止電壓。額定容量 15Ah。
- 充電模式 CC/CV(定電流、定電壓)。充電電流 2 至 10A。最大放電電流為連續 60A,峰值 90A 持續 1 秒。
- 重量約 3.1kg。充電溫度 0 至 45°C。放電溫度 -20 至 60°C。
- 存放溫度:-20 至 60°C 可存放 1 個月;-20 至 40°C 可存放 3 個月;-20 至 25°C 可存放 1 年。循環壽命 250 次以上。內阻低於 160 毫歐姆。
8.3 以 SMART BMS app 檢查 Pro 電池並打開遙控器
Pro 電池的狀態是透過藍牙在 SMART BMS app 中讀取,而不是在診斷頁面上。
- 確認機器人吊掛在防護架上,並檢查各部位是否鬆動或損壞,以及動作是否順暢。
- 機器人開機狀態下(Pro 的開機步驟見下方):下載 SMART BMS app 並開啟手機藍牙。開啟 app,點選 'local monitoring',再點選 'single group'。在機器人本體上找到電池編號,在清單中找到它並點選 '+' 連線。開啟已連線的電池:錶盤下方的數字即為電量。要讀取另一顆電池,請先點選 '-' 中斷連線。
- 遙控器關機充電時:Home 燈會以不同顏色呼吸閃爍:紅色 0 至 25%,橙色 25 至 50%,黃色 50 至 75%,綠色 75 至 90%,綠色 2 秒後熄滅為 90 至 100%。按住 Home 鍵 1 至 3 秒即可開機。
8.4 啟動 Pro 電源並打開背板以使用網路埠
按下電池開關,再按下主控制開關,然後解除緊急停止;依 Pro 手冊,要使用除錯乙太網路埠,需拆下背板上的六顆螺絲。
- 按下電池開關鍵。按下主控開關鍵。順時針旋轉緊急停止按鈕直到彈起。
- 主控板:運動控制 x86(ubuntu,192.168.41.1)、大模型 Orin(nvidia,192.168.41.2)、導航 Orin(nvidia,192.168.41.3)。Pro 手冊表示,登入密碼須向客服索取。
- 設定 Wi-Fi 時,Pro 手冊要求你卸下機器人背板上的六顆螺絲並取下背板,然後依照 Lite 的網路步驟操作(網路線接到除錯乙太網路埠、電腦設為 192.168.41.xx / 255.255.255.0、ping、ssh、nmcli、ifconfig)。這是手冊中唯一要求你打開機器人的地方。
8.5 啟動 Pro 的三個程式
Pro 會執行本體驅動程式、手臂驅動程式與運動控制程式,各在自己的終端機中執行。
- 第一個終端機,本體驅動:cd rosws;sudo -s(輸入密碼);source install_isolated/setup.bash;roslaunch body_control motion_evt.launch
- 第二個終端機,手臂驅動:cd catkin_ws;sudo -s(輸入密碼);source install_isolated/setup.bash;roslaunch aubo_dev_plugin aubo_dev_all.launch
- 第三個終端機,運動控制程式:cd rosws;source install_isolated/setup.bash;roslaunch motion_control motion.launch
- 在第三個終端機中,須先確認每個 current pos 的絕對值都小於 1,才在提示(enter 1:)處輸入 1。若任何 current pos 的絕對值大於 1,請按 control+C 結束程式,並檢查是否有馬達的位置誤差過大。
8.6 讓 Pro 站立、行走、停止與關機
在保護架上以 A 歸零,以 X 站立,以 Y 行走,以 B 鎖定;依 Pro 的順序關機。
- 按 'A' 鍵回到初始狀態。按 'A' 鍵之前,機器人必須固定在防護架上。降下防護架,讓機器人保持直立 30 秒,然後按 'X' 站立,並檢查是否晃動或傾倒。若不平衡,請重複。
- 行走:機器人站立時按 'Y',它會原地踏步。左搖桿上下:前進或後退。左搖桿左右:橫向移動。右搖桿左右:逆時針或順時針。按 'X' 停止並回到站立。
- 緊急停止按鈕:用於冒煙或有燒焦味、進水或有異物、失控、損壞、緊急避險或周遭環境突變等情況,按下後再按主控與電源開關,並聯絡售後服務。機器人必須先固定在防護架上。
- 關機:確認機器人已站立;按 'B' 凍結;將它固定在防護架上並吊起;按 control+C 依序停止運動控制程式、手臂驅動、本體驅動;三者都停止後,在本體驅動的終端機輸入 poweroff;按下緊急停止按鈕;按主控開關鍵;按電池開關鍵;按住 Home 鍵 5 秒以關閉遙控器。
- 站立不穩:按 'B',吊起機器人,按 'A' 回零,放下並讓它保持直立 2 分鐘,然後按 'X' 站立。
9. 選配:TienKung-Lab 中的模擬設置
這部分不需要機器人。這是原專案為 TienKung 提供的強化學習工作流程,需要 NVIDIA Omniverse 產品 Isaac Sim。
9.1 安裝 TienKung-Lab 並確認能執行
安裝 Isaac Lab,在其目錄之外複製 TienKung-Lab,以 pip 安裝兩個套件,並執行一次簡短的行走訓練。
- TienKung-Lab 以 IsaacSim 4.5.0 與 IsaacLab 2.1.0 建置。
- 依照 Isaac Lab 的安裝指南安裝。原專案建議使用 conda 安裝,因為這樣從終端機呼叫 Python 腳本比較簡單。
- 將本儲存庫與 Isaac Lab 的安裝分開複製,放在 IsaacLab 目錄之外。
- 使用已安裝 Isaac Lab 的 Python 直譯器,執行:cd TienKung-Lab,然後 pip install -e .
- 安裝 rsl-rl 函式庫:cd TienKung-Lab/rsl_rl,然後 pip install -e .
- 檢查安裝:python legged_lab/scripts/train.py --task=walk --logger=tensorboard --headless --num_envs=64
- 原專案的徽章列出 Python 3.10、Linux 平台上的 Ubuntu 22.04,以及 RSL_RL 2.3.1。
9.2 在實體機器人上測試前,留意原專案的警告
原專案表示,訓練出的策略可能導致非預期或劇烈的動作。
- 原專案的安全注意事項,原文如下:「在真實機器人上測試有風險。RL 策略可能造成非預期或劇烈的動作,因此請確認已投保意外險,且緊急停止功能正常。」
- README 指向用於部署的 Deploy_Tienkung 儲存庫。該儲存庫列出 Ubuntu 22.04 LTS 與 ROS2 Humble,而 2025 年 5 月的手冊描述的是 ROS 1。原專案沒有說明部署儲存庫在哪些機器人上驗證過,因此本指南不提供部署步驟。