Conosci l’area di lavoro
Inizia con un terreno già pronto e impara a leggere pannelli e strumenti prima di inviare comandi al veicolo.
Accedere e avviare il primo mondo
- Registrati su WWW-POSIM, verifica l’email e accedi. Se il messaggio manca, controlla la posta indesiderata o richiedine un altro. La verifica serve anche nell’app installata.
- Nell’app scegli Avvia simulatore. Sul sito apri l’area personale; potrebbe esserci una coda per il server.
- Apri Area di lavoro, scegli Terreno pregenerato, poi KMOU waterfront · 1 × 1 km.
- In Terreno regionale → Veicolo, seleziona WAM-V, profondità 0 m e Autopilot.
- Seleziona Avvia mondo generato e attendi il veicolo e dati di posizione recenti. La finestra iniziale dell’app resta aperta finché il mondo non è in esecuzione.

| Voce | Funzione |
|---|---|
| Mondi dimostrativi | Avvia WAM-V o BlueROV2; le altre anteprime indicano la disponibilità. |
| Terreno pregenerato | Riunisce terreni pronti, scaricabili e già generati. |
| Area di esercitazione | Prepara l’esercizio quando disponibile. |
| Mondo personalizzato | Apre terreno regionale, editor dei veicoli, strumenti RViz e archiviazione. |
| Posizione → Veicolo → Riepilogo | Seleziona terreno, veicolo e posa iniziale; verifica le impostazioni prima dell’avvio. |
Scegli Autopilot o ROS 2 diretto prima di avviare. Per cambiare tipo di controllo, avvia un mondo con l’altra opzione. Il cambio di modalità ArduPilot è un’operazione distinta. Rispetta i limiti di coordinate e profondità. Il seme dell’esercitazione accetta interi da 0 a 1 000 000; vuoto genera una disposizione automatica. Esplorazione libera ed esecuzioni di riferimento dell’amministratore ignorano questo seme.
L’app Mac scarica un terreno pronto alla prima selezione, mostrando l’avanzamento. Poi resta disponibile offline con la revisione del contenuto fissata. Se il download fallisce, controlla la connessione e selezionalo di nuovo. La demo WAM-V usa Hong Kong: una boa corallo è 16 m avanti e 5 m a sinistra, una verde lime 30 m avanti e 8 m a destra. Osservale con camera frontale e LiDAR.
Orientarsi nell’interfaccia

| Zona | Contenuto |
|---|---|
| Barra superiore | Veicolo, terreno, stato in diretta, area di lavoro, lingua e pulsanti per ingrandire la scena o nascondere i pannelli. La sessione compare quando si contabilizza il tempo d’uso. |
| Centro | Viste del veicolo, del mondo e della mappa. |
| Sinistra | Ambiente e visualizzazione in Scena; misure in Sensori e topic ROS. |
| Destra | Controlli ArduPilot o ROS 2, seguiti dagli strumenti e dai grafici del veicolo. |
| Mappa inferiore | Posizione geografica, waypoint e comandi di missione in Controllo missione. |
Espandi le intestazioni o i pulsanti + / −. Il contenuto scorre nello spazio disponibile; un’altra sezione può ridursi per lasciare posto. Pannelli nasconde o mostra i pannelli. Vista scena ingrandisce la scena mantenendo accessibile la mappa. La simulazione continua. La schermata iniziale offre anche il ritorno alla pagina principale e la disconnessione.
| Vista o azione | Effetto |
|---|---|
| Veicolo | Segue il veicolo; permette di orbitare e usare lo zoom. |
| Mondo | Panoramica obliqua dell’area vicina, con limiti di zoom e orbita. |
| Mappa | Mappa orientata a nord con posizione simulata; trascina per spostarla. |
| Trascinamento, tasto destro, rotellina | Spostamento, orbita o zoom secondo i suggerimenti della vista. |
| Cancella traccia | Rimuove dalla vista rotta prevista e traccia percorsa. La registrazione riparte dalla posizione corrente e il rapporto di missione resta disponibile. |
La bussola inferiore segue la camera di osservazione, non la prua del veicolo. La freccia fissa indica la direzione della camera e le lettere ruotano per individuare il nord. Il tempo visualizzato è quello simulato. 1,00× indica un avanzamento pari al tempo reale.
La rotta prevista è gialla, la traiettoria misurata verde acqua. Restano visibili al massimo 1 024 segmenti. Una nuova missione guidata cancella la traccia Gazebo. Le linee di scena larghe 5 mm non appaiono nelle immagini dei sensori.
Scena, onde e corrente

