智元機器人開源資料 智元靈犀X1開發(fā)指南

給大家?guī)硪恍┲窃?a href="http://www.wenjunhu.com/soft/data/42-101/" target="_blank">機器人開源資料 ；這里主要分享給大家 智元靈犀X1開發(fā)指南。

智元機器人將其自主研發(fā)的全棧開源機器人智元靈犀X1面向全球開發(fā)者正式開源，在提供核心組件的基礎(chǔ)上，智元機器人完整地開源了軟硬件全套圖紙和代碼，總資料大小超過1.2GB。在整機結(jié)構(gòu)硬件方面，提供了整機結(jié)構(gòu)圖紙、整機硬件框圖、整機BOM，細致到每一個螺絲和齒輪，確保開發(fā)者能夠精確理解和復(fù)現(xiàn)他們的設(shè)計理念，整機全部物料均可通過自行加工或者購買方式獲取，還特別提供整機裝機說明，幫助開源用戶迅速完成機器人本體的組裝。在整機軟件算法方面，提供了AimRT平臺組件、機器人URDF文件、仿真Sim2Sim、Sim2Real代碼、強化學(xué)習(xí)訓(xùn)練代碼、模型轉(zhuǎn)換、推理工具，和調(diào)試工具（數(shù)據(jù)可視化、遙控器）等等，“一站式”全套圖紙和代碼幫助大家更好地學(xué)習(xí)人形機器人開發(fā)流程。

毫無疑問，靈犀X1的開源大幅降低了機器人開發(fā)的門檻，無論是企業(yè)還是個人，是學(xué)生還是愛好者，都能夠以更簡單的方式去開發(fā)機器人的各種軟件算法，包括運動控制、感知系統(tǒng)、人機交互等。

智元靈犀X1機器人開發(fā)資料 軟硬件全套圖紙和代碼

https://bbs.elecfans.com/jishu_2460649_1_1.html

BOM清單、整機STEP、整機圖紙（SolidWorks）、裝機SOP。

智元靈犀X1整機標(biāo)零作業(yè)指導(dǎo)書
*附件：智元靈犀X1整機標(biāo)零作業(yè)指導(dǎo)書.xlsx

關(guān)于智元靈犀X1

靈犀X1采用串并聯(lián)混合構(gòu)型手臂和差分驅(qū)動雙肩關(guān)節(jié)設(shè)計，整臂僅重2.5kg。依托智元X-Lab自研的PowerFlow兩款模塊化關(guān)節(jié)，實現(xiàn)全身三十多個自由度的精準(zhǔn)操控。

另外還支持獨特的“機-機模式”，將手機屏幕作為機器人的“臉”，同時手機也作為機器人的“大腦”。

那么在靈犀X1正式開源后，我們來看一下實際的開源資料都有哪些，是不是普通人也能“手搓”機器人 了？

首先在智元機器人官網(wǎng)上，目前已經(jīng)放出了靈犀X1的開發(fā)指南，官方表示根據(jù)該指南即可完成機器人的搭建。而其中設(shè)計資料官方也提供了下載鏈接，包括BOM清單、整機STEP、整機圖紙（SolidWorks）、裝機SOP等。

從官方的BOM清單中我們看到，靈犀X1共有175種物料，其中結(jié)構(gòu)件需要自行定制，大部分可以用3D打印制造，也有部分需要進行機加工，比如腳踝連桿就需要用到鈦合金材料，腳踝連接軸用到40Cr鋼等材料。

同時智元提供了詳細的整機SolidWorks建模圖紙，可以根據(jù)圖紙來進行制作相應(yīng)的零部件。

在電子硬件部分，可以BOM清單上的部件看到大部分都能夠在網(wǎng)上購買，甚至還給出了相應(yīng)的購買鏈接。當(dāng)然核心的PowerFlow關(guān)節(jié)電機、域控制器DCU等還需要向智元購買，目前官網(wǎng)的通用人形機器人套件，包括6個PowerFlow R86-3、9個PowerFlow R86-2、10個PowerFlow R52、4個PowerFlow L28、2個域控制器 、2個自適應(yīng)夾爪，售價為54818，并已經(jīng)售罄。

