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.