HORST600-G2-Offline-Vorbereitung
Die ROS-Component enthält experimentelle lokale Vorbereitung für MoveIt 2 und Gazebo Harmonic. Sie nutzt die detaillierten G2-Visuals des Models-Repositorys und einen getrennten CAD-abgeleiteten Kollisionsvorschlag. Dies ist keine Hardware-, produktive Collision-, kalibrierte Planungs-, validierte Physik- oder Runtime-Ausführungsintegration.
Für einen geführten ersten Lauf folge MoveIt-Planung oder Gazebo-Visualisierung. Diese Seite erhält die vollständigen Installations-, Konfigurations- und Prüfdetails.
Windows-Start
Von der Workspace-Wurzel mit WSL Ubuntu-24.04 und gebautem ROS-Overlay:
pwsh -File integrations/ros/env/launch-horst-rviz.ps1 -Mode MoveIt
pwsh -File integrations/ros/env/launch-horst-rviz.ps1 -Mode GazeboJeder Befehl läuft in seinem Terminal weiter. Der Launcher prüft Pakete, geprüfte Modellhashes, Overlay und OpenGL. Er nutzt oder startet das vorhandene authentifizierte VcXsrv auf Display :1. Offline-Modi benötigen keinen Runtime-Endpunkt oder Simulator-Supervisor. -CheckOnly prüft Bereitschaft ohne Start der Ansicht. -Distribution, -VcXsrvPath und -XAuthority überschreiben vorhandene Pfade.
MoveIt nutzt ROS-Domain 78; Gazebo nutzt Domain 79 und Gazebo-Partition plexa_horst600_g2_offline. Halte diese Domains von der lesenden Live-Ansicht (Standarddomain 74) getrennt. Starte nur eine Instanz je Offline-Modus.
MoveIt akzeptiert -Pose zero, -Pose bent_a oder -Pose bent_b für synthetische anfängliche Gelenkwerte. -Pose gilt nur für MoveIt. Keine dieser Werte werden an Robot Runtime gesendet. Der Standardlaunchermodus bleibt die lesende Live-Ansicht.
Installation und Modellzuständigkeit
env/install-robotics-tools-ubuntu-24.04.sh pinnt MoveIt 2.12.4, ros_gz 1.0.24 und joint_state_publisher 2.4.3 gegen den signierten Jazzy-Snapshot vom 11.09.2026. env/robotics-tools.lock dokumentiert beobachtete Versionen einschließlich Gazebo Sim 8.15.0. Nutze die persistente Python-/SDK-Umgebung und den Overlay-Build aus der Hauptanleitung; temporäre Interpreter dürfen nicht in installierte ROS-Executables eingebaut werden.
Gemeinsame DAE-/STL-, Planungs-URDF- und SDF-Assets bleiben in models/robots/horst600/. Ihre LFS-Inhalte müssen materialisiert sein. Der ROS-Loader prüft vor dem Laden geprüfte Herkunft, alle Derivathashes und kanonische Gelenkkonsistenz. models/verification/OFFLINE-PREVIEW.md beschreibt Regenerierung und Validierung. Modellderivate bleiben intern und benötigen vor Weiterverteilung eine Lizenzprüfung.
MoveIt: planen und untersuchen
Der Offline-Launch startet robot_state_publisher, synthetischen joint_state_publisher, move_group und RViz. Die Gruppe arm nutzt KDL und OMPL RRTConnect mit CAD-Kollisionshüllen auf allen sieben Links. Nur die sechs benachbarten Linkpaare sind von Selbstkollision ausgenommen. link_6 ist ein Kettenendpunkt und kein kalibrierter TCP.
Wähle im RViz-Planning-Panel arm, Start <current> und Ziel turned und klicke auf Plan. Untersuche die angezeigte Trajektorie. Ausführung ist durch allow_trajectory_execution: false deaktiviert; keine Controller sind konfiguriert. Die Standardaktion ExecuteTrajectory bleibt verfügbar, weil RViz während der Initialisierung auf sie wartet. Ihre Disabled-Execution-Sperre bricht Anfragen mit CONTROL_FAILED ab; sie bietet keinen Controller oder Runtime-Pfad. In diesem Launch gibt es keinen SDK-Client.
Planner-Timing nutzt vorläufige Grenzen von 0.5 rad/s und 0.5 rad/s². Diese ersetzen keine kanonischen Roboterlimits und belegen kein gültiges physisches Trajektorientiming. Die Szene enthält aktuell nur den Roboter; es gibt kein geprüftes Werkzeug oder Zelle.
Nach Laden von Jazzy und Overlay führe von der Workspace-Wurzel die unabhängige Serviceprüfung aus:
ROS_DOMAIN_ID=78 "$HOME/.local/share/plexa/ros-venv/bin/python" \
integrations/ros/env/check-g2-planning.py --report integrations/ros/log/offline-acceptance.jsonSie prüft Null und zwei angewinkelte Posen, lehnt eine feste selbstkollidierende Gegenprobe ab, plant von Null zu J1=15° und prüft jedes zurückgegebene Sample durch GetStateValidity. Sie veröffentlicht nur eine Anzeigetrajektorie, niemals eine Ausführungsanfrage.
Die getrennte Sperrprobe prüft zuerst explizit deaktivierte Ausführung und sendet anschließend eine leere lokale Trajektorie ohne Gelenke, Punkte oder Controller:
ROS_DOMAIN_ID=78 "$HOME/.local/share/plexa/ros-venv/bin/python" \
integrations/ros/env/check-g2-execution-guard.py --report integrations/ros/log/execution-guard.jsonErwartetes Ergebnis: ABORTED (Status 6), CONTROL_FAILED (-4). Es wird keine Roboter- oder Simulatorbewegung angefragt. Dieser Test ist auf die isolierte Offline-Domain begrenzt.
Gazebo: Visual- und Statusvorbereitung
Der Launcher wählt explizit ein SDF mit unvalidierten Physikplatzhaltern. Er spawnt horst600_g2_offline in die installierte leere Welt mit fester Basis, sieben Visual-Links und sechs Drehachsen. Wähle dieses Modell im Entity Tree, um sechs lokale Gelenkpositionsregler in Radiant zu öffnen. Diese Regler steuern nur das isolierte Gazebo-Modell. Gravitation und Selbstkollision sind deaktiviert.
Massen, Bounding-Box-Trägheiten, Schwerpunkte, Effort und Dämpfung sind vorläufig. Werte und Herleitung sind in models/robots/horst600/gazebo-preview-parameters.json und der Models-Prüfanleitung dokumentiert. Exakte Werte können später geprüft und übernommen werden; die aktuelle Vorbereitung ist keine nutzbare Physikreferenz.
Die Bridge läuft nur Gazebo → ROS:
ROS_DOMAIN_ID=79 ros2 topic echo /gazebo_preview/joint_states --once
ROS_DOMAIN_ID=79 ros2 topic echo /clock --onceGazebo veröffentlicht exakt joint_1…joint_6, Radiant und Simulationszeit. Die ROS-Bridge bietet kein Command-Topic, Runtime-Client, Aktuator- oder Hardwareinterface.
WSL und Fehlersuche
Mit bereits laufendem authentifiziertem VcXsrv nutze den Shelleinstieg:
PLEXA_OFFLINE_MODE=MoveIt ROS_DOMAIN_ID=78 bash integrations/ros/env/launch-g2-offline.sh
PLEXA_OFFLINE_MODE=Gazebo ROS_DOMAIN_ID=79 bash integrations/ros/env/launch-g2-offline.shHalte das Terminal geöffnet. Nutze Ctrl+C zum Stoppen eigener Prozesse. Vermeide das Speichern einer RViz-Konfiguration bei bloßer Trajektorienuntersuchung; ein Dialog für ungespeicherte Konfiguration kann das Beenden verzögern. MoveIt 2.12.4 erzeugte in dieser WSL-Umgebung bei einem Shutdown einen CallbackGroup-Destruktor-Segmentation-Fault. Planung und Serviceprüfungen bestanden; sauberes MoveIt-Beenden bleibt ein ungelöstes Werkzeugproblem. Der Launch-Supervisor stoppte schließlich seinen RViz-Prozess. Begrenzte Gazebo-Läufe bereinigten ihre eigenen Simulator- und Bridge-Prozesse.
Historischer Vergleich: ExecuteTrajectory und WSL-Shutdown
Das Entfernen der ExecuteTrajectory-Fähigkeit verursachte hier 30 Sekunden RViz-Startwartezeit, Marker-Update-Rückstau und einen Absturz in InteractiveMarkerClient::pushUpdates. Die endgültige Konfiguration erhält die Aktion bei deaktivierter Ausführung; die Leertrajektorien-Sperrprobe prüft die Ablehnung. Der Debugger war GDB 15.1-1ubuntu1~24.04.1; Debuglogs bleiben unversioniert.
Erwartete Vorbereitungswarnungen umfassen fehlende Perception-/Octomap-Plugins und keine controller_names. Sie spiegeln den konfigurierten Umfang wider. Eine Modellhashabweichung erfordert Regenerierung, Prüfung und Review der Derivate, statt Validierung zu umgehen.
Begrenzte Shutdown-Diagnose ohne GUI
Der Fehler wurde am 14.10.2026 ohne RViz mit unveränderten Paketen MoveIt 2.12.4 und rclcpp 28.1.22 reproduziert. Bereitschaft wurde erreicht, der tatsächliche Parameter allow_trajectory_execution war false, und SIGINT ging einmal an den eigenen Launch-Supervisor. Dieser gab 0 zurück, während move_group mit −11 in rclcpp::CallbackGroup::~CallbackGroup() abstürzte. Beide State-Publisher endeten sauber. Launch-Exitcode 0 belegt daher keinen sauberen Shutdown; der historische RViz-Speicherdialog ist zur Reproduktion nicht erforderlich.
Nach Laden von Jazzy und dem vorhandenen Overlay:
ROS_DOMAIN_ID=78 python3 integrations/ros/env/check-g2-shutdown.py --report .tmp/new-moveit-shutdown.jsonDer Checker verwendet einen neuen eigenen Start ohne GUI, Localhost-Discovery, begrenzte Wartezeiten und eine lesende Parameteranfrage. Eine bereits laufende MoveIt-Instanz in Domain 78 bleibt erhalten; nur neue ignorierte Dateien werden geschrieben. Kindprozessabsturz, fehlende Bereitschaft/Readback und erzwungenes Beenden ergeben einen Fehler. Beurteile den Shutdown anhand der Kindprozessresultate im Report; Launch-Exitcode 0 allein genügt bei diesem Fehlerbild nicht. Ähnliche Upstream-Berichte 3680 und 3721 beschreiben Shutdown- beziehungsweise Destruktorfehler; identische Ursache ist damit nicht bewiesen.
Quelle und Manifest bleiben im ROS-Extension-Repository.
Konfigurationsreferenzen: MoveIt-Konfiguration, Gazebo-Gelenkcontroller, ROS-2-Interoperabilität.