Controllo con QGroundControl
Collega QGroundControl (QGC) al BlueROV2 simulato, usa i joystick virtuali e osserva la telecamera anteriore. Completa l’installazione e prepara i terminali A e B.
1. Aprire QGC nell'ambiente POSIM
Windows/WSL: per questi tutorial usa la versione Linux di QGC. Non avviare l’applicazione installata su Windows. Avvia QGC nella stessa distribuzione Ubuntu di POSIM oppure, con Docker, nello stesso contenitore POSIM. WSLg può mostrare la finestra Linux sul desktop di Windows; l’applicazione continua a essere eseguita in Linux.
Gli indirizzi 127.0.0.1 di questa guida si riferiscono all’ambiente in cui viene eseguito QGC. Non configurano l’applicazione Windows per ricevere telemetria o video da WSL o Docker.
| Installazione | Dove eseguire QGC |
|---|---|
| Ubuntu nativo | Installa e avvia l'applicazione Linux in Ubuntu. |
| Windows con WSL nativo | Installa e avvia l'applicazione Linux nella stessa distribuzione Ubuntu. |
| Linux o Windows con Docker | Avvia l'applicazione inclusa nel container POSIM. |
| macOS con Docker e RDP | Avvia l'applicazione da un terminale del desktop RDP. |
Questa guida usa QGC 5.1.5, incluso nelle immagini Docker di POSIM. Per un’installazione nativa, segui la guida ufficiale all’installazione e scarica l’AppImage Linux per la tua architettura dalla pagina della versione 5.1.5. Nel container, usa il terminale B:
qgroundcontrol &
Il simbolo & restituisce il prompt mentre QGC rimane aperto. Se hai avviato l'applicazione da un altro terminale, lascialo aperto. Se compaiono le preferenze iniziali, scegli Metric System.
QGC, MAVROS e Gazebo condividono lo stesso ambiente Linux. La telemetria usa UDP 14550, il video UDP 5600. Questa configurazione non richiede di pubblicare altre porte Docker. Su macOS, accedi all'ambiente tramite RDP.
2. Preparare i joystick
Apri Application Settings → Fly View → Virtual Joystick:
- Attiva Virtual Joystick.
- Attiva Auto-Center Throttle per riportare il comando al centro quando rilasci la leva.
- Lascia Left-Handed Mode disattivato per mantenere la disposizione usata nell'esempio.
3. Configurare il video
Apri Application Settings → Video. Seleziona prima la sorgente video, poi inserisci l'indirizzo UDP e gli altri valori della tabella.
| Impostazione | Valore |
|---|---|
| Video Source | UDP h.264 Video Stream |
| UDP URL | 127.0.0.1:5600 |
| Aspect Ratio | 0, proporzioni automatiche |
| Disable Video Stream When Disarmed | Disattivato |
| Low Latency Mode | Attivo |
| Auto-reconnect on stream loss | Attivato |
4. Avviare robot e telecamera
Arresta la simulazione precedente. Nel terminale A preparato:
ros2 launch posim_demos posim_robot.launch.py \
namespace:=bluerov2 world_name:=camera_tutorial \
x:=3 z:=-94 paused:=false gui:=true headless:=false \
use_teleop:=false use_web_joystick:=false \
open_qgc:=false open_virtual_joystick:=false qgc_video:=true
Gazebo apre la scena del fondale e QGC si collega ad ArduSub. Attendi il completamento dell'inizializzazione. Nel terminale B:
gz topic -t /model/bluerov2/camera/enable_streaming \
-m gz.msgs.Boolean -p 'data: true' --duration 3
Torna a Fly View e fai clic sull'anteprima video per ingrandirla.
La telecamera produce immagini di 640 × 480 a 5 Hz nel tempo di simulazione. Il rendering software può ridurre la frequenza effettiva. BlueROV2 ha un assetto a galleggiabilità positiva: anche disarmato, può risalire e portare gli oggetti fuori dall'inquadratura.
qgc_video:=true aggiunge il trasmettitore H.264. Il video RGB include gli effetti subacquei del mondo. Il filtro della telecamera indipendente ha una propria uscita ROS. GNSS perde la posizione quando l'antenna si immerge e la riacquisisce dopo l'emersione; telemetria, video e controllo manuale restano connessi. Usa Manual sott'acqua. La lente è più bassa dell'antenna, quindi l'immagine può essere subacquea anche con una posizione GNSS valida.
5. Armare, muovere e fermare
- Attendi Ready e scegli Manual.
- Apri il menu di stato del veicolo e tieni premuto Arm fino al completamento.
- Sposta brevemente la leva destra in avanti e indietro.
- Rilasciala per tornare al comando neutro. Correnti e inerzia possono continuare a muovere il robot.
- Al termine, tieni premuto Disarm nel menu di stato.
Mantieni disattivati il controllo da tastiera e il joystick web per evitare comandi concorrenti. Ferma il video dal terminale B:
gz topic -t /model/bluerov2/camera/enable_streaming \
-m gz.msgs.Boolean -p 'data: false' --duration 3
Premi Ctrl+C in A e chiudi QGC.
MAVROS attende fino a 60 secondi senza ricevere un heartbeat dal veicolo prima di segnalare la perdita della connessione. Questo margine tiene conto del rendering software lento; una reale interruzione degli heartbeat può quindi richiedere fino a 60 secondi per apparire in /mavros/state.
Risolvere problemi di connessione
Le opzioni qgc_video e qgc_video_port qui sotto si applicano all’avvio separato del passaggio 4. Le prime simulazioni includono già un trasmettitore video; usa il loro comando /tutorial/camera/enable_streaming. Se il carico del sonar allunga gli intervalli tra i fotogrammi, QGC può mostrare temporaneamente Waiting for video. Mantieni Low Latency Mode attivo e prova il tutorial subacqueo senza sonar.
- Veicolo assente: verifica che QGC sia nello stesso ambiente Linux di POSIM e che un'altra istanza non occupi UDP 14550.
- Waiting for video: controlla sorgente H.264, indirizzo UDP e
qgc_video:=true. Attiva l'invio da B e attendi qualche fotogramma. - Porta diversa: usa
qgc_video_port:=5602e imposta127.0.0.1:5602in QGC. - Opzione
qgc_videoassente: aggiorna POSIM oppure scarica l'immagine e ricrea il container. - Avvisi su firmware o porta seriale: la simulazione usa ArduSub incluso e una connessione di rete; non richiede aggiornamenti firmware né una configurazione seriale.
Consulta le impostazioni video ufficiali e le interfacce ROS dei propulsori.