| Sezione | Uso |
|---|---|
| Onde | Scegli uno stato del mare da 0 a 4 e applica. Le impostazioni avanzate consentono di modificare vento, direzione e ripidità. |
| Corrente marina | Attiva la corrente, scegli flusso uniforme o profilo di profondità e seleziona Applica corrente. Attendi la conferma del solutore. |
| Traffico marittimo | Mostra navi da rapporti AIS recenti; dipende da copertura e velocità della simulazione. |
| Rendering della scena | Sceglie Browser o Gazebo, quando disponibili, e apre gli effetti subacquei. |
| Visualizzazione | Fondale, superficie, griglia e assi; illuminazione e opacità dell’acqua o della mappa quando supportate. |
| Prestazioni grafiche | Statistiche misurate del rendering nel browser. |
Le aree libere iniziano con stato del mare 2. Le preimpostazioni usano venti di 0, 1, 3, 6 e 8 m/s e ripidità 1: sono approssimazioni, non altezze d’onda garantite. Il pulsante informativo mostra gli intervalli WMO. Gli esercizi mantengono le condizioni assegnate.
Ferma la missione o il controllo ROS prima di cambiare corrente. Il profilo parte da 0 m di profondità, accetta fino a otto nodi e velocità di 0–1 m/s. Trascina i nodi orizzontalmente per cambiare velocità; la tabella modifica profondità e direzione. 0° indica est, 90° nord, nel verso del flusso. I vettori vengono interpolati linearmente alla profondità reale di ogni link a ogni passo fisico. Sotto l’ultimo nodo resta valida la sua corrente. Il flusso modifica la resistenza relativa all’acqua; le onde mantengono il proprio modello.
L’app installata apre Gazebo per impostazione predefinita. Browser riduce il carico della camera di scena Gazebo; fisica, camere e LiDAR GPU restano calcolati in Gazebo. La selezione vale per la vista aperta. La camera di inseguimento BlueROV2 smorza il movimento e mostra la superficie. Il trascinamento verticale nelle viste compatibili permette di osservare dal basso.
Aspetto subacqueo
Apri Scena → Rendering della scena → Aspetto subacqueo. Le modifiche si applicano alla scena Gazebo e alle immagini a colori delle camere, compreso RGBD. Misure di profondità e geometria di collisione conservano i propri valori.
- Texture della sabbia, foschia, assorbimento dei colori, attenuazione solare e motivi luminosi sul fondale: inizialmente attivi.
- Griglia, curve di livello e particelle: inizialmente disattivati; spaziature predefinite di 10 m per la griglia e 5 m per le curve.
- La demo BlueROV2 KMOU si avvia con le particelle sospese attivate e l’attenuazione solare in base alla profondità disattivata. Le impostazioni salvate nell’applicazione installata hanno priorità su questi valori predefiniti della demo.
- L’ottica dell’acqua raggruppa gli effetti ottici; texture e linee restano indipendenti.
- L’app installata salva le impostazioni confermate. Le sessioni sul server iniziano con i valori predefiniti. Le modifiche sono bloccate durante una valutazione.
Gazebo mostra tutti gli effetti; Browser condivide i dettagli della sabbia e le linee del fondale. Il modello visivo usa un livello medio del mare piano e superfici PBR. Materiali non illuminati e shader personalizzati dell’acqua hanno una propria resa. Particelle e motivi di luce sono approssimazioni visive. Foschia, attenuazione e occlusione limitano la visibilità utile oltre al ritaglio geometrico. Consulta Specifiche tecniche e Dinamica marina e rendering.
Sensori e topic ROS

In Sensori, seleziona il veicolo e poi una camera, LiDAR o IMU. La lista dipende dal modello. La camera d’ispezione rivolta verso il basso serve a osservare il fondale.
| Controllo | Azione |
|---|---|
| Avvia/interrompi flusso | Controlla la ricezione dell’immagine; la simulazione continua. |
| Ingrandisci / Salva immagine | Ingrandisce l’immagine o salva il fotogramma ricevuto. |
| Frequenza del sensore | Richiede una frequenza di consegna; l’indicatore misurato mostra la ricezione effettiva. |
| Zoom digitale / Ripristina | Ingrandisce l’immagine ricevuta o ripristina la scala. |
| Topic ROS → ricerca → topic | Apre il messaggio; la sottoscrizione controlla la ricezione. |
| Campo / Grafico / Dati grezzi / Disegna | Mostra campi numerici o messaggi spaziali compatibili in base al tipo e al riferimento. |
La camera di scena è un osservatore esterno. Quella del sensore segue la propria posa sul veicolo. Possono guardare in direzioni diverse.
Stati del flusso
Connessione o In attesa indica che il sensore o il trasporto si sta preparando. Controlla l’ora di ricezione. Un’immagine conservata e segnalata come obsoleta o in riconnessione non è una misura recente. Verifica prima che il mondo sia pronto e il sensore corretto.
La demo pubblica di Hong Kong usa video H.264 condiviso con un buffer iniziale. Le camere personali richiedono immagini JPEG; le immagini ROS compresse seguono un percorso separato. Salvare un fotogramma acquisisce il video visualizzato nella demo e il file immagine ricevuto nell’area personale. Frequenza del sensore, FPS video e fattore di tempo reale sono misure diverse. Consulta Simulazione, rendering e sensori e Visualizzazione con RViz e Foxglove.
ArduPilot e controllo manuale


