WWW-POSIM v0.6.16Documentation du simulateur
Menu de la documentation
WWW-POSIM / Documentation du simulateur

Commander un espace de travail local

Ouvrez l’exemple ROS 2 préparé dans VS Code, puis envoyez une commande courte à votre simulation locale.

Démarrer un monde contrôlable

  1. Suivez Installation et installez VS Code.
  2. Ouvrez WWW-POSIM, connectez-vous avec votre compte vérifié et choisissez Démarrer le simulateur. Sur Windows et Ubuntu, lancez d’abord Docker.
  3. Dans Espace de travail, choisissez un terrain prêt, WAM-V et Commande directe ROS 2.
  4. Démarrez le monde et attendez le véhicule et des positions récentes. Gardez l’application et le navigateur ouverts.

L’application exécute la simulation ; VS Code sert à éditer et lancer le programme de commande.

Ouvrir l’exemple préparé dans VS Code

Ouvrir dans VS Code affiche le dossier de travail et ros_vehicle_command.py. Le dossier initial est Documents/WWW-POSIM. Créer un projet Python ajoute exemples et réglages sans écraser les fichiers existants. L’ouverture de VS Code ajoute aussi l’exemple du véhicule s’il manque. Changez de dossier dans Réglages locaux → Dossier de travail. Ouvrir le dossier de travail l’affiche dans le gestionnaire de fichiers.

Si VS Code le demande, approuvez votre propre projet et autorisez la tâche automatique WWW-POSIM: ROS terminal. Sinon, lancez-la via Terminal → Exécuter la tâche → WWW-POSIM: ROS terminal. Les nouveaux terminaux intégrés utilisent WWW-POSIM ROS. Attendez ROS connected. Ouvrir le fichier n’exécute pas l’exemple.

Sur macOS, terminal et débogueur utilisent le Python de l’application avec ROS préparé ; aucun autre environnement virtuel n’est nécessaire pour ce projet. Sur Windows et Ubuntu, les commandes tournent dans le conteneur de commande préparé, tandis que VS Code édite le dossier partagé.

Installez les extensions Microsoft Python et Python Debugger. Sur Windows et Ubuntu, ajoutez Dev Containers et utilisez Dev Containers: Reopen in Container pour le débogage dans le conteneur. Ouvrir le terminal ROS lance un terminal externe préparé dans le même dossier.

Exécuter l’exemple ROS 2

Choisissez Activer ROS dans le panneau de commande du monde. Dans le terminal préparé, consultez les options et demandez un court déplacement du WAM-V :

python ros_vehicle_command.py --help
python ros_vehicle_command.py --vehicle wamv --forward 0.3 --seconds 2

L’exemple publie régulièrement des commandes, puis envoie des valeurs neutres à la fin ou sur Ctrl+C. Il attend un abonné avant de commander le mouvement. Chaque exécution est limitée à 30 secondes, les commandes WAM-V à 1 m/s et 0.5 rad/s, et la poussée BlueROV2 à 5 N par moteur.

Pour BlueROV2, commencez par six valeurs neutres :

python ros_vehicle_command.py --vehicle bluerov2 --thrusters 0 0 0 0 0 0 --seconds 2

Vérifiez le véhicule et sa réponse avant d’augmenter l’entrée. Les commandes neutres ne suppriment ni inertie ni forces des vagues.

Utiliser l’interface de session Python

Le paquet propose aussi une interface de session Python. Enregistrez ce code dans controller.py et lancez python controller.py dans le terminal préparé :

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"])

Le programme lit une position récente, demande une avance à 0.3 m/s pendant deux secondes, puis libère la commande. L’écart entre les positions affichées n’est pas nécessairement une distance exacte. Utilisez yaw_rate=0.1 pour tourner à gauche. La commande d’arrêt du navigateur interrompt immédiatement le contrôle.

Propulseurs du BlueROV

L’interface accepte six valeurs BlueROV2 en newtons, dans l’ordre natif des articulations. WAM-V utilise deux valeurs : gauche et droite. Commencez au neutre :

from www_posim_ros import Session

with Session.local(control=True) as sim:
    sim.set_thrusters([0.0] * 6, duration=1.0)
Limite de l’interface Valeur
Vitesse WAM-V Avance ±1.5 m/s ; lacet ±0.5 rad/s
Poussée WAM-V ±200 N par moteur
Poussée BlueROV2 ±50 N par moteur
Durée des fonctions d’aide Supérieure à 0 ; jusqu’à 300 secondes
Surveillance des commandes 0.75 seconde sans mise à jour valide

