Überwasserroboter und Wellen
Simulieren Sie ein WAM-V mit Wave-Sim-Wellen und ArduRover im Bootsmodus. POSIM-Installer und Docker-Rezepte bauen die externen Wellenbibliotheken.
Standardtutorial
Die Standardinstallation enthält einen WAM-V-Bojenparcours mit Kamera, Lidar und vorkonfigurierter RViz-Ansicht. Das optionale Image unten ist dafür nicht nötig. Führen Sie im vorbereiteten POSIM-Terminal aus:
ros2 launch posim_demos surface_tutorial.launch.py
Szene, Lidar-Anzeige sowie QGroundControl-Video und Steuerung sind unter Erste Simulation beschrieben.
WAM-V vorbereiten
Dieses optionale Image verwendet den ARM64-Desktopaufbau. Bereiten Sie auf einem Apple-Silicon-Mac Docker und RDP vor. Führen Sie im macOS-Terminal aus einer POSIM-Repository-Kopie Folgendes aus:
docker pull ioeslab/posim:latest
docker build -f extras/surface/Dockerfile \
--build-arg POSIM_BASE_IMAGE=ioeslab/posim:latest -t posim:surface .
docker run -d --name posim-surface --shm-size=1g \
-p 127.0.0.1:3390:3389 posim:surface
Verbinden Sie RDP mit 127.0.0.1:3390 und dem Konto docker. Öffnen Sie im Linux-Desktop ein Terminal:
source /opt/ros/lyrical/setup.bash
source /home/docker/posim_ws/install/setup.bash
ros2 launch /opt/posim-surface/wamv.launch.py headless:=false
Das Image enthält getrennte ArduSub- und ArduRover-Programme. Das Beispiel wählt ArduRover mit FRAME_CLASS=2. Starten Sie eine Instanz je Umgebung: Fahrzeugname, erzeugte Dateien und Controller-Ports sind festgelegt. Mehrere Fahrzeuge benötigen getrennte Dateien, Namen, Controller-Kennungen und Ports oder isolierte Umgebungen.
Der Controller wartet auf das Fahrzeug und dessen IMU-Daten. Scheitert das Einsetzen oder dauert es länger als 180 s, oder folgt innerhalb weiterer 180 s keine IMU-Messung, endet der Start mit Fehlerstatus und nennt die betroffene Phase. Prüfen Sie vor einem erneuten Versuch die Gazebo- und Sensormeldungen.
Modell, Steuerung und Navigation
extras/surface/wamv.py bereitet das externe Modell vor. Die hinteren Propeller verwenden Ausgänge 1 und 3; das Fahrzeug startet an der Wasseroberfläche.
Der Adapter für externe Navigation sendet simulierte Gazebo-Pose und -Geschwindigkeit an MAVROS. Prüfen Sie Controller-Zustand, gültige Navigation und Schubrichtung, bevor Sie eine Mission senden.
Für Empfängerrauschen, Wasserkontakt und Wiedererfassung integrieren Sie Marine-GNSS, Antenne und einen passenden Navigationsadapter. Der Adapter für externe Pose ist ein eigener Navigationseingang.
Wellen einstellen
Die Steuerung nutzt gz.msgs.Param auf /world/<world_name>/waves. Der Name stammt aus <world name="…">. Listen Sie laufende Topics auf:
gz topic -l
Der WAM-V-Start verwendet standardmäßig posim_surface, also /world/posim_surface/waves. Im vorbereiteten Container lässt sich der Name ändern:
SURFACE_WORLD=harbour
ros2 launch /opt/posim-surface/wamv.launch.py headless:=false world_name:="$SURFACE_WORLD"
Das Topic lautet dann /world/harbour/waves; die ROS-IMU bleibt unter /model/wamv/imu. world_name benennt die erzeugte Welt. Es wählt keine Geländedatei und isoliert keine zweite Instanz.
Der ebene Meeresboden liegt bei z = −10 m. Eigene Böden beschreibt Höhenkartengelände.
Parameter (double) |
Einheit | Bedeutung |
|---|---|---|
wind_speed |
m/s | Windgeschwindigkeit des Wellenmodells |
wind_angle |
Grad | Windrichtung |
steepness |
dimensionslos | Wellensteilheit |
Stimmen Sie Darstellung und Hydrodynamik aufeinander ab. Strömungen werden getrennt eingestellt. Die Welt muss die Wellensysteme einbinden und konfigurieren; installierte Bibliotheken allein aktivieren sie nicht.
Grenzen und Abhängigkeiten
Das optionale Dockerfile unterstützt den ARM64-Aufbau. Rumpf, Antrieb und Widerstand müssen für das Fahrzeug und seine Betriebsbedingungen kalibriert werden. Beim Herunterfahren kann der Supervisor MAVROS oder Gazebo beenden müssen; prüfen Sie vor einem Neustart, dass beide Prozesse beendet sind.
extras/surface/dependency.json legt die externe Revision fest. Der Installer baut nach /opt/waves und behält Quellen unter /opt/asv_wave_sim. Es handelt sich um eine Build-Abhängigkeit, nicht um ein Git-Submodul. Siehe Integrationsanleitung und Lizenzen.