त्वरित शुरुआत: आरंभ करने से पहले

पहले इसे पढ़ें. यह पृष्ठ आपको बताता है कि आपको वास्तव में किस हार्डवेयर की आवश्यकता है, कौन सा सॉफ़्टवेयर स्थापित करना है, सब कुछ कितना समय लगता है, और जब आप पूरा पथ पूरा कर लेंगे तो आप क्या कर पाएंगे।

इसमें कितना समय लग जाता है?

बॉक्स से लेकर अपना पहला प्रशिक्षण एपिसोड रिकॉर्ड करने तक।

हार्डवेयर सेटअप
~2 घंटे
अनबॉक्सिंग, माउंटिंग, कैन वायरिंग, सुरक्षा जांच
सॉफ़्टवेयर स्थापित करें
~1.5 घंटे
Ubuntu, ROS2, SDK, CAN ड्राइवर
पहला प्रस्ताव
~30मी
नकली हार्डवेयर मोड, फिर असली हार्डवेयर लाना
कैलिब्रेशन
~45मी
संयुक्त होमिंग, कार्यस्थल सत्यापन
टेलीऑपरेशन
~1 घंटा
ऑपरेटर डिवाइस सेटअप, पहला रिकॉर्डिंग सत्र
पहला डेटासेट
~1 घंटा
LeRobot प्रारूप, गुणवत्ता जांच, अपलोड

पहले दिन का कुल समय: पूरे पहले सत्र के लिए लगभग 6-7 घंटे। शुरुआती लोगों के लिए दो दिनों तक फैला रहना आरामदायक है।

हार्डवेयर चेकलिस्ट

शुरू करने से पहले वह सब कुछ जो आपके डेस्क पर होना चाहिए। "बॉक्स में" चिह्नित आइटम OpenArm 101 के साथ भेजे जाते हैं।

  • ओपनआर्म 101 आर्म यूनिट बॉक्स में - 8-डीओएफ आर्म, ~3 किग्रा, एल्यूमीनियम और कार्बन फाइबर। स्टोर से खरीदें →
  • 24V डीसी बिजली की आपूर्ति (150W मिनट) बॉक्स में - ओपनआर्म 101 के साथ शामिल।
  • CAN USB अडैप्टर (CANable 2.0 या समतुल्य) बॉक्स में - आपके होस्ट पीसी को आर्म की CAN बस से जोड़ता है।
  • माउंटिंग प्लेट + हार्डवेयर बॉक्स में - M6 बोल्ट, बेस प्लेट। आपको बोल्ट लगाने के लिए एक स्थिर सतह या कार्यक्षेत्र की आवश्यकता है।
  • होस्ट पीसी Ubuntu 22.04 चला रहा है शामिल नहीं - विश्वसनीय सॉकेटकैन टाइमिंग के लिए मूल उबंटू इंस्टॉल होना चाहिए (वीएम या डब्लूएसएल नहीं)। न्यूनतम: 8 जीबी रैम, 50 जीबी डिस्क। उबंटू डाउनलोड करें →
  • यूएसबी-ए से यूएसबी-बी केबल (कैन एडाप्टर के लिए) शामिल नहीं - मानक यूएसबी केबल, ~1 मीटर। अधिकांश इलेक्ट्रॉनिक्स खुदरा विक्रेता।
  • कैमरा (डेटा संग्रह के लिए) सेटअप के लिए वैकल्पिक, प्रशिक्षण डेटा के लिए आवश्यक - USB वेबकैम या RealSense D435i अनुशंसित। सहायक उपकरण देखें →
  • बांह के आधार के चारों ओर 1 मीटर × 1 मीटर स्पष्ट कार्यक्षेत्र आवश्यक - बांह का कार्यक्षेत्र लिफ़ाफ़ा 650 मिमी त्रिज्या है। बिजली चालू करने से पहले लोगों और बाधाओं से मुक्त क्षेत्र। देखना सुरक्षा पृष्ठ →

आरंभ करने से पहले क्या स्थापित करें

The सेटअप गाइड प्रत्येक चरण पर विस्तार से चलता है। यह सारांश है ताकि आप पहले से तैयारी कर सकें।

ऑपरेटिंग सिस्टम

