WWW-POSIM v0.6.16Simulator-Dokumentation
Dokumentationsmenü
WWW-POSIM / Simulator-Dokumentation

Einen lokalen Arbeitsbereich steuern

Öffnen Sie das vorbereitete ROS-2-Beispiel in VS Code und senden Sie einen kurzen Befehl an Ihre lokale Simulation.

Eine steuerbare Welt starten

  1. Folgen Sie Installation und installieren Sie VS Code.
  2. Öffnen Sie WWW-POSIM, melden Sie sich mit Ihrem bestätigten Konto an und wählen Sie Simulator starten. Starten Sie unter Windows und Ubuntu zuerst Docker.
  3. Wählen Sie unter Arbeitsbereich ein fertiges Gelände, WAM-V und ROS-2-Direktsteuerung.
  4. Starten Sie die Welt und warten Sie auf Fahrzeug und aktuelle Positionsdaten. Lassen Sie Anwendung und Browser geöffnet.

Die Anwendung führt die Simulation aus; VS Code dient zum Bearbeiten und Starten Ihres Steuerprogramms.

Das vorbereitete Beispiel in VS Code öffnen

In VS Code öffnen öffnet das Arbeitsverzeichnis und ros_vehicle_command.py. Anfangs ist dies Documents/WWW-POSIM. Python-Projekt erstellen ergänzt Beispiele und Editoreinstellungen, ohne bestehende Dateien zu überschreiben. Beim Öffnen von VS Code wird auch ein fehlendes Fahrzeugbeispiel ergänzt. Ein anderes Verzeichnis wählen Sie unter Lokale Einstellungen → Arbeitsverzeichnis. Arbeitsverzeichnis öffnen zeigt es im Dateimanager.

Bestätigen Sie auf Nachfrage Ihr eigenes Projekt als vertrauenswürdig und erlauben Sie die automatische Aufgabe WWW-POSIM: ROS terminal. Andernfalls starten Sie sie über Terminal → Aufgabe ausführen → WWW-POSIM: ROS terminal. Neue integrierte Terminals verwenden WWW-POSIM ROS. Warten Sie auf ROS connected. Das Öffnen der Datei führt das Beispiel nicht aus.

Unter macOS verwenden Terminal und Python-Debugger das mitgelieferte Python samt vorbereiteter ROS-Umgebung. Eine weitere virtuelle Umgebung ist für dieses Projekt nicht nötig. Unter Windows und Ubuntu laufen Befehle im vorbereiteten Steuerungscontainer, während VS Code den gemeinsamen Ordner bearbeitet.

Installieren Sie Microsofts Erweiterungen Python und Python Debugger. Unter Windows und Ubuntu benötigen Sie außerdem Dev Containers und Dev Containers: Reopen in Container zum Debuggen im Container. ROS-Terminal öffnen startet ein vorbereitetes externes Terminal im selben Verzeichnis.

Das ROS-2-Beispiel ausführen

Wählen Sie in der laufenden Welt ROS aktivieren. Prüfen Sie im vorbereiteten Terminal die Optionen und fordern Sie eine kurze WAM-V-Bewegung an:

python ros_vehicle_command.py --help
python ros_vehicle_command.py --vehicle wamv --forward 0.3 --seconds 2

Das Beispiel veröffentlicht regelmäßig Befehle und sendet beim Ende oder bei Strg+C neutrale Werte. Vor Bewegungsbefehlen wartet es auf einen Subscriber. Ein Lauf dauert höchstens 30 Sekunden; WAM-V-Befehle sind auf 1 m/s und 0.5 rad/s begrenzt, BlueROV2-Schub auf 5 N je Motor.

Beginnen Sie bei BlueROV2 mit sechs neutralen Werten:

python ros_vehicle_command.py --vehicle bluerov2 --thrusters 0 0 0 0 0 0 --seconds 2

Prüfen Sie Fahrzeug und Reaktion, bevor Sie die Eingabe erhöhen. Neutrale Befehle beseitigen weder Trägheit noch Wellenkräfte.

Die Python-Sitzungsschnittstelle verwenden

Das Paket bietet auch eine Python-Sitzungsschnittstelle. Speichern Sie diesen Code als controller.py und führen Sie python controller.py im vorbereiteten Terminal aus:

from www_posim_ros import Session

with Session.local(control=True) as sim:
    topic = next(name for name, kind in sim.topics.items()
                 if kind == "nav_msgs/msg/Odometry")
    print("Before:", sim.latest(topic)["pose"]["pose"]["position"])
    sim.set_velocity(forward=0.3, yaw_rate=0.0, duration=2.0)
    print("After:", sim.latest(topic)["pose"]["pose"]["position"])

Das Programm liest eine aktuelle Position, fordert zwei Sekunden Vorwärtsfahrt mit 0.3 m/s an und gibt die Steuerung frei. Die ausgegebenen Positionen müssen nicht genau um eine bestimmte Strecke auseinanderliegen. yaw_rate=0.1 fordert eine Linkskurve an. Mit der Stoppfunktion im Browser unterbrechen Sie die Steuerung unmittelbar.

BlueROV-Schub steuern

Die Schnittstelle nimmt sechs BlueROV2-Schubwerte in Newton und in der nativen Gelenkreihenfolge entgegen. WAM-V verwendet zwei Werte: links und rechts. Beginnen Sie neutral:

from www_posim_ros import Session

with Session.local(control=True) as sim:
    sim.set_thrusters([0.0] * 6, duration=1.0)
