POSIM v1.0.1Platform for Ocean Simulation · Documentation
Menu de la documentation
POSIM / Bien démarrer

Windows : WSL et Docker

Docker Desktop exécute POSIM et WSLg affiche Gazebo sur le bureau Windows. Lancez les commandes Docker de cette page dans le terminal Ubuntu de WSL.

1. Préparer WSL et l'affichage

Suivez les deux premières étapes de l'installation sous Windows : installez Ubuntu 26.04 dans WSL2, puis mettez à jour WSL et le pilote graphique de Windows, y compris avec une carte NVIDIA. N'installez pas de pilote d'affichage Linux dans WSL.

Installez Docker Desktop avec WSL2 et activez Settings → Resources → WSL Integration → Ubuntu-26.04. Utilisez le moteur de Docker Desktop ; un second moteur dans Ubuntu est inutile.

Vérifiez le serveur et le socket d'affichage :

docker version --format '{{.Server.Version}}'
test -S /mnt/wslg/.X11-unix/X0
printf '%s\n' "$DISPLAY"

Si le socket est absent, terminez la configuration de WSLg.

2. Télécharger POSIM

docker pull ioeslab/posim:latest

La page Environnement Docker présente les versions et la compilation des images. La configuration ci-dessous utilise le rendu logiciel. Pour une carte NVIDIA compatible, consultez les conditions d'accès au GPU.

3. Créer le conteneur

docker run -d --name posim --init --shm-size=1g \
  -e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
  --mount type=bind,source=/mnt/wslg/.X11-unix,target=/tmp/.X11-unix,readonly \
  --mount type=volume,source=posim-data,target=/work \
  --entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'

Enregistrez vos fichiers dans /work, associé au volume posim-data. Utilisez docker stop posim pour arrêter le conteneur et docker start posim pour le redémarrer.

Pour les exemples suivants, ouvrez deux terminaux Ubuntu et connectez-les au même conteneur. Gazebo s'affiche directement dans une fenêtre Windows.

4. Lancer le monde de démonstration

Entrez dans le conteneur :

docker exec -it posim bash

Vérifiez l'installation :

source /opt/ros/lyrical/setup.bash
source /opt/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false

Gazebo doit afficher l'océan. Gardez le terminal ouvert ; Ctrl+C arrête la simulation. Passez ensuite à votre premier robot.

Exécutez la version Linux de QGC dans le même conteneur POSIM. Ne lancez QGC ni sur l’hôte Windows ni dans WSL en dehors du conteneur. Suivez la configuration de QGC.