Fehlerbehebung
Beginnen Sie mit dem ersten Fehler in der Startausgabe. Prüfen Sie danach Umgebung, Modellressourcen, Simulationszeit, Plugins und Datenempfang. Bewahren Sie den Fehler und die für seine Reproduktion relevanten Nachbarzeilen auf.
Ein Paket wird nicht gefunden
printf 'ROS_DISTRO=%s\n' "$ROS_DISTRO"
ros2 pkg prefix posim_demos
Erwartet werden lyrical und der Pfad des gewählten Workspaces. Bereiten Sie das Terminal passend zu Ihrem Installationsweg vor. Unterscheiden Sie dabei Host- und Containerpfade.
Modelle oder Meshes fehlen
Suchen Sie die erste nicht auflösbare URI. Prüfen Sie, ob die Paketressourcen installiert sind und die passende Umgebung geladen wurde. Für Fuel-Ressourcen benötigt die Gazebo-Umgebung Netzwerkzugriff. Der erste Download kann dauern; prüfen Sie seinen Fortschritt, bevor Sie einen weiteren Start versuchen.
Es gibt kein Bild oder das Rendering startet nicht
Prüfen Sie Grafiktreiber und Bildschirmanbindung anhand der Installationsanleitung. Gazebo und Kameras benötigen einen funktionierenden Renderer. Prüfen Sie beim Sonar das gewählte Backend und die installierten Pakete.
Prüfen Sie bei Unterwassereffekten:
- Den Dienst
/posim/appearance/<session_nonce>/state, Renderer- und Shaderpfade sowie die Zahl aktiver Kameras. - Die angewandte Revision und den Bereitschaftszustand nach dem Rendering.
- Ob Schwebteilchen ausdrücklich aktiviert wurden; standardmäßig sind sie aus. Das Beispiel zur Kameradämpfung lädt allein noch nicht das System für Szeneneffekte.
GNSS liefert keine gültige Position
Prüfen Sie den GNSS-Gültigkeitsstatus, die Antennenhöhe im Weltkoordinatensystem, die lokale Wasserhöhe und den Aufnahmezeitstempel. Die Welt braucht passende sphärische Koordinaten, die Antenne muss oberhalb des Wassers und unverdeckt sein. Lassen Sie genügend Simulationszeit für erneuten Empfang und Latenz verstreichen.
Ein konfiguriertes Wellen-Topic muss aktuelle, kompatible lokale Höhenwerte liefern. Die Installation des Empfängers fügt ihn weder dem Modell hinzu noch stellt sie einen ROS- oder Autopilot-Adapter bereit.
Es kommen keine Nachrichten an
Prüfen Sie zuerst, ob die Zeit fortschreitet, und ermitteln Sie Topic und Typ:
gz topic -l
ros2 topic list -t
ros2 topic info /underwater_camera/simulated_image --verbose
Verwenden Sie den richtigen Transport und dieselbe vorbereitete Umgebung. Prüfen Sie QoS, Domain sowie Bridge- und Pluginfehler. Beim Sensorstart muss namespace einen vorhandenen Deskriptor benennen. USBL ist bereits in seiner Beispielwelt enthalten und wird über den Weltstart geladen.
Bild-Topics sind sichtbar, aber Bilder bleiben aus
Wenn Gazebo Bilder erzeugt und ROS den Publisher findet, aber kaum oder keine Bilder empfängt, prüfen Sie den DDS-Datenpfad. Große UDP-Datagramme können bei Cyclone DDS an Grenzen der IP-Fragmentierung stoßen. Kleinere Datagramme können bei einer Netzwerk-MTU von 1500 Byte helfen. Siehe Fragmentierung in Cyclone DDS.
Ein Profil vorbereiten
Erstellen Sie dieses Profil einmal, wenn rmw_cyclonedds_cpp installiert ist. Verwenden Sie bereits ein Cyclone-DDS-Profil, ergänzen Sie dort die beiden Größen in General. Behalten Sie die Einstellungen für Discovery und Netzwerkschnittstellen bei.
mkdir -p "$HOME/.config/posim"
cat > "$HOME/.config/posim/cyclonedds-images.xml" <<'XML'
<CycloneDDS xmlns="https://cdds.io/config">
<Domain Id="any">
<General>
<MaxMessageSize>1400B</MaxMessageSize>
<FragmentSize>1280B</FragmentSize>
</General>
</Domain>
</CycloneDDS>
XML
Mit einheitlichen Einstellungen neu starten
Beenden Sie Simulation und Anzeigeprogramme. Laden Sie die POSIM-Umgebung und wählen Sie das Profil in jedem Terminal, bevor Sie die Programme neu starten. Bei einem vorhandenen Profil verwenden Sie dessen Pfad.
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export CYCLONEDDS_URI="file://$HOME/.config/posim/cyclonedds-images.xml"
Läuft in dieser Domain bereits der Hintergrundprozess der ROS-Kommandozeile, beenden Sie ihn einmal. Nachfolgende Befehle verwenden dann die neue Konfiguration:
ros2 daemon stop
Wiederholen Sie die Bild- und Ratenprüfung. Prüfen Sie neben der Empfangsrate die Aufnahmezeitstempel. Kleinere Pakete verursachen zusätzlichen Aufwand; bei niedrigerer MTU müssen auch die Größen weiter sinken.
Das Fahrzeug bewegt sich nicht
Prüfen Sie Controllerzustand, Arming, Navigationsgültigkeit, Befehlsempfang und Betriebsmodus. Kontrollieren Sie Gelenknamen und Schubachsen. Lassen Sie nur eine Befehlsquelle aktiv. Neutrale Eingaben, eine pausierte Welt oder ein nicht scharfgeschalteter Autopilot können das Fahrzeug stillhalten.
Die Simulation beendet sich nicht
Schließen Sie die Anzeigeprogramme, drücken Sie einmal Ctrl+C im Startterminal und warten Sie auf das Ende der Prozesse. Bewahren Sie relevante Meldungen zu Abbruch, Speicherzugriffsfehlern oder erzwungenem Beenden auf. Nennen Sie beim Fehlerbericht Befehl, Revision, Betriebssystem, Architektur und Renderer.
RViz stürzt nach Discard ab
Das POSIM-Installationsprogramm für Ubuntu/WSL und die AMD64/ARM64-Docker-Images enthalten ein isoliertes RViz-Overlay für RViz 15.2.6. Es stoppt den Aktualisierungstimer nach bestätigtem Schließen und gibt beim Beenden die ROS-Ressourcen der Ansichten frei. Bei Cancel laufen die Aktualisierungen weiter. Die RViz-Systempakete bleiben unverändert. Nach dem Laden der POSIM-Umgebung sollte ros2 pkg prefix rviz_common den Pfad /opt/posim/rviz-close/install ausgeben. Für ältere Installationen folgen Sie der Bau- und Aktivierungsanleitung unter diesem Link.
Ohne das Overlay kann RViz 15.2.6 unter Ubuntu 26.04 gelegentlich beim Schließen des Fensters mit Discard abstürzen, obwohl die Sensoranzeigen funktionieren. Das Overlay behebt bestimmte Timer- und Ressourcenfreigabeprobleme, deckt aber nicht jeden Renderer oder Beendigungspfad ab. Falls ein Problem weiterhin auftritt, geben Sie RViz-Version, Pfade der geladenen Bibliotheken und Schließvorgang im Bericht an.
Wenn RViz nach dem Schließen seines Fensters weiterläuft, kann es besonders beim Software-Rendering übermäßig viel Arbeitsspeicher belegen. Drücken Sie vor einem Neustart im Startterminal Ctrl+C, um die verbleibenden Prozesse zu beenden. Falls RViz nicht regulär endet, beendet ROS launch den Prozess zwangsweise. Wenn Sie das Sonarbeispiel ohne Anzeige ausführen möchten, ergänzen Sie den Befehl für multibeam_sonar_demo.launch.py um rviz:=false. Die ROS-Bildausgabe bleibt verfügbar.
Tiefenkameras mit einem nativen macOS-SDK neu erzeugen
Für macOS arm64 / Ogre-Next 2.3.3 enthält die isolierte Ogre-Umgebung die Korrektur der Materiallebensdauer beim Entfernen und erneuten Erzeugen von Tiefenkameras.
Beachten Sie die vorgegebenen SDK- und Quellversionen, bauen Sie mit dem Hilfsprogramm und übergeben Sie Ihren Gazebo-Befehl an run_overlay.py. Ein Build allein wählt die Bibliothek noch nicht aus. Prüfen Sie die tatsächlich geladenen Pfade und bewahren Sie das Validierungsergebnis auf. Der normale Installer aktiviert diese Umgebung nicht; sie ersetzt keine Systembibliotheken und richtet keine Linux-Container ein. Andere Versionen oder Plattformen benötigen ein eigenes passendes Profil.
Einen nachvollziehbaren Bericht erstellen
Geben Sie Quell-SHA oder Image-Digest, Abhängigkeitsversionen, Befehl und Argumente, ersten Fehler, erwartetes Verhalten, relevante Topic-Typen und ein minimales Beispiel an. Unterscheiden Sie zwischen einem nur gefundenen Topic und tatsächlich empfangenen Daten.
MAVROS 2.16.0 wird mit SIGSEGV beendet
Das POSIM-Installationsskript und die offiziellen Docker-Builds enthalten die
Korrektur der Router-Lebensdauer
für MAVROS 2.16.0. Nach dem Laden der POSIM-Umgebung sollte ros2 pkg prefix mavros
den Pfad /opt/posim/mavros-router/install ausgeben. Für bestehende Installationen
ist unter dem Link eine separate Build-Anleitung verfügbar. Falls der Absturz
weiterhin auftritt, fügen Sie dem Fehlerbericht das MAVROS-Protokoll und die Pfade
der tatsächlich geladenen Bibliotheken bei.
QGC läuft unter Windows, POSIM aber in WSL
Schließen Sie die Windows-Anwendung und starten Sie die Linux-Version von QGC in derselben Ubuntu-Distribution wie POSIM oder im POSIM-Container. Ein WSLg-Fenster erscheint auf dem Windows-Desktop, bleibt aber ein Linux-Prozess. Die QGC-Einrichtung hält Telemetrie und Video innerhalb dieser Umgebung.