Controlla un’area di lavoro web
Esegui Python sul tuo computer per inviare comandi alla tua simulazione personale sul sito.
Preparare Python e VS Code
- Apri WWW-POSIM, accedi e crea un mondo WAM-V con il controllo diretto ROS 2. Attendi che il mondo sia in esecuzione.
- Installa VS Code e l’estensione Python di Microsoft.
- Segui il blocco relativo al tuo sistema. La cartella
.venvcontiene i pacchetti Python del progetto.
Windows: PowerShell
Installa il gestore di installazione di Python. Apri una nuova finestra PowerShell dal menu Start ed esegui:
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: Terminale
Installa Python 3.14 con il programma di installazione di Python.org. Apri Applicazioni → Utility → Terminale ed esegui:
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: terminale
Premi Ctrl+Alt+T ed esegui:
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 può chiedere la password del computer. Durante la digitazione non compaiono caratteri; al termine premi Invio.
Eseguire il programma in VS Code
- In VS Code, apri
posim-controllernella tua cartella personale con File → Apri cartella. - Installa l’estensione Python di Microsoft, se manca.
- Apri la tavolozza dei comandi con Ctrl+Maiusc+P su Windows/Linux o Cmd+Maiusc+P su Mac. Cerca
Python: Select Interpretere scegli l’interprete di.venv. - Crea
controller.py, incolla il codice seguente, sostituisciYOU@example.comcon l’indirizzo del tuo account e salva.
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)
- Apri un terminale integrato ed esegui il comando per il tuo sistema.
Windows:
.\.venv\Scripts\python.exe controller.py
Mac/Ubuntu:
.venv/bin/python controller.py
- Alla richiesta
Password:, inserisci la password di WWW-POSIM e premi Invio. La digitazione resta invisibile. Osserva WAM-V muoversi sul sito.
Il programma viene eseguito sul tuo computer e controlla la tua area di lavoro sul server. Importare il pacchetto non effettua l’accesso né apre la connessione: la connessione inizia quando si entra nel blocco with.
Risolvere i problemi
No module named www_posim_ros: seleziona l’interprete del progetto e reinstalla il pacchetto con il Python di.venv.- Nessuna telemetria recente: verifica che il mondo sia in esecuzione e che il robot sia apparso. Un topic elencato non garantisce la ricezione dei dati.
- Viene richiesta un’area di lavoro con controllo diretto ROS 2: crea il mondo con questa modalità.
controller_busy: arresta l’altro programma che controlla il mondo, poi riprova.- Mondo o robot cambiato: riavvia il programma per ottenere il profilo di connessione attuale.
- Gli strumenti ROS dell’app non funzionano: consulta
~/.www-posim-ros/domain-76/client.lognell’ambiente preparato. Se necessario, chiudi e riapri gli strumenti ROS.
Per usare i topic ROS da un altro ambiente, consulta Terminali ROS e connessione.