WWW-POSIM v0.6.16Documentazione del simulatore
Menu della documentazione
WWW-POSIM / Documentazione del simulatore

GNSS e navigazione

Le sessioni WAM-V e BlueROV2 attivano per impostazione predefinita il ricevitore GNSS satellitare simulato POSIM. BlueROV2 permette di disattivarlo esplicitamente. Contratto del sensore, antenna e topic sono comuni. Stato GNSS e stima FCU restano distinti.

Implementazione

Fase Metodo Parametri e uscita
Cinematica dell’antenna Il plugin Gazebo nativo posim::Gnss osserva il link reale, compresi rotazione e braccio di leva. link_name, pose; posizione geografica e velocità da differenze finite.
Errori Perturbazioni gaussiane indipendenti di posizione e velocità, con seme. horizontal_stddev, vertical_stddev, velocity_stddev, seed; covarianza diagonale.
Disponibilità Controllo d’immersione sulle onde, isteresi, riacquisizione continua e ostruzione esplicita. water_level, wave_topic, dry_margin, reacquire_seconds, enabled; fix, acquisizione, immersione, blocco o indisponibilità.
Tempo Cadenza e coda di misure ritardate in tempo simulato. update_rate, latency; conserva il timestamp originale d’acquisizione.
ROS e FCU Verifica epoca, tempo e valori finiti; pubblica misura/stato e converte le misure accettate in MAVLink GPS_INPUT. Alias del sensore, GPS grezzo FCU e stime fuse restano distinti.
Interfaccia e missione Freschezza ed EKF determinano disponibilità e vincoli della missione. L’indicatore di fusione interpreta stati, senza esporre tutte le innovazioni del filtro.

L’implementazione e i profili del ricevitore definiscono il sensore. WWW-POSIM aggiunge conversione ROS, scelta della sorgente e integrazione delle missioni. Vedi Modelli e parametri dei sensori.

Misure e stime

Uscita Significato
/model/{robot}/gnss/fix NavSatFix del sensore: posizione dell’antenna con rumore configurato.
/model/{robot}/gnss/status Stato e tempo originale di misura; JSON in std_msgs/String.
/vehicle/gnss/fix, /vehicle/gnss/status Alias del veicolo attivo per gli stessi messaggi, non un secondo iniettore GPS.
/mavros/global_position/raw/fix GPS ricevuto da ArduPilot e convertito da MAVROS.
/mavros/global_position/global Posizione fusa della FCU.
/mavros/local_position/pose Posa locale fusa, ENU.
/model/{robot}/odometry Riferimento del simulatore per vista 3D, sicurezza del terreno e verifica; non fornisce le coordinate della mappa

Gazebo genera le misure. L’adattatore converte quelle accettate in GPS_INPUT con ricevitore 0. Il profilo ArduPilot sceglie questo ricevitore MAV, disabilita il secondo e il GPS sintetico SITL, e usa posizione/velocità orizzontale GPS con imbardata da bussola. Posa e velocità di riferimento del simulatore non vengono iniettate come visione nella FCU, anche con GNSS disattivato. Una sola antenna non misura la prua da fermo; la rotta GPS in movimento è distinta dall’orientamento del corpo.

Il profilo GNSS imposta il limite inferiore del rumore di velocità orizzontale EK3_VELNE_M_NSE da receiver.velocity_stddev, vincolato all’intervallo documentato di 0.05–5 m/s (predefinito: 0.1 m/s). L’accuratezza di velocità dichiarata dal ricevitore può aumentare il limite effettivo. Questo configura la ponderazione EKF; il rumore di misura simulato resta invariato.

L’IMU Gazebo di WAM-V invia accelerazione e velocità angolare tramite l’interfaccia JSON ArduPilot. La bussola usa il campo magnetico SITL. È una dipendenza idealizzata della simulazione, non una prua statica derivata da GNSS.

Gli obiettivi usano l’origine geografica EKF della FCU; l’arrivo viene deciso con la posizione stimata. Lo stato del simulatore serve a valutare le traiettorie e controllare il terreno, senza eliminare per allineamento l’errore orizzontale GNSS. Un fix recente non garantisce un filtro sano: l’interfaccia separa validità EKF e fusione. L’indicatore combina sorgente configurata, stato recente e flag EKF; non è un registro delle innovazioni per osservazione.

Per le missioni con GNSS configurato, dopo l’armamento, la missione richiede 2 secondi reali continui di posa locale recente e fusione osservata da GNSS o navigazione esterna accettata prima di GUIDED. La perdita riavvia l’intervallo; senza stabilizzazione entro 35 secondi, la missione si ferma. La riacquisizione usa un timer separato in tempo simulato.