Schnittstellengrenze Wert
WAM-V-Geschwindigkeit Vorwärts ±1.5 m/s; Gieren ±0.5 rad/s
WAM-V-Schub ±200 N je Motor
BlueROV2-Schub ±50 N je Motor
Laufzeit der Hilfsfunktionen Größer als 0, höchstens 300 Sekunden
Befehlsüberwachung 0.75 Sekunden ohne gültige Aktualisierung

Diese Grenzen unterscheiden sich von den absichtlich kleineren Beispielgrenzen in ros_vehicle_command.py. Die Hilfsfunktionen wiederholen Befehle mit etwa 10 Hz und geben danach die Steuerung frei. sim.stop() unterbricht die aktive Hilfsfunktion aus einem anderen Thread. Ein Verbindungsabbruch beendet die Steuerung; Befehle starten nach einem Netzwerkfehler nicht automatisch erneut.

Wenn der Server die Freigabe bestätigt, wartet die Hilfsfunktion auf neutralen Schub und die Freigabe der Steuerung. Bei controller_busy zuerst die andere Steuerung beenden. Ein reguläres Bewertungsende oder ein Stopp kann control_lease_ended auslösen. watchdog_timeout und simulation_or_sensor_unavailable beenden den Lauf mit einem Fehler.

Bei einer Aufgabenbewertung bedeutet control_service_stalled, dass die nativen Steuerungsaufrufe des Servers länger als 0.75 Sekunden ausgeblieben sind. Der Antrieb wird sicher gestoppt; dieser Lauf erhält keine gültige Punktzahl. Website-Einreichungen behalten abgeschlossene Ergebnisse und wiederholen den unterbrochenen Lauf automatisch. Prüfen Sie beim lokalen Üben den Simulator und starten Sie den Lauf erneut.

Erweiterung in der installierten App laden

Ein lokaler Arbeitsbereich der installierten App kann eine vom Eigentümer genehmigte world/model-ZIP-Erweiterung laden. Gehostete Arbeitsbereiche und Bewertungssitzungen führen keinen Erweiterungscode aus.

  1. Öffnen Sie im letzten Prüfschritt des Arbeitsbereichs User world/model extensions und Import extension ZIP. Das Archiv enthält extension.json, seinen SDF-Einstiegspunkt und die deklarierten Dateien mit Hashwerten. Der Import prüft und speichert das Archiv, ohne Code auszuführen.
  2. Prüfen Sie unter Declared files and SDK Code, Zielplattform, ZIP-SHA-256 und SDK-SHA-256. Zielplattform und SDK müssen zur laufenden Engine passen. Der Code erhält den Datei- und Netzwerkzugriff der lokalen Laufzeit.
  3. Wählen Sie Approve code and select, bestätigen Sie nur vertrauenswürdigen Code und starten Sie die Welt. Die Genehmigung gilt für den Eigentümer und das genaue ZIP/SDK-Paar; die Auswahl gilt für die neue Sitzung. Clear selected extension lässt das gespeicherte Archiv bestehen.

Ein unbekanntes SDK oder abweichende Zielplattformen beziehungsweise Hashwerte sperren die Auswahl. Verwenden Sie eine für die gewählte Engine gebaute Erweiterung und genehmigen Sie deren genaues Archiv. Allgemeine Skripte ohne registrierten Einstiegspunkt eines Navigationsproviders sind nicht ausführbar. Die App verwaltet den Providerprozess und beendet ihn mit der Sitzung.

WAM-V und BlueROV2 verwenden dieselbe Schnittstelle mit einem aktiven ROS-Navigationsprovider. Ein ausgewählter Benutzerprovider ersetzt die Ausgabe des integrierten Providers; der rohe GNSS-Empfänger bleibt erhalten. Gemeinsame Ausgaben sind /vehicle/navigation/estimate (nav_msgs/Odometry) und /vehicle/navigation/status (std_msgs/String-JSON). Die Pose verwendet navigation_map ENU, der Twist base_link mit Körperachsen FLU. Übereinstimmende Simulationszeitstempel, endliche Kovarianz, Sitzungsidentität und ein geografischer WGS-84-Ursprung sind erforderlich.

Im Autopilot-Modus prüft das gemeinsame Gateway diese Ausgaben, bevor es externe Navigation an die FCU liefert. Nur rohes GNSS bestimmt den GPS-Fix-Status. Fehlende Kalibrierung, globale Ausrichtung oder gültige Sensordaten müssen die Providerbereitschaft auf false halten. Import oder Prozessstart bedeuten keine Navigationsbereitschaft. Quellenauswahl und Ausfallverhalten erläutert GNSS und Navigation.

SDK aktualisieren

Das Python-SDK prüft ab Version 0.4.2 beim Verbinden im Hintergrund auf stabile Updates und zeigt die Installationsschritte im Terminal. Offizielle Bewertungen überspringen diese Abfrage. Aktualisieren Sie für das gebündelte SDK die App und öffnen Sie ein neues ROS-Terminal. Tragen Sie für einen bestehenden VS Code Dev Container das angezeigte Image in .devcontainer/devcontainer.json ein und bauen Sie den Container neu. Führen Sie in einer eigenen Python-Umgebung den angezeigten Befehl aus und starten Sie Python neu. Prüfen Sie manuell mit python -m www_posim_ros.updates.

Probleme beheben

Weiterführend: ROS-Terminals und Verbindung, Einen Web-Arbeitsbereich steuern, Visualisierung mit RViz und Foxglove, ROS-Fehlerbehebung.

Dokumentation durchsuchen