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

Controlar un espacio de trabajo local

Abre el ejemplo ROS 2 preparado en VS Code y ejecuta una orden breve en tu simulación local.

Iniciar un mundo controlable

  1. Sigue Instalación e instala VS Code.
  2. Abre WWW-POSIM, accede con tu cuenta verificada y pulsa Iniciar simulador. En Windows y Ubuntu, inicia Docker primero.
  3. En Espacio de trabajo, elige un terreno listo, WAM-V y Control directo ROS 2.
  4. Inicia el mundo y espera al vehículo y a datos de posición recientes. Mantén abiertos aplicación y navegador.

La aplicación ejecuta la simulación; VS Code permite editar y ejecutar el programa de control.

Abrir el ejemplo preparado en VS Code

Abrir en VS Code abre la carpeta de trabajo y ros_vehicle_command.py. La carpeta inicial es Documents/WWW-POSIM. Crear proyecto Python añade ejemplos y configuración del editor sin sobrescribir archivos existentes. Al abrir VS Code también se añade el ejemplo de vehículo si falta. Puedes cambiar la carpeta en Ajustes locales → Carpeta de trabajo. Abrir carpeta de trabajo la muestra en el explorador de archivos.

Si VS Code lo solicita, confía en tu propio proyecto y permite la tarea automática WWW-POSIM: ROS terminal. Si no la permites, ejecútala desde Terminal → Ejecutar tarea → WWW-POSIM: ROS terminal. Los nuevos terminales integrados usan el perfil WWW-POSIM ROS. Espera a ROS connected. Abrir el archivo no ejecuta el ejemplo.

En macOS, terminal y depurador usan el Python de la aplicación con ROS preparado; no necesitas otro entorno virtual para este proyecto. En Windows y Ubuntu, los comandos se ejecutan en el contenedor de control preparado, mientras VS Code edita la carpeta compartida.

Instala las extensiones Python y Python Debugger de Microsoft. En Windows y Ubuntu, añade Dev Containers y usa Dev Containers: Reopen in Container para depurar dentro del contenedor. Abrir terminal ROS abre un terminal externo preparado en la misma carpeta.

Ejecutar el ejemplo ROS 2

Pulsa Activar ROS en el panel de control del mundo. En el terminal preparado, consulta las opciones y solicita un movimiento corto de WAM-V:

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

El ejemplo publica órdenes periódicas y envía valores neutros al terminar o al pulsar Ctrl+C. Espera a un suscriptor antes de ordenar movimiento. Limita cada ejecución a 30 segundos, WAM-V a 1 m/s y 0.5 rad/s, y BlueROV2 a 5 N por motor.

Para BlueROV2, empieza con seis valores neutros:

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

Comprueba el vehículo y su respuesta antes de aumentar la entrada. Las órdenes neutras no eliminan la inercia ni las fuerzas de las olas.

Usar la interfaz de sesión Python

El paquete también ofrece una interfaz de sesión Python. Guarda este código como controller.py y ejecuta python controller.py en el terminal preparado:

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

El programa lee una posición reciente, pide 0.3 m/s hacia delante durante dos segundos y libera el control. Las posiciones impresas no tienen por qué diferir una distancia exacta. Usa yaw_rate=0.1 para girar a la izquierda. El control de parada del navegador interrumpe el control inmediatamente.

Propulsores de BlueROV

La interfaz acepta seis valores de empuje BlueROV2, en newtons y en el orden nativo de las articulaciones. WAM-V usa dos: izquierdo y derecho. Empieza en neutro:

from www_posim_ros import Session

with Session.local(control=True) as sim:
    sim.set_thrusters([0.0] * 6, duration=1.0)
Límite de la interfaz Valor
Velocidad WAM-V Avance ±1.5 m/s; guiñada ±0.5 rad/s
Empuje WAM-V ±200 N por motor
Empuje BlueROV2 ±50 N por motor
Duración de las funciones auxiliares Mayor que 0; hasta 300 segundos
Vigilancia de órdenes 0.75 segundos sin una actualización válida

