LeRobot documentation
Koch v1.1
Koch v1.1
في الخطوات أدناه، نشرح كيفية تجميع روبوت Koch v1.1.
اطلب الأجزاء وجمّعها
اتبع تعليمات sourcing و assembling المقدمة في هذا README. سيوجهك هذا الإعداد لكلٍّ من الذراع التابع (follower) والذراع القائد (leader)، كما هو موضح في الصورة أدناه.
لجولة بصرية في عملية التجميع، يمكنك الرجوع إلى هذا الشرح التعليمي بالفيديو.
منذ إنتاج هذا الفيديو، قمنا بتبسيط مرحلة التهيئة. ونتيجةً لذلك، يختلف أمران عن التعليمات الواردة في ذلك الفيديو:
- لا تقم بتوصيل جميع كابلات المحركات على الفور وانتظر حتى يُطلب منك ذلك في إعداد المحركات.
- لا تثبّت لوحة التحكم (PCB) في القاعدة فورًا، وانتظر حتى يُطلب منك ذلك في إعداد المحركات.
تثبيت LeRobot 🤗
لتثبيت LeRobot، اتبع دليل التثبيت الخاص بنا
بالإضافة إلى هذه التعليمات، تحتاج إلى تثبيت Dynamixel SDK (إذا قمت بتثبيت LeRobot من PyPI، فقم بتشغيل pip install 'lerobot[dynamixel]' بدلاً من ذلك):
pip install -e ".[dynamixel]"The input "Configure the motors" is a short phrase/heading. According to the instructions, headings and short phrases should be translated into natural Modern Standard Arabic. "Motors" in a technical context (likely robotics or hardware control) is translated as "المحركات". "Configure" is translated as "إعداد" or "تهيئة". "تهيئة المحركات" is a very common and professional term in technical documentation for "Configure the motors".
1. ابحث عن منافذ USB المرتبطة بكل ذراع
لإيجاد منفذ كل محوّل عتاد حافلة، نفّذ هذا النص البرمجي:
lerobot-find-port
مثال على المخرجات:
Finding all available ports for the MotorBus.
['/dev/tty.usbmodem575E0032081', '/dev/tty.usbmodem575E0031751']
Remove the USB cable from your MotorsBus and press Enter when done.
[...Disconnect corresponding leader or follower arm and press Enter...]
The port of this MotorsBus is /dev/tty.usbmodem575E0032081
Reconnect the USB cable.حيث أن المنفذ الذي تم العثور عليه هو: /dev/tty.usbmodem575E0032081 والذي يتوافق مع ذراع القائد أو التابع لديك.
على نظام لينكس، قد تحتاج إلى منح الوصول إلى منافذ USB من خلال تشغيل الأمر التالي:
sudo chmod 666 /dev/ttyACM0
sudo chmod 666 /dev/ttyACM1مثال على المخرجات:
Finding all available ports for the MotorBus.
['/dev/ttyACM0', '/dev/ttyACM1']
Remove the usb cable from your MotorsBus and press Enter when done.
[...Disconnect corresponding leader or follower arm and press Enter...]
The port of this MotorsBus is /dev/ttyACM1
Reconnect the USB cable.حيث أن المنفذ الذي تم العثور عليه هو: /dev/ttyACM1 والذي يتوافق مع ذراع القائد أو التابع الخاص بك.
2. تعيين معرّفات المحركات ومعدلات البود
يتم تحديد كل محرك بمعرّف فريد على الحافلة. عند شرائها جديدة، تأتي المحركات عادةً بمعرّف افتراضي هو 1. لكي تعمل الاتصالات بشكل صحيح بين المحركات والمتحكم، نحتاج أولاً إلى تعيين معرّف فريد ومختلف لكل محرك. بالإضافة إلى ذلك، يتم تحديد سرعة نقل البيانات على الحافلة بواسطة معدل البود. ولكي يتواصل المتحكم مع جميع المحركات، يجب ضبطها جميعًا على نفس معدل البود.
لبلوغ هذا الهدف، نحتاج أولاً إلى الاتصال بكل محرك على حدة عبر وحدة التحكم من أجل ضبط هذه الإعدادات. وبما أننا سنكتب هذه المعلمات في القسم غير المتطاير من الذاكرة الداخلية للمحركات (EEPROM)، فلن نحتاج إلى القيام بذلك إلا مرة واحدة.
إذا كنت تعيد استخدام محركات من روبوت آخر، فستحتاج على الأرجح إلى تنفيذ هذه الخطوة أيضًا، حيث من المرجح أن المعرّفات ومعدل البود (baudrate) لن يتطابقا.
متابع
قم بتوصيل كابل usb من جهاز الحاسوب ومصدر الطاقة 12 فولت بلوحة تحكم ذراع المتابعة (بينما تستخدم ذراع القائد مصدر طاقة 5 فولت). ثم، نفّذ الأمر التالي أو نفّذ مثال الواجهة البرمجية باستخدام المنفذ الذي حصلت عليه من الخطوة السابقة. ستحتاج أيضًا إلى منح ذراع المتابعة اسمًا باستخدام معامل id.
للاطلاع على مرجع بصري حول كيفية تعيين معرّفات المحركات، يُرجى الرجوع إلى هذا الفيديو حيث نتبع العملية الخاصة بالذراع SO101.
lerobot-setup-motors \
--robot.type=koch_follower \
--robot.port=/dev/tty.usbmodem575E0031751 # <- paste here the port found at previous stepfrom lerobot.robots.koch_follower import KochFollower, KochFollowerConfig
config = KochFollowerConfig(
port="/dev/tty.usbmodem575E0031751",
id="my_awesome_follower_arm",
)
follower = KochFollower(config)
follower.setup_motors()يجب أن ترى التعليمات التالية.
Connect the controller board to the 'gripper' motor only and press enter.كما هو موضح، قم بتوصيل محرك الماسك. تأكد من أنه المحرك الوحيد المتصل باللوحة، وأن المحرك نفسه غير موصول بعد بسلسلة متسلسلة مع أي محرك آخر. عند الضغط على [Enter]، سيقوم السكربت تلقائيًا بإعداد المعرّف ومعدل البود لهذا المحرك.
Troubleshooting
إذا واجهت خطأً في تلك النقطة، فتأكد من الكابلات وتأكد من أنها موصولة بشكل صحيح:
- مزود الطاقة
- كابل USB بين حاسوبك ولوحة التحكم
- كابل 3-أطراف من لوحة التحكم إلى المحرك
إذا كنت تستخدم لوحة تحكم Waveshare، فتأكد من ضبط القفزين على قناة B (USB).
يجب أن ترى الرسالة التالية:
'gripper' motor id set to 6يُتبع ذلك بالتعليم التالي:
Connect the controller board to the 'wrist_roll' motor only and press enter.يمكنك فصل كابل 3-pin عن لوحة التحكم، لكن يمكنك تركه موصولاً بمحرك القبضة في الطرف الآخر لأنه سيكون بالفعل في المكان الصحيح. الآن، وصّل كابل 3-pin آخر بمحرك دوران المعصم (wrist roll motor) ووصّله بلوحة التحكم. وكما في المحرك السابق، تأكد من أنه المحرك الوحيد الموصول باللوحة، وأن المحرك نفسه غير موصول بأي محرك آخر.
كرر العملية لكل محرك كما هو موضح في التعليمات.
تحقق من التوصيلات في كل خطوة قبل الضغط على مفتاح Enter. على سبيل المثال، قد تنفصل كابل مصدر الطاقة أثناء التعامل مع اللوحة.
عند الانتهاء، سينتهي تشغيل السكربت ببساطة، وعند ذلك تكون المحركات جاهزة للاستخدام. يمكنك الآن توصيل كابل 3-pins من كل محرك إلى المحرك التالي، ثم توصيل الكابل من المحرك الأول (وهو ‘shoulder pan’ المعرّف بـ id=1) إلى لوحة التحكم، والتي يمكن الآن تثبيتها على قاعدة الذراع.
القيادي
قم بنفس الخطوات للذراع القائدة، لكن عدّل الأمر أو السكربت وفقاً لذلك.
lerobot-setup-motors \
--teleop.type=koch_leader \
--teleop.port=/dev/tty.usbmodem575E0031751from lerobot.teleoperators.koch_leader import KochLeader, KochLeaderConfig
config = KochLeaderConfig(
port="/dev/tty.usbmodem575E0031751",
id="my_awesome_leader_arm",
)
leader = KochLeader(config)
leader.setup_motors()المعايرة
في الخطوة التالية، ستحتاج إلى معايرة روبوتك للتأكد من أن ذراعي القائد والمتبوع تمتلكان قيم موضع متطابقة عندما تكونان في الموضع الفيزيائي نفسه. تُعد عملية المعايرة بالغة الأهمية لأنها تتيح لشبكة عصبية مُدرَّبة على روبوت واحد أن تعمل على روبوت آخر.
متابع
شغّل الأمر أو مثال واجهة برمجة التطبيقات التالي لمعايرة ذراع المتبّع:
# Use the port of your follower arm, and give the arm a unique name with --robot.id
lerobot-calibrate \
--robot.type=koch_follower \
--robot.port=/dev/tty.usbmodem58760431551 \
--robot.id=my_awesome_follower_armfrom lerobot.robots.koch_follower import KochFollowerConfig, KochFollower
config = KochFollowerConfig(
port="/dev/tty.usbmodem585A0076891",
id="my_awesome_follower_arm",
)
follower = KochFollower(config)
follower.connect(calibrate=False)
follower.calibrate()
follower.disconnect()لقد قمنا بتوحيد طريقة المعايرة لمعظم الروبوتات. وبالتالي، فإن خطوات المعايرة لذراع Koch هذه هي نفسها خطوات SO100 وSO101. أولاً، يجب علينا تحريك الروبوت إلى الموضع الذي يكون فيه كل مفصل في منتصف نطاق حركته، ثم نضغط على Enter. ثانياً، نحرك جميع المفاصل عبر نطاق حركتها الكامل. يمكن العثور على فيديو لعملية المعايرة هذه نفسها لـ SO101 كمرجع هنا.
القيادي
قم بنفس الخطوات لمعايرة الذراع الرئيسية، ونفّذ الأمر التالي أو مثال واجهة برمجة التطبيقات:
# Use the port of your leader arm, and give the arm a unique name with --teleop.id
lerobot-calibrate \
--teleop.type=koch_leader \
--teleop.port=/dev/tty.usbmodem58760431551 \
--teleop.id=my_awesome_leader_armfrom lerobot.teleoperators.koch_leader import KochLeaderConfig, KochLeader
config = KochLeaderConfig(
port="/dev/tty.usbmodem575E0031751",
id="my_awesome_leader_arm",
)
leader = KochLeader(config)
leader.connect(calibrate=False)
leader.calibrate()
leader.disconnect()تهانينا 🎉، روبوتك جاهز تمامًا لتعلم مهمة بشكل مستقل. ابدأ تدريبه باتباع هذا الشرح التعليمي: البدء مع الروبوتات الواقعية
Update on GitHubإذا كانت لديك أي أسئلة أو كنت بحاجة إلى مساعدة، يرجى التواصل معنا عبر Discord.