POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Guide avanzate

Aggiungere un robot

Parti da un robot POSIM con struttura simile. L'SDF descrive meccanica e sistemi; la configurazione ROS collega misure e comandi.

Ambiente di lavoro

Usa i terminali Linux preparati su Ubuntu nativo, WSL o Docker. Su macOS lavora nel terminale del desktop RDP. Modifica e compila lì; POSIM_WS è il percorso del relativo spazio di lavoro.

1. Copiare un modello di riferimento

REXROV usa propulsori Gazebo. BlueROV2 integra ArduSub/MAVROS. Slocum mostra un'altra disposizione.

Da $POSIM_WS, copia interamente REXROV per mantenere insieme mesh, configurazione del bridge e nomi dei topic:

cd "$POSIM_WS"

Salva il programma seguente come copy_robot.py, poi esegui python3 copy_robot.py. Si ferma se my_robot esiste già.

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 struttura risultante comprende:

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 è l'identificativo scelto. L'avvio cerca description/<namespace>/model.sdf e la configurazione corrispondente.

2. Definire meccanica e risorse

Mantieni la meccanica copiata per il primo avvio. Quando modifichi lo scafo, controlla insieme:

Percorso SDF Unità Verifica
model/@name, nomi di link e giunti identificativo Corrispondenza con plugin e configurazione ROS
link/inertial/mass kg Massa positiva per ogni link mobile
link/inertial/pose m, rad Centro di massa e orientamento del riferimento d'inerzia
link/inertial/inertia/ixx, iyy, izz kg·m² Momenti rispetto ai suoi assi
link/inertial/inertia/ixy, ixz, iyz kg·m² Termini fuori diagonale; tensore completo fisicamente valido
link/visual, link/collision m, rad Scala e allineamento delle geometrie
joint/axis, impostazioni dei propulsori secondo il plugin Direzione degli attuatori e ripartizione delle forze

STL fornisce la geometria. Definisci massa e dinamica nell'SDF e controlla unità e scala della mesh. Segui gli URI installati degli esempi. Scegli forme di collisione semplici quando il dettaglio visivo rende inutilmente oneroso il calcolo dei contatti.

3. Collegare sistemi e ROS

Adatta idrodinamica, galleggiamento, assi dei propulsori e pose dei sensori al veicolo. I coefficienti devono rappresentarne le proprietà fisiche.

Consulta Correnti, Aggiungere sensori e i riferimenti dei plugin collegati. Per latitudine e longitudine, imposta l'origine con le coordinate sferiche.

Adatta config/<namespace>/robot_config.py: aggiorna insieme nomi di entità e giunti, topic, sistemi di riferimento e porte. Il pacchetto installa già description, meshes, config e le impostazioni dei percorsi delle risorse. Modifica i sorgenti, non i file generati in install/.

4. Compilare e provare

Dallo spazio di lavoro con l'ambiente caricato:

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

Prova ogni asse con comandi di piccola ampiezza e verifica anche l'avvio da fuori della directory sorgente:

In un altro terminale preparato, leggi il modello rinominato:

ros2 topic echo --no-daemon /model/my_robot/odometry nav_msgs/msg/Odometry --once

Dovresti ricevere posizione e velocità. Fai funzionare la copia, poi modifica la meccanica e infine sensori o propulsione. Confronta le prove con Dati dei sensori; per risorse mancanti, consulta la risoluzione dei problemi.