POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Referencias y proyecto

Solución de problemas

Empieza por el primer error del registro de lanzamiento. Revisa, en este orden, el entorno, los recursos del modelo, el tiempo de simulación, los plugins y la recepción de datos. Conserva el error y las líneas cercanas que permitan reproducirlo.

No se encuentra un paquete

printf 'ROS_DISTRO=%s\n' "$ROS_DISTRO"
ros2 pkg prefix posim_demos

El resultado debe indicar lyrical y la ruta del espacio de trabajo elegido. Prepara el terminal según tu método de instalación y distingue las rutas del equipo de las del contenedor.

Faltan modelos o mallas

Busca la primera URI que no se puede resolver. Comprueba que se hayan instalado los recursos del paquete y cargado el entorno correcto. Gazebo necesita acceso a la red para descargar recursos de Fuel. La primera descarga puede tardar: comprueba su progreso antes de iniciar otra simulación.

No hay imagen o falla el renderizado

Revisa controladores y conexión de pantalla en la guía de instalación. Gazebo y las cámaras necesitan renderizado. Para el sonar, comprueba el motor elegido y los paquetes instalados.

Para los efectos de la escena submarina, comprueba:

El GNSS no obtiene una solución

Consulta el estado de validez del GNSS, la altura de la antena en el sistema de coordenadas del mundo, la altura local del agua y la marca de tiempo de adquisición. Comprueba las coordenadas esféricas del mundo, que la antena esté fuera del agua y sin obstrucciones, y que transcurra suficiente tiempo de simulación para la readquisición y la latencia.

Si usas un tópico de olas, verifica que entregue muestras locales compatibles y recientes. Instalar el receptor no lo añade al modelo ni proporciona un adaptador ROS o de autopiloto.

No llegan mensajes

Confirma primero que avance el tiempo y descubre el tópico y su tipo:

gz topic -l
ros2 topic list -t
ros2 topic info /underwater_camera/simulated_image --verbose

Usa el transporte correcto, el mismo entorno preparado y ajustes compatibles de QoS y dominio. Revisa errores del puente y del plugin. En el lanzamiento de sensores, namespace debe identificar un descriptor existente. El USBL ya está incorporado en su mundo de ejemplo y se inicia con el lanzamiento del mundo.

Aparecen los tópicos de imagen, pero no llegan fotogramas

Si Gazebo genera imágenes y ROS descubre el publicador, pero llegan pocos fotogramas o ninguno, revisa el transporte DDS. Los datagramas UDP grandes de Cyclone DDS pueden alcanzar límites de fragmentación IP. Reducir su tamaño puede ayudar en redes con MTU de 1500 bytes; consulta la configuración de fragmentación de Cyclone DDS.

Preparar el perfil

Con rmw_cyclonedds_cpp instalado, crea este perfil una vez. Si ya tienes un perfil Cyclone DDS, incorpora los dos tamaños a su sección General y conserva la configuración de descubrimiento e interfaces.

mkdir -p "$HOME/.config/posim"
cat > "$HOME/.config/posim/cyclonedds-images.xml" <<'XML'
<CycloneDDS xmlns="https://cdds.io/config">
  <Domain Id="any">
    <General>
      <MaxMessageSize>1400B</MaxMessageSize>
      <FragmentSize>1280B</FragmentSize>
    </General>
  </Domain>
</CycloneDDS>
XML

Reiniciar con la misma configuración

Detén la simulación y los visores. Carga el entorno POSIM y selecciona el perfil en cada terminal antes de reiniciarlos. Si modificaste un perfil existente, usa su ruta.

export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export CYCLONEDDS_URI="file://$HOME/.config/posim/cyclonedds-images.xml"

Si ya hay un daemon de la CLI de ROS en ese dominio, detenlo una vez para que las siguientes consultas utilicen la nueva configuración:

ros2 daemon stop

Repite las comprobaciones de imagen y frecuencia, incluidas las marcas de tiempo de adquisición. Los paquetes pequeños añaden sobrecarga; una MTU inferior requiere tamaños todavía menores.

El vehículo no se mueve

