Zustand in RViz anzeigen
G2-Simulatorzustand lesen; Identität, sechs Gelenke, TF und Freshness prüfen.
RViz-Tutorial öffnenDer 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.
G2-Simulatorzustand lesen; Identität, sechs Gelenke, TF und Freshness prüfen.
RViz-Tutorial öffnen →Drei lokale Posen und eine Kollisionsgegenprobe untersuchen; Ausführung bleibt deaktiviert.
MoveIt-Tutorial öffnen →Sieben visuelle Links, sechs Gelenkzustände und Simulationsuhr ansehen; Physikplatzhalter beachten.
Gazebo-Tutorial öffnen →Command-Adapter für alle 48 RPCs und FollowJointTrajectory mit ausdrücklicher Fixture-/Simulatorquelle.
Command-Anleitung öffnen →
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.
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.
| Ausgabe | Bedeutung |
|---|---|
/joint_states | joint_1 bis joint_6, Positionen in Radiant, mit leeren Velocity- und Effort-Arrays |
/diagnostics | Streamzustand, Datenalter, Identität und Samplevalidierungsfehler |
/tf | base_link bis link_6, von robot_state_publisher aus der Referenz-URDF berechnet |
| RViz | S5: 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.
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.
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.
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.
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.
Wähle eine kanonische Modell-ID für synthetische JointState-/TF-Ansichten. Der Katalogmodus bleibt von Runtime-Lesen und Commands getrennt.
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:
ROS_DOMAIN_ID=117 ros2 launch plexa_ros_read catalog_offline.launch.py models_root:="$PWD/models" model:=horst-1000-g2-s1 pose:=0Mit 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.
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:=trueDiese 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.