Robot di superficie e onde
Simula un WAM-V con le onde di Wave Sim e ArduRover in modalità imbarcazione. L'installatore POSIM e le ricette Docker compilano le librerie esterne per le onde.
Tutorial standard
L’installazione standard include un percorso tra boe con WAM-V, telecamera, lidar e vista RViz preconfigurata. Non richiede l’immagine opzionale descritta sotto. Nel terminale POSIM preparato, esegui:
ros2 launch posim_demos surface_tutorial.launch.py
Segui Prima simulazione per la scena, la vista lidar, il video e i controlli di QGroundControl.
Preparare il WAM-V
Questa immagine opzionale usa la struttura desktop ARM64. Su un Mac Apple Silicon, prepara Docker e RDP, poi esegui i comandi nel Terminale macOS da una copia del repository POSIM:
docker pull ioeslab/posim:latest
docker build -f extras/surface/Dockerfile \
--build-arg POSIM_BASE_IMAGE=ioeslab/posim:latest -t posim:surface .
docker run -d --name posim-surface --shm-size=1g \
-p 127.0.0.1:3390:3389 posim:surface
Collega il client RDP a 127.0.0.1:3390 con l'account docker. Apri un terminale nel desktop Linux:
source /opt/ros/lyrical/setup.bash
source /home/docker/posim_ws/install/setup.bash
ros2 launch /opt/posim-surface/wamv.launch.py headless:=false
L'immagine contiene eseguibili separati di ArduSub e ArduRover. L'esempio seleziona ArduRover con FRAME_CLASS=2. Esegui una sola istanza per ambiente: nome del veicolo, file generati e porte del controllore sono fissi. Più veicoli richiedono file, nomi, identificativi e porte distinti, oppure ambienti isolati.
Il controllore attende la creazione del veicolo e i dati della sua IMU. Se la creazione fallisce o supera 180 s, oppure non arriva una misura IMU nei successivi 180 s, l'avvio termina con errore indicando la fase. Controlla i messaggi Gazebo e del sensore prima di riprovare.
Modello, controllo e navigazione
extras/surface/wamv.py prepara il modello esterno. Le eliche di poppa usano le uscite 1 e 3; il veicolo parte in superficie.
L'adattatore di navigazione esterna invia a MAVROS posa e velocità simulate da Gazebo. Verifica stato del controllore, validità della navigazione e direzione della spinta prima di inviare una missione.
Per studiare rumore, contatto con l'acqua e riacquisizione del ricevitore, integra il GNSS marino, l'antenna e un adattatore di navigazione adatto. L'adattatore di posa esterna di questo esempio è un ingresso distinto.
Regolare le onde
I comandi usano gz.msgs.Param su /world/<world_name>/waves. Il nome deriva da <world name="…">. Elenca i topic attivi:
gz topic -l
Il file di avvio WAM-V usa normalmente posim_surface, quindi /world/posim_surface/waves. Nel contenitore preparato puoi cambiare nome:
SURFACE_WORLD=harbour
ros2 launch /opt/posim-surface/wamv.launch.py headless:=false world_name:="$SURFACE_WORLD"
Il topic diventa /world/harbour/waves; l'IMU ROS resta su /model/wamv/imu. world_name assegna il nome al mondo generato: non seleziona un terreno né isola una seconda istanza.
Il fondale è piano, a z = −10 m. Per modificarlo, consulta Terreni da mappe di elevazione.
Parametro (double) |
Unità | Funzione |
|---|---|---|
wind_speed |
m/s | Velocità del vento nel modello delle onde |
wind_angle |
gradi | Direzione del vento |
steepness |
adimensionale | Ripidità delle onde |
Mantieni coerenti le impostazioni visive e idrodinamiche. Le correnti si configurano separatamente. Il mondo deve includere e configurare i sistemi delle onde, oltre ad avere le librerie installate.
Limiti e dipendenze
Il Dockerfile opzionale supporta la struttura ARM64. Calibra scafo, propulsione e resistenza per l'imbarcazione e le condizioni d'uso. Alla chiusura, MAVROS o Gazebo possono richiedere la terminazione da parte del supervisore; verifica che entrambi siano usciti prima di riavviare.
extras/surface/dependency.json fissa la revisione esterna. L'installatore compila in /opt/waves e conserva i sorgenti in /opt/asv_wave_sim: è una dipendenza di compilazione, non un sottomodulo Git. Vedi la guida all'integrazione e le licenze.