Le aree web e installate richiedono stato EKF, sistema e heartbeat FCU a 5 Hz simulati. Scartano stati più vecchi di 3 s reali. Con un fix validato dall’orologio, l’adattatore ripete lo stato ogni 0,2 s reali, conservando il timestamp originale. Ogni nuovo ingresso GPS e fix deriva da una nuova acquisizione accettata. Orologio fermo o misura obsoleta invalidano il ricevitore.

Configurazione e riferimenti

posim_gz_gnss/config/profiles.json definisce ricevitore e montaggio. Il SDF contiene base_link → gnss_link → gnss e il publisher delle pose espone la gerarchia reale tramite TF. L’antenna WAM-V è 1,8 m sopra base_link; quella BlueROV2, 0,3 m. Il link aggiunge 0,001 kg.

Lo stato di riferimento usa map e i link del modello. La stima usa fcu_map e TF map → fcu_map → fcu_base_link. La prima trasformazione proietta l’origine geografica EKF nel datum del terreno, senza adattamento allo stato reale. La traslazione verticale è assunta nulla: approssimazione dello zero barometrico locale, non quota da rilievo. Il TF di montaggio appartiene alla gerarchia di riferimento; un’elaborazione di rilievo deve applicare gli stessi estrinseci alla posa stimata e mantenere i tempi.

Grandezza Valore predefinito
Coordinate Latitudine/longitudine WGS 84 in gradi; datum definito dalle coordinate sferiche del mondo.
Riferimento locale ENU: est, nord, alto; orientamento del mondo 0°.
Riferimento del corpo FLU; offset dell’antenna convertito in FRD: x, −y, −z.
Velocità Spostamento dell’antenna tra misure, ruotato in ENU; GPS_INPUT usa nord, est, basso.
Braccio di leva Applicato geometricamente prima della misura e fornito ad ArduPilot come lo stesso offset corporeo.
Deviazione della posizione Est/nord: 0,7 m ciascuno; verticale: 1,2 m.
Deviazione della velocità 0,1 m/s per asse.
Covarianza Diagonale ENU nota: 0,49; 0,49; 1,44 m².
Frequenza / latenza 5 Hz / 0,2 s simulati.
Validità Scarta duplicati, tempi invertiti, valori non finiti, futuro e misure oltre 0,6 s; watchdog di 0,8 s reali sull’avanzamento dell’orologio.
Tempo Acquisizione mantenuta durante il ritardo; settimana GPS deterministica 2296 più tempo simulato.
Qualità nominale 12 satelliti, HDOP 1,0, VDOP 1,5; nessun calcolo della costellazione.
Casualità Seme 42; errori gaussiani indipendenti di posizione e velocità.

Il mondo predefinito usa quota marina 0 m e separazione geoidica sintetica nulla. Sotto questa ipotesi, quota del sensore e quota MSL di GPS_INPUT coincidono. MAVROS applica la propria conversione EGM96 per riportare la quota ellissoidica, che può differire dal topic del sensore. La geodesia verticale assoluta non è qualificata per rilievi. La profondità resta riferita all’acqua locale. Una catena GNSS+IMU+profondità per multibeam deve preservare riferimenti, tempi e datum verticale.

Immersione, perdita e recupero

Il ricevitore confronta l’altezza mondiale dell’antenna, rotazione compresa, con la superficie locale. I mondi dell’app usano il campo locale del solutore fisico delle onde con interpolazione bilineare. Un campione di superficie più vecchio di 0,6 s simulati rende il sensore indisponibile. I modelli POSIM indipendenti usano il piano medio configurato, salvo ricevere un topic d’onda.

L’app inoltra celle d’onda misurate con i timestamp originali, vecchie di 0,2–0,5 secondi simulati. Le celle mancanti restano non valide; il ricevitore richiede valori locali finiti e verifica l’immersione dell’antenna.

Alla superficie o sotto di essa, il fix diventa subito invalido e la coda ritardata si svuota. L’acquisizione inizia sopra un margine asciutto di 0,05 m e richiede 3 s simulati continui. Un fix già acquisito resta valido entro il margine fino alla soglia bagnata. L’isteresi evita commutazioni rapide con le onde.

Senza fix, le coordinate sono NaN. L’adattatore invia un GPS_INPUT esplicitamente invalido, senza assegnare un nuovo tempo a coordinate vecchie. Un reset svuota la coda, azzera l’acquisizione, avanza l’epoca e riavvia la verifica dell’orologio.

La perdita del fix sott’acqua permette di mantenere controllo manuale di assetto, profondità e spinta per risalire. Le missioni assolute richiedono una stima FCU recente e valida basata sui sensori. WAM-V richiede un fix recente o fonte esterna qualificata e accettata, oltre agli altri controlli di armamento.

