POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Riferimenti e progetto

Risoluzione dei problemi

Parti dal primo errore nel log di avvio. Controlla nell'ordine ambiente, risorse del modello, tempo di simulazione, plugin e ricezione dei dati. Conserva l'errore e le righe vicine utili a riprodurlo.

Un pacchetto non viene trovato

printf 'ROS_DISTRO=%s\n' "$ROS_DISTRO"
ros2 pkg prefix posim_demos

Il risultato deve mostrare lyrical e il percorso del workspace scelto. Prepara il terminale secondo il tuo metodo di installazione e distingui i percorsi dell'host da quelli del container.

Mancano modelli o mesh

Individua il primo URI non risolto. Verifica che le risorse del pacchetto siano installate e che l'ambiente corretto sia stato caricato. Gazebo deve poter accedere alla rete per scaricare risorse Fuel. Il primo download può richiedere tempo: controllane l'avanzamento prima di avviare un'altra simulazione.

Non compare un'immagine o il rendering non parte

Verifica driver grafici e collegamento dello schermo nella guida di installazione. Gazebo e le telecamere richiedono un renderer funzionante. Per il sonar, controlla il backend scelto e i pacchetti installati.

Per gli effetti della scena subacquea, verifica:

Il GNSS non fornisce una posizione valida

Controlla lo stato di validità GNSS, la quota dell'antenna nel mondo, il livello locale dell'acqua e il timestamp di acquisizione. Verifica le coordinate sferiche del mondo, che l'antenna sia emersa e libera da ostacoli, e che trascorra abbastanza tempo di simulazione per riacquisizione e latenza.

Se è configurato un topic delle onde, deve fornire campioni locali compatibili e recenti. Installare il ricevitore non lo aggiunge al modello né fornisce un adattatore ROS o per l'autopilota.

Non arrivano messaggi

Verifica prima che il tempo avanzi, poi cerca il topic e il tipo:

gz topic -l
ros2 topic list -t
ros2 topic info /underwater_camera/simulated_image --verbose

Usa il trasporto corretto e lo stesso ambiente preparato. Controlla QoS, dominio ed errori di bridge e plugin. Per avviare un sensore, namespace deve indicare un descrittore esistente. L'USBL è già incluso nel mondo del tutorial e si avvia insieme al mondo.

I topic delle immagini compaiono, ma i fotogrammi non arrivano

Se Gazebo genera immagini e ROS trova il publisher, ma arrivano pochi fotogrammi o nessuno, controlla il trasporto DDS. I datagrammi UDP grandi di Cyclone DDS possono incontrare limiti di frammentazione IP. Ridurne le dimensioni può aiutare su reti con MTU di 1500 byte. Consulta le impostazioni di frammentazione di Cyclone DDS.

Preparare il profilo

Con rmw_cyclonedds_cpp installato, crea questo profilo una sola volta. Se usi già un profilo Cyclone DDS, aggiungi le due dimensioni alla sua sezione General, conservando le impostazioni di discovery e delle interfacce.

mkdir -p "$HOME/.config/posim"
cat > "$HOME/.config/posim/cyclonedds-images.xml" <<'XML'
<CycloneDDS xmlns="https://cdds.io/config">
  <Domain Id="any">
    <General>
      <MaxMessageSize>1400B</MaxMessageSize>
      <FragmentSize>1280B</FragmentSize>
    </General>
  </Domain>
</CycloneDDS>
XML

Riavviare con la stessa configurazione

Ferma simulazione e visualizzatori. Carica l'ambiente POSIM e seleziona il profilo in ogni terminale prima di riavviarli. Se hai modificato un profilo esistente, usa il suo percorso.

export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export CYCLONEDDS_URI="file://$HOME/.config/posim/cyclonedds-images.xml"

Se il processo in background della CLI ROS è già attivo in quel dominio, fermalo una volta per applicare la nuova configurazione alle successive chiamate:

ros2 daemon stop

Ripeti i controlli delle immagini e della frequenza, verificando anche i timestamp di acquisizione. I pacchetti piccoli aumentano il sovraccarico; reti con MTU inferiore richiedono dimensioni ancora più piccole.

Il veicolo non si muove