उबंटू 22.04 एलटीएस (जैमी)। Ubuntu 20.04 भी काम करता है लेकिन 22.04 की अनुशंसा की जाती है। macOS और Windows वास्तविक हार्डवेयर के लिए समर्थित नहीं हैं - सॉकेटकैन को लिनक्स कर्नेल की आवश्यकता होती है। आपको मूल इंस्टाल का उपयोग करना होगा, विश्वसनीय CAN टाइमिंग के लिए डॉकर या WSL2 नहीं।

अजगर

पायथन 3.10 (उबंटू 22.04 के साथ बंडल)। SDK का लक्ष्य Python 3.10+ है। शुरू करने से पहले पिप और वेनव स्थापित करें:

sudo apt update
sudo apt install python3-pip python3-venv -y

ROS2

ROS2 हंबल हॉक्सबिल (उबंटू 22.04) या ROS2 आयरन इर्विनी (उबंटू 22.04/23.04)। हंबल एलटीएस संस्करण है और स्थिरता के लिए अनुशंसित है। पूर्ण स्थापना में ~15 मिनट लगते हैं:

# Add ROS2 apt repo (abbreviated — full steps in setup guide)
sudo apt install ros-humble-desktop ros-humble-ros2-control \
  ros-humble-ros2-controllers -y

सॉकेटकैन ड्राइवर

लिनक्स कर्नेल में निर्मित. आपको केवल कर्नेल मॉड्यूल लोड करने और अपने CAN इंटरफ़ेस को कॉन्फ़िगर करने की आवश्यकता है:

sudo modprobe can
sudo modprobe can_raw
sudo modprobe slcan   # for USB CAN adapters

ओपनआर्म एसडीके

pip install roboticscenter

इंस्टॉल openarm_can और सभी पायथन निर्भरताएँ। देखें सॉफ्टवेयर पेज पूर्ण SDK सेटअप और के लिए विकी में एसडीके क्विकस्टार्ट.

लेरोबोट (डेटा संग्रह के लिए)

pip install lerobot

एपिसोड को रिकॉर्ड करने और LeRobot / HuggingFace डेटासेट प्रारूप में परिवर्तित करने के लिए आवश्यक है। देखें डेटा संग्रहण पृष्ठ संपूर्ण वर्कफ़्लो के लिए.

सिमुलेशन (वैकल्पिक - किसी हार्डवेयर की आवश्यकता नहीं)

✓ सिमुलेशन उपलब्ध है

आप ROS2 नकली हार्डवेयर मोड का उपयोग करके हार्डवेयर के बिना संपूर्ण सॉफ़्टवेयर स्टैक चला सकते हैं:

ros2 launch openarm_ros2 openarm.launch.py \
  use_fake_hardware:=true

मुजोको और इसाक सिम भी भौतिकी सिमुलेशन और सिंथेटिक डेटा पीढ़ी के लिए समर्थित हैं। देखें सॉफ्टवेयर → सिमुलेशन अनुभाग सेटअप के लिए.

पूर्ण पथ के बाद आप क्या कर सकते हैं

सभी 7 चरणों को पूरा करने के बाद - पहले प्रशिक्षण डेटासेट के माध्यम से अनबॉक्सिंग - आप इसमें सक्षम होंगे:

एमआईटी स्थिति/वेग/टॉर्क मोड का उपयोग करके सॉकेटकैन पर वास्तविक समय में सभी 8 जोड़ों को नियंत्रित करें
के साथ ROS2 Humble चलाएँ openarm_ros2 प्रक्षेपवक्र योजना और राज्य प्रकाशन के लिए पैकेज
एक ऑपरेटर डिवाइस के साथ बांह को टेलीऑप करें और सिंक्रनाइज़ संयुक्त स्थिति + कैमरा एपिसोड रिकॉर्ड करें
लेरोबोट/हगिंगफेस प्रारूप में डेटासेट निर्यात करें, एसीटी और डिफ्यूजन पॉलिसी प्रशिक्षण के लिए तैयार
वास्तविक हार्डवेयर पर तैनात करने से पहले म्यूजोको सिमुलेशन में वही नीति चलाएँ
एसवीआरसी डेटासेट रजिस्ट्री में डेटासेट प्रकाशित करें और साझा मॉडल को प्रशिक्षित करें

सहायता कैसे प्राप्त करें

आप इसे अकेले नहीं करेंगे। यहां प्रत्येक चरण में प्रश्न पूछने का स्थान है।

तैयार? सेटअप गाइड प्रारंभ करें.

एक बार जब आप अपना हार्डवेयर और उबंटू इंस्टॉल कर लेते हैं, तो सेटअप गाइड आपको हर कदम पर ले जाता है।