POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Roboter steuern

Steuern mit QGroundControl

Verbinden Sie QGroundControl (QGC) mit dem simulierten BlueROV2, bedienen Sie die virtuellen Joysticks und betrachten Sie das Bild der Frontkamera. Schließen Sie die Installation ab und bereiten Sie Terminal A und B vor.

1. QGC in der POSIM-Umgebung öffnen

Windows/WSL: Verwenden Sie für diese Tutorials die Linux-Version von QGC. Starten Sie nicht die unter Windows installierte Anwendung. QGC muss in derselben Ubuntu-Distribution wie POSIM laufen, bei Docker im selben POSIM-Container. WSLg kann das Linux-Fenster auf dem Windows-Desktop anzeigen; die Anwendung läuft weiterhin in Linux.

Die Adressen 127.0.0.1 in dieser Anleitung beziehen sich auf die Umgebung, in der QGC läuft. Damit wird eine Windows-Anwendung nicht für den Empfang von Telemetrie oder Video aus WSL oder Docker eingerichtet.

Installation Wo QGC ausgeführt wird
Ubuntu nativ Linux-Anwendung in Ubuntu installieren und starten.
Windows mit nativer WSL-Installation Linux-Anwendung in derselben Ubuntu-Distribution installieren und starten.
Linux oder Windows mit Docker Mitgelieferte Anwendung im POSIM-Container starten.
macOS mit Docker und RDP Anwendung in einem Terminal des RDP-Desktops starten.

Diese Anleitung verwendet QGC 5.1.5, das in den POSIM-Docker-Images enthalten ist. Für native Installationen folgen Sie der offiziellen Installationsanleitung und laden das Linux-AppImage für Ihre Prozessorarchitektur von der Release-Seite für 5.1.5 herunter. Im Container verwenden Sie Terminal B:

qgroundcontrol &

Das & gibt die Eingabeaufforderung frei, während QGC geöffnet bleibt. Lassen Sie auch ein separat für QGC geöffnetes Terminal weiterlaufen. Wählen Sie bei den Einstellungen zum ersten Start Metric System.

QGC, MAVROS und Gazebo laufen in derselben Linux-Umgebung. Telemetrie verwendet UDP 14550, Video UDP 5600. Dafür sind keine zusätzlichen Docker-Portfreigaben nötig. Unter macOS greifen Sie per RDP auf diese Umgebung zu.

2. Joysticks vorbereiten

Öffnen Sie Application Settings → Fly View → Virtual Joystick:

3. Videoempfang einstellen

Öffnen Sie Application Settings → Video. Wählen Sie zuerst die Videoquelle und tragen Sie anschließend UDP-Adresse und weitere Einstellungen aus der Tabelle ein.

Einstellung Wert
Video Source UDP h.264 Video Stream
UDP URL 127.0.0.1:5600
Aspect Ratio 0, automatisches Seitenverhältnis
Disable Video Stream When Disarmed Aus
Low Latency Mode Ein
Auto-reconnect on stream loss Ein

4. Roboter und Kamera starten

Beenden Sie die vorherige Simulation. Im vorbereiteten Terminal A:

ros2 launch posim_demos posim_robot.launch.py \
  namespace:=bluerov2 world_name:=camera_tutorial \
  x:=3 z:=-94 paused:=false gui:=true headless:=false \
  use_teleop:=false use_web_joystick:=false \
  open_qgc:=false open_virtual_joystick:=false qgc_video:=true

Gazebo öffnet die Meeresbodenszene; QGC verbindet sich mit ArduSub. Warten Sie, bis die Initialisierung abgeschlossen ist. In Terminal B:

gz topic -t /model/bluerov2/camera/enable_streaming \
  -m gz.msgs.Boolean -p 'data: true' --duration 3

Wechseln Sie zu Fly View und klicken Sie auf die Videovorschau, um sie zu vergrößern.

Die Frontkamera zeigt die Objekte der Beispielwelt. Beide virtuellen Joysticks bleiben über dem Videobild bedienbar.
Die Frontkamera zeigt die Objekte der Beispielwelt. Beide virtuellen Joysticks bleiben über dem Videobild bedienbar.

Die Kamera liefert Bilder mit 640 × 480 Pixeln bei 5 Hz bezogen auf die Simulationszeit. Software-Rendering kann die tatsächliche Bildrate verringern. BlueROV2 hat positiven Auftrieb: Auch bei deaktivierten Antrieben kann es aufsteigen, sodass die Objekte aus dem Bild verschwinden.

qgc_video:=true fügt den H.264-Sender hinzu. Das RGB-Bild enthält die Unterwassereffekte der Szene. Der separate Kamerafilter hat einen eigenen ROS-Ausgang. GNSS verliert beim Untertauchen der Antenne die Position und erfasst sie nach dem Auftauchen erneut; Telemetrie, Video und manuelle Steuerung bleiben verbunden. Verwenden Sie unter Wasser Manual. Die Linse liegt unter der Antenne, sodass trotz gültiger GNSS-Position ein Unterwasserbild möglich ist.

5. Antriebe freigeben, fahren und stoppen

  1. Warten Sie auf Ready und wählen Sie Manual.
  2. Öffnen Sie das Fahrzeugstatusmenü und halten Sie Arm gedrückt, bis der Vorgang abgeschlossen ist.
  3. Bewegen Sie den rechten Joystick kurz vor und zurück.
  4. Lassen Sie ihn los, um den Befehl auf neutral zurückzusetzen. Strömung und Trägheit können den Roboter weiterhin bewegen.
  5. Halten Sie zum Abschluss Disarm im Statusmenü gedrückt.

Lassen Sie Tastatursteuerung und Web-Joystick deaktiviert, damit keine konkurrierenden Befehle entstehen. Beenden Sie die Videoübertragung in B:

gz topic -t /model/bluerov2/camera/enable_streaming \
  -m gz.msgs.Boolean -p 'data: false' --duration 3

Drücken Sie in A Strg+C und schließen Sie QGC.

MAVROS meldet einen Verbindungsverlust, wenn bis zu 60 Sekunden lang kein Heartbeat des Fahrzeugs eintrifft. Damit wird langsames Software-Rendering berücksichtigt; ein tatsächlicher Ausfall der Heartbeats kann deshalb erst nach bis zu 60 Sekunden in /mavros/state erscheinen.

Verbindungsprobleme beheben

Die folgenden Optionen qgc_video und qgc_video_port gelten für den separaten Startbefehl in Schritt 4. Die ersten Simulationen enthalten bereits einen Videosender; verwenden Sie dort den Befehl für /tutorial/camera/enable_streaming. Bei hoher Sonarlast und langen Abständen zwischen Bildern kann QGC vorübergehend Waiting for video anzeigen. Lassen Sie Low Latency Mode aktiviert und versuchen Sie das Unterwassertutorial ohne Sonar.

Weitere Optionen finden Sie in den offiziellen Videoeinstellungen. Die ROS-Schnittstellen erläutert Thruster und Joystick-Steuerung.