POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Per iniziare

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.