Skip to content

Mit KI weiterarbeiten

Mit KI weiterarbeiten

ROS 2: Fixture und Simulator einrichten ​

Wähle das Profil passend zu deiner Quelle. S5-Testfixture und G2-Simulator haben getrennte Identitäten und Modellzuordnungen. Die folgenden Setupbefehle gehören zum lesenden Adapter. Für lokale MoveIt-/Gazebo-Modi gilt die getrennte Offline-Vorbereitung.

Lokaler Fixture-Schnellstart ​

Die geprüfte Umgebung ist Ubuntu 24.04 amd64, nativ oder unter WSL 2, mit ROS 2 Jazzy aus dem signierten Snapshot vom 11.09.2026 und Python 3.12. RViz benötigt einen grafischen Server; der geprüfte G2-Windows-Launcher nutzt authentifiziertes VcXsrv. Das Repository enthält gepinntes Umgebungssetup und beobachtete Paketversionen.

Installiere aus dem ROS-Integrationsrepository die gepinnte Entwicklungsumgebung:

sh
bash env/setup-ubuntu-24.04.sh

Baue von der Multi-Repository-Workspace-Wurzel das Python-SDK-Wheel und ROS-Overlay:

sh
python3 -m venv /tmp/plexa-sdk-build
/tmp/plexa-sdk-build/bin/python -m pip install build==1.3.0
cd sdks/python
/tmp/plexa-sdk-build/bin/python -m build --wheel
cd ../..

python3 -m venv --system-site-packages "$HOME/.local/share/plexa/ros-venv"
"$HOME/.local/share/plexa/ros-venv/bin/python" -m pip install -r integrations/ros/env/requirements.lock
"$HOME/.local/share/plexa/ros-venv/bin/python" -m pip install --no-deps sdks/python/dist/plexa_runtime_read-0.2.0-py3-none-any.whl

source /opt/ros/jazzy/setup.bash
cd integrations/ros
"$HOME/.local/share/plexa/ros-venv/bin/python" -m colcon build --packages-select plexa_ros_read
cd ../..

Starte die deterministische HORST-Fixture in einem Terminal:

sh
cd testkit
npm run start -- --profile horst600s5 --scenario continuous

Starte den Adapter von der Workspace-Wurzel in einem zweiten Terminal:

sh
source /opt/ros/jazzy/setup.bash
source integrations/ros/install/setup.bash
ros2 launch plexa_ros_read horst600s5.launch.py \
  model_dir:="$(pwd)/models/robots/horst600s5"

Untersuche das Ergebnis aus einem dritten Terminal mit geladener ROS-Umgebung:

sh
ros2 topic echo /joint_states --once
ros2 topic echo /tf --once
ros2 topic echo /diagnostics --once

Der RViz-Fixed-Frame ist base_link. Angezeigte Kollisionsformen sind absichtlich grob, und link_6 ist kein kalibrierter TCP.

Lokaler Simulatorpilot ​

Für einen bereits aktiven HorstOS-Neo-Simulator, der HORST mit Modell-ID horst-600-g2-pt1 meldet, kann das WSL-2-NAT-Setup Windows-Port 9040 mit bash integrations/ros/env/forward-windows-runtime.sh an WSL-Loopback-Port 19042 weiterleiten. Starte von der Workspace-Wurzel das getrennte G2-Profil:

sh
source /opt/ros/jazzy/setup.bash
source integrations/ros/install/setup.bash
ros2 launch plexa_ros_read horst600g2_sim.launch.py \
  model_dir:="$(pwd)/models/robots/horst600" endpoint:=127.0.0.1:19042

Nutze in jedem Terminal dieselbe ROS_DOMAIN_ID, wenn andere lokale ROS-Graphen laufen. Die G2-Ansicht zeigt den gelesenen Simulatorzustand mit dem zugehörigen Visual-Modell. Nutze für lokale Planung und Gazebo die getrennte Offline-Vorbereitung.

Visual-Assets, Materialdarstellung und Modellgrenzen

Die G2-Anzeige nutzt sieben link-lokale COLLADA-Meshes aus den GLB-Dateien des Models-Repositorys. Die geprüfte Visual-URDF erhält kanonische Gelenke, Limits und Kollisionskörper. Quellfarben, Materialien und sechs Normal-Map-Bilder bleiben erhalten; RViz nutzt Geometrienormalen und eine Phong-Annäherung der PBR-Quellschattierung. Normal Maps bleiben als Quellmetadaten erhalten und werden vom RViz-Jazzy-Materialloader nicht angewendet. Dies belegt keine kalibrierte Geometrie oder pixelgleiche Darstellung. Dem Modell fehlen validierte Collision-, Inertial-, Kalibrierungs- und TCP-Daten für roboterspezifische MoveIt- oder Gazebo-Abnahme. Installation dieser Werkzeuge und Öffnen ihrer Beispielfenster belegen keine PLEXA-Planungs- oder Simulationsintegration.

Unter Windows mit bereits aktivem Simulator-Supervisor und Robot Runtime prüft der Workspace-Launcher WSL, Overlay, SDK und Simulator, nutzt oder startet die vorhandene authentifizierte VcXsrv-Installation und öffnet RViz:

powershell
pwsh -File integrations/ros/env/launch-horst-rviz.ps1

Standarddistribution ist Ubuntu-24.04, Display :1, ROS-Domain 74. -CheckOnly prüft Voraussetzungen; die Component-README beschreibt Pfadüberschreibungen. Der Launcher prüft Visual-Asset-Hashes und sieben Linkzuordnungen, bevor RViz die Beschreibung lädt. Fehlende Voraussetzungen werden direkt gemeldet. Er benötigt die Modell-LFS-Assets und vorhandene Xauthority-Datei. Halte das Terminal während der Betrachtung geöffnet. Er sendet keine Simulator- oder Robotercommands.