Controlla stato del controllore, armamento, validità della navigazione, ricezione dei comandi e modalità selezionata. Verifica nomi dei giunti e assi dei propulsori. Mantieni una sola sorgente di comandi attiva. Un comando neutro, il mondo in pausa o l'autopilota disarmato possono spiegare l'immobilità.

La simulazione non termina

Ferma i visualizzatori, premi Ctrl+C una volta nel terminale di avvio e attendi la chiusura dei processi. Conserva i messaggi pertinenti di arresto anomalo, errore di segmentazione o terminazione forzata. Nella segnalazione, indica comando, revisione, sistema operativo, architettura e renderer.

RViz si arresta dopo Discard

Il programma di installazione POSIM per Ubuntu/WSL e le immagini Docker AMD64/ARM64 includono un overlay RViz isolato per RViz 15.2.6. Arresta il timer di aggiornamento dopo la conferma della chiusura e libera le risorse ROS delle viste durante l'uscita. Scegliendo Cancel, gli aggiornamenti continuano. I pacchetti RViz di sistema restano invariati. Dopo aver caricato l'ambiente POSIM, ros2 pkg prefix rviz_common dovrebbe mostrare /opt/posim/rviz-close/install. Per le installazioni precedenti, segui le istruzioni di compilazione e attivazione al link.

Senza l'overlay, RViz 15.2.6 su Ubuntu 26.04 può arrestarsi in modo intermittente quando chiudi la finestra e scegli Discard, anche se le viste dei sensori funzionano. L'overlay corregge problemi specifici del timer e del rilascio delle risorse, ma non copre tutti i renderer o tutti i percorsi di chiusura. Se il problema persiste, indica la versione di RViz, i percorsi delle librerie caricate e l'azione di chiusura nella segnalazione.

Se RViz resta in esecuzione dopo la chiusura della finestra, può consumare troppa memoria, soprattutto con il rendering software. Prima di riavviare la simulazione, premi Ctrl+C nel terminale di avvio per arrestare i processi rimasti. Se RViz non si arresta normalmente, ROS launch ne forza la terminazione. Per eseguire il sonar senza il visualizzatore, aggiungi rviz:=false al comando multibeam_sonar_demo.launch.py. Le immagini restano disponibili in ROS.

Ricreare telecamere di profondità con un SDK macOS nativo

Per macOS arm64 / Ogre-Next 2.3.3, l'ambiente Ogre isolato fornisce la correzione del ciclo di vita dei materiali durante la distruzione e la ricreazione delle telecamere di profondità.

Rispetta le versioni di SDK e sorgenti previste, usa lo strumento di compilazione e passa il comando Gazebo a run_overlay.py. Compilare non seleziona automaticamente la libreria. Verifica i percorsi effettivamente caricati e conserva il risultato della validazione. L'installazione standard non attiva questo ambiente; non sostituisce librerie di sistema e non configura container Linux. Altre versioni o piattaforme richiedono un profilo compatibile dedicato.

Preparare una segnalazione riproducibile

Includi SHA del codice o digest dell'immagine, versioni delle dipendenze, comando e argomenti, primo errore, risultato atteso, tipi dei topic interessati e un esempio minimo. Distingui un topic semplicemente trovato da uno che trasmette davvero dati.

MAVROS 2.16.0 termina con SIGSEGV

Il programma di installazione di POSIM e le build Docker ufficiali includono la correzione del ciclo di vita del Router per MAVROS 2.16.0. Dopo aver caricato l'ambiente POSIM, ros2 pkg prefix mavros deve mostrare /opt/posim/mavros-router/install. Per un'installazione esistente, segui le istruzioni per la compilazione separata disponibili al link. Se il crash persiste, allega alla segnalazione il log di MAVROS e i percorsi delle librerie effettivamente caricate.

QGC è aperto su Windows, ma POSIM viene eseguito in WSL

Chiudi l’applicazione Windows e avvia la versione Linux di QGC nella stessa distribuzione Ubuntu di POSIM o nel contenitore POSIM. Una finestra WSLg appare sul desktop di Windows, ma resta un processo Linux. La configurazione di QGC mantiene telemetria e video all’interno di quell’ambiente.