Controlla un’area di lavoro locale
Apri l’esempio ROS 2 preparato in VS Code ed esegui un comando breve nella simulazione locale.
Avviare un mondo controllabile
- Segui Installazione e installa VS Code.
- Apri WWW-POSIM, accedi con l’account verificato e scegli Avvia simulatore. Su Windows e Ubuntu avvia prima Docker.
- In Area di lavoro, scegli un terreno pronto, WAM-V e Controllo diretto ROS 2.
- Avvia il mondo e attendi il veicolo e dati di posizione recenti. Lascia aperti app e browser.
L’app esegue la simulazione; VS Code serve a modificare e avviare il programma di controllo.
Aprire l’esempio preparato in VS Code
Apri in VS Code apre la cartella di lavoro e ros_vehicle_command.py. La cartella iniziale è Documents/WWW-POSIM. Crea progetto Python aggiunge esempi e impostazioni senza sovrascrivere file esistenti. L’apertura di VS Code aggiunge anche l’esempio del veicolo, se manca. Per cambiare cartella usa Impostazioni locali → Cartella di lavoro. Apri cartella di lavoro la mostra nel gestore dei file.
Se VS Code lo richiede, considera attendibile il tuo progetto e consenti l’attività automatica WWW-POSIM: ROS terminal. In alternativa, avviala da Terminale → Esegui attività → WWW-POSIM: ROS terminal. I nuovi terminali integrati usano WWW-POSIM ROS. Attendi ROS connected. Aprire il file non esegue l’esempio.
Su macOS, terminale e debugger usano il Python incluso nell’app con l’ambiente ROS preparato; per questo progetto non serve un altro ambiente virtuale. Su Windows e Ubuntu, i comandi vengono eseguiti nel contenitore di controllo preparato, mentre VS Code modifica la cartella condivisa.
Installa le estensioni Microsoft Python e Python Debugger. Su Windows e Ubuntu aggiungi Dev Containers e usa Dev Containers: Reopen in Container per il debug nel contenitore. Apri terminale ROS avvia un terminale esterno preparato nella stessa cartella.
Eseguire l’esempio ROS 2
Scegli Attiva ROS nel pannello di controllo del mondo. Nel terminale preparato, consulta le opzioni e richiedi un breve movimento di WAM-V:
python ros_vehicle_command.py --help
python ros_vehicle_command.py --vehicle wamv --forward 0.3 --seconds 2
L’esempio pubblica comandi periodici e invia valori neutri al termine o con Ctrl+C. Prima del movimento attende un sottoscrittore. Ogni esecuzione dura al massimo 30 secondi; WAM-V è limitato a 1 m/s e 0.5 rad/s, BlueROV2 a 5 N per motore.
Per BlueROV2, inizia con sei valori neutri:
python ros_vehicle_command.py --vehicle bluerov2 --thrusters 0 0 0 0 0 0 --seconds 2
Controlla veicolo e risposta prima di aumentare l’ingresso. I comandi neutri non eliminano inerzia o forze delle onde.
Usare l’interfaccia di sessione Python
Il pacchetto offre anche un’interfaccia di sessione Python. Salva questo codice come controller.py ed esegui python controller.py nel terminale preparato:
from www_posim_ros import Session
with Session.local(control=True) as sim:
topic = next(name for name, kind in sim.topics.items()
if kind == "nav_msgs/msg/Odometry")
print("Before:", sim.latest(topic)["pose"]["pose"]["position"])
sim.set_velocity(forward=0.3, yaw_rate=0.0, duration=2.0)
print("After:", sim.latest(topic)["pose"]["pose"]["position"])
Il programma legge una posizione recente, richiede 0.3 m/s in avanti per due secondi e rilascia il controllo. Le posizioni stampate non devono necessariamente differire di una distanza esatta. Usa yaw_rate=0.1 per girare a sinistra. Il comando di arresto del browser interrompe subito il controllo.
Propulsori di BlueROV
L’interfaccia accetta sei valori di spinta BlueROV2, in newton e nell’ordine nativo dei giunti. WAM-V usa due valori: sinistro e destro. Inizia in neutro:
from www_posim_ros import Session
with Session.local(control=True) as sim:
sim.set_thrusters([0.0] * 6, duration=1.0)
| Limite dell’interfaccia | Valore |
|---|---|
| Velocità WAM-V | Avanzamento ±1.5 m/s; imbardata ±0.5 rad/s |
| Spinta WAM-V | ±200 N per motore |
| Spinta BlueROV2 | ±50 N per motore |
| Durata delle funzioni ausiliarie | Maggiore di 0; fino a 300 secondi |
| Sorveglianza dei comandi | 0.75 secondi senza aggiornamenti validi |
Questi limiti differiscono da quelli volutamente più bassi di ros_vehicle_command.py. Le funzioni ripetono i comandi a circa 10 Hz, poi rilasciano il controllo. sim.stop() interrompe la funzione attiva da un altro thread. La disconnessione termina il controllo; i comandi non riprendono automaticamente dopo un errore di rete.
Quando il server conferma il rilascio, ogni funzione attende l’azzeramento della spinta e il rilascio del controllo. Se compare controller_busy, arresta prima l’altro controller. Il completamento normale della valutazione o un arresto può produrre control_lease_ended. watchdog_timeout e simulation_or_sensor_unavailable indicano un errore.
Durante la valutazione di una sfida, control_service_stalled indica che i callback nativi di controllo del server si sono fermati per più di 0.75 secondi. La propulsione si arresta in sicurezza e questa esecuzione non riceve un punteggio valido. Gli invii web conservano i risultati completati e riprovano automaticamente la valutazione interrotta. Nella pratica locale, controlla il simulatore e riavvia l’esecuzione.
Caricare un’estensione nell’app installata
Uno spazio locale dell’app installata può caricare un’estensione ZIP world/model approvata dal proprietario. Gli spazi ospitati e le sessioni di valutazione non eseguono codice delle estensioni.
- Nella verifica finale dello spazio, aprire User world/model extensions e Import extension ZIP. L’archivio contiene
extension.json, il punto di ingresso SDF e i file dichiarati con i relativi hash. L’importazione verifica e conserva l’archivio senza eseguire il codice. - Controllare Declared files and SDK: codice, piattaforma di destinazione, SHA-256 del ZIP e SHA-256 dell’SDK. Destinazione e SDK devono corrispondere al motore in esecuzione. Il codice dispone dell’accesso a file e rete dell’ambiente locale di esecuzione.
- Scegliere Approve code and select, confermare solo codice attendibile e avviare il mondo. L’approvazione è legata al proprietario e alla coppia ZIP/SDK esatta; la selezione vale per la nuova sessione. Clear selected extension conserva l’archivio salvato.
Un SDK sconosciuto o una mancata corrispondenza di destinazione/hash impedisce la selezione. Usare un’estensione compilata per il motore scelto e approvare il suo archivio esatto. Gli script generici senza un punto di ingresso registrato come provider di navigazione non vengono eseguiti. L’app gestisce il processo del provider e lo arresta al termine della sessione.
WAM-V e BlueROV2 condividono un’interfaccia con un solo provider ROS di navigazione attivo. Il provider utente selezionato sostituisce l’uscita di quello integrato, mantenendo il ricevitore GNSS grezzo. Le uscite comuni sono /vehicle/navigation/estimate (nav_msgs/Odometry) e /vehicle/navigation/status (JSON in std_msgs/String). La posa usa navigation_map ENU; le velocità usano gli assi FLU del corpo in base_link. Servono timestamp di simulazione corrispondenti, covarianza finita, identità di sessione e origine geografica WGS 84.
In modalità Autopilot, il gateway comune verifica le uscite prima di fornire navigazione esterna alla FCU. Solo il GNSS grezzo determina lo stato del fix GPS. Senza calibrazione, allineamento globale o dati validi, il provider deve restare non pronto. Importarlo o avviarlo non stabilisce la disponibilità della navigazione. Vedere GNSS e navigazione per la selezione delle sorgenti e la perdita del segnale.
Aggiornare l’SDK
Dalla versione 0.4.2, l’SDK verifica in background la disponibilità di una versione stabile e mostra come installarla nel terminale. La valutazione ufficiale salta il controllo. Per l’SDK incluso, aggiorna l’app e riapri il terminale ROS. Per un contenitore VS Code esistente, imposta l’immagine indicata in .devcontainer/devcontainer.json e ricostruisci il contenitore. In un ambiente Python personale, esegui il comando indicato e riavvia Python. Per un controllo manuale, esegui python -m www_posim_ros.updates.
Risolvere i problemi
No module named www_posim_ros: usa l’interprete preparato del progetto.- Nessuna telemetria recente: verifica che il mondo sia attivo e il veicolo visibile. Un topic elencato non prova la ricezione.
- È richiesto il controllo diretto: avvia il mondo in controllo diretto ROS 2.
controller_busy: arresta l’altro controllore prima di riprovare.- Mondo o veicolo cambiato: riavvia il programma per ottenere il profilo attuale.
- Gli strumenti ROS non funzionano: consulta
~/.www-posim-ros/domain-76/client.lognell’ambiente preparato e, se necessario, chiudi e riapri gli strumenti.
Prosegui con Terminali ROS e connessione, Controlla un’area di lavoro web, Visualizzazione con RViz e Foxglove o Risoluzione dei problemi ROS.