POSIM v1.0.1Platform for Ocean Simulation · Documentation
Menu de la documentation
POSIM / Piloter les robots

Piloter avec QGroundControl

Connectez QGroundControl (QGC) au BlueROV2 simulé, utilisez les joysticks virtuels et regardez l’image de sa caméra avant. Terminez l’installation, puis préparez les terminaux A et B.

1. Ouvrir QGC dans l'environnement de POSIM

Windows/WSL : utilisez la version Linux de QGC pour ces tutoriels. Ne lancez pas l’application installée sous Windows. Démarrez QGC dans la même distribution Ubuntu que POSIM ou, avec Docker, dans le même conteneur POSIM. WSLg peut afficher la fenêtre Linux sur le bureau Windows ; l’application continue de fonctionner dans Linux.

Les adresses 127.0.0.1 de ce guide désignent l’environnement où QGC s’exécute. Elles ne configurent pas l’application Windows pour recevoir la télémétrie ou la vidéo provenant de WSL ou de Docker.

Installation Où lancer QGC
Ubuntu natif Installez et lancez l'application Linux dans Ubuntu.
Windows avec WSL natif Installez et lancez l'application Linux dans la même distribution Ubuntu.
Linux ou Windows avec Docker Lancez l'application fournie dans le conteneur POSIM.
macOS avec Docker et RDP Lancez l'application depuis un terminal du bureau RDP.

Ce guide utilise QGC 5.1.5, fourni dans les images Docker POSIM. Pour une installation native, suivez le guide officiel d’installation et téléchargez l’AppImage Linux correspondant à votre processeur depuis la page de la version 5.1.5. Dans Docker, utilisez le terminal B :

qgroundcontrol &

Le & rend la main au terminal sans fermer QGC. Si vous avez lancé l'application dans un autre terminal, gardez-le ouvert. Lorsque les préférences du premier démarrage apparaissent, choisissez Metric System.

QGC, MAVROS et Gazebo partagent le même environnement Linux. La télémétrie utilise UDP 14550, la vidéo UDP 5600. Aucun de ces ports ne doit être publié par Docker dans cette configuration. Sous macOS, RDP donne accès à cet environnement.

2. Préparer les joysticks

Ouvrez Application Settings → Fly View → Virtual Joystick :

3. Régler la réception vidéo

Ouvrez Application Settings → Video. Choisissez d'abord la source vidéo, puis renseignez l'adresse UDP et les autres réglages du tableau.

Réglage Valeur
Video Source UDP h.264 Video Stream
UDP URL 127.0.0.1:5600
Aspect Ratio 0, proportions automatiques
Disable Video Stream When Disarmed Désactivé
Low Latency Mode Activé
Auto-reconnect on stream loss Activé

4. Lancer le robot et la caméra

Arrêtez toute simulation précédente. Dans le terminal A préparé :

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 ouvre la scène sous-marine et QGC se connecte à ArduSub. Attendez la fin de l'initialisation. Dans le terminal B :

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

Revenez à Fly View et cliquez sur l'aperçu vidéo pour l'agrandir.

La caméra avant montre les objets du monde de démonstration. Les joysticks virtuels restent accessibles au-dessus de la vidéo.
La caméra avant montre les objets du monde de démonstration. Les joysticks virtuels restent accessibles au-dessus de la vidéo.

La caméra produit des images de 640 × 480 à 5 Hz en temps simulé. Le rendu logiciel peut ralentir la simulation. BlueROV2 possède une flottabilité positive : même désarmé, il peut remonter et perdre les objets de vue.

qgc_video:=true ajoute l'émetteur H.264. La vidéo RVB inclut les effets sous-marins du monde. Le filtre de caméra indépendant conserve sa sortie ROS. Le GNSS perd la position quand l'antenne est immergée et la retrouve après émersion ; télémétrie, vidéo et commande manuelle restent connectées. Utilisez Manual sous l'eau. L'objectif est plus bas que l'antenne : une image sous-marine peut donc coexister avec une position GNSS valide.

5. Armer, déplacer et arrêter

  1. Attendez Ready, puis sélectionnez Manual.
  2. Ouvrez le menu d'état du véhicule et maintenez Arm jusqu'à la fin de l'action.
  3. Déplacez brièvement la manette droite vers l'avant, puis vers l'arrière.
  4. Relâchez-la pour ramener la consigne au neutre. Le courant et l'inertie peuvent encore déplacer le robot.
  5. Maintenez Disarm dans le menu d'état lorsque vous avez terminé.

Gardez les commandes au clavier et le joystick web désactivés pour éviter les consignes concurrentes. Arrêtez la vidéo depuis B :

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

Appuyez sur Ctrl+C dans A, puis fermez QGC.

MAVROS attend jusqu’à 60 secondes sans message de présence du véhicule avant de signaler une perte de connexion. Ce délai tient compte du rendu logiciel lent ; une interruption réelle de ces messages peut donc mettre jusqu’à 60 secondes à apparaître dans /mavros/state.

Résoudre un problème de connexion

Les options qgc_video et qgc_video_port ci-dessous concernent le lancement séparé de l’étape 4. Les premières simulations incluent déjà un émetteur vidéo ; utilisez leur commande /tutorial/camera/enable_streaming. Une forte charge du sonar peut espacer les images et faire apparaître temporairement Waiting for video dans QGC. Gardez Low Latency Mode activé et essayez le tutoriel sous-marin sans sonar.

Consultez les réglages vidéo officiels et les interfaces ROS des propulseurs.