Terminali ROS e connessione
Il pacchetto www_posim_ros collega l’ambiente ROS a un’area di lavoro WWW-POSIM in esecuzione. Il connettore riceve telemetria autenticata e pubblica messaggi ROS 2 standard nel dominio ROS locale. Lascialo in esecuzione mentre usi gli strumenti ROS.
Sensori Gazebo→ HTTPS / WebSocket →www_posim_ros
Connettore→ ROS 2 locale →ros2 topic · RViz
Programma Python
Terminale dell’app installata
Avvia un mondo, quindi apri il terminale ROS dall’app. Il terminale apre la cartella di lavoro, inizialmente Documents/WWW-POSIM, e prepara l’ambiente ROS dell’applicazione. Più terminali dell’app condividono un solo connettore locale.
Su macOS compaiono un’intestazione WWW-POSIM, lo stato di preparazione e il tempo trascorso durante la connessione. Attendi ROS connected e le versioni di ROS, Python e del connettore. Il prompt colorato WWW-POSIM identifica l’ambiente preparato.
L’apertura in VS Code mostra la stessa cartella e ros_vehicle_command.py con un terminale ROS pronto. Segui Controlla un’area di lavoro locale per eseguire un controllore. L’opzione RViz apre il visualizzatore installato.
In modalità Autopilot, gli strumenti ROS forniscono solo telemetria. ros_vehicle_command.py richiede Controllo diretto ROS 2. Per cambiare modalità, disarma il veicolo, riutilizza un terreno preparato nelle impostazioni, scegli Controllo diretto ROS 2 e riavvia il mondo. Il riavvio azzera la simulazione. Un veicolo salvato mantiene la sua modalità di controllo; usa un veicolo integrato o modifica una copia del veicolo salvato per cambiarla.
Il pannello Controllo diretto ROS 2 dell’app installata offre anche Apri terminale ROS e Apri in VS Code. Entrambi usano la cartella di lavoro selezionata nell’app. Sul sito web, o se l’avvio locale non è disponibile, usa Guida al terminale ROS e VS Code. La guida si apre in una finestra separata.
Collegare ROS a un’area di lavoro web
Avvia il tuo mondo personale sul sito. Installa ROS 2 Lyrical e i pacchetti standard dei messaggi seguendo la guida di installazione di ROS. In un terminale Ubuntu o WSL, carica ROS e installa il connettore:
source /opt/ros/lyrical/setup.bash
sudo apt install ros-lyrical-rmw-cyclonedds-cpp
python3 -m venv --system-site-packages .venv-ros
source .venv-ros/bin/activate
python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export ROS_DOMAIN_ID=76
export ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST
www-posim-connect --server https://www-posim.vercel.app/api --email YOU@example.com
Inserisci la password quando richiesta e lascia aperto il terminale. In un secondo terminale, carica la stessa configurazione ROS, attiva lo stesso ambiente virtuale e imposta le stesse tre variabili d’ambiente. Un ambiente virtuale Python da solo non fornisce ROS né rclpy.
Per utilizzare l’ambiente incluso nell’app Mac, sostituisci il comando che carica ROS con:
eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"
Collegare ROS a un’area di lavoro locale
Avvia l’app installata e il tuo mondo. Nell’ambiente ROS preparato, usa questo comando al posto della connessione al sito:
www-posim-connect --local --server http://127.0.0.1:3300/api
Il connettore utilizza la sessione attiva dell’app senza chiedere le credenziali del sito. Usa un solo connettore per dominio ROS; non avviare anche quello gestito dall’app nello stesso dominio. Se una distribuzione WSL separata non raggiunge l’indirizzo di loopback dell’app Windows, apri il terminale ROS dall’app.
Verificare i topic e il flusso dei dati
Quando il connettore è pronto, esegui:
ros2 topic list
ros2 topic echo /model/wamv/odometry
Controlla che continuino ad arrivare messaggi e che i timestamp avanzino. Ctrl+C interrompe la visualizzazione. Per BlueROV2, scegli il suo topic di odometria nell’elenco. La presenza di un nome nell’elenco non conferma da sola che il flusso sia attivo.
Se non arrivano dati, verifica che il mondo sia in esecuzione e che i due terminali usino lo stesso ambiente e dominio ROS. Consulta Risoluzione dei problemi ROS, Controlla un’area di lavoro web o Controlla un’area di lavoro locale.