Skip to content

Mit KI weiterarbeiten

Mit KI weiterarbeiten

ROS-2-Adapter ​

Der lesende Adapter stellt Gelenkzustand für Standard-ROS-2-Werkzeuge bereit. Der getrennte Command-Adapter leitet alle 48 Runtime-RPCs weiter und bietet eine FollowJointTrajectory-Action für ausdrückliche Fixture-/Simulatorvorschläge. Wähle zwischen Runtime-Lesen, lokaler MoveIt-Planung, Gazebo-Vorschau und ausdrücklichen Runtime-Vorschlägen. Die Runtime-Modi nutzen getrennte Profile für HORST600 S5 als Testfixture und HORST600 G2 als HorstOS-Neo-Simulator.

Ein Tutorial wählen ​

Domain 74 · Runtime-Lesen

Zustand in RViz anzeigen

G2-Simulatorzustand lesen; Identität, sechs Gelenke, TF und Freshness prüfen.

RViz-Tutorial öffnen
Domain 78 · synthetischer Zustand

Mit MoveIt lokal planen

Drei lokale Posen und eine Kollisionsgegenprobe untersuchen; Ausführung bleibt deaktiviert.

MoveIt-Tutorial öffnen
Domain 79 · isolierter Simulator

Gazebo-Preview öffnen

Sieben visuelle Links, sechs Gelenkzustände und Simulationsuhr ansehen; Physikplatzhalter beachten.

Gazebo-Tutorial öffnen
Opt-in · Fixture/Simulator

Runtime-Vorschläge senden

Command-Adapter für alle 48 RPCs und FollowJointTrajectory mit ausdrücklicher Fixture-/Simulatorquelle.

Command-Anleitung öffnen
Konzeptionelle Orientierung
Konzeptillustration: Generierter Arm im HORST-Stil neben konzeptionellen Gelenkverläufen, rasterbasierter Pfadvorschau und Aufzeichnungsansicht

Nutze den Fixture-Schnellstart für ein S5-Testkit-Setup oder Offline-Vorbereitung für exakte Paketpins, gemeinsame Asset-Prüfungen und vollständige Konfigurationsgrenzen. Halte Runtime-Lesezugriffe und isolierten synthetischen Offline-Zustand in getrennten ROS-Domains.

Architektur ​

Der Adapter ruft RobotStatusService.ListRobots und RobotStatusService.StreamCurrentRobotJoints auf. Er akzeptiert ausschließlich einen Loopback-Endpunkt. S5-Fixture und G2-Simulator nutzen getrennte Profile mit geprüfter Identität, Sechsachsanordnung, Modellzuordnung und URDF vor Veröffentlichung. Es wird keine Runtime-Schreib-API bereitgestellt.

Veröffentlichte ROS-Daten ​

Topic-Zuordnung, Einheiten, Empfangszeit und Freshness
AusgabeBedeutung
/joint_statesjoint_1 bis joint_6, Positionen in Radiant, mit leeren Velocity- und Effort-Arrays
/diagnosticsStreamzustand, Datenalter, Identität und Samplevalidierungsfehler
/tfbase_link bis link_6, von robot_state_publisher aus der Referenz-URDF berechnet
RVizS5: schematische Kollisionsgeometrie; G2: detaillierte quellabgeleitete Visual-Meshes mit optionalen Collision- und TF-Overlays

Runtime-Gelenkwerte sind logische J1...J6-Werte in Grad. Der Adapter ordnet sie der Reihe nach URDF-joint_1...joint_6 zu, konvertiert in Radiant und prüft endliche Werte sowie URDF-Limits vor Veröffentlichung.

Die Runtime-Payload hat keinen Messzeitstempel. ROS-Header nutzen daher die ROS-Empfangszeit. Eine monotone Uhr verfolgt Freshness unabhängig; die standardmäßige Stale-Schwelle ist 500 ms beim 100-ms-Sampleintervall der Fixture. Veraltete oder ungültige Samples werden verworfen; letzter Zustand wird nie still erneut veröffentlicht. Hochfrequente Zwischensamples werden zum neuesten Sample zusammengefasst; /diagnostics zählt diese Werte.

Streamende, Runtime-Fehler, fehlerhafte Samples und Identitätsabweichungen bleiben auf /diagnostics sichtbar. Der Pilot verbindet nach einem terminalen Streamfehler nicht automatisch neu. Veröffentlichung kann nach vorübergehender Verzögerung bei einem neuen gültigen Sample fortgesetzt werden.

Fixture-Setup ​

Die Setupanleitung für S5-Fixture und G2-Simulator enthält die gepinnte Ubuntu-/WSL-Umgebung, SDK-/Overlay-Builds und drei Terminalschritte zur ersten lesenden Prüfung.

Simulatorprofil ​

Das getrennte G2-Simulatorprofil dokumentiert Loopback-Weiterleitung, Visual-Assets und den Windows-RViz-Launcher. Verwende denselben ROS-Domain-Wert innerhalb eines Modus und getrennte Domains zwischen Runtime-Lesen und synthetischer Offline-Planung.

