Añadir un robot
Parte de un robot POSIM con una distribución parecida. El SDF describe la mecánica y los sistemas; la configuración ROS conecta medidas y comandos.
Entorno de trabajo
Usa las terminales Linux preparadas en Ubuntu nativo, WSL o Docker. En macOS, trabaja en la terminal del escritorio RDP. Edita y compila allí; POSIM_WS es la ruta de ese espacio de trabajo.
1. Copiar un modelo de referencia
REXROV usa propulsores Gazebo. BlueROV2 integra ArduSub/MAVROS. Slocum muestra otra disposición.
Desde $POSIM_WS, crea una copia completa de REXROV para conservar mallas, configuración del puente y nombres de tópicos:
cd "$POSIM_WS"
Guarda el siguiente programa como copy_robot.py y ejecuta python3 copy_robot.py. Se detiene si ya existe my_robot.
from pathlib import Path
import shutil
root = Path('src/posim/models/posim_robot_models')
directories = ('description', 'config', 'meshes')
if any((root / directory / 'my_robot').exists() for directory in directories):
raise SystemExit('my_robot already exists; choose another model name.')
for directory in directories:
shutil.copytree(root / directory / 'rexrov', root / directory / 'my_robot')
for relative in ('description/my_robot/model.sdf',
'description/my_robot/model.config',
'config/my_robot/robot_config.py'):
target = root / relative
target.write_text(target.read_text().replace('rexrov', 'my_robot'))
La estructura resultante incluye:
models/posim_robot_models/
description/my_robot/model.sdf
description/my_robot/model.config
meshes/my_robot/RexROV_no_props.dae
config/my_robot/robot_config.py
my_robot es el identificador elegido. El lanzamiento busca description/<namespace>/model.sdf y su configuración correspondiente.
2. Definir mecánica y recursos
Conserva la mecánica copiada para el primer lanzamiento. Al modificar el casco, revisa en conjunto:
| Ruta SDF | Unidad | Comprobación |
|---|---|---|
model/@name, nombres de eslabones y articulaciones |
identificador | Coincidir con plugins y configuración ROS |
link/inertial/mass |
kg | Masa positiva de cada eslabón móvil |
link/inertial/pose |
m, rad | Centro de masa y orientación del sistema de inercia |
link/inertial/inertia/ixx, iyy, izz |
kg·m² | Momentos respecto a sus ejes |
link/inertial/inertia/ixy, ixz, iyz |
kg·m² | Términos cruzados; tensor completo físicamente válido |
link/visual, link/collision |
m, rad | Escala y alineación de geometrías |
joint/axis, ajustes de propulsores |
según el plugin | Dirección del actuador y distribución de fuerzas |
STL aporta geometría. Define masa y dinámica en SDF y comprueba unidades y escala de la malla. Sigue las URI instaladas de los ejemplos existentes. Usa una geometría de colisión sencilla si el detalle visual encarece innecesariamente el cálculo de contactos.
3. Conectar sistemas y ROS
Adapta hidrodinámica, flotabilidad, ejes de propulsión y poses de sensores al vehículo. Los coeficientes deben representar sus propiedades físicas.
Consulta Corrientes, Añadir sensores y las referencias de cada plugin. Si necesitas latitud y longitud, configura el origen con Coordenadas esféricas.
Adapta config/<namespace>/robot_config.py: cambia de forma coherente nombres de entidades y articulaciones, tópicos, sistemas de referencia y puertos. El paquete ya instala description, meshes, config y los ajustes de búsqueda de recursos. Edita los archivos fuente, no los archivos generados en install/.
4. Compilar y probar
Desde el espacio de trabajo con su entorno cargado:
colcon build --merge-install --executor sequential --symlink-install
source install/setup.bash
ros2 launch posim_demos posim_robot.launch.py --show-args
ros2 launch posim_demos posim_robot.launch.py \
namespace:=my_robot world_name:=posim_ocean_waves z:=-2 paused:=false \
gui:=true headless:=false use_teleop:=false use_web_joystick:=false
Prueba cada eje con comandos de pequeña magnitud. Comprueba también el lanzamiento desde fuera del repositorio:
- Rutas de recursos instalados.
- Masa, inercia y pose de equilibrio.
- Geometría de colisión y respuesta al contacto.
- Sistemas de referencia y contenido de mensajes.
En otra terminal preparada, consulta el modelo renombrado:
ros2 topic echo --no-daemon /model/my_robot/odometry nav_msgs/msg/Odometry --once
Debes recibir posición y velocidad. Primero haz funcionar la copia, después cambia la mecánica y finalmente sensores o propulsión. Compara ejecuciones con Datos de sensores y consulta Solución de problemas si faltan recursos.