如果你已經(jīng)準(zhǔn)備好BOM清單上的物料，那么在裝機SOP文件中，智元提供了133頁的整機組裝指導(dǎo)，你可以像搭建樂高積木一樣，按照步驟將零部件組裝成靈犀X1。

在組裝好靈犀X1之后，在軟件部分也同樣可以直接使用智元提供的推理和訓(xùn)練代碼。據(jù)官方文檔介紹，X1的軟件系統(tǒng)基于智元開源組件AimRT作為中間件實現(xiàn)，并且采用強化學(xué)習(xí)方法進行運動控制。智元提供靈犀X1所使用的強化學(xué)習(xí)訓(xùn)練代碼，配合配套的推理軟件可以進行真機和仿真的行走調(diào)試，或?qū)肫渌麢C器人模型進行訓(xùn)練。

官方文檔介紹--智元靈犀X1開發(fā)指南

靈犀X1概述

1. 整機結(jié)構(gòu)

靈犀X1全身包含29個關(guān)節(jié)（R86-29、R86-36、R5210、L284）和2個夾爪，支持?jǐn)U展頭部3自由度。

2. 整機硬件

3. 開源資料（更新時間：2025.03.07）

3.1 設(shè)計資料

BOM清單、整機STEP、整機圖紙（SolidWorks）、裝機SOP可通過以下任一途徑下載：

百度云盤：https://pan.baidu.com/s/1UEdeDBTJiXRmIqMKwmO5RA?pwd=1234（提取碼：1234）

谷歌云盤：https://drive.google.com/drive/folders/1MECbyKRJbnc_XKWsdUbn-70xmYFmw9FW?usp=sharing

Github：https://github.com/AgibotTech/agibot_x1_hardware

3.2 開源代碼

推理代碼：https://github.com/AgibotTech/agibot_x1_infer

訓(xùn)練代碼：https://github.com/AgibotTech/agibot_x1_train

4. X1整機開發(fā)流程（更新時間：2025年1月14日）

依次按照如下流程操作即可完成智元靈犀X1機器人的搭建，

4.1 執(zhí)行器狀態(tài)確認(rèn)

X1整機裝配前，針對各個執(zhí)行器做確認(rèn)工作，防止裝機后需要重新標(biāo)定設(shè)置，以下是執(zhí)行器的狀態(tài)確認(rèn)流程。

上位機可以通過命令行顯式地更改R86-3/R86-2/R52/L28執(zhí)行器內(nèi)部的參數(shù)，在第一次使用時建議充分了解參數(shù)配置的方法。

注：以R系列的執(zhí)行器為主，L28執(zhí)行器有不同點會進行標(biāo)注。

4.1.1 準(zhǔn)備環(huán)境

準(zhǔn)備一臺Windows系統(tǒng)的電腦，并下載上位機軟件 REF-CLI v1.0.3.exe 。

1.給執(zhí)行器上電，用 USB-C 數(shù)據(jù)線（注：L28為4pin USB線）將執(zhí)行器連接至電腦，并打開上位機軟件。等待上位機識別成功后，會有如下顯示：

此時，編號為 00003986464D 的設(shè)備在上位機中的索引名為 ref0,下發(fā)指令需要與設(shè)備名一致。

在上位機中直接鍵入 ref0 并敲擊回車，會顯示當(dāng)前執(zhí)行器的基本信息。根據(jù)下圖所示，當(dāng)前的固件版本為 3.2.7，CAN總線ID為1。

注：可通過機身鐳射的14位SN碼區(qū)分執(zhí)行器版本， 區(qū)分方式如下，

SN第6、7位為版本號，有20和30兩種，

X1 0 0X 20 XXXXXXX X1 0 0X 30 XXXXXXX

V2執(zhí)行器（版本號20）的固件版本為3.2.7

V3執(zhí)行器（版本號30）的固件版本為3.2.9

2. 查詢執(zhí)行器內(nèi)部參數(shù)模式，輸入指令: ref0.motor.config，默認(rèn)為模式6=MIT混合控制，如下圖所示:

注：詳細操作方式，見智元靈犀X1 PowerFlow R系列執(zhí)行器產(chǎn)品手冊。

