Commander un espace de travail web
Exécutez Python sur votre ordinateur pour envoyer des commandes à votre simulation personnelle sur le site.
Préparer Python et VS Code
- Ouvrez WWW-POSIM, connectez-vous et créez un monde WAM-V avec la commande directe ROS 2. Attendez que le monde fonctionne.
- Installez VS Code et l’extension Python de Microsoft.
- Suivez le bloc correspondant à votre système. Le dossier
.venvcontient les paquets Python du projet.
Windows : PowerShell
Installez le gestionnaire d’installation de Python. Ouvrez une nouvelle fenêtre PowerShell depuis le menu Démarrer et exécutez :
py install 3.14
mkdir "$HOME\posim-controller"
cd "$HOME\posim-controller"
py -3.14 -m venv .venv
.\.venv\Scripts\python.exe -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
Mac : Terminal
Installez Python 3.14 avec le programme fourni par Python.org. Ouvrez Applications → Utilitaires → Terminal, puis exécutez :
mkdir -p ~/posim-controller
cd ~/posim-controller
python3.14 -m venv .venv
.venv/bin/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
Ubuntu : terminal
Ouvrez un terminal avec Ctrl+Alt+T, puis exécutez :
sudo apt update
sudo apt install -y python3-venv python3-pip
mkdir -p ~/posim-controller
cd ~/posim-controller
python3 -m venv .venv
.venv/bin/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
sudo peut demander le mot de passe de votre ordinateur. Aucun caractère ne s’affiche pendant la saisie ; appuyez sur Entrée une fois terminé.
Exécuter le programme dans VS Code
- Dans VS Code, ouvrez le dossier
posim-controllerde votre dossier personnel avec Fichier → Ouvrir le dossier. - Installez l’extension Python de Microsoft si nécessaire.
- Ouvrez la palette de commandes avec Ctrl+Maj+P sur Windows/Linux ou Cmd+Maj+P sur Mac. Recherchez
Python: Select Interpreteret sélectionnez l’interpréteur de.venv. - Créez
controller.py, collez le code suivant, remplacezYOU@example.compar l’adresse de votre compte et enregistrez.
from www_posim_ros import Session
with Session.remote(email="YOU@example.com", control=True) as sim:
topic = next(name for name, kind in sim.topics.items()
if kind == "nav_msgs/msg/Odometry")
print(sim.latest(topic)["pose"]["pose"]["position"])
sim.set_velocity(forward=0.3, yaw_rate=0.0, duration=2.0)
- Ouvrez un terminal intégré et lancez la commande adaptée à votre système.
Windows :
.\.venv\Scripts\python.exe controller.py
Mac/Ubuntu :
.venv/bin/python controller.py
- À l’invite
Password:, saisissez votre mot de passe WWW-POSIM et appuyez sur Entrée. La saisie reste invisible. Observez le déplacement de WAM-V sur le site.
Le programme s’exécute sur votre ordinateur et commande votre propre espace de travail sur le serveur. Importer le paquet ne connecte pas votre compte ; la connexion s’ouvre à l’entrée dans le bloc with.
Résoudre les problèmes
No module named www_posim_ros: sélectionnez l’interpréteur du projet et réinstallez le paquet avec le Python de.venv.- Aucune télémétrie récente : vérifiez que le monde fonctionne et que le robot est apparu. Un topic visible ne garantit pas la réception de données.
- Un espace de travail en commande directe ROS 2 est demandé : créez le monde avec ce mode.
controller_busy: arrêtez l’autre programme qui commande le monde, puis relancez le vôtre.- Le monde ou le robot a changé : redémarrez le programme pour obtenir le profil de connexion actuel.
- Les outils ROS de l’application échouent : consultez
~/.www-posim-ros/domain-76/client.logdans l’environnement préparé. Fermez et rouvrez les outils ROS si nécessaire.
Pour utiliser les topics ROS depuis un autre environnement, consultez Terminaux ROS et connexion.