Ubuntu: installazione nativa
Compila POSIM su Ubuntu 26.04. Apri l’applicazione Terminale ed esegui un blocco alla volta, aspettando che ogni passaggio termini. Per usare un’immagine pronta, segui Linux con Docker.
1. Scaricare i sorgenti
mkdir -p ~/posim_ws/src
git clone https://github.com/IOES-Lab/POSIM.git ~/posim_ws/src/posim
cd ~/posim_ws
Mantieni il nome della directory posim: viene usato dal manifesto dei repository.
2. Installare lo stack software
Leggi prima src/posim/extras/ros-lyrical-gz-jetty-install.sh. Lo script configura repository, usa sudo ed esegue apt-get full-upgrade -y. È consigliato un ambiente Ubuntu dedicato.
POSIM_EXTRAS_DIR="$PWD/src/posim/extras" \
bash src/posim/extras/ros-lyrical-gz-jetty-install.sh
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
Installa ROS 2 Lyrical, Gazebo Jetty, ArduSub, ArduRover, MAVROS e le librerie delle onde. Wave Sim viene scaricato a una revisione fissata e compilato come dipendenza esterna; non serve clonare POSIM in modo ricorsivo.
3. Risolvere le dipendenze del workspace
vcs import src --skip-existing \
--input src/posim/extras/repos/posim.lyrical.repos
rosdep update --rosdistro lyrical
rosdep install --rosdistro lyrical --from-paths src --ignore-src -r -y
--skip-existing conserva il repository POSIM già clonato. Controlla ogni errore di dipendenza prima della compilazione.
Il manifesto importa anche una revisione fissata di ros_gz con correzioni al ciclo di vita del bridge e all’avvio POSIX. Se src/ros_gz esiste già, rimane invariato: confronta origine e revisione con il manifesto oppure usa un workspace nuovo.
4. Compilare e caricare l’ambiente
colcon build --merge-install --executor sequential --symlink-install
source install/setup.bash
ros2 pkg prefix posim_demos
ros2 pkg prefix ros_gz_bridge
ros2 pkg prefix ros_gz_sim
Entrambi i percorsi ros_gz devono appartenere alla directory install/ del workspace. Se compare /opt/ros/lyrical, viene ancora selezionato il pacchetto di sistema. Carica ROS e il workspace in ogni nuovo terminale, come spiegato in Preparare i terminali.
Se la memoria non basta
--executor sequential esegue un pacchetto alla volta, ma non limita i processi del compilatore. Per limitare entrambi:
MAKEFLAGS="-j1" CMAKE_BUILD_PARALLEL_LEVEL=1 colcon build --merge-install --executor sequential --symlink-install
Aggiornare il workspace
Salva prima le tue modifiche in un commit Git. Annota la revisione, scarica gli aggiornamenti, poi ripeti la risoluzione delle dipendenze e la compilazione:
git -C ~/posim_ws/src/posim rev-parse HEAD
git -C ~/posim_ws/src/posim pull --ff-only
Prosegui con la prima simulazione. Per il sonar, consulta compilazione e configurazione CPU/WGPU/CUDA.
5. Avviare il mondo dimostrativo
L’ultima verifica apre Gazebo con la scena oceanica. Al primo avvio può essere necessario scaricare modelli Fuel. Ferma la simulazione con Ctrl+C prima di passare alla preparazione dei terminali.
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