Einen Roboter hinzufügen
Verwenden Sie einen ähnlich aufgebauten POSIM-Roboter als Ausgangspunkt. SDF beschreibt Mechanik und Systeme; die ROS-Konfiguration verbindet Messungen und Befehle.
Arbeitsumgebung
Nutzen Sie die vorbereiteten Linux-Terminals unter nativem Ubuntu, WSL oder Docker. Auf macOS arbeiten Sie im Terminal des RDP-Desktops. Bearbeiten und bauen Sie dort; POSIM_WS ist der Pfad dieses Arbeitsbereichs.
1. Referenzmodell kopieren
REXROV verwendet Gazebo-Thruster. BlueROV2 bindet ArduSub/MAVROS ein. Slocum zeigt einen weiteren Fahrzeugaufbau.
Kopieren Sie REXROV ausgehend von $POSIM_WS vollständig, damit Meshes, Bridge-Konfiguration und Topic-Namen zusammenbleiben:
cd "$POSIM_WS"
Speichern Sie das folgende Programm als copy_robot.py und führen Sie python3 copy_robot.py aus. Existiert my_robot bereits, bricht es ab.
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'))
Die erzeugte Struktur enthält:
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 ist die gewählte Kennung. Der Start sucht description/<namespace>/model.sdf und die passende Konfiguration.
2. Mechanik und Ressourcen festlegen
Behalten Sie die kopierte Mechanik beim ersten Start bei. Prüfen Sie bei Rumpfänderungen gemeinsam:
| SDF-Pfad | Einheit | Prüfung |
|---|---|---|
model/@name, Link- und Gelenknamen |
Kennung | Übereinstimmung mit Plugins und ROS-Konfiguration |
link/inertial/mass |
kg | Positive Masse jedes beweglichen Links |
link/inertial/pose |
m, rad | Schwerpunkt und Orientierung des Trägheitsrahmens |
link/inertial/inertia/ixx, iyy, izz |
kg·m² | Momente um dessen Achsen |
link/inertial/inertia/ixy, ixz, iyz |
kg·m² | Nebendiagonalelemente; physikalisch gültiger Gesamttensor |
link/visual, link/collision |
m, rad | Maßstab und Ausrichtung beider Geometrien |
joint/axis, Thruster-Einstellungen |
pluginspezifisch | Antriebsrichtung und Kraftverteilung |
STL liefert Geometrie. Masse und Dynamik gehören in die SDF; prüfen Sie Mesh-Einheiten und Maßstab. Folgen Sie den installierten Ressourcen-URIs der Beispiele. Vereinfachen Sie die Kollisionsform, wenn visuelle Details die Kontaktberechnung unnötig aufwendig machen.
3. Systeme und ROS verbinden
Passen Sie Hydrodynamik, Auftrieb, Schubachsen und Sensorposen an das Fahrzeug an. Die Koeffizienten müssen zu seinen physikalischen Eigenschaften passen.
Verwenden Sie Strömungen, Sensoren hinzufügen und die dort verlinkten Plugin-Referenzen. Für Breiten- und Längengrade legen Sie den Ursprung über sphärische Koordinaten fest.
Passen Sie config/<namespace>/robot_config.py an: Ändern Sie Entitäts- und Gelenknamen, Topics, Koordinatenrahmen und Ports gemeinsam. Das Paket installiert bereits description, meshes, config und die Ressourcenpfade. Bearbeiten Sie Quellen, keine erzeugten Dateien unter install/.
4. Bauen und ausprobieren
Im Arbeitsbereich mit geladener Umgebung:
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
Prüfen Sie jede Achse mit kleinen Befehlen und starten Sie auch einmal außerhalb des Quellverzeichnisses:
- Installierte Ressourcenpfade.
- Masse, Trägheit und Gleichgewichtslage.
- Kollisionsgeometrie und Kontaktverhalten.
- Koordinatenrahmen und Nachrichteninhalte.
Fragen Sie das umbenannte Modell in einem weiteren vorbereiteten Terminal ab:
ros2 topic echo --no-daemon /model/my_robot/odometry nav_msgs/msg/Odometry --once
Sie sollten Position und Geschwindigkeit empfangen. Bringen Sie zuerst die Kopie zum Laufen, ändern Sie danach die Mechanik und anschließend Sensoren oder Antrieb. Vergleichen Sie Versuche über Sensordaten; fehlende Ressourcen behandelt die Fehlerbehebung.