Estos límites difieren de los más reducidos del ejemplo ros_vehicle_command.py. Las funciones repiten órdenes a unos 10 Hz y después liberan el control. sim.stop() interrumpe la función activa desde otro hilo. La desconexión termina el control; las órdenes no se reanudan automáticamente después de un error de red.

Si el servidor confirma la liberación, cada función espera a que el empuje vuelva a cero y se ceda el control. Si aparece controller_busy, detén primero el otro controlador. El fin normal de la evaluación o el botón de parada pueden producir control_lease_ended. watchdog_timeout y simulation_or_sensor_unavailable indican un fallo.

Durante la evaluación de un reto, control_service_stalled indica que las llamadas nativas de control del servidor se detuvieron durante más de 0.75 segundos. La propulsión se detiene de forma segura y esa ejecución no obtiene una puntuación válida. Las entregas web conservan los resultados completados y reintentan automáticamente la evaluación interrumpida. En la práctica local, comprueba el simulador y vuelve a iniciar la ejecución.

Cargar una extensión en la aplicación instalada

Un espacio local de la aplicación instalada puede cargar una extensión ZIP world/model aprobada por su propietario. Los espacios alojados y las sesiones de evaluación no ejecutan código de extensiones.

  1. En la revisión final del espacio, abra User world/model extensions e Import extension ZIP. El archivo contiene extension.json, su punto de entrada SDF y los archivos declarados con sus hashes. La importación valida y guarda el archivo sin ejecutarlo.
  2. Revise Declared files and SDK: código, plataforma de destino, SHA-256 del ZIP y SHA-256 del SDK. El destino y el SDK deben coincidir con el motor en ejecución. El código tiene el acceso a archivos y red del entorno local de ejecución.
  3. Elija Approve code and select, confirme solo código de confianza e inicie el mundo. La aprobación corresponde al propietario y al par exacto ZIP/SDK; la selección se aplica a la nueva sesión. Clear selected extension conserva el archivo guardado.

Un SDK desconocido o una discrepancia de destino/hash impide la selección. Use una extensión compilada para el motor elegido y apruebe su archivo exacto. Los scripts generales sin un punto de entrada registrado como proveedor de navegación no se ejecutan. La aplicación administra el proceso del proveedor y lo detiene al terminar la sesión.

WAM-V y BlueROV2 comparten una interfaz con un único proveedor ROS de navegación activo. El proveedor del usuario seleccionado sustituye la salida del integrado y conserva el receptor GNSS bruto. Las salidas comunes son /vehicle/navigation/estimate (nav_msgs/Odometry) y /vehicle/navigation/status (JSON en std_msgs/String). La pose usa ENU en navigation_map; las velocidades usan FLU del cuerpo en base_link. Se requieren marcas de tiempo de simulación coincidentes, covarianza finita, identidad de sesión y un origen geográfico WGS 84.

En modo Autopilot, la pasarela común verifica las salidas antes de suministrar navegación externa a la FCU. Solo el GNSS bruto determina el estado de fijación GPS. Sin calibración, alineación global o datos válidos, el proveedor debe mantener su preparación en false. Importarlo o iniciarlo no establece la preparación de navegación. Véase GNSS y navegación para la selección de fuentes y las pérdidas de señal.

Actualizar el SDK

Desde la versión 0.4.2, el SDK comprueba en segundo plano si hay una versión estable y muestra en el terminal cómo instalarla. La evaluación oficial omite la comprobación. Para el SDK incluido, actualiza la aplicación y vuelve a abrir el terminal ROS. Para un contenedor de VS Code existente, cambia la imagen de .devcontainer/devcontainer.json por la indicada y reconstruye el contenedor. En un entorno Python propio, ejecuta el comando mostrado y reinicia Python. Para comprobarlo manualmente, ejecuta python -m www_posim_ros.updates.

Resolver problemas

Continúa con Terminales ROS y conexión, Controlar un espacio de trabajo web, Visualización con RViz y Foxglove o Solución de problemas de ROS.

Buscar en la documentación