Terminaux ROS et connexion
Le paquet www_posim_ros relie votre environnement ROS à un espace de travail WWW-POSIM en cours d’exécution. Le connecteur reçoit la télémétrie authentifiée et publie des messages ROS 2 standard dans votre domaine ROS local. Laissez-le actif pendant l’utilisation des outils ROS.
Capteurs Gazebo→ HTTPS / WebSocket →www_posim_ros
Connecteur→ ROS 2 local →ros2 topic · RViz
Programme Python
Terminal de l’application installée
Démarrez un monde, puis ouvrez le terminal ROS depuis l’application. Il ouvre votre dossier de travail, initialement Documents/WWW-POSIM, et prépare l’environnement ROS de l’application. Plusieurs terminaux de l’application partagent un seul connecteur local.
Sur macOS, le terminal affiche un en-tête WWW-POSIM, l’état de préparation et la durée de connexion. Attendez ROS connected, puis les versions de ROS, de Python et du connecteur. L’invite colorée WWW-POSIM identifie cet environnement prêt à l’emploi.
L’ouverture dans VS Code affiche le même dossier et ros_vehicle_command.py avec un terminal ROS préparé. Consultez Commander un espace de travail local pour exécuter un contrôleur. L’ouverture de RViz lance le visualiseur installé.
En mode Autopilot, les outils ROS fournissent uniquement la télémétrie. ros_vehicle_command.py nécessite Commande directe ROS 2. Pour changer de mode, désarmez le véhicule, réutilisez un terrain préparé dans les réglages, choisissez Commande directe ROS 2 et redémarrez le monde. Le redémarrage réinitialise la simulation. Un véhicule enregistré conserve son mode de commande ; choisissez un véhicule intégré ou modifiez une copie du véhicule enregistré pour le changer.
Le panneau Commande directe ROS 2 de l’application installée propose aussi Ouvrir le terminal ROS et Ouvrir dans VS Code. Les deux utilisent le dossier de travail choisi dans l’application. Sur le site web, ou si le lanceur local est indisponible, utilisez Guide du terminal ROS et de VS Code. Le guide s’ouvre dans une autre fenêtre.
Relier votre environnement ROS à un espace de travail web
Démarrez votre monde personnel sur le site. Installez ROS 2 Lyrical et les paquets de messages standard à l’aide du guide d’installation de ROS. Dans un terminal Ubuntu ou WSL, chargez ROS et installez le connecteur :
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
Saisissez votre mot de passe à l’invite et gardez ce terminal ouvert. Dans un second terminal, chargez la même configuration ROS, activez le même environnement virtuel et définissez les trois mêmes variables d’environnement. Un environnement virtuel Python seul ne fournit ni ROS ni rclpy.
Pour utiliser l’environnement fourni avec l’application Mac, remplacez la commande de chargement de ROS par :
eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"
Relier votre environnement ROS à un espace de travail local
Démarrez l’application et votre monde. Dans l’environnement ROS préparé, utilisez cette commande à la place de la connexion au site :
www-posim-connect --local --server http://127.0.0.1:3300/api
Le connecteur utilise la session active de l’application sans demander les identifiants du site. Utilisez un seul connecteur par domaine ROS ; ne lancez pas en parallèle le connecteur géré par l’application dans ce domaine. Si une distribution WSL séparée n’accède pas à l’adresse de boucle locale de l’application Windows, ouvrez le terminal ROS depuis l’application.
Vérifier les topics et le flux de données
Une fois le connecteur prêt, exécutez :
ros2 topic list
ros2 topic echo /model/wamv/odometry
Vérifiez que les messages continuent d’arriver et que leurs horodatages progressent. Ctrl+C arrête l’affichage. Pour BlueROV2, choisissez son topic d’odométrie dans la liste. La présence d’un nom de topic ne garantit pas la réception de données.
En l’absence de données, vérifiez que le monde fonctionne et que les deux terminaux utilisent le même environnement et le même domaine ROS. Consultez Dépannage ROS, Commander un espace de travail web ou Commander un espace de travail local.