Controlla telemetria, armamento e modalità indicata nell’intestazione. Centra gli ingressi manuali e termina o annulla la missione prima di cambiare modalità. Scegli Modalità di volo, applica e verifica il valore ricevuto: il menu esprime una richiesta.
Arma abilita la propulsione dopo le verifiche preliminari. Disarma la disabilita e annulla la missione. Scegliere una modalità non arma il veicolo. In caso di rifiuto, leggi errore e dettagli di connessione; un’immagine della camera non basta a confermare che il controllo sia pronto.
| Veicolo | Modalità del menu |
|---|---|
| WAM-V · ArduRover | MANUAL: acceleratore e sterzo diretti. HOLD: propulsione neutra, con possibile deriva per inerzia, onde o corrente. STEERING: assistenza di velocità e virata. |
| BlueROV2 · ArduSub | MANUAL: controllo diretto. STABILIZE: stabilizza l’assetto, profondità manuale. ALT_HOLD: aggiunge il mantenimento della profondità, non della posizione orizzontale. |
Le missioni verificate richiedono GUIDED e armano il controllore all’avvio. La missione gestisce questa modalità, che non compare nel menu manuale. Vedi Missioni con autopilota.

Attiva l’ingresso joystick e scegli mouse/touch o gamepad. WAM-V offre acceleratore e sterzo; BlueROV2 aggiunge movimento laterale e verticale. Inizia con ingressi centrati e guadagno basso. Ferma input annulla la pressione corrente: rilascia e premi di nuovo per riprendere. Anche perdita di focus, disarmo, cambio di sorgente o comando rifiutato terminano la pressione.
Con il gamepad, tieni premuto LB/L1 mentre usi gli stick. Rilasciarlo invia un ingresso neutro; non disarma né ferma immediatamente un veicolo in moto. Su BlueROV2, Y/Triangolo richiede ALT_HOLD e A/Croce, STABILIZE. Verifica la modalità ricevuta. Tutte le associazioni sono in Controllo manuale e gamepad.
Mappa e missioni
I nuovi punti subacquei partono da 2 m. L’intervallo normale è 0–10 m; nelle scene di ispezione supportate, consultare il Limiti di profondità delle missioni mostrato dal server.

Completa coordinate e profondità prima di verificare la rotta. I punti di superficie usano 0 m; ogni punto della mappa prevede un’attesa di un secondo. Durante la modifica, i campi vuoti restano vuoti.
| Azione | Effetto |
|---|---|
| Clic / clic destro | Aggiunge un punto / rimuove un punto vicino. Trascinamento, rotellina o gesto di pinza spostano e ingrandiscono la mappa. |
| Ritorna alla partenza / Cancella | Imposta il ritorno / elimina i punti modificabili. |
| Verifica percorso | Calcola un’anteprima verificata sul terreno. Controlla percorso, margine e impedimenti. |
| Avvia percorso | Avvia la rotta verificata e arma dopo i controlli. |
| Ferma / Continua / Interrompi | Mantiene un obiettivo di attesa / riprende / annulla e disarma. |
Verifica di nuovo prima di un’altra esecuzione, perché il veicolo può essersi spostato. I punti della mappa hanno priorità sugli scenari predefiniti: cancellali per usare uno scenario. La verifica valuta terreno e distanza dello scafo, senza garantire l’evitamento di navi in movimento o la conformità al COLREG. Vedi Missioni con autopilota.
Strumenti del veicolo