Comprueba el estado del controlador, el armado, la validez de navegación, la recepción de órdenes y el modo seleccionado. Revisa nombres de articulaciones y ejes de propulsores. Mantén una sola fuente de órdenes activa. Una entrada neutra, el mundo en pausa o el autopiloto desarmado pueden explicar que el vehículo permanezca quieto.

La simulación no termina

Detén los visores, pulsa Ctrl+C una vez en el terminal de lanzamiento y espera a que terminen los procesos. Conserva los mensajes relevantes de aborto, fallo de segmentación o terminación forzada. Al informar del problema, incluye comando, revisión, sistema operativo, arquitectura y renderizador.

RViz falla al pulsar Discard

El instalador de POSIM para Ubuntu/WSL y las imágenes Docker AMD64/ARM64 incluyen un overlay aislado de RViz para RViz 15.2.6. Detiene el temporizador de actualización al confirmar el cierre y libera los recursos ROS de las vistas durante la salida. Al elegir Cancel, las actualizaciones continúan. Los paquetes RViz del sistema no se modifican. Tras cargar el entorno de POSIM, ros2 pkg prefix rviz_common debería mostrar /opt/posim/rviz-close/install. Para instalaciones anteriores, sigue las instrucciones de compilación y activación del enlace.

Sin el overlay, RViz 15.2.6 en Ubuntu 26.04 puede fallar de forma intermitente al cerrar la ventana y elegir Discard, aunque la visualización de sensores funcione. El overlay corrige problemas concretos del temporizador y de la liberación de recursos, pero no cubre todos los renderizadores ni todas las rutas de cierre. Si el problema persiste, indica la versión de RViz, las rutas de las bibliotecas cargadas y la acción de cierre en el informe.

Si RViz sigue ejecutándose tras cerrar su ventana, puede consumir demasiada memoria, especialmente con renderizado por software. Antes de volver a iniciar la simulación, pulsa Ctrl+C en el terminal de lanzamiento para detener los procesos restantes. Si RViz no se cierra normalmente, ROS launch fuerza su terminación. Para ejecutar el sonar sin el visor, añade rviz:=false al comando multibeam_sonar_demo.launch.py. Las imágenes siguen disponibles en ROS.

Recrear cámaras de profundidad en un SDK nativo de macOS

Para el SDK macOS arm64 / Ogre-Next 2.3.3, el entorno Ogre aislado incorpora la corrección del ciclo de vida de materiales necesaria al destruir y recrear cámaras de profundidad.

Sigue las comprobaciones exactas de SDK y código fuente, compila con el asistente y pasa el comando de Gazebo a run_overlay.py. Compilar no selecciona automáticamente esa biblioteca. Verifica las rutas cargadas y conserva el resultado de validación. El instalador normal no activa este entorno; no sustituye bibliotecas del sistema ni configura contenedores Linux. Otras versiones y plataformas necesitan un perfil compatible propio.

Preparar un informe reproducible

Incluye el SHA del código o digest de la imagen, versiones de dependencias, comando y argumentos, primer error, resultado esperado, tipos de tópicos pertinentes y un ejemplo mínimo. Distingue entre descubrir un tópico y recibir datos por él.

MAVROS 2.16.0 termina con SIGSEGV

El instalador de POSIM y las compilaciones oficiales de Docker incluyen la corrección del ciclo de vida del Router para MAVROS 2.16.0. Tras cargar el entorno de POSIM, ros2 pkg prefix mavros debe mostrar /opt/posim/mavros-router/install. Para una instalación existente, sigue las instrucciones de compilación independiente del enlace. Si el fallo persiste, adjunta al informe el registro de MAVROS y las rutas de las bibliotecas que se han cargado.

QGC se abre en Windows, pero POSIM se ejecuta en WSL

Cierra la aplicación de Windows y abre la versión de Linux de QGC en la misma distribución Ubuntu que POSIM o dentro del contenedor POSIM. Una ventana de WSLg aparece en el escritorio de Windows, pero sigue siendo un proceso de Linux. La configuración de QGC mantiene la telemetría y el vídeo dentro de ese entorno.