POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Primeros pasos

Windows: instalación en WSL

Instala POSIM en Ubuntu 26.04 dentro de Windows Subsystem for Linux 2 (WSL2). WSLg muestra Gazebo en el escritorio de Windows. Para usar una imagen preparada, elige WSL con Docker.

1. Instalar WSL y Ubuntu

Abre PowerShell como administrador:

wsl --install -d Ubuntu-26.04

Reinicia si Windows lo solicita. Abre Ubuntu y crea tu usuario y contraseña de Linux. Comprueba en PowerShell que la distribución usa WSL 2:

wsl --list --verbose

Si ya tienes WSL o falla la instalación, consulta la guía de Microsoft.

2. Preparar el controlador gráfico y WSLg

Instala o actualiza el controlador de Windows de tu GPU Intel, AMD o NVIDIA. También es necesario con NVIDIA. WSLg utiliza ese controlador para la aceleración gráfica; consulta la guía de aplicaciones gráficas.

Con NVIDIA, sigue CUDA en WSL: instala el controlador de Windows, no un controlador de pantalla Linux dentro de WSL. El toolkit CUDA solo es necesario para compilar el backend CUDA del sonar.

Actualiza WSL desde PowerShell:

wsl --update

Guarda el trabajo de los terminales WSL antes de cualquier reinicio solicitado y vuelve a abrir Ubuntu.

3. Instalar POSIM en Ubuntu

Usa el perfil Ubuntu de Windows Terminal para los comandos Linux. Comprueba la distribución:

cat /etc/os-release

Sigue Ubuntu: instalación nativa, desde la descarga del código hasta la compilación. Mantén el espacio de trabajo en ~/posim_ws, dentro de Linux. El instalador usa sudo y actualiza los paquetes de Ubuntu.

Si aparecen tópicos de imagen pero no llegan fotogramas, consulta Resolución de problemas. Preparar los terminales explica las dos ventanas utilizadas en los siguientes ejemplos.

4. Ejecutar el mundo de demostración

Ejecuta lo siguiente en Ubuntu. Gazebo debe abrirse en el escritorio de Windows y mostrar el océano. El primer inicio puede descargar modelos de Fuel. Pulsa Ctrl+C antes de iniciar otro ejemplo.

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

Ejecuta la versión de Linux de QGC en la misma distribución Ubuntu que POSIM. Para esta configuración, no uses la aplicación instalada en Windows. Sigue la configuración de QGC.