Experimentelle Offline-G2-Vorbereitung ​

Untersuche synthetische G2-Posen und lokale Pfade mit MoveIt oder öffne das isolierte Gazebo-Modell mit Gelenkzuständen und Simulationsuhr. Die Offline-Vorbereitung führt durch Installation und Start. MoveIt-Ausführung bleibt deaktiviert; Gazebo verwendet explizite Physikplatzhalter.

Runtime- und Hardwaregrenzen ​

Der lesende Adapter und der Offline-Simulatorpilot belegen keine Interoperabilität mit Roboterhardware. Sie bieten keine Bewegungscommands, ros2_control-Hardwareschnittstelle, Trajektoriencontroller, Realtime-Pfad, Kamera, I/O, Greifer, kalibriertes Visual-Modell oder Safety-Funktion. WSL-Tests sind keine Realtime- oder Safety-Tests.

Die detaillierten G2-Derivate bleiben zur internen Nutzung im Models-Repository; diese Anleitung verteilt keine Meshes oder Texturen. Externe Modellasset-Veröffentlichung benötigt eine getrennte Lizenzprüfung. Ausdrückliche Trajektorienvorschläge verwenden den neuen Command-Adapter. Zyklische Setpoints benötigen ihre separat zugelassene Streaming-Architektur; der southbound Realtime-Contract ist kein Integrationsbypass.

Quelle, Manifest, gepinnte Umgebung und Tests werden im PLEXA-ROS-Extension-Repository gepflegt.

Offline-Modelle aus dem Katalog ​

Wähle eine kanonische Modell-ID für synthetische JointState-/TF-Ansichten. Der Katalogmodus bleibt von Runtime-Lesen und Commands getrennt.

Katalogmodelle laden und geschätzte Offline-Profile vorbereiten

Der zusätzliche Modus catalog_offline.launch.py lädt ein genaues, quellgeprüftes Modell und veröffentlicht synthetische Referenzpositionen. Er unterstützt beliebige bewegliche Gelenkbäume, mehrere Arme, feste Toolframes und gemischte Radiant/Meter; er öffnet keine Runtime-Verbindung. Die bisherigen Lese- und Kommandomodi behalten ihre getrennt validierten Identitäten und Bindungen.

Nach dem erneuten Bauen des SDK-Wheels und des ROS-Overlays vom Workspace-Root starten:

sh
ROS_DOMAIN_ID=117 ros2 launch plexa_ros_read catalog_offline.launch.py models_root:="$PWD/models" model:=horst-1000-g2-s1 pose:=0

Mit model:=horst-1500-s1, model:=franka-panda, model:=unitree-g1 oder einer anderen kanonischen Katalog-ID ein anderes Modell auswählen. Ein portabler Models-visual-v1-Export lässt sich mit visual_urdf:=/absolute/path/to/model.urdf für RViz-Geometrie übergeben; Quell- und Ausgabehashes werden vor dem Laden geprüft. Ohne diesen Export erhält die kanonische Quelle Kinematik und vorhandene Primitiven.

python -m plexa_ros_read.catalog --models-root models --model franka-panda --pose 1 gibt das vollständige synthetische JointState-/TF-Eingabepaket aus. Panda-Finger verwenden Meter, der Arm Radiant. Das vollständige Modell mit gemischten Einheiten wird im bisherigen gradbasierten Runtime-Kommandomapper nicht freigeschaltet. Das AMR-Showroomvisual hat keinen JointState-Modus. Die vorhandene HORST1500-S1-Quelle behält eine unbestätigte G2-Produktzuordnung.

Für einen geschätzten Kollisions-/Physikexport bereitet python -m plexa_ros_read.catalog_planning gruppenübergreifend vollständige SRDF- und URDF-Dateien vor. Das Flag --allow-estimated ist erforderlich; --gazebo ruft zusätzlich den installierten nativen sdformat-Konverter auf und erzeugt eine Welt mit fester Basis, ohne Gravitation und mit deaktivierter Selbstkollision. Im MoveIt-Profil werden keine Kollisionspaare automatisch ausgeschlossen.

sh
python -m plexa_ros_read.catalog_planning --models-root models --model horst-1500-s1 --profile-directory models/.generated/library/estimated-offline-v1/horst-1500-s1 --output .tmp/horst1500-planning --allow-estimated --gazebo
ROS_DOMAIN_ID=119 ros2 launch plexa_ros_read catalog_moveit_offline.launch.py models_root:="$PWD/models" model:=horst-1500-s1 profile_directory:="$PWD/models/.generated/library/estimated-offline-v1/horst-1500-s1" allow_estimated:=true

Diese Profile bereiten Offline-Szenen und Gelenkraumgruppen vor. Ein nativer Szenenimport wird getrennt von erfolgreicher Planung und sauberem Prozessende erfasst; der bestehende native MoveIt-Fehler beim Beenden bleibt bis zu einem bestandenen neuen Lebenszyklustest eine offene Abhängigkeit. Trajektorienausführung bleibt deaktiviert.