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 servizio
/posim/appearance/<session_nonce>/state, i percorsi di renderer e shader e il numero di telecamere attive. - La revisione applicata e lo stato di disponibilità dopo il rendering.
- L'attivazione esplicita delle particelle sospese, disabilitate per impostazione predefinita. L'esempio di attenuazione della telecamera non carica da solo il sistema degli effetti di scena.
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.