OpenArm-Setup-Leitfaden: Von der Entfernung der Box bis zur ersten Teleoperation
Vollständiger OpenArm-Setup-Leitfaden: Checkliste für die Auflösung von Boxen, Montage Schritte, Kalibrierung, Verbindung zur RCSV-Plattform, Ausführung Ihrer ersten Teleoperationssitzung und Tipps zur Datenerfassung.
Teil: [Teleoperationsleitfaden]
OpenArm ist die Open-Source-Roboter-Arm-Plattform von RCSV, die für die Sammlung von Daten imitierender Lernarten entwickelt wurde. Dieser Leitfaden führt Sie durch jeden Schritt, von der Öffnung der Versandbox bis zum Abschluss Ihrer ersten teleoperativen Demonstration und der Aufzeichnung Ihrer ersten Datensatz-Episode.
Checkliste für die Entfernung von Flächen
Bevor Sie Verpackungen entsorgen, prüfen Sie alle Komponenten mit der Verpackungsliste. Ein Standard-OpenArm-Kit umfasst: den Followerarm (6-DOF-Roboterarm mit servomotorigen Gelenken und integrierter Greifer), den Führerarm (passive kinematische Replik, die vom Betreiber zum Telebetreiben verwendet wird), zwei USB-Kameras (an Handgelenk montiert und übergeladen), das Steuerplatte und den USB-Hub, eine 24V-Stromversorgung, alle erforderlichen M3- und M4-Hardware, einen Drehmomentschrauber und das USB-A-zu-USB-C-Steuerkabel. Kits, die die Berechnungsoption enthalten, werden auch mit einem konfigurierten Mini-PC mit Ubuntu 22.04 und dem vorinstallierten RCSV-Software-Stack versendet.
Überprüfen Sie die Servokabel an beiden Armen, ob während der Versandzeit ein Kink oder ein Kink aufgetreten ist. Wenn sich ein Gelenk eher steif oder steif als glat und konform anfühlt, so schalten Sie die
Die Hardware ist vor dem Montage in einem klaren Arbeitsplatz mit mindestens 1 Meter Entfernung um den Roboterarm in alle Richtungen ausgelegt. Der Führerarm kann je nach bevorzugtem Arbeitsstil neben dem Anhänger oder gegenüber dem Betreiber platziert werden; die meisten Betreiber finden die Platzierung des Führerarms direkt an ihre dominierende Handseite die natürlichste Anordnung.
Versammlungsschritte
Wenn Ihr OpenArm zum Versand teilweise demontiert ankommt (die meisten Kits werden zum Schutz mit dem Oberarm entfernt verschifft), beginnen Sie damit, das Oberarmsegment an den Schultergelenk zu befestigen. Die Montageführer in der OpenArm-Dokumentation (über die [RCSV-Plattform]
Die Handgelenkkamera mit dem in dem Kit enthaltenen Druckstützpunkt montieren. Das USB-Kabel durch den Unterarmkanal neben dem Griffservokabel lenken. Die Oberkamera befindet sich auf einem separaten Stand (in vollen Kits enthalten), der etwa 600 mm über und 300 mm hinter der Fußarmbasis der Anhänger befindet ist und 30
Verbinden Sie das Steuerplatte mit der Servokette des Anhängersarm über den JST-Anschluss an den ersten Servokett an der Basis. Das Steuerplatte versorgt alle Servokette durch einen Daisy-ketten-Power Bus; bestätigen Sie die Polarität jedes Anschlusses, bevor Sie Strom anwenden. Verbinden Sie die 24V-Stromversorgung mit dem Steuerplatte (der Fassenschalter, nicht der Servokett). Verbinden Sie das Steuerablatt über das mitgelieferte USB-C-Kabel mit Ihrem Rechner. Schließlich verbinden Sie beide Kameras mit dem USB-Hub und den Hub, um über USB-A zu rechnen.
Kalibrierung
Die Kalibrierung legt die Nullposition jedes Gelenks fest
Das Kalibrierungsprozedur dauert ungefähr 10 Minuten. Sie werden aufgefordert, jedes Gelenk in seine definierte Heimatposition zu bewegen
Die Kamera Kalibrierung ist separat. Die RCSV-Plattform enthält einen ChArUco-Board-basierten Kamera Kalibrierung Workflow, der intrinsische Parameter und die extrinsische Transformation zwischen der Handgelenkkamera, Oberkopfkamera und Roboter-Basisrahme berechnet. Drucken Sie das Kalibrierungskennfeld auf der angegebenen Skala (A3-Papier, 100%-Skala), sammeln Sie 30
Verbindung zur RCSV-Plattform
Die RCSV-Plattform ist die Software-Schicht für die Aufzeichnung von Episoden, das Management von Datensätzen und die Politikbildung. Erstellen oder melden Sie sich in Ihr RCSV-Konto an, navigieren Sie in den Hardware-Abschnitt und fügen Sie ein neues OpenArm-Gerät hinzu. Geben Sie die Seriennummer ein, die auf dem Kontrollplatten-Label gedruckt ist. Die Plattform erzeugt ein Gerätstoken
Wenn der Agent sich anschließt, erscheint das Gerät als "Online" im Plattform-Dashboard. Sie können die Verbindung durch Streaming von Live-Joint-State- und Kamera-Feeds aus der Plattform-Geräteansicht überprüfen. Dieser Live-Feed ist auch nützlich für die Fernüberwachung von Datenerhebungssitzungen und für die Überprüfung der Episodequalität ohne Downloaden von Rohdatendateien. Der Datensatz-Explorer der Plattform ermöglicht es Ihnen, Episoden direkt im Browser zu taggen, zu annoteren und zu verwalten.
Ihre erste Teleoperationssitzung
Aktivieren Sie den Telebetriebsmodus in der RCSV-Plattform oder über das Kommandozeilen-Tool:
Wählen Sie für Ihre erste aufgezeichnete Episode eine einfache, wiederholbare Aufgabe aus: Sie nehmen einen Würfel aus einer festen Position und stellen ihn auf ein markiertes Ziel. Üben Sie die Bewegung mit dem Teleoperationssystem für 5
Softwareinstallation: ROS 2 und der OpenArm SDK
Wenn Sie die Berechnungsoption mit einem vorkonfigurierten Mini-PC erhalten haben, überspringen Sie unten auf "Verifizieren Sie den Software-Stack". Wenn Sie Ihre eigene Maschine verwenden, folgen Sie diesen Schritten.
Schritt 1 - Installieren Sie Ubuntu 22.04 LTS. OpenArm Software-Stack zielt ausschließlich auf Ubuntu 22.04 ab. Andere Verteilungen und Versionen können funktionieren, aber nicht getestet oder unterstützt werden. Verwenden Sie eine saubere Installation, nicht einen Dual-Boot oder VM - Echtzeit-Servo-Kommunikation erfordert eine konsistente USB-Latenz, die virtualisierte Umgebungen nicht garantieren können.
Schritt 2 - Installieren Sie ROS 2 Humble. ROS 2 Humble Hawksbill ist die LTS-Version, die die OpenArm-Pakete zielen.
sudo apt update && sudo apt install software-properties-common
sudo add-apt-repository universe
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key \
-o /usr/share/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] \
http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" \
| sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
sudo apt update && sudo apt install ros-humble-desktop python3-colcon-common-extensions
So finden Sie die ROS 2-Einstellung in Ihrem Shell-Profil:
Schritt 3 -- Installieren Sie das OpenArm Python SDK. Das SDK bietet die Servo-Kommunikationsschicht, Kalibrierungsanwendungen und den Telebetriebscontroller:
pip install openarm-sdk
# Or from source for development:
git clone https://github.com/svrc-robotics/openarm-sdk.git
cd openarm-sdk && pip install -e ".[dev]"
Schritt 4 -- Installieren Sie den RCSV-Agent. Der RCSV-Agent verbindet Ihren OpenArm mit der RCSV-Plattform für Fernüberwachung, Episodenaufzeichnung und Datensatzmanagement:
pip install svrc-agent
svrc-agent init # Creates ~/.svrc/config.yaml
Verifizieren der Software Stack. Laufen Sie das eingebaute Diagnosetool aus, um zu bestätigen, dass alles funktioniert:
openarm diagnose --all
# Expected output:
# [OK] USB servo chain detected (6 servos on /dev/ttyUSB0)
# [OK] Leader arm detected (6 joints on /dev/ttyUSB1)
# [OK] Camera 0: /dev/video0 (640x480 @ 30fps)
# [OK] Camera 1: /dev/video2 (640x480 @ 30fps)
# [OK] ROS 2 Humble: active
# [OK] RCSV Agent: connected to platform
Erster Vorschlag: Gemeinsame Positionskontrolle
Bevor Sie die Teleoperation ausführen, überprüfen Sie, ob Sie einzelne Gelenke programmatisch beherrschen können. Dies bestätigt, dass die Servokette, die Kalibrierungskompensationen und der Kommunikationsbus alle richtig funktionieren.
from openarm import OpenArm
import time
arm = OpenArm(port="/dev/ttyUSB0")
arm.connect()
# Read current joint positions (radians)
print("Current positions:", arm.get_joint_positions())
# Move joint 1 (shoulder) to 0.5 rad at 30% speed
arm.move_joint(joint_id=1, position=0.5, speed=0.3)
time.sleep(2)
# Move to a named home pose
arm.move_to_home()
time.sleep(2)
# Move through a sequence of waypoints
waypoints = [
[0.0, -0.5, 1.0, 0.0, 0.5, 0.0], # approach
[0.0, -0.3, 0.8, 0.0, 0.3, 0.5], # pre-grasp
[0.0, -0.3, 0.8, 0.0, 0.3, 1.0], # close gripper
]
for wp in waypoints:
arm.move_joints(wp, speed=0.2)
time.sleep(1.5)
arm.disconnect()
Wenn ein Gelenk nicht reagiert oder in eine unerwartete Position bewegt, laufen Sie die Kalibrierung für dieses Gelenk erneut vor der Weiterführung aus. Das häufigste Problem ist ein Servo-ID-Konflikt - zwei Servos zugewiesen die gleiche ID auf dem Bus.
Häufige Probleme und Lösungen
| Symptom | Likely Cause | Fix |
|---|---|---|
| Servo LED amber on power-up | Communication bus error; bad JST connection | Reseat JST connector; check for bent pins |
| Servo LED red on power-up | Overcurrent fault (stalled motor or short) | Power off, check for mechanical binding; replace servo if persistent |
| Follower arm drifts during teleoperation | PID gains too low or calibration offset drift | Re-run calibration; increase P gain by 10-20% in servo config |
| Camera feed black or frozen | USB bandwidth conflict with servo chain | Move cameras to a separate USB controller (different physical port group) |
| openarm diagnose shows 5/6 servos | Servo ID conflict or broken daisy chain | Run openarm scan-servos; re-assign IDs with openarm set-id |
| High-pitched whine from servo | Servo fighting against hard limit or calibration offset wrong | Re-calibrate the joint; check that no wires are caught in joint mechanism |
| RCSV agent shows "Disconnected" | Device token expired or network issue | Regenerate token in platform dashboard; check firewall allows outbound HTTPS |
| Episodes not appearing in platform | Agent not running or config.yaml path wrong | Check systemctl status svrc-agent; verify ~/.svrc/config.yaml contains correct token |
Nähere Schritte nach dem Aufbau
Sobald Ihr OpenArm zusammengestellt, kalibriert und an die Plattform angeschlossen ist und Sie die gemeinsame Steuerung und Teleoperation überprüft haben, ist hier die empfohlene Entwicklung:
- Üben Sie die Teleoperation (2-4 Stunden). Verbringen Sie Zeit, um mit dem Führerarm das Muskelgedächtnis zu entwickeln. Beginnen Sie mit großen Bewegungen (bewegen Sie sich zu Positionen im Arbeitsplatz) bevor Sie versuchen, feine Manipulationen (Fangen von kleinen Objekten) zu machen.
- Sammeln Sie einen Kalibrierungsdatensatz (50 Episoden). Erfassen Sie 50 Demonstrationen einer einfachen Pick-and-Place-Aufgabe. Überprüfen Sie jede Episode in der Plattform. Dieser Datensatz validiert Ihre gesamte Pipeline von Hardware bis Speicher und ermöglicht es Ihnen, alle verbleibenden Probleme zu erfassen, bevor Sie in größere Sammelkampagnen investieren.
- Train a test policy. Verwenden Sie den 50-episodes-Datensatz, um eine ACT- oder Diffusion-Politik mit [LeRobot] zu trainieren. Wenn die Politik bei der einfachen Aufgabe 40-60% erfolgreich ist, funktioniert Ihre Hardware und Datenleitung korrekt. Wenn sie weniger als 30% erreicht, überprüfen Sie die Datenqualität mit dem Datenqualitätsrahmen.
- Skala bis Produktionssammlung. Sobald die Pipeline validiert ist, skalieren Sie bis zu Ihrer Zieldatensatzgröße. Für die meisten Ein-Tasken-Manipulation-Politiken sind 200-500 Demonstrationen der typische Bereich. Für die Feinasting-Vorführung von Multi-Tasken- oder Fundamentmodellen, planen Sie 1.000 bis 5.000 Demonstrationen.
Spezifikationen von OpenArm auf einen Blick
| Specification | Value |
|---|---|
| Degrees of freedom | 6 DOF + gripper |
| Maximum reach | 850 mm |
| Wiederholgenauigkeit | +/- 1 mm |
| Nutzlast | 500 g sustained |
| Control frequency | 50 Hz (configurable to 100 Hz) |
| Communication | USB serial (TTL half-duplex) |
| Power supply | 24V DC, 5A max |
| Weight (follower arm) | 2.8 kg |
| Price | $4,500 (leader + follower kit) |
Tipps zur Datenerfassung
Bei der Demonstration ist die Geschwindigkeit konstant zu halten. Plötzliche Geschwindigkeitsänderungen
Die Erschöpfung der Betreiber führt zu subtilen Veränderungen in der Demonstrationsqualität, Zögerungen, asymmetrischen Anfängen, unvollständigen Platzierungen, die in einzelnen Episoden schwer zu erkennen sind, aber die politische Ausbildung im großen Maßstab schwächen. Die Sitzungsanalyse der RCSV-Plattform zeigt Episoden, bei denen die Demonstrationsdauer ein Ausfall ist (zu schnell oder zu langsam im Vergleich zum Sitzungsmedian), das ein automatisiertes Qualitätssignal liefert. Für die Skalierung über das hinaus, was ein einzelner Betreiber erzeugen kann, bietet RCSVs [Managed Collection Service]
Verwandte Lesungen
- Roboter Arm Kaufführer 2026 -- Wie OpenArm sich mit UR5e, Franka FR3 und anderen Plattformen vergleicht
- [Was macht gute Roboter-Training-Daten?]
T28 ) -- Die 6 Qualitätsdimensionen, die Ihre gesammelten Daten erfüllen sollten - LeRobot Guide --Ausbildung ACT und Diffusion Policy auf Ihren OpenArm-Datensätzen
- Verteilung der Kosten für die Roboter-Datenerhebung -- Budgetplanung für Ihre Datenerhebungskampagnen
- Beste Roboterhands 2025 - Dexterose End-Effektoren kompatibel mit OpenArm
- RCSV-Datendienste -- Verwaltete Sammlung mit ausgebildeten Betreibern und QA-Pipelines
- Roboterleasing -- Probieren Sie OpenArm mit einem kurzfristigen Leasing vor dem Kauf
Verwandte: OpenArm in Store · Robot Arm Kaufführer 2026 · Nachahmungslernen for Robots · Teleoperationsplattform · Datendienste