4.1.2 LED狀態(tài)指示

4.1.3 使能 / 失能

執(zhí)行器上電后為失能狀態(tài)，可以通過以下指令進行狀態(tài)切換，并觀察LED狀態(tài)進行判定。

4.1.5 執(zhí)行器標(biāo)零

注：L28上電自動回零，不支持手動標(biāo)零。

用戶可以自行設(shè)置執(zhí)行器的零位，在失能狀態(tài)下輸入以下命令：

ref0.motor.apply_user_offset() // 保存當(dāng)前位置為零位

ref0.motor.request_state(0) // 若當(dāng)前處于使能狀態(tài)下，先將執(zhí)行器 失能

ref0.save_config() // 保存所有參數(shù)，返回 True 即為成功，重新上電后生效。

4.2 執(zhí)行器桌面聯(lián)調(diào)測試

4.2.1 接線說明

按照整機接線方案進行連接，包含DCU以及所有關(guān)節(jié)。

4.2.2 測試步驟

注：該測試是桌面聯(lián)調(diào)環(huán)境，所有關(guān)節(jié)會使能并執(zhí)行正反向運動，請勿用于整機環(huán)境?。?！

PC需要X86架構(gòu)CPU，并且安裝Ubuntu22.04 實時系統(tǒng)

1.下載聯(lián)調(diào)測試軟件 xyber_dcu_test_v0.1.3.zip

2.進入 cfg目錄，打開 x1_test_cfg.yaml，修改對應(yīng)的網(wǎng)卡名稱，也可以屏蔽掉缺失的關(guān)節(jié)。若不希望執(zhí)行器運動，可以將 move_actuator 字段設(shè)為 false，這樣測試程序只會對執(zhí)行器進行使能操作以驗證整機通信。imu_dcu_name 字段可以開關(guān)IMU數(shù)據(jù)的檢查，詳見注釋。

3.執(zhí)行測試腳本，根據(jù)提示輸入密碼

4.所有關(guān)節(jié)會執(zhí)行 使能->正轉(zhuǎn)->反轉(zhuǎn)->停止 步驟，軟件會自動判斷其是否運動到位。觀察日志打印，若測試失敗會紅色打印log。

4.3 整機組裝

完成整機組裝方法請參照3.1 設(shè)計資料 中的智元靈犀X1裝機SOP 部分及智元靈犀X1裝機視頻教程https://agibotmall.com/video的說明。

4.4 IMU調(diào)試

靈犀X1使用的IMU為 YIS320，具體型號請參考開源BOM清單。

目前軟件中只啟用了下肢DCU所連接的IMU，只連接一個下肢IMU即可。

DCU與IMU是串口通信，波特率為921600，購買IMU需要用其自帶的上位機檢查一下波特率，并將輸出頻率調(diào)整至最大值。

4.5 整機硬件部署

請按照如下步驟完成X1整機的硬件確認(rèn)，

STEP1: 按照SOP接線完成以后，使用萬用表，撥碼到短路測試擋位，測試電池的或者電源的正極（萬用表紅色筆芯）和負(fù)極（萬用表黑色筆芯），如果萬用表沒有發(fā)出蜂鳴聲，則代表正負(fù)極無短路。

STEP2: 正負(fù)極確認(rèn)沒有短路后，把總開關(guān)船型開關(guān)打開，讓開關(guān)處于ON的狀態(tài)。

STEP3:拿出整機物料中的鑰匙無線開關(guān)，按下ON 按鍵，整機上電。

STEP4:整機上電完畢，沒有出現(xiàn)異常，例如指示燈異常（具體參考4.2指示燈定義）或者異常下電（緩起板指示燈熄滅）等情況，則可以按照手冊進行后續(xù)調(diào)試步驟。

4.6 整機標(biāo)零

整機標(biāo)零請參照* 智元靈犀X1整機標(biāo)零作業(yè)指導(dǎo)書*

智元靈犀X1整機標(biāo)零作業(yè)指導(dǎo)書.xlsx

4.7 整機軟件部署

軟件部署方法請參照3.2 開源代碼 中的推理代碼部分的說明。