Ces limites diffèrent de celles, volontairement plus faibles, de ros_vehicle_command.py. Les fonctions répètent les commandes à environ 10 Hz, puis libèrent le contrôle. sim.stop() interrompt la fonction active depuis un autre thread. Une déconnexion termine le contrôle ; les commandes ne reprennent pas automatiquement après une erreur réseau.

Lorsque le serveur confirme la libération, chaque fonction attend le retour à une poussée nulle et la fin de l’autorisation de pilotage. Si controller_busy s’affiche, arrêtez l’autre contrôleur. La fin normale de l’évaluation ou un arrêt peut déclencher control_lease_ended. watchdog_timeout et simulation_or_sensor_unavailable signalent un échec.

Pendant une évaluation de défi, control_service_stalled indique que les rappels natifs de commande du serveur se sont arrêtés pendant plus de 0.75 seconde. La propulsion s’arrête en sécurité et cette exécution ne reçoit aucun score valide. Les soumissions web conservent les résultats terminés et relancent automatiquement l’évaluation interrompue. En entraînement local, vérifiez le simulateur puis redémarrez l’exécution.

Charger une extension dans l’application installée

Un espace local de l’application installée peut charger une extension ZIP world/model approuvée par son propriétaire. Les espaces hébergés et les sessions d’évaluation n’exécutent pas de code d’extension.

  1. À l’étape finale de vérification de l’espace, ouvrez User world/model extensions, puis Import extension ZIP. L’archive contient extension.json, son point d’entrée SDF et les fichiers déclarés avec leurs empreintes. L’importation vérifie et conserve l’archive sans exécuter le code.
  2. Consultez Declared files and SDK : code, plateforme cible, SHA-256 du ZIP et SHA-256 du SDK. La cible et le SDK doivent correspondre au moteur actif. Le code dispose des accès aux fichiers et au réseau de l’environnement local d’exécution.
  3. Choisissez Approve code and select, confirmez uniquement du code de confiance, puis démarrez le monde. L’approbation est liée au propriétaire et au couple ZIP/SDK exact ; la sélection concerne la nouvelle session. Clear selected extension conserve l’archive enregistrée.

Un SDK inconnu ou une différence de cible ou d’empreinte désactive la sélection. Utilisez une extension construite pour le moteur choisi et approuvez son archive exacte. Les scripts généraux sans point d’entrée enregistré comme fournisseur de navigation ne sont pas exécutables. L’application gère le processus du fournisseur et l’arrête à la fin de la session.

WAM-V et BlueROV2 partagent une interface avec un seul fournisseur ROS de navigation actif. Le fournisseur utilisateur sélectionné remplace la sortie du fournisseur intégré ; le récepteur GNSS brut reste actif. Les sorties communes sont /vehicle/navigation/estimate (nav_msgs/Odometry) et /vehicle/navigation/status (JSON dans std_msgs/String). La pose utilise navigation_map ENU ; les vitesses utilisent les axes du véhicule FLU de base_link. Des horodatages de simulation concordants, une covariance finie, l’identité de session et une origine géographique WGS 84 sont requis.

En mode Autopilot, la passerelle commune vérifie ces sorties avant de fournir la navigation externe à la FCU. Seul le GNSS brut détermine l’état du fix GPS. Sans calibration, alignement global ou données valides, le fournisseur doit rester non prêt. L’importer ou le démarrer ne suffit pas à établir la disponibilité de la navigation. Voir GNSS et navigation pour la sélection des sources et les pertes de signal.

Mettre à jour le SDK

Depuis la version 0.4.2, le SDK Python vérifie en arrière-plan la disponibilité d’une version stable et affiche la méthode d’installation dans le terminal. Les évaluations officielles désactivent cette vérification. Pour le SDK fourni, mettez à jour l’application et ouvrez un nouveau terminal ROS. Dans un conteneur VS Code existant, renseignez l’image indiquée dans .devcontainer/devcontainer.json et reconstruisez le conteneur. Dans votre propre environnement Python, lancez la commande affichée puis redémarrez Python. Lancez python -m www_posim_ros.updates pour vérifier manuellement.

Résoudre les problèmes

Poursuivez avec Terminaux ROS et connexion, Commander un espace de travail web, Visualiser avec RViz et Foxglove ou Dépannage ROS.

Rechercher dans la documentation