Kommunikation Raspberry Pi mit ROS2: Unterschied zwischen den Versionen
| Zeile 318: | Zeile 318: | ||
[[Datei:RQT_Plot_Infrared.png|left|mini|700px|Abb. | [[Datei:RQT_Plot_öffnen.png|left|mini|600px|Abb. 12 RQT Plot öffnen]] | ||
<br clear=all> | |||
[[Datei:RQT_Plot_Infrared.png|left|mini|700px|Abb. 13 Infrarot Hindernisumfahrung]] | |||
<br clear=all> | <br clear=all> | ||
Version vom 7. März 2022, 11:54 Uhr
Autoren: Jonas Gerken
Betreuer: Prof. Schneider
Art: Praxissemester
Projektlaufzeit: 02.11.2021-20.02.2022
Einleitung
Dieser Artikel beschreibt die Kommunikation von einem Raspberry Pi mit dem Robot Operating System2 (ROS2). Dazu wird erklärt, wie ein Raspberry Pi mit einem PC über SSH(Secure Shell) verbunden werden kann und wie der AlphaBot über den Raspberry Pi und ROS2 gesteuert wurde. Außerdem wird beschrieben was es für grafische Anzeige Möglichkeiten unter ROS2 gibt.
Übersicht
Dokumentation
Zum beginn dieses Artikels werden die verschiedenen Anforderungen an das Projekt aufgezeigt(Tabelle 1/2).
Funktionale Anforderungen
| F1 | Der Roboter muss Hindernisse mit Infrarotsensoren erkennen können. |
| F2 | Der Roboter muss Hindernisse mit einem Ultraschallsensor erkennen können. |
| F5 | Der Ultraschallsensor muss mit einem Servo-Motor nach rechts und links gedreht werden können. |
| F3 | Der Roboter muss Hindernisse umfahren können. |
| F4 | Die Motoren müssen einzeln angesteuert werden können. |
Nicht Funktionale Anforderungen
| NF1 | Es muss ein Alphabot verwendet werden. |
| NF2 | Der Roboter soll mit ROS2 programmiert werden. |
| NF3 | Der Roboter soll mit einem Raspberry Pi gesteuert werden. |
| NF4 | Der Roboter soll mit Python programmiert werden. |
| NF5 | Es soll die Python Bibliothek RPi.GPIO verwendet werden. |
| NF6 | Es muss Ubuntu Server 20.04 Server auf dem RPi verwendent werden. |
| NF7 | Es kann Secure Shell(SSH) zur Nutzung des Raspberry Pi's verwendet werden. |
| NF8 | Für eine SSH-Verbindung kann PuTTY verwendet werden. |
Hardware
Software
Raspberry Pi über Secure Shell(SSH) mit Desktop PC verbinden
In dem hier beschriebenen Projekt wurde Secure Shell(SSH) zur Verwendung des RPi's verwendet. Dies ermöglicht die Nutzung des RPi's und Ubuntu Desktop auf einem Bildschirm gleichzeitig. So wird keine HDMI-Verbindung zwischen dem RPi und einem Bildschirm mehr benötigt.
Über SSH kann der AlphaBot später mittels einer WIFI-Verbindung autonom fahren.
Die SSH Verbindung kann über verschiedene Wege erfolgen. Zum einen über das Programm PuTTY oder über das Ubuntu Desktop Terminal.
Im weiteren wird beschrieben, wie SSH auf dem RPi aktiviert wird und wie es mit PuTTY oder in einem Terminal verwendet werden kann.
SSH auf dem Raspberry Pi Aktivieren
Damit SSH genutzt werden kann muss es auf dem Raspberry Pi zuerst aktiviert werden. Dazu sind folgende Schritte wie in Abb. 1 gezeigt zu befolgen:
- SD-Karte mit einem SD-Karten-Adapter in ein Kartenleseslot an einem PC stecken
- im boot-Verzeichnis (hier: "system-boot") mit rechter Maustaste Drop-Down-Menu öffnen
- unter dem Reiter Neu "Textdokument" auswählen
- ssh als Namen eingeben, zunächst wird die Datei ssh.txt heißen
- im Windows-Explorer unter dem Reiter Ansicht Haken bei Dateinamenserweiterung setzen, damit die Dateiendung angezeigt wird
- die nun angezeigte .txt Dateiendung entfernen
- die darauf folgende Warnung mit JA bestätigen(Abb. 2)
- beim Booten des Raspberry Pi's wird nun SSH aktiviert
IP-Adresse des RPi herausfinden
Damit der Raspberry Pi über SSH verbunden werden kann, wird die IPv4-Adresse des Raspberry Pi's benötigt.
Dafür wird der RPi mit einem HDMI-Kabel an einem Bildschirm und an das dazugehörige Stromkabel angeschlossen.
Allgemein muss der RPi für eine SSH-Verbindung mit dem Internet verbunden sein. Hier kann der RPi mit einem Ethernet Kabel oder über einer WIFI-Verbindung verbunden werden. Für die Ethernet-Verbindung wird zwischen den RPi und den Computer ein Netzwerk-Switch zwischengeschaltet.
Und um den RPi mit WIFI zu verbinden, muss die RPi Netzwerk Konfiguration verändert werden. Wie das gemacht wird kann in dem Artikel zur Installation von Ubuntu Server nachgelesen werden.
Wenn letzteres das Stromkabel angeschlossen wurde, bootet der RPi und der Login Bildschirm wird angezeigt, wo nach dem Benutzernamen (hier: ubuntu) und nach dem Passwort (hier: Hshl2021) gefragt wird(Abb. 2).
Nach der Anmeldung auf dem Raspberry Pi, kann die IPv4-Adresse auf dem Start Bildschirm abgelesen werden.
Für den hier verwendeten RPi war die Ethernet IP-Adresse 172.31.14.89, wie in Abb. 3 zusehen ist. Und für WIFI war die IP-Adresse 192.168.10.102.
PuTTY für die SSH Verbindung
Wie oben erwähnt, kann die freie Software PuTTY zur Herstellung von Secure Shell Verbindungen verwendet werden. Auf einem Pc mit Ubuntu wird PuTTY über die Kommandozeile installiert [1].
sudo apt-get install putty
Nach der Installation kann über die folgenden Schritte SSH gestartet werden(Abb. 5):
- starten von PuTTY über ein Terminal mit dem Befehl
putty - Reiter Session auswählen
- bei Host-Name die IP-Adresse des RPi angeben
- als Connection Type SSH auswählen
- überprüfen ob Port 22 eingestellt ist
- gegeben falls spezifischen Namen geben
- mit save die Ip-Adresse abspeichern
- auf Open klicken, um SSH zu starten
Dann öffnet sich ein neues Fenster, wo sich mit den zuvor gezeigten Anmeldedaten(username: ubuntu, Passwort: Hshl2021) auf dem RPi angemeldet werden kann.
Nach dem Anmelden sieht der PuTTY-Bildschirm, wie in Abb. 6 gezeigt aus. Hier ist außerdem zusehen das die SSH-Verbindung über WIFI hergestellt wurde und die IP-Adresse eine andere ist, wie bei Ethernet.
Um die IP-Adressen auseinander zuhalten, ist es am besten, bei der ersten Nutzung des RPi's die Ip-Adressen einmal nachzuschauen.
Nun ist die SSH-Verbindung über PuTTY hergestellt.
SSH über ein Terminal verwenden
Eine SSH-Verbindung über ein Ubuntu Terminal herzustellen ist im Vergleich zu PuTTY einfacher.
Dafür muss nur der Befehl ssh username@IP-Adresse [2] in einem Terminal eingegeben werden.
Danach erscheint direkt im Terminal der Login-Bildschirm.
Hier kann sich wie gewohnt mit den genannten Daten angemeldet werden.
Microcontroller coding mit der Integration von ROS2
In diesem Abschnitt wird die Programmierung des Raspberry Pi's mit ROS2 beschrieben. Dazu gehört die Motorsteuerung, genau sowie die Infrarot Sensoren oder dem Ultraschallsensor um Hindernisse umfahren zu können.
Da es die Bibliothek wiringPi, welche für die Ansteuerung der GPIO Pins über CPP nicht mehr unterstützt wird, haben wir uns für die Python Bibliothek "RPi.GPIO" entschieden. Für mehr Informationen siehe hier: Raspberry Pi
Da es beim ausführen von den Codes auf dem RPi zu dem Fehler "RuntimeError: Not running on a RPi!" kam, können die folgenden Befehle helfen. Die hier genannten Befehle müssen bei jedem Neustart des RPi's erneut ausgeführt werden. Weiteres wurde dazu nicht gefunden.
ls -l /dev/ gpiomem crw-rw---- 1 root dialout 239, 0 Apr 1 17:23 /dev/gpiomem groups ubuntu adm dialout cdrom floppy sudo audio dip video plugdev netdev lxd
sudo chown root.gpio /dev/gpiomem
sudo chmod g+rw /dev/gpiomem
Um mit der Programmierung zu beginnen wurde ein Ros2 Workspace mit einem source Ordner erstellt.
mkdir ros_ws
cd ros_ws
mkdir src
In dem source Ordner wurde dann das ROS2 Package mit den benötigten Bibliotheksabhängigkeiten erstellt.
Dazu gehören rclpy, der ROS2 Client Library für Python und std_msgs, um die Standard Nachrichten, wie Int8, Float64 oder String in ROS2 nutzen zu können.
ros2 pkg create --build-type ament_python packagename(z.B. sensor_test) --dependencies rclpy std_msgs
Motorsteuerung
Es wurde damit begonnen die Motoren zu programmieren und zu testen. Dazu wurde eine ROS2 Node namens slave.py erstellt, welche zu diesem Zeitpunkt die Programmierung zur Steuerung der Motor GPIO Pins beinhaltet. Dazu werden bestimmte Nachrichten wie forward, backward, right, left oder stop manuell an diese ROS2 Node gepublished.
Der Ablauf ist dazu in Abb. 10 Graphisch dargestellt.
Damit überhaupt etwas passiert muss zuerst der ROS2 Code, die slave.py ausgeführt werden.
ros2 run sensor_test Motortest
Unter Demos wird dazu im Detail beschrieben was bei der Ausführung zu beachten ist.
Danach ist der subscriber in einer Art Standby Modus und wartet auf eingehende Nachrichten.
Im nächsten Schritt sendet jemand manuell eine Movement Nachricht an den subscriber.
ros2 topic pub /cmd_vel std_msgs/msg/String '{data: forward}'
Diese Nachricht wird in einer Dauerschleife gesendet, bis das publishen gestoppt wird.
Die Node "motor_subscriber" empfängt dann die zuvor gesendete Nachricht über den dort definierten subscriber.
Anhand dieser Nachricht entscheidet die Node über eine If-Schleife welche GPIO Pins angesteuert werden müssen.
Dazu gibt es 3 Pins für den linken Motor und 3 Pins für den rechten Motor.
Jeweils einen für vorwärts, einen für rückwärts und einen um die Motoren zu aktivieren. Die Aktivierung erfolgt in der Initialisierungsfunktion. Dadurch wird ermöglicht, das der AlphaBot beim ausführen des Codes sofort losfährt.
Jetzt endlich werden bei der Nachricht "forward" die beiden GPIO Pins für das vorwärts Fahren auf HIGH gesetzt und der AlphaBot fährt vorwärts.
In Abb. 8 ist zusehen wie links die Nachricht "forward" gepublished wird und rechts die Node "motor_subscriber" diese Nachricht empfängt. Zudem ist zu sehen das nach dem pub Befehl eine loop beginnt, das heißt, dass die Nachricht in gleichmäßigen Zeitabständen gepublished wird.
Infrarot Hindernisumfahrung
Nachdem die Motoren mit ROS2 implementiert und getestet wurden, wurde die Hindernisumfahrung mit Infrarotsensoren implementiert. Hierfür wurden zwei neue Dateien mit den Namen "master_IR.py" und "slave_IR.py" in dem source Ordner des ROS2 Packages erstellt.
Der Ablauf für die Hindernisumfahrung mit Infrarotsensoren ist in Abb. 9 abgebildet.
Das Programm wird mit einer ROS2 launch-file ausgeführt. Die launch-file beinhaltet alle auszuführenden ROS2-Nodes. Dazu gehört der package Name und der Name der auszuführenden Datei. Mit dem folgenden Befehl werden dann beide Nodes ausgeführt.
ros2 launch sensor_test alphabot_IR_launch.py
Dann fährt der AlphaBot los und die Sensordaten werden über die Slave-Node an die Master-Node gepublished.
Nachdem die Master-Node die Sensordaten erhalten hat, entscheidet sie über eine IF-Schleife in welche Richtung der AlphaBot fahren kann.
Der unterschied zur Motorsteuerung oben ist, das hier der Master anhand der Sensordaten forward, right, left oder backward an die Slave-Node published.
Für die Sensordaten musste zunächst der richtige Datentype herausgefunden werden. Dazu kann dieser Code in der Slave-Node unter der timer_callback() Funktion nachdem DR_status deklariert wurde integriert werden.
print(type(DR_status))
So wurde herausgefunden, dass es sich hier um ein Integer handelt.
Mit der Codezeile print(DR_status) wurde festgestellt, dass diese Infrarotsensoren bei einer 1 nichts vor ihnen steht und bei einer 0 etwas im Weg ist.
So published die Master-Node "forward" wenn die Slave-Node für beide Sensoren eine 1 published und steuert beide GPIO Pins zum vorwärts fahren an. Wenn z.B. der rechte Sensor eine "0" und der linke eine "1" angibt, dann ist rechts ein Hindernis. Der master sendet der Slave die Nachricht "left", sodass die Slave-Node die GPIO Pins zum rückwärts fahren des Linken Motors ansteuert.
In Abb 10 ist dazu ein Beispiel, wie der master und die slave miteinander kommunizieren.
Dort ist zum Beispiel zusehen, das die Master-Node(commander) "forward" published, da beide Sensoren eine 1 ausgeben. Die Slave-Node(IR_Publisher) empfängt die Nachricht forward, was an dem I heard zu erkennen ist.
In ROS2 können die Programmierten Nodes und Topics in einem RQT-Graph grafisch Dargestellt werden wie schon in den ROS2 Tutorials gezeigt. Für die Infrarot Hindernisumfahrung könnte der Graph dann wie in Abb. 11 gezeigt aussehen.
Dort ist zusehen das der master zu den beiden Topics "IR_right und IR_left" subscript und über die Topic "cmd_vel" published. Auf der anderen Seite, die Slave, published über die Topics "IR_right und IR_left" und subscript zur Topic "cmd_vel".
Ultraschall Hindernisumfahrung
Demo
Checkout URL : https://svn.hshl.de/svn/Robotik_und_Autonome-Systeme/trunk/Projekte/AlphaBot_PI_ROS2/
Der Code kann direkt aus dem SVN-Verzeichnis ausgeführt werden.
| # | Name |
|---|---|
| 1 | Motortest |
| 2 | Infrared_Obstacle_Avoidance |
| 3 | Ultrasonic_Obstacle_Avoidance |
Software
Zusammenfassung
Weiterführende Links
→ zurück zum Hauptartikel: Robot Operating System2 (ROS2)