Il marcatore blu fisso rappresenta il veicolo. L’orizzonte mobile mostra rollio e beccheggio. La prua usa 0° nord, 90° est, 180° sud e 270° ovest. La profondità è −Z rispetto al livello zero del mare: positiva sotto, negativa sopra. Non è la distanza dal fondale.
Il grafico conserva le ultime 100 pose ricevute. Scegli profondità, prua, beccheggio, rollio, velocità o spinta richiesta. Profondità, assetto e velocità provengono dal simulatore. La velocità mostra X avanti, Y a sinistra e Z in alto, in m/s. La spinta rappresenta comandi in newton, non una forza misurata. Dati assenti o obsoleti producono interruzioni o —. Profondità e assetto condividono acquisizione e tempo; la demo li allinea al video.
Velocità e passo fisico
La selezione viene inviata subito. Attendi la conferma.
| Impostazione | Valori |
|---|---|
| Velocità richiesta | 0,25×, 0,5×, 1×, 2× e 4× |
| Passo fisico | 5, 10 o 20 ms; compare anche 30 ms se il mondo lo usa già |
| Effettiva | Tempo simulato diviso per tempo reale; può essere inferiore al valore richiesto |
Il veicolo deve essere disarmato, il terreno pronto e i flussi di missione o controllo manuale/ROS inattivi. AIS non è disponibile oltre 1×. Windows e Linux partono da 20 ms, Mac nativo da 10 ms. Gli esercizi mantengono il passo obbligatorio di 10 ms. Vedi Personalizza i mondi.
Posizione e connessioni
N/E/D indica nord, est e basso in metri dall’origine locale. Le coordinate geografiche sono latitudine e longitudine in gradi. R/P/Y · ENU mostra gli angoli grezzi: imbardata 0° verso est, 90° verso nord. Lo strumento mostra beccheggio −P e prua (90 − Y + 360) % 360.
I dettagli di connessione indicano sequenza, età e riferimento ENU della posizione. Una sequenza crescente e dati recenti confermano nuove acquisizioni. Il pannello di controllo ha diagnostica separata. RViz apre il visualizzatore supportato: RViz2 nativo nell’app, visualizzatore web nel browser. Serve un mondo pronto e, nell’app, il servizio RViz disponibile. Vedi Visualizzazione con RViz e Foxglove. I parametri ArduPilot si leggono, esportano e modificano nel proprio pannello; le modifiche consentite si applicano disarmati e vengono verificate rileggendo i valori.
Controllo ROS 2 diretto

Abilita ROS per accettare comandi limitati dal controllore collegato. Ferma ROS mantiene l’uscita neutra fino alla nuova abilitazione. La diagnostica mostra motivo, sequenza applicata, conferma e spinte. Il watchdog riporta le uscite a neutro se i comandi smettono di arrivare. Segui Terminali ROS e connessione, Controlla un’area di lavoro web o Controlla un’area di lavoro locale.
Salvare e trasferire risorse
In Area di lavoro → Mondo personalizzato → Archiviazione, controlla terreni, revisioni dei veicoli, configurazioni dei mondi, cache e spazio libero. Archiviare nasconde una risorsa senza rimuoverne i file o liberare spazio. Ripristinare la rende nuovamente selezionabile. Attendi la fine delle sessioni che la usano.
Esportazione/importazione ZIP trasferisce il veicolo con le risorse. Modificare una copia crea una revisione nuova. Prima dell’avvio puoi scaricare i file SDF di veicolo e mondo, modificarli e caricare una revisione compatibile. Vedi Prepara il veicolo, Personalizza il veicolo e Personalizza i mondi.
Schermi piccoli e stati di attesa
Sul telefono, i pulsanti inferiori aprono un solo pannello scorrevole. Chiudilo con × o Escape per tornare alla scena. In orizzontale si dispone accanto ai controlli. La vista desktop della demo pubblica ridimensiona l’intera disposizione; in verticale invita a ruotare il telefono. Lo schermo intero dipende dal browser e da un’azione dell’utente.
Un pulsante disabilitato indica spesso preparazione incompleta, terreno in attesa, missione attiva o comando in corso. Leggi lo stato prima di riprovare. Nascondere pannelli, cancellare tracce, fermare immagini o annullare una sottoscrizione non ferma il veicolo. Al termine chiudi la sessione. Chiudere l’app installata arresta i servizi locali e la generazione del terreno, conservando i dati salvati.
Credenziali AIS
Le demo usano la chiave AISStream del server. In sua assenza, quelle installate usano il flusso AIS pubblico di Open Waters. Il pannello mostra provider e stato; le navi visibili dipendono da rapporti recenti.
Per un mondo personalizzato inserisci la tua chiave in Scena → Traffico marittimo e salvala localmente. Resta in questo browser e viene inviata al server di simulazione selezionato. Rimuovere la chiave locale la cancella dal browser. Attiva il traffico per connetterti. Vedi Simulazione, rendering e sensori.
Controllare con QGC
Per un veicolo Autopilot, seleziona Open QGC nel pannello ArduPilot. Tieni aperti l’app installata e l’area di lavoro con accesso effettuato. La finestra prepara il veicolo e passa il controllo a QGroundControl. Consulta Controllare con QGC per installazione, connessione e rilascio del controllo.
Luci anteriori BlueROV2
Usare Luci anteriori nel joystick per commutare entrambe le lampade BlueROV2 ON/OFF. La lettura conferma lo stato effettivo; un comando fallito o indisponibile non viene indicato come riuscito. Le luci del veicolo sono indipendenti da giorno/notte della scena e scelta della camera.