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

Windows : installation dans WSL

Installez POSIM dans Ubuntu 26.04 avec Windows Subsystem for Linux 2 (WSL2). WSLg affiche Gazebo sur le bureau Windows. Pour utiliser une image prête à l’emploi, choisissez WSL avec Docker.

1. Installer WSL et Ubuntu

Ouvrez PowerShell en tant qu’administrateur :

wsl --install -d Ubuntu-26.04

Redémarrez Windows si nécessaire. Ouvrez Ubuntu et créez votre compte Linux. Dans PowerShell, vérifiez que la distribution utilise WSL 2 :

wsl --list --verbose

Consultez le guide Microsoft si WSL est déjà installé ou si l’installation échoue.

2. Préparer le pilote graphique et WSLg

Installez ou mettez à jour le pilote Windows de votre GPU Intel, AMD ou NVIDIA. Cette étape concerne aussi NVIDIA. WSLg utilise ce pilote pour l’accélération graphique ; suivez le guide des applications graphiques.

Avec NVIDIA, suivez CUDA sous WSL : installez le pilote Windows, pas de pilote d’affichage Linux dans WSL. Le toolkit CUDA est nécessaire uniquement pour compiler le backend CUDA du sonar.

Mettez WSL à jour depuis PowerShell :

wsl --update

Enregistrez le travail des terminaux WSL avant tout redémarrage demandé, puis rouvrez Ubuntu.

3. Installer POSIM dans Ubuntu

Utilisez le profil Ubuntu de Windows Terminal pour les commandes Linux. Vérifiez la distribution :

cat /etc/os-release

Suivez Ubuntu : installation native, du téléchargement des sources à la compilation. Conservez l’espace de travail dans ~/posim_ws, dans le système Linux. L’installateur utilise sudo et met à jour les paquets Ubuntu.

Si les topics d’image sont visibles mais que les images n’arrivent pas, consultez le dépannage. Préparer les terminaux explique les deux fenêtres utilisées dans la suite.

4. Lancer le monde de démonstration

Exécutez ces commandes dans Ubuntu. Gazebo doit s’ouvrir sur le bureau Windows et afficher l’océan. Au premier lancement, des modèles Fuel peuvent être téléchargés. Arrêtez la simulation avec Ctrl+C avant de lancer un autre exemple.

source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
source ~/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false

Exécutez la version Linux de QGC dans la même distribution Ubuntu que POSIM. Pour cette configuration, n’utilisez pas l’application installée sous Windows. Suivez la configuration de QGC.