Anleitung zum einfachen Einstieg in ROS2: Unterschied zwischen den Versionen

Aus HSHL Mechatronik
Zur Navigation springen Zur Suche springen
 
(144 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
[[Kategorie:Projekte]]  
[[Kategorie:Projekte]]  
<!-- Kopieren Sie diesen Header in Ihren Artikel, damit er aufgelistet wird. 
 
[[Datei:Speedy.jpg|mini|200px|Abb. 1: Speedy das Tempomessgerät]]-->
[[Datei:Csm_ROS2_de25589e21.png|right|mini|500px|Abb.1: ROS 2<nowiki></nowiki>]]
'''Autor:''' Marius Küpper<br/>
 
 
'''Autor:''' [[Benutzer:Marius_Kuepper| Marius Küpper]]<br/>
'''Art:''' Projektarbeit<br>
'''Art:''' Projektarbeit<br>
'''Dauer:''' April - September 2022<br>
'''Dauer:''' April - September 2022<br>
Zeile 9: Zeile 11:


== Thema ==
== Thema ==
 
Das Unternehmen '''Hanning Elektro-Werke GmbH & Co. KG''' hat der Hochschule Hamm-Lippstadt ein Fahrerloses Transportfahrzeug '''(FTF)''', sowie eine Simulation von diesem zu Forschungszwecken zur Verfügung gestellt. Diese Projektarbeit soll als Anleitung dienen die Simulation in Betrieb zu nehmen und auf dem Weg dahin das verwendete Robot Operating System 2 '''(ROS2)''' zu vermitteln. Es wird unter anderem erklärt, wie Sie dazu eine virtuelle Maschine '''(VM)''' nutzen können, das Linux-Betriebssystem installieren, an das benötigte Repository kommen, '''ROS2''' und alle anderen benötigten Programme und Pakete installieren, die Simulation des '''FTF''' starten und sich darin zurechtfinden und arbeiten können.


== Aufgabenstellung ==
== Aufgabenstellung ==
Zeile 17: Zeile 19:
* Optimierung des Artikels
* Optimierung des Artikels
* optional: Bereitstellung von Demoprogrammen zum einfachen Einstieg
* optional: Bereitstellung von Demoprogrammen zum einfachen Einstieg
 
<br clear = all>
 
 
 
 
 
 
== Anforderungen an die Projektarbeit ==
== Anforderungen an die Projektarbeit ==
* Wissenschaftliche Vorgehensweise (Projektplan, etc.), nützlicher Artikel: [[Gantt-Diagramm| Gantt Diagramm erstellen]]
* Wissenschaftliche Vorgehensweise (Projektplan, etc.), nützlicher Artikel: [[Gantt-Diagramm| Gantt Diagramm erstellen]]
Zeile 31: Zeile 27:
*[[Anforderungen_an_eine_wissenschaftlich_Arbeit| Anforderungen an eine wissenschaftlich Arbeit]]
*[[Anforderungen_an_eine_wissenschaftlich_Arbeit| Anforderungen an eine wissenschaftlich Arbeit]]
*[[Software_Versionsverwaltung_mit_SVN|Regeln zum Umgang mit SVN]]
*[[Software_Versionsverwaltung_mit_SVN|Regeln zum Umgang mit SVN]]
 
<br clear = all>
== Projektplan ==
==Projektplan==
Nützlicher Artikel: [[Gantt-Diagramm| Gantt Diagramm erstellen]]
[[Datei:MK-Projektplan_neu.png|900px|thumb|left|Abb.2: Projektplan<nowiki></nowiki>]]
[[Datei:Projektplan MariusKüpper.png|rahmenlos|rechts]]
<br clear = all>
 
 
 
 
 
 
 
 
== Anforderungen ==
== Anforderungen ==
=== Hardwareanforderungen ===
=== Hardwareanforderungen ===
* PC i5 ...
'''[https://www.virtualbox.org/wiki/End-user_documentation VirtualBox]:'''
*'''Prozessor:''' aktuellere AMD- oder Intel-Prozessoren sind ausreichend. <br>
*'''Arbeitsspeicher:''' 8 GB Minimum, aber je mehr, desto besser. <br>
*'''Festplattenspeicherplatz:''' Für die Installation werden nur etwa 30 MB benötigt. Für das Gastbetriebssystem wird allerdings deutlich mehr Speicherplatz benötigt. Sie sollten mindestens 20-30 GB einplanen, je nachdem was Sie vorhaben zu installieren. <br>
'''[https://www.cyberbotics.com/doc/guide/system-requirements?version=develop WeBots]:'''
*'''Prozessor:''' Aktuellere AMD- oder Intel-Prozessoren sind ausreichend. Eine CPU mit vier Kernen wird empfohlen. <br>
*'''Grafikkarte/ -chip:''' Eine NVIDIA oder AMD [https://support.esri.com/de/technical-article/000011375 OpenGL-fähige] (Minimum Version 3.3) Grafikkarte mit mindestens 512 MB Grafikspeicher ist erforderlich. <br>
 
=== Softwareanforderungen ===
=== Softwareanforderungen ===
* [https://download.virtualbox.org/virtualbox/6.1.36/VirtualBox-6.1.36-152435-Win.exe VirtualBox-6.1.36.exe]
* [https://www.virtualbox.org/ VirtualBox] '''(Version 6.1.36!)'''
 
* [https://docs.ros.org/ ROS2]
 
* [https://tortoisesvn.net/ TortoiseSVN]
 
* [https://cyberbotics.com/doc/guide/installation-procedure#installing-the-debian-package-with-the-advanced-packaging-tool-apt WeBots]
== Installation der virtuellen Maschine VirtualBox ==
 
* 1. Download der Software
  Direkter Download: [https://download.virtualbox.org/virtualbox/6.1.36/VirtualBox-6.1.36-152435-Win.exe VirtualBox-6.1.36.exe]
* 2. Nach dem Download das Setup ausführen und abschließen.
* 3. Wenn möglich, Virtualization oder SVM im BIOS aktivieren. (Befindet sich im BIOS unter den CPU-Einstellungen. Dies sorgt dafür, dass man Virtualbox später mehr Ressourcen zuweisen kann.)
* 4. Download des Betriebssystems.
  Direkter Download : [https://releases.ubuntu.com/20.04/ubuntu-20.04.4-desktop-amd64.iso Ubuntu 20.04.4 LTS]
  Direkter Download : [https://releases.ubuntu.com/22.04.1/ubuntu-22.04.1-desktop-amd64.iso?_ga=2.104294080.1746881759.1661265452-1939419577.1661265452 Ubuntu 22.04.1 LTS] '''(Empfohlen!)'''
 
<gallery mode="slideshow" caption="Installationsablauf und Einrichtung von VirtualBox" style="max-width:1000px">
MK-1.png|Schritt 1: Beginnen Sie die Installation von Ubuntu, indem Sie oben auf die Schaltfläche ("Neu") mit dem blauen Stern drücken. 
MK-2.png|Schritt 2: Nach Eingabe des Installationspfades und dem Namen des Betriebssystems werden die Felder "Typ" und "Version" automatisch ergänzt.
MK-3.png|Schritt 3: Im nächsten Schritt entscheiden Sie, wie viel Arbeitsspeicher Sie der virtuellen Maschine zuweisen. Sie sollten den Schieber in jedem Falle im "grünen Bereich" lassen, da es sonst möglicherweise zu Leistungseinbußen Ihres Computers kommen könnte.
MK-4.png|Schritt 4: "Festplatte erzeugen" übernehmen.
MK-5.png|Schritt 5: "VDI (VirtualBox Disk Image)" übernehmen.
MK-6.png|Schritt 6: "dynamisch alloziert" übernehemen. Die virtuelle Maschine verwendet somit nur den Platz, den sie benötigt. Im nächsten Schritt wird also nur die maximale nutzbare Größe ausgewählt.
MK-7.png|Schritt 7: Hier wählen Sie den Ordner, in dem Dateien von Ubuntu gespeichert werden. Außerdem wählen Sie die Größe der virtuellen Festplatte aus. Ubuntu benötigt für die ausschließliche Verwendung von ROS2 nur sehr wenig Speicherplatz. 10 GB - 20 GB sind ausreichend.
MK-8.png|Schritt 8: Nach erfolgreichem Erstellen der virtuellen Maschine werden jetzt noch die Einstellungen dieser verändert um Ubuntu starten zu können. Dazu klicken Sie oben auf die Schaltfläche ("Ändern") mit dem orangen Zahnrad.
MK-9.png|Schritt 9: Im Pfad "Allgemein", unter dem Reiter "Erweitert" wählen Sie nun bei "Gemeinsame Zwischenablage, sowie "Drag'n'Drop" die Option "bidirektional" aus. Dadurch haben Sie die Möglichkeit zwischen Ihrer virtuellen Maschine, auf der Ubuntu läuft und Ihrem primären Betriebssystem Dateien und alle Inhalte der Zwischenablage zu teilen.
MK-10.png|Schritt 10: Gehen Sie nun auf den Pfad "Massenspeicher", klicken Sie unter "Controller: IDE" auf die blaue CD mit der Beschriftung "leer". Wählen Sie nun unter "Attribute" die blaue CD am rechten Rand des Fensters aus und klicken auf den 2. Punkt "Abbild auswählen...".
MK-11.png|Schritt 11: In dem neu geöffneten Fenster wählen Sie die zuvor heruntergeladene iso-Datei (Ubuntu-Betriebssystem) aus und klicken auf "Öffnen".
MK-12.png|Schritt 12: Nun können Sie die virtuelle Maschine zum ersten Mal starten. Dazu drücken Sie am oberen Rand des Fensters auf den grünen Pfeil "Starten".
MK-13.png|Schritt 13: Nach einer kurzen Ladezeit erscheint das Installationsinterface von Ubuntu. Wählen Sie zunächst Ihre bevorzugte Sprache aus und drücken auf "Ubuntu installieren".
MK-14.png|Schritt 14: Wählen Sie jetzt die zu Ihrer Tastatur passende Tastaturbelegung aus und führen die Installation mit einem Mausklick auf den rechten unteren Button "Weiter" fort.
MK-15.png|Schritt 15: In diesem Fenster wählen Sie die für Sie passende Einstellung aus und drücken auf "Weiter".
MK-16.png|Schritt 16: Wählen Sie in diesem Schritt unbedingt die obere Option aus! Es werden keine Daten auf Ihrer Festplatte gelöscht, da Ubuntu durch VirtualBox nur Zugriff auf die zuvor erzeugte virtuelle Festplatte hat.
MK-17.png|Schritt 17: "Weiter".
MK-18.png|Schritt 18: Wählen Sie hier Ihre zutreffende Zeitzone aus.
MK-19.png|Schritt 19: Geben Sie nun Ihre Daten und Ihr persönliches Passwort ein. Das automatisch erzeugte "-VirtualBox" bei der zweiten Leerzelle können Sie nach belieben löschen.
MK-20.png|Schritt 20: Nach Beendigung der Installation können Sie die virtuelle Maschine neu starten.
MK-21.png|Schritt 21: Drücken Sie nun Enter auf Ihrer Tastatur.
MK-22.png|Schritt 22: Geben Sie ihr zuvor vergebenes Passwort ein und drücken Sie Enter.
MK-23.png|Schritt 23: Geschafft! ...naja, fast. Wie Sie eventuell bemerkt haben, lässt sich das Fenster der virtuellen Maschine zwar vergrößern, allerdings bleibt der Desktop auf der ursprünglichen Größe. In den folgenden Schritten werden Sie dies korrigieren.
MK-24.png|Schritt 24: Öffnen Sie das Terminal. Das Terminal können Sie über die Suchfunktion in den Anwendungen öffnen, welche sich in der linken unteren Ecke des Bildschirms befinden.
MK-25.png|Schritt 25: Geben Sie nun folgenden Befehl ein und bestätigen Sie mit Enter: sudo apt install build-essential dkms linux-headers-$(uname -r)
MK-25.png|Schritt 26: Geben Sie Ihr zuvor vergebenes Passwort ein und bestätigen Sie mit Enter. Das Passwort ist bei der Eingabe nicht sichtbar!
MK-26.png|Schritt 27: Drücken Sie zur Bestätigung "J" und danach Enter.
MK-27.png|Schritt 28: Wählen Sie nun unter dem Reiter "Geräte" den Punkt "Gasterweiterungen einlegen..." aus.
MK-28.png|Schritt 29: In dem neu geöffneten Fenster klicken Sie auf "Ausführen".
MK-29.png|Schritt 30: Nach Beendigung der Installation von Guest Additions drücken Sie zum Abschluss die Enter-Taste.
MK-30.png|Schritt 31: Nun Schalten Sie die virtuelle Maschine über den Button am rechten oberen Bildschirmrand aus.
MK-31.png|Schritt 31: Wenn Sie das nächste Mal Ihre virtuelle Maschine starten sind Sie in der Lage das Fenster zu vergrößern, sowie die in Schritt 9 erklärten Funktionen zu nutzen.
</gallery>
 
== ROS2 in Ubuntu einbinden ==
 
Die aktuelle Version von ROS2 (Humble Hawksbill) wird über das Terminal von Ubuntu installiert.
 
> Alle Eingaben für das Terminal befinden sich als Copy&Paste in diesen grauen Feldern <
 
 
Zunächst muss die ROS2 apt Repository zum System hinzugefügt werden. Dazu autorisieren wir unseren GPG Schlüssel mit apt:
 
sudo apt update && sudo apt install curl gnupg lsb-release
 
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
 
 
Danach fügen Sie die Repository zur Liste Ihrer sources:
 
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(source /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
 
 
Updaten Sie den Cache Ihrer apt Repository:
 
sudo apt update
 
 
Zur Sicherheit überprüfen wir noch, ob Ubuntu auf dem neusten Stand ist:
 
sudo apt upgrade
 
 
'''Im Fall von Ubuntu 22.04:'''
 
Installation der Vollversion von '''ROS2 Humble für Desktop-PCs''': <code>sudo apt install ros-humble-desktop</code> '''ODER:''' Installation der Basis-Version von '''ROS2 Humble für Raspberrys etc.''': <code>sudo apt install ros-humble-ros-base</code>
 
 
'''Im Fall von Ubuntu 20.04:'''
 
Installation der Vollversion von '''ROS2 Galactic für Desktop-PCs''': <code>sudo apt install ros-galactic-desktop</code> '''ODER:''' Installation der Basis-Version von '''ROS2 Galactic für Raspberrys etc.''': <code>sudo apt install ros-galactic-ros-base</code>
 
 
Nach der abgeschlossenen Installation muss nun das Environment eingerichtet werden, damit die ROS2-Befehle im Terminal auch verwendet werden können. Wir erweitern dazu die Befehlsliste des Terminals, um somit nicht jedes mal den selben Befehl eingeben zu müssen, wenn wir das Terminal öffnen. Geben Sie den folgenden Befehl ins Terminal ein um die .bashrc zu öffnen:
 
gedit ~/.bashrc
 
 
Nun fügen Sie unter die letzte Zeile des Dokuments zwei neue Zeilen ein und geben in die letzte Zeile (Z.119) folgenden Befehl ein:
 
 
'''Im Fall von Ubuntu 22.04 (Humble):'''
source /opt/ros/humble/setup.bash
 
'''Im Fall von Ubuntu 20.04 (Galactic):'''
source /opt/ros/galactic/setup.bash
 
[[Datei:Bashrc.png|mini|links|alternativtext=bashrc]]
 
 
 
 
 
 
 


== [[Installation der virtuellen Maschine VirtualBox|Installation der virtuellen Maschine VirtualBox]] ==
== [[ROS2 in Ubuntu einbinden|ROS2 in Ubuntu einbinden]] ==
== [[SVN-Repository in Linux erstellen|SVN-Repository in Linux erstellen]] ==
== [[Inbetriebnahme unserer WeBots-Simulation|Inbetriebnahme unserer WeBots-Simulation]] ==
== [[Der Umgang mit ROS2|Der Umgang mit ROS2]] ==
== [[Steuerung des FTF in der Simulation|Steuerung des FTF in der Simulation]] ==
== [[Knoten, Nachrichten und Beziehungen|Knoten, Nachrichten und Beziehungen]] ==
== [[Mögliche Alternativen|Mögliche Alternativen]] ==




== Evaluation anderer Studierender ==


=== Evaluationen ===


'''"'''Nach der Installation der richtigen Version von VirtualBox konnte ich der Anleitung gut folgen und habe besonders durch die Bilder einfach durch den Installationsprozess gefunden. Die Befehle in den grauen Kästen haben am Ende immer zum gewünschten Ziel geführt. Mir war manchmal nicht klar, welche Version von ROS ich installieren sollte, wenn man die Wahl hatte, zwischen Galactic oder Humble. Da würde ich mir eine bessere Erklärung wünschen. Im Github konnte ich mir den Roboter Epuk herunterladen und mit Hilfe der Anleitung auch steuern. Ohne einmal mit Ubuntu gearbeitet zu haben, konnte ich nach kurzer Zeit und ein bisschen Probieren eine Simulation starten und ein paar Funktionen ausprobieren.'''"'''
Aykut Ersoy, studiert WING an der HSHL im 7. Semester


'''"'''Im Allgemeinen eine gut und detailierte Anleitung für die Einrichtung einer virtuellen Maschine mit ROS2. Der Step by Step Guide hilft immer mit passenden Bildern, um schnell durch die Installation zu finden. Ein Nachteil der VM ist die schlechte Skalierung der Fenster und dadurch halb verdeckte „Akzeptieren“ Felder. Dieses Problem wird jedoch, sobald es möglich ist mit Hilfe der Anleitung gelöst. Die Einbindung in ROS2 klappte danach problemlos. Leider musste ich mich einer Alternative zu Webots bedienen, die sich durch das passende Grundgerüst, leicht mit kleinen Modifikationen installieren und ausführen ließ. Hier hilft es im Zweifelsfall die VM als Administrator zu starten.'''"'''
Marten Eilers, studiert INFO/ MATH an der RWTH Aachen


 
=== Optimierung des Artikels aufgrund der Evaluationen: ===
 
*Kompatible VirtualBox-Version besser gekennzeichnet
 
*ROS2-Version besser gekennzeichnet
 
*Problem mit verdeckten Fenstern erläutert
 
*VM als Administrator ausführen hinzugefügt
 
== SVN-Repository in Linux erstellen ==
 
Um die Befehle für die Erstellung einer SVN-Repository zu nutzen muss zunächst das entsprechende Paket installiert werden:
 
sudo apt install subversion
 
Mit der Einagbe <code>svn help checkout</code> kann man sich nun eine Hilfestellung anzeigen lassen, wie man sich eine Kopie der Repository auf Ubuntu lädt.
 
Zunächst sollten Sie sich einen Ordner anlegen, in den die Repository abgelegt wird.
In diesem Fall wird der Ordner im persönlichen Benutzerordner erstellt.
 
cd
 
mkdir svn
 
Nach anlegen des Ordners "svn" kann nach folgendem Schema die Repository in den zuvor erstellten Ordner abgelegt werden: <code>svn checkout "SVN Checkout URL" home/"Benutzer"/svn</code>
 
 
'''Beispiel:'''
svn checkout https://svn-test.hshl.de/svn/Robotik_und_Autonome-Systeme/ /home/hshl/SVN
 
 
== Inbetriebnahme der WeBots-Simulation von Hanning ==
 
Installation der benötigten Pakete, Environments und Repositorys:
 
sudo apt install python3-serial
 
install python3-colcon-common-extensions
 
sudo apt install ros-${ROS_DISTRO}-navigation2 ros-${ROS_DISTRO}-nav2-bringup '~ros-${ROS_DISTRO}-turtlebot3-.*' ros-${ROS_DISTRO}-laser-geometry ros-${ROS_DISTRO}-webots-ros2
 
wget -qO- https://cyberbotics.com/Cyberbotics.asc | sudo apt-key add -
 
sudo apt-add-repository 'deb https://cyberbotics.com/debian/ binary-amd64/'
 
sudo apt-get update
 
sudo apt-get install webots
 
 
Navigieren Sie jetzt ins "FTS" Verzeichnis.
 
'''Beispiel:''' <code>cd SVN/trunk/Projekte/FTF_Hanning/FTS</code>
 
 
Durch '''colcon build''' werden die benötigten Daten komprimiert und der Workspace "vernetzt".
colcon build --packages-select hewagv_simulation openslam_gmapping slam_gmapping
Eventuell muss die Eingabe wiederholt werden, wenn es zu einer Fehlermedlung kommt.
Beim zweiten '''colcon build''' sollte der Prozess dann erfolgreich verlaufen.
 
 
Als letzten Schritt vor dem Start der Simulation muss nur noch das Environment gesourcet werden.
source install/local_setup.bash
 
'''Simulation starten:'''
ros2 launch hewagv_simulation full_system_launch.py
 
 
Mit '''Strg + C''' kann die Simulation im Terminal beendet werden.
 
 
== Funktionaler Systementwurf / Technischer Systementwurf ==
 
== Komponentenspezifikation ==
 
== Programmierung ==
 
== Komponententest ==
 
 
== Ergebnis ==
 


== Zusammenfassung ==
== Zusammenfassung ==
Im Rahmen der Projektarbeit werden alle notwendigen Anforderungen aufgezeigt und schrittweise erläutert. Die virtuelle Maschine VirtualBox, welche sich aufgrund ihrer vielen Features und Einstellmöglichkeiten sehr gut zur Benutzung eignet, wird vorgestellt und die Installation und Einrichtung gezeigt. Um die Simulation von Hanning in Betrieb zu nehmen, wird die Installation von ROS2 erklärt und vorgestellt, wie ein Workspace mit den benötigten Dateien aus SVN aufgebaut wird. Anhand der bereitgestellten Simulation von Hanning wird gezeigt, welche Möglichkeiten zur Steuerung des FTF zur Verfügung stehen. Durch die Steuerung mit SLAM wird das Thema Navigation aufgegriffen und erläutert. Zum Schluss werden Tools (RQt, RViz, roswtf) zur Anschauung von Knoten, Themen und Abhängigkeiten, sowie zum Debugging aufgezeigt und erklärt.


=== Lessons Learned ===
*Da ich vor Beginn der Projektarbeit wenig Berührungspunkte mit Linux, Java und ROS2 hatte, war es zunächst schwierig für mich einige Inhalte zu durchdringen. Dies wiederum hat mich motiviert, mich besonders eingehend und strukturiert mit dem Thema zu befassen. Durch die intensive Auseinandersetzung konnte ich viele Dinge neu lernen und anwenden. Die Tutorials auf der [[https://docs.ros.org/ ROS2-Seite]], sowie die interaktiven Tutorials von [[https://www.theconstructsim.com/ TheConstruct]] habe ich als besonders hilfreich wahrgenommen. Für zukünftige Aufgaben im Studium, aber auch im späteren Arbeitsleben nehme ich mit, dass es für mich besonders motivierend ist, wenn ich vor komplexe Aufgaben gestellt werde. Außerdem nehme ich mit, dass es eine intensive und strukturierte Erarbeitung möglich macht, sehr komplexe Themen zu erschließen.
*Die Verwendung einer VM hat sich als großer Vorteil herausgestellt, da man Abbilder des Betriebssystems erstellen kann und die Integrität der Simulation durch Veränderungen von Softwareversionen nicht gefährdet.
*Der Installationsvorgang bis zum Starten der Simulation kann mit einer VM umgangen werden, indem ein Abbild einer funktionsfähigen VM erstellt und zur Verfügung gestellt wird.
*Die Verwendung von Docker, um ein Systemabbild zu erstellen, hat sich als kompliziert herausgestellt, da gewisse Container auf dem Dockerhub gar nicht, oder nicht als kompatible Version vorhanden sind.
*Als Neueinsteiger ins Thema ROS2 und geringen Kenntnissen in Python, sowie dem Betriebssystem Linux empfiehlt sich zunächst der Umgang mit den Grundlagen, bevor man sich an eine komplexe Simulation, wie die von Hanning, begibt.


=== Ausblick ===
*Mir war es nicht möglich einen lauffähigen Docker-Container für die Simulation des FTF zu erstellen, daher könnte das Thema "Docker" vom Umfang und der Komplexität als eigenständiges Projekt bearbeitet werden, mit dem Ziel eine dauerhaft lauffähige Simulation als "Abbild" (ohne VM) für spätere Studierende zu ermöglichen.


=== Lessons Learned ===
== Projektunterlagen ==
*[https://svn.hshl.de/svn/Robotik_und_Autonome-Systeme/trunk/Projekte/FTF_Hanning/FTS/src/ Link zu dem SVN_Ordner des Projekts.]
*[https://hshl.sciebo.de/s/M6TQL4AxqOP9aU1 VM Appliance]


== Weblinks ==
<div class="toccolours mw-collapsible mw-collapsed">
'''Verwendete Software'''
<div class="mw-collapsible-content">
*https://www.virtualbox.org/
*https://docs.ros.org/
*https://tortoisesvn.net/
*https://cyberbotics.com/doc/guide/installation-procedure#installing-the-debian-package-with-the-advanced-packaging-tool-apt
*https://ubuntu.com/
*https://rapidsvn.org/
*https://code.visualstudio.com/</div>
</div>


<div class="toccolours mw-collapsible mw-collapsed">
'''ROS2'''
<div class="mw-collapsible-content">
*https://docs.ros.org/en/foxy/index.html
*https://docs.ros.org/en/galactic/index.html
*https://docs.ros.org/en/humble/index.html
*https://www.theconstructsim.com/
*http://wiki.ros.org/ROS/Tutorials/InstallingandConfiguringROSEnvironment</div>
</div>


== Projektunterlagen ==
<div class="toccolours mw-collapsible mw-collapsed">
[https://svn-test.hshl.de/svn/Robotik_und_Autonome-Systeme/trunk/Projekte/FTF_Hanning/FTS/ Link zu dem SVN_Ordner des Projekts.]
'''SVN'''
[https://hshl.sciebo.de/s/Odi0kxe7UoDZlSu VM Appliance]
<div class="mw-collapsible-content">
*https://rapidsvn.org/
*https://tortoisesvn.net/</div>
</div>


== YouTube Video ==
<div class="toccolours mw-collapsible mw-collapsed">
Das Video von diesem Projekt finden Sie auf Youtube unter dem Link:
'''WeBots'''
 
<div class="mw-collapsible-content">
== Weblinks ==
*https://cyberbotics.com/doc/reference/webots-world-files
*
*https://docs.ros.org/en/foxy/Tutorials/Advanced/Simulators/Webots.html
*https://cyberbotics.com/doc/guide/tutorials</div>
</div>


<div class="toccolours mw-collapsible mw-collapsed">
'''Der Umgang mit ROS2'''
<div class="mw-collapsible-content">
*https://code.visualstudio.com/
*http://wiki.ros.org/catkin/package.xml
*https://roboticscasual.com/tutorial-ros2-launch-files-all-you-need-to-know/
*https://docs.ros.org/en/foxy/Tutorials/Intermediate/Launch/Creating-Launch-Files.html</div>
</div>


== Literatur ==
<div class="toccolours mw-collapsible mw-collapsed">
'''Steuerung des FTF in der Simulation'''
<div class="mw-collapsible-content">
*https://github.com/ros-teleop/teleop_twist_keyboard</div>
</div>


<div class="toccolours mw-collapsible mw-collapsed">
'''Knoten, Nachrichten und Beziehungen'''
<div class="mw-collapsible-content">
*https://en.wikipedia.org/wiki/Monte_Carlo_localization
*http://wiki.ros.org/rviz
*https://docs.ros.org/en/foxy/Concepts/About-RQt.html
*http://wiki.ros.org/roswtf
*http://wiki.ros.org/roswtf/Plugins
*https://pypi.org/
*https://pypi.org/project/pip/</div>
</div>




----
----
→ zurück zum Hauptartikel: [[Studentische_Arbeiten|Studentische Arbeiten]]
→ zurück zum Hauptartikel: [[Studentische_Arbeiten|Studentische Arbeiten]]

Aktuelle Version vom 26. Februar 2023, 14:24 Uhr


Abb.1: ROS 2


Autor: Marius Küpper
Art: Projektarbeit
Dauer: April - September 2022
Betreuer: Prof. Schneider


Thema

Das Unternehmen Hanning Elektro-Werke GmbH & Co. KG hat der Hochschule Hamm-Lippstadt ein Fahrerloses Transportfahrzeug (FTF), sowie eine Simulation von diesem zu Forschungszwecken zur Verfügung gestellt. Diese Projektarbeit soll als Anleitung dienen die Simulation in Betrieb zu nehmen und auf dem Weg dahin das verwendete Robot Operating System 2 (ROS2) zu vermitteln. Es wird unter anderem erklärt, wie Sie dazu eine virtuelle Maschine (VM) nutzen können, das Linux-Betriebssystem installieren, an das benötigte Repository kommen, ROS2 und alle anderen benötigten Programme und Pakete installieren, die Simulation des FTF starten und sich darin zurechtfinden und arbeiten können.

Aufgabenstellung

  • Einarbeitung in ROS 2 mit Tutorials
  • Dokumentation der wesentlichen Anleitungen bezogen auf das FTF im HSHL Wiki
  • Evaluation durch andere(n) Studierende
  • Optimierung des Artikels
  • optional: Bereitstellung von Demoprogrammen zum einfachen Einstieg


Anforderungen an die Projektarbeit


Projektplan

Abb.2: Projektplan


Anforderungen

Hardwareanforderungen

VirtualBox:

  • Prozessor: aktuellere AMD- oder Intel-Prozessoren sind ausreichend.
  • Arbeitsspeicher: 8 GB Minimum, aber je mehr, desto besser.
  • Festplattenspeicherplatz: Für die Installation werden nur etwa 30 MB benötigt. Für das Gastbetriebssystem wird allerdings deutlich mehr Speicherplatz benötigt. Sie sollten mindestens 20-30 GB einplanen, je nachdem was Sie vorhaben zu installieren.

WeBots:

  • Prozessor: Aktuellere AMD- oder Intel-Prozessoren sind ausreichend. Eine CPU mit vier Kernen wird empfohlen.
  • Grafikkarte/ -chip: Eine NVIDIA oder AMD OpenGL-fähige (Minimum Version 3.3) Grafikkarte mit mindestens 512 MB Grafikspeicher ist erforderlich.

Softwareanforderungen

Installation der virtuellen Maschine VirtualBox

ROS2 in Ubuntu einbinden

SVN-Repository in Linux erstellen

Inbetriebnahme unserer WeBots-Simulation

Der Umgang mit ROS2

Steuerung des FTF in der Simulation

Knoten, Nachrichten und Beziehungen

Mögliche Alternativen

Evaluation anderer Studierender

Evaluationen

"Nach der Installation der richtigen Version von VirtualBox konnte ich der Anleitung gut folgen und habe besonders durch die Bilder einfach durch den Installationsprozess gefunden. Die Befehle in den grauen Kästen haben am Ende immer zum gewünschten Ziel geführt. Mir war manchmal nicht klar, welche Version von ROS ich installieren sollte, wenn man die Wahl hatte, zwischen Galactic oder Humble. Da würde ich mir eine bessere Erklärung wünschen. Im Github konnte ich mir den Roboter Epuk herunterladen und mit Hilfe der Anleitung auch steuern. Ohne einmal mit Ubuntu gearbeitet zu haben, konnte ich nach kurzer Zeit und ein bisschen Probieren eine Simulation starten und ein paar Funktionen ausprobieren."

Aykut Ersoy, studiert WING an der HSHL im 7. Semester

"Im Allgemeinen eine gut und detailierte Anleitung für die Einrichtung einer virtuellen Maschine mit ROS2. Der Step by Step Guide hilft immer mit passenden Bildern, um schnell durch die Installation zu finden. Ein Nachteil der VM ist die schlechte Skalierung der Fenster und dadurch halb verdeckte „Akzeptieren“ Felder. Dieses Problem wird jedoch, sobald es möglich ist mit Hilfe der Anleitung gelöst. Die Einbindung in ROS2 klappte danach problemlos. Leider musste ich mich einer Alternative zu Webots bedienen, die sich durch das passende Grundgerüst, leicht mit kleinen Modifikationen installieren und ausführen ließ. Hier hilft es im Zweifelsfall die VM als Administrator zu starten."

Marten Eilers, studiert INFO/ MATH an der RWTH Aachen

Optimierung des Artikels aufgrund der Evaluationen:

  • Kompatible VirtualBox-Version besser gekennzeichnet
  • ROS2-Version besser gekennzeichnet
  • Problem mit verdeckten Fenstern erläutert
  • VM als Administrator ausführen hinzugefügt

Zusammenfassung

Im Rahmen der Projektarbeit werden alle notwendigen Anforderungen aufgezeigt und schrittweise erläutert. Die virtuelle Maschine VirtualBox, welche sich aufgrund ihrer vielen Features und Einstellmöglichkeiten sehr gut zur Benutzung eignet, wird vorgestellt und die Installation und Einrichtung gezeigt. Um die Simulation von Hanning in Betrieb zu nehmen, wird die Installation von ROS2 erklärt und vorgestellt, wie ein Workspace mit den benötigten Dateien aus SVN aufgebaut wird. Anhand der bereitgestellten Simulation von Hanning wird gezeigt, welche Möglichkeiten zur Steuerung des FTF zur Verfügung stehen. Durch die Steuerung mit SLAM wird das Thema Navigation aufgegriffen und erläutert. Zum Schluss werden Tools (RQt, RViz, roswtf) zur Anschauung von Knoten, Themen und Abhängigkeiten, sowie zum Debugging aufgezeigt und erklärt.

Lessons Learned

  • Da ich vor Beginn der Projektarbeit wenig Berührungspunkte mit Linux, Java und ROS2 hatte, war es zunächst schwierig für mich einige Inhalte zu durchdringen. Dies wiederum hat mich motiviert, mich besonders eingehend und strukturiert mit dem Thema zu befassen. Durch die intensive Auseinandersetzung konnte ich viele Dinge neu lernen und anwenden. Die Tutorials auf der [ROS2-Seite], sowie die interaktiven Tutorials von [TheConstruct] habe ich als besonders hilfreich wahrgenommen. Für zukünftige Aufgaben im Studium, aber auch im späteren Arbeitsleben nehme ich mit, dass es für mich besonders motivierend ist, wenn ich vor komplexe Aufgaben gestellt werde. Außerdem nehme ich mit, dass es eine intensive und strukturierte Erarbeitung möglich macht, sehr komplexe Themen zu erschließen.
  • Die Verwendung einer VM hat sich als großer Vorteil herausgestellt, da man Abbilder des Betriebssystems erstellen kann und die Integrität der Simulation durch Veränderungen von Softwareversionen nicht gefährdet.
  • Der Installationsvorgang bis zum Starten der Simulation kann mit einer VM umgangen werden, indem ein Abbild einer funktionsfähigen VM erstellt und zur Verfügung gestellt wird.
  • Die Verwendung von Docker, um ein Systemabbild zu erstellen, hat sich als kompliziert herausgestellt, da gewisse Container auf dem Dockerhub gar nicht, oder nicht als kompatible Version vorhanden sind.
  • Als Neueinsteiger ins Thema ROS2 und geringen Kenntnissen in Python, sowie dem Betriebssystem Linux empfiehlt sich zunächst der Umgang mit den Grundlagen, bevor man sich an eine komplexe Simulation, wie die von Hanning, begibt.

Ausblick

  • Mir war es nicht möglich einen lauffähigen Docker-Container für die Simulation des FTF zu erstellen, daher könnte das Thema "Docker" vom Umfang und der Komplexität als eigenständiges Projekt bearbeitet werden, mit dem Ziel eine dauerhaft lauffähige Simulation als "Abbild" (ohne VM) für spätere Studierende zu ermöglichen.

Projektunterlagen

Weblinks

Steuerung des FTF in der Simulation



→ zurück zum Hauptartikel: Studentische Arbeiten