Il booleano Gazebo /model/{robot}/gnss/blocked impone un’ostruzione. Il vento non spegne direttamente GNSS: può spostare e inclinare il veicolo o generare onde che immergono l’antenna. Geometria satellitare, edifici, multipercorso, atmosfera, interferenze RF e diagrammi d’antenna non sono simulati fisicamente. Rumore gaussiano, blocco e immersione sono modelli semplificati, non prestazioni RF misurate.

Equipaggiamento BlueROV2

Il ricevitore selezionabile è un carico simulato; non afferma che il BlueROV2 di serie monti GNSS satellitare o che esista quel kit del produttore.

L’integrazione Water Linked combina riferimento geografico in superficie e posizionamento acustico subacqueo. È documentato anche DVL con UGPS. Sono dispositivi e misure distinti; questo ricevitore satellitare non implementa UGPS acustico.

GPS.gov spiega i fattori che influenzano l’accuratezza reale. Le deviazioni simulate sono impostazioni, non una garanzia del servizio GPS. I siti sono riferimenti; il ricevitore non include immagini di prodotto, manuali o codice dei fornitori.

Posizione della mappa basata sui sensori

Ground Control usa una misura GNSS recente o una stima esterna valida accettata dal gateway FCU, senza sostituirla con coordinate del simulatore. GPS fixed è verde, GPS lost rosso; sconosciuto, scaduto e invalido restano distinti. Fix e disponibilità di navigazione sono indipendenti.

Con GPS fixed appare solo l’indicatore GPS. Con GPS lost e una stima recente e validata appare anche Stima posizione ON. Se una stima subacquea è necessaria ma non disponibile, appare Stima non disponibile. Il pulsante info accanto a ON apre il metodo e un collegamento alla documentazione con clic, tocco o tastiera; Escape chiude l’aiuto. Le coordinate numeriche sono nascoste. Aprire Dettagli navigazione sotto la mappa per supporto, riferimento iniziale e inizializzazione dei sensori.

Lo stimatore IMU/DVL usa velocità angolare, forza specifica e velocità valida rispetto al fondo, mantenendo tempi, montaggi e covarianza. Non usa l’orientamento Gazebo. La sola odometria locale non determina posizione geografica né prua.

La BlueROV2 · KMOU usa una coordinata iniziale dichiarata nello scenario e prua misurata dal magnetometro con declinazione configurata. Il riferimento è distinto da GPS. Un supporto temporaneo trattiene il veicolo durante preparazione delle camere e inizializzazione stazionaria. Dopo normale armamento ALT_HOLD e accettazione della navigazione, si rilascia il supporto e si conferma la rimozione effettiva del giunto. Il riferimento non viene continuamente aggiornato con la verità del simulatore.

Il profilo è limitato a questa demo integrata, senza attivazione automatica per veicoli salvati o mondi arbitrari. L’allineamento generale da movimento GNSS non è qualificato per uscita geografica. La diagnostica locale mantiene navigation_ready=false; il gateway verifica separatamente dati recenti, origine/covarianza valide, conferma della fonte e telemetria EKF/globale FCU.

Perdita DVL, dati scaduti, reset o nuovo segmento invalidano la stima. La mappa rimuove le coordinate stimate e mostra il problema. Il ritorno DVL non riutilizza l’ancora iniziale: riavviare la simulazione. Un nuovo fix in superficie può restituire posizione GNSS senza reinizializzare lo stimatore subacqueo.

ArduPilot, QGC e fornitori sostituibili

GNSS alimenta GPS_INPUT e fonte EKF 1. Posizione/velocità esterne accettate usano MAVROS vision pose/speed e fonte 2. WAM-V con GNSS predefinito non attiva ingressi di odometria visiva inutilizzati. Un fornitore esterno selezionato esplicitamente abilita lo stesso percorso controllato per entrambi i veicoli.

QGC riceve validità GPS con GPS_RAW_INT e posizione fusa con GLOBAL_POSITION_INT. Può indicare assenza di fix con una stima FCU valida. La stima non cambia il fix. La Controllare con QGC richiede disarmo per trasferire il controllo; la spinta idrostatica può far risalire il veicolo.

Le estensioni dell’app installata selezionano fornitori ROS approvati, vincolati agli hash e dichiarati in SDF. /vehicle/navigation/estimate trasporta posa ENU e velocità corpo FLU in nav_msgs/Odometry; /vehicle/navigation/status contiene sessione, tempo, origine, metadati di disponibilità e fonte corrispondenti. Il gateway rifiuta dati scaduti, discordanti e pubblicatori duplicati. Il ricevitore conserva l’autorità GNSS. Vedere Controlla un’area di lavoro locale. Caricare un fornitore non qualifica precisione geografica o disponibilità della missione.

Cerca nella documentazione