WWW-POSIM v0.6.16Documentación del simulador
Menú de documentación
WWW-POSIM / Documentación del simulador

Terminales ROS y conexión

El paquete www_posim_ros conecta tu entorno ROS con un espacio de trabajo WWW-POSIM en ejecución. El conector recibe telemetría autenticada y publica mensajes ROS 2 estándar en tu dominio ROS local. Mantenlo en ejecución mientras utilices las herramientas ROS.

Espacio de trabajo WWW-POSIM
Sensores Gazebo
→ HTTPS / WebSocket →www_posim_ros
Conector
→ ROS 2 local →ros2 topic · RViz
Programa Python

Terminal de la aplicación de escritorio

Inicia un mundo y selecciona la opción para abrir el terminal ROS en la aplicación. El terminal abre tu carpeta de trabajo, inicialmente Documents/WWW-POSIM, y prepara el entorno ROS de la aplicación. Varios terminales de la aplicación comparten un único conector local.

En macOS aparecen una cabecera WWW-POSIM, el estado de preparación y un indicador del tiempo de conexión. Espera a ROS connected y a las versiones de ROS, Python y el conector. El indicador de comandos WWW-POSIM, en color, identifica el entorno preparado.

La opción para abrir VS Code abre esa misma carpeta y ros_vehicle_command.py en un terminal ROS preparado. Sigue Controlar un espacio de trabajo local para ejecutar un controlador. La opción de RViz abre el visor instalado.

En modo Autopilot, las herramientas ROS solo proporcionan telemetría. ros_vehicle_command.py requiere Control directo ROS 2. Para cambiar de modo, desarma el vehículo, reutiliza un terreno preparado en la configuración, selecciona Control directo ROS 2 e inicia el mundo otra vez. El reinicio restablece la simulación. Un vehículo guardado conserva su modo de control; usa un vehículo integrado o edita una copia del guardado para cambiarlo.

El panel Control directo ROS 2 de la aplicación instalada también ofrece Abrir terminal ROS y Abrir en VS Code. Ambos usan la carpeta de trabajo elegida en la aplicación. En el sitio web, o si el iniciador local no está disponible, usa Guía del terminal ROS y VS Code. La guía se abre en otra ventana.

Conectar tu entorno ROS a un espacio de trabajo web

Inicia tu mundo personal en el sitio web. Instala ROS 2 Lyrical y los paquetes estándar de mensajes según la guía de instalación de ROS. En un terminal Ubuntu o WSL, carga ROS e instala el conector:

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

Introduce tu contraseña cuando se solicite y deja abierto el terminal. En otro terminal, carga el mismo entorno ROS y el mismo entorno virtual, y define las tres mismas variables de entorno. Un entorno virtual de Python por sí solo no incluye ROS ni rclpy.

Para usar el entorno incluido en la aplicación de Mac, sustituye el comando que carga ROS por:

eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"

Conectar tu entorno ROS a un espacio de trabajo local

Inicia la aplicación y un mundo. En el entorno ROS preparado, utiliza este comando en lugar de la conexión al sitio web:

www-posim-connect --local --server http://127.0.0.1:3300/api

El conector utiliza la sesión activa de la aplicación sin pedir credenciales del sitio web. Usa un conector por dominio ROS; no inicies además el conector gestionado por la aplicación en ese dominio. Si una distribución WSL independiente no puede acceder a la dirección de bucle local de la aplicación de Windows, abre el terminal ROS desde la aplicación.

Comprobar los temas y los datos en directo

Cuando el conector esté listo, ejecuta:

ros2 topic list
ros2 topic echo /model/wamv/odometry

Comprueba que siguen llegando mensajes y que sus marcas de tiempo avanzan. Pulsa Ctrl+C para detener la recepción. Para BlueROV2, elige su tema de odometría en la lista. Que un nombre aparezca en la lista no confirma que estén llegando datos.

Si no hay datos, comprueba que el mundo esté en ejecución y que ambos terminales utilicen el mismo entorno y dominio ROS. Consulta Solución de problemas de ROS, Controlar un espacio de trabajo web o Controlar un espacio de trabajo local.

Buscar en la documentación