Windows: installazione in WSL
Installa POSIM in Ubuntu 26.04 tramite Windows Subsystem for Linux 2 (WSL2). WSLg mostra Gazebo sul desktop di Windows. Per usare un’immagine già pronta, scegli WSL con Docker.
1. Installare WSL e Ubuntu
Apri PowerShell come amministratore:
wsl --install -d Ubuntu-26.04
Riavvia Windows se richiesto. Apri Ubuntu e crea il tuo account Linux. Da PowerShell verifica che la distribuzione utilizzi WSL 2:
wsl --list --verbose
Se WSL è già installato o la procedura non riesce, consulta la guida Microsoft.
2. Preparare il driver grafico e WSLg
Installa o aggiorna il driver Windows della GPU Intel, AMD o NVIDIA. Il passaggio serve anche con NVIDIA. WSLg usa questo driver per l’accelerazione grafica; segui la guida alle applicazioni grafiche.
Con NVIDIA, segui CUDA su WSL: installa il driver Windows, non un driver video Linux dentro WSL. Il toolkit CUDA serve solo per compilare il backend CUDA del sonar.
Aggiorna WSL da PowerShell:
wsl --update
Salva il lavoro nei terminali WSL prima di un eventuale riavvio richiesto, quindi riapri Ubuntu.
3. Installare POSIM nel terminale Ubuntu
Usa il profilo Ubuntu di Windows Terminal per i comandi Linux. Verifica la distribuzione:
cat /etc/os-release
Segui Ubuntu: installazione nativa, dal download dei sorgenti alla compilazione. Crea il workspace in ~/posim_ws, nel filesystem Linux. Il programma d’installazione usa sudo e aggiorna i pacchetti Ubuntu.
Se i topic delle immagini sono visibili ma i fotogrammi non arrivano, consulta la risoluzione dei problemi. Preparare i terminali spiega le due finestre degli esempi successivi.
4. Avviare il mondo dimostrativo
Esegui questi comandi nel terminale Ubuntu. Gazebo dovrebbe aprirsi sul desktop di Windows e mostrare la scena oceanica. Il primo avvio può scaricare modelli da Fuel. Ferma la simulazione con Ctrl+C prima di avviare un altro esempio.
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
Esegui la versione Linux di QGC nella stessa distribuzione Ubuntu di POSIM. Per questa configurazione, non usare l’applicazione installata su Windows. Segui la configurazione di QGC.