POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Erste Schritte

Windows: Installation in WSL

Installieren Sie POSIM in Ubuntu 26.04 unter Windows Subsystem for Linux 2 (WSL2). WSLg zeigt Gazebo auf dem Windows-Desktop an. Ein vorbereitetes Image verwenden Sie über WSL mit Docker.

1. WSL und Ubuntu installieren

Öffnen Sie PowerShell als Administrator:

wsl --install -d Ubuntu-26.04

Starten Sie Windows neu, falls Sie dazu aufgefordert werden. Öffnen Sie Ubuntu und legen Sie ein Linux-Benutzerkonto an. Prüfen Sie in PowerShell, ob die Distribution WSL 2 verwendet:

wsl --list --verbose

Bei vorhandenem WSL oder Installationsproblemen hilft die Microsoft-Anleitung.

2. Grafiktreiber und WSLg vorbereiten

Installieren oder aktualisieren Sie den Windows-Grafiktreiber für Ihre Intel-, AMD- oder NVIDIA-GPU. Das gilt auch für NVIDIA. WSLg nutzt diesen Treiber zur Grafikbeschleunigung; siehe grafische Anwendungen unter WSL.

Befolgen Sie bei NVIDIA die Anleitung zu CUDA unter WSL: Installieren Sie den Windows-Treiber, keinen Linux-Anzeigetreiber innerhalb von WSL. Das CUDA Toolkit wird nur zum Bauen des CUDA-Sonarbackends benötigt.

Aktualisieren Sie WSL in PowerShell:

wsl --update

Speichern Sie vor einem angeforderten Neustart Ihre Arbeit in den WSL-Terminals. Öffnen Sie Ubuntu anschließend erneut.

3. POSIM im Ubuntu-Terminal installieren

Verwenden Sie für Linux-Befehle das Profil Ubuntu in Windows Terminal. Prüfen Sie die Distribution:

cat /etc/os-release

Folgen Sie Ubuntu: native Installation vom Herunterladen der Quellen bis zum Build. Legen Sie den Arbeitsbereich unter ~/posim_ws im Linux-Dateisystem an. Das Installationsskript nutzt sudo und aktualisiert Ubuntu-Pakete.

Sind Bild-Topics sichtbar, aber es kommen keine Bilder an, hilft die Fehlerbehebung. Terminals vorbereiten erklärt die beiden Fenster für weitere Beispiele.

4. Die Demo-Welt starten

Führen Sie diese Befehle im Ubuntu-Terminal aus. Gazebo sollte auf dem Windows-Desktop erscheinen und die Ozeanszene zeigen. Beim ersten Start können Fuel-Modelle heruntergeladen werden. Beenden Sie die Simulation mit Strg+C, bevor Sie ein weiteres Beispiel starten.

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

Starten Sie die Linux-Version von QGC in derselben Ubuntu-Distribution wie POSIM. Verwenden Sie für diese Konfiguration nicht die unter Windows installierte Anwendung. Folgen Sie der QGC-Einrichtung.