Stopplinien-Verhalten: Unterschied zwischen den Versionen

Aus HSHL Mechatronik
Zur Navigation springen Zur Suche springen
 
(163 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
→ zurück zur Übersicht: [[SDE-Team_2019/20]]<br/>
'''Autoren:''' [[Benutzer: Hagen Heuer | Hagen Heuer]], [[Benutzer: Tim Kruse | Tim Kruse]] <br/>
'''Bearbeitet:''' [[Benutzer: Daniel Gosedopp | Daniel Gosedopp]], [[Benutzer: Ran Wei | Ran Wei]] <br/>
'''Betreuer:''' [[Benutzer:Ulrich_Schneider| Prof. Schneider]], [[Benutzer:Mirekgoebel | Prof. Göbel]]<br/>


----
== Einleitung ==
Ziel ist es, das Verhalten des Fahrzeugs an Stopplinien entsprechend den Anforderungen im Lastenheft zu implementieren. Das Fahrzeug muss nach dem Lastenheft im Falle der Erkennung einer Haltelinie immer langsamer fahren. Befindet sich es an der Stopplinie, so muss es dort stoppen und zwei Sekunden halten. Liegt eine Vorfahrtssituation vor, muss dem Hindernis Vorfahrt gewährt und erst dann weitergefahren werden.
 
== Anforderungen ==
Im Lastenheft des Projekts Carolo Cup wird die Anforderung an das Verhalten des Fahrzeugs an einer Stopplinie in REQ10.2340 festgehalten (s. Abbildung 1).<br>
<gallery mode = "traditional" widths=500px heights=150px>
File:Anforderungen.JPG|<b>Abbildung 1: Lastenheftauszug Stopplinien-Verhalten.</b>
</gallery>
 
Die Umsetzung der Anforderung ist im Pflichtenheft wie folgt festgehalten:<br>
<gallery mode = "traditional" widths=1250px heights=230px>
File:Pflichtenheft Heuer Kruse MS2.png|<b>Abbildung 2: Pflichtenheftauszug zu REQ10.2340.</b>
</gallery>


'''Bearbeiter:''' [[Benutzer:Yanick-Christian_Tchenko|Yanick Christian Tchenko]] <br/>
Folgende Anforderungen können festgelegt werden und im späteren Projekt berücksichtigt werden.
'''Betreuer:''' [[Benutzer:Ulrich_Schneider| Prof. Schneider]]<br/>


*Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung, so muss es 15 cm vor der Stopplinie anhalten.
*Während das Fahrzeug auf die Stopplinie zufährt, muss die Geschwindigkeit des Fahrzeugs gedrosselt werden.
*Das Fahrzeug muss vor der Stoppline halten und 2 Sekunden warten.
*Nach der Wartezeit muss das Fahrzeug die Kreuzung passieren, ohne das die Stopplinie ein weiteres Mal erkannt wird.
*Die Implementierung erfolgt in Matlab-Simulink.
== Konzept ==
Als Basis für die Implementierung diente die vorhandene MATLAB-Funktion für das Verhalten an Stopplinien. Beim Testen dieser Funktion viel unter anderem auf, dass diese nicht lauffähig ist. Außerdem war die Implementierung der Weiterfahrt nach einer Stopplinie fehlerhaft, da das Fahrzeug die vorherige Stopplinie erneut erkennen würde. Daher wurde ein neues Konzept erstellt, in dem Teile der ursprünglichen Idee berücksichtigt wurden. Zunächst werden die externen Ein- und Ausgänge des Moduls definiert:


== Aufgabe ==
=== Grundidee ===
Bearbeiten Sie nachfolgende Aufgaben bis zum Abgabetermin und stellen Sie Ihre Lösung Prof. Schneider vor. Gehen Sie systematisch in den in SDE vermittelten Schritten
Das Modul BSF ermittelt unter anderem die Sollgeschwindigkeit des Fahrzeugs. Dies geschieht entweder auf Basis der Kurvenkrümmung oder wird bei Vorhandensein eines Hindernisses als konstant angenommen. Die Grundidee ist es, die Sollgeschwindigkeit bei Erkennung einer Stopplinie mit einem Faktor (Werte von 0 - 1) zu multiplizieren, also immer weiter zu verringern, bis das Fahrzeug 15cm vor der Linie stillsteht. Der Stillstand soll für zwei Sekunden beibehalten werden. Danach soll das Fahrzeug mit unveränderter Sollgeschwindigkeit weiterfahren (Faktor = 1). Den Verlauf des Faktorwertes zeigt Abb. 3.
# Einleitung
# Anforderungen
# Funktionaler Systementwurf / Technischer Systementwurf
# Komponentenspezifikation
# Programmierung
# Komponententest
# Zusammenfassung
# Link zum Quelltext in SVN


vor.
<gallery mode = "traditional" widths=500px heights=250px>
File:Konzept des Geschwindigkeitsfaktors.png|<b>Abbildung 3: Verlauf des Geschwindigkeitsbegrenzungsfaktors</b>
</gallery>


== Einleitung ==
Am Anfang ist der Faktor 1, bis eine Stopplinie erkannt wird. Dann verringert er sich kontinuierlich, bis zum Wert 0, sodass das Auto immer langsamer wird und schließlich 15cm vor der Stopplinie zum Stillstand kommt. Hier wird für zwei Sekunden gewartet. Danach wird der Faktor wieder auf 1 gesetzt, sodass wieder auf errechnete Sollgeschwindigkeit beschleunigt wird.


In dieser Aufgabestellung ist die Zielsetzung, das Verhalten des Fahrzeugs an Stopplinien entsprechend den Anforderungen im Lastenheft zu implementieren. Das Fahrzeug muss nach dem Lastenheft im Falle der Erkennung einer Haltelinie immer langsamer fahren. Befindet sich es an der Stopplinie, dann muss es zwei Sekunden halten und dann weiterfahren<br>
=== Festlegung von Ein- und Ausgängen ===


== Anforderungen ==
Zur Umsetzung der Funktion werden zunächst die Ein- und Ausgänge festgelegt. Diese zeigt Tab. 1.
Im Lastenheft des Projets Carolo Cup wird die Steuerung des Verhaltens des Fahrzeugs an der Stopplinie genau so wie in der folgenden Abbildung gefordert:<br>
[[Datei:Anforderungen.JPG|500px|Anforderungen]]<br>
Es entstand demnach das untere Pflichtenheft: <br>
[[Datei:Aufgaben Pfichtenheft.JPG|1600px]]


Zu den Anforderungen wurden die in der unteren Tabelle zusammengefassten Arbeitspunkte arrangiert.
{| class="wikitable" style="margin:auto" style="text-align: center;
{| class="mw-datatable"
|+ Tabelle 1: Ein- und Ausgangsvariablen
! style="font-weight: bold;" | ID
! Art !! Variablenname !! Beschreibung !! Einheit
! style="font-weight: bold;" | Inhalt
! style="font-weight: bold;" | Ersteller
! style="font-weight: bold;" | Datum
! style="font-weight: bold;" | Geprüft von
! style="font-weight: bold;" | Datum
|-
| 1
| Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung so muss es 10cm vor der Stopplinie anhalten.
| Christian Tchenko
| 25.10.2019
| Prof. Schneider
| 08.11.2019
|
|-
| 2
| Änderung des Faktors (<code> BSFVx_Faktor_i8 </code>) in Abhängigkeit des gemessenen Abstands.
| Christian Tchenko
| 25.10.2019
| Prof. Schneider
| 08.11.2019
|-
|-
| 3
| Eingang
| Das Fahrzeug muss 2 Sekunden  an der Stopplinie anhalten.
| SenKam_Stopplinienabstand_f64
| Christian Tchenko
| Abstand von Fahrzeugfront zur Stopplinie
| 25.10.2019
| m
| Prof. Schneider
| 08.11.2019 
|-
|-
| 4
| Eingang
| Das Fahrzeug muss vor der Stopplinie immer langsamer fahren.
| SenKam_Stopplinienflag_bit
| Christian Tchenko
| Gesetzt, wenn eine Stopplinie erkannt wird
| 25.10.2019
| -
| Prof. Schneider
| 08.11.2019
|-
|-
| 4
| Eingang
| Wird keine Stopplinie erkannt, dann muss das Fahrzeug weiterfahren
| Vorfahrtssituation_bit
| Christian Tchenko
| Gesetzt, wenn ein Hindernis an der Kreuzung steht.
| 25.10.2019
| -
| Prof. Schneider
| 08.11.2019
|-
|-
| 5
| Eingang
| Die Programmierung erfolgt in MATLAB/Simulink
| T
| Christian Tchenko
| Zykluszeit der Simulation
| 25.10.2019
| s
| Prof. Schneider
| 08.11.2019
|-
|-
| Ausgang
| BsfVx_Faktor_f64
| Geschwindigkeitsbegrenzungsfaktor, falls Stopplinie erkannt wurde
| -
|}
|}


== Funktionaler Systementwurf / Technischer Systementwurf ==
=== Programmablauf ===
[[Datei:Stopplinienverhalten.GIF|rechts|mini|800px|Ab. 1: Technischer Systementwurf zu Bearbeitung des Fahrzeugsverhaltens an der Stopplinie.]]
Das Programm wird als Zustandsautomat realisiert, dessen Zustandsdiagramm Abbildung 3 zeigt.
Im Rahmen der bisherigen Aufgaben wird das Verhalten hauptsächlich aufs Geradefahrszenario berücksichtigt. Es wird im Verhältnis zu den ermittelten Informationen über die Präsenz einer Stopplinie sowie deren Abstand zu Fahrzeug ein Geschwindigkeitsänderungsfaktor als Resultat gelifert.
 
Das Modell wird, beruht auf einer Funktion <code>Stopplinien_Verhalten</code>, in der das Verhalten des Fahrzeug an und vor und an den Stopplinien bestimmt wird (Siehe Abb. 1).
<gallery mode = "traditional" widths=800px heights=380px>
Datei:Stoppverhalen Automat.png|<b>Abb. 3: Progammablaufplan des Stopplinien-Verhaltens.</b>
</gallery>
 
Zu Beginn werden Variablen eingelesen und initialisiert. Anschließend erfolgt die Abfrage des Zustands. Das Programm wird hierbei in vier Zustände unterteilt.
 
'''Zustand 1 - Auf Stopplinie warten'''<br>
Im ersten Zustand werden zunächst Variablen an den Ausgang übergeben. Anschließend wird abgefragt, ob das Stopplinienflag 1 ist. Trifft dies zu wird der Zustand auf 2 gesetzt. Wurde keine Stopplinie gefunden, so wird der Zustand nicht gewechselt.


== Konzept ==
'''Zustand 2 - Abbremsen nach Stopplinienerkennung'''<br>
[[Datei:Konzept.GIF|rechts|mini|600px|Abb. 2: Konzept zur Implementierung]]
In diesem Zustand wird abgebremst. Ist der Stopplinienabstand kleiner als 15cm, werden die Motoren abgeschaltet und der Zustand auf 3 gesetzt.
[[Datei:BSF Konzept.JPG|rechts|mini|400px|Abb. 3: Spezifikation des Fahrtverhaltens]]
Als Aufgabenstellung ein MATLAB/Simulink-Block für das Verhalten an Stopplinien gemäß Lastenheft zu entwickeln. Dieser Block muss in Simulation und im realen Fahrzeug lauffähig sein.


'''Zustand 3 - An Stopplinie warten'''<br>
In diesem Zustand wird an der Stopplinie gewartet. Liegt keine Vorfahrtssituation vor, beträgt die Wartezeit 2 Sekunden, ansonsten wird solange gewartet, bis das Hindernis die Kreuzung passiert hat.


Eingänge:
'''Zustand 4 - Kreuzung überfahren'''
* <code>SenKam_StoplinieFlag_bit</code>
Hier wird solange gefahren, bis die Stopplinie überquert wurde, der Stopplinienabstand also <= 0 ist. Dies ist nötig, damit die Stopplinie nicht als neue Stopplinie erkannt wird und das Farzeug erneut anhält. Danach wechselt der Automat wieder in den ersten Zustand.
* <code>SenKam_StoplinieAbst_f64</code>


Ausgang:
== Umsetzung und Ergebnis der Simulation ==
* <code>BSFVx_Faktor_i8</code>
Die Implementierung des Algorithmus erfolgt in Simulink als Stateflow Chart. Diese wurde nach dem Zustandsdiagramm aus Abbildung 3 aufgebaut. Der Zustandsautomat besitzt als Eingang den Stopplinienabstand. Die Kamera kann die Stopplinie aber nur bis ca. 52cm vor dem Auto sehen, sodass dieser bei Zufahrt auf die Kreuzung interpoliert werden muss. Dies geschieht im Subsystem "Berechnung_Stopplinienabstand". Um zu prüfen, ob eine Vorfahrtssituation vorliegt, muss auf die LiDAR-Objektliste zugegriffen werden. Das passiert im Subsystem "Überprüfung_Vorfahrtssituation". Im Lastenheft findet sich eine Abbildung, die zeigt, welche Bedingung zur Einleitung einer Vorfahrtssituation erfüllt sein muss. Wenn die Bedingung erfüllt ist, wird das "Vorfahrtssituation_bit" gesetzt.
(Siehe Abb. 1)


Im Fall einer Stopplinienerkennung, wobei sich das Fahrzeug noch nicht an der Stopplinie befindet, wird die Geschwindigkeit wie folgend berechnet.<br>
<gallery mode = "traditional" widths=1100px heights=400px>
* Der Zustand des Fahrzeugs genauso wie der maximale Abstand, die eine Zeitvariable und der Faktor  werden im ersten Programmdurchlauf initialisieren. Der Zustand wird an der Stelle als Fahren-Zustand durch durch die Bezeichnung <code>halten = false </code> gesetzt.
File:Stoppverhalten_Stateflow.png|<b>Abbildung 5: Implementierung der Anhalte- und Vorfahrtlogik.</b>
</gallery>


*Im Falle einer Objekt- bzw. Stopplinienerkenung, also <code>SenKam_StoplinieFlag_bit</code> gesetzt, dann wird bei der ersten Bitsetztung der geliferte SenKam_StoplinieAbst_f64 als maximaler Abstand festgelegt. Bei weiteren Bitsetzungen ändert sich die Geschwindigkeit proportional zu dem Faktor. Letzterer lässt sich wie folgend bestimmen: <br> 
Das Ergebnis des Stopplinienverhalten wird in der nachfolgenden Abbildung dargestellt.


# Faktor = Abstand/Abstandmax und <br>  
<gallery mode = "traditional" widths=800px heights=520px>
# Geschwindigkeit = Faktor x Soll_Geschwindigkeit
File:Ergebnis StopplinienverhaltenV2.png|<b>Abbildung 6: Wichtige Variablenwerte beim Test der Funktion.</b>
</gallery>


* Bei einer Annäherung bis zu einem Abstand von 15 cm, wird der Faktor zu Null gesetzt, und der Zustand entsprechend, wie folgt, geändert <code> halten = true </code>. An der Stelle kommt die Zeitvariable in Frage. Es wird für eine Ausführung der Fortfahrtfunktion eine Periode von ca. 0,005s, also 5 ms, gebraucht. Im Falle einer Haltung erfolgen c.a 400 Ausführungen, bei denen die Faktor und entsprechend die Geschwindigkeit auf Null gesetzt werden. Dies bedeutet, dass das Fahrzeug während einer Dauer von ca. 400 x 0,005s = 2s hält.(Genauso wie in Abb. 2 zu erkennen ist) 
Im ersten Diagramm ist das Stopplinienflag zu sehen, welches bei Detektion einer Stopplinie auf Eins wechselt.


Im zweiten Diagramm ist der dazugehörige Stopplinienabstand zu sehen. Dieser ist solange Null, bis eine Stopplinie erkannt wurde. Die Stopplinie kann ab einem Abstand von einem Meter oder weniger erfasst werden. Am Verlauf ist zudem gut zu erkennen, dass das Fahrzeug beginnt zu verzögern, da der Abstand nicht linear abnimmt. Nach der zweisekündigen Wartezeit beschleunigt das Fahrzeug wieder und der Abstand zur Stopplinie nimmt linear weiter ab. Erreicht dieser Null, so wird die Stopplinie überfahren.


# Das Bit <code>SenKam_StoplinieFlag_bit</code> aktiviert den Simulink Block.
Im letzten Diagramm wird die errechnete Sollgeschwindigkeit ausgegeben. Auch an dieser Kurve ist gut zu sehen, dass das Fahrzeug verzögert. Wenn der Abstand 15 cm oder weniger beträgt, werden die Motoren abgeschaltet, da der Faktor auf Null abfällt.
# Vor der Stopplinie wird <code>BSFVx_Faktor_i8</code> abhängig von <code>SenKam_StoplinieAbst_f64</code> linear von <code>1</code> auf <code>0</code> runtergeramt.
# Standphase entsprechend des Lastenheftes.
# Überprüfung ob die Straße frei ist.
# Bei freier Straße <code>BSFVx_Faktor_i8=1</code> setzen.


Die allgemeine Vorgehensweise beim dem vorliegenden Projekt sieht genauso wie in Abb. 3 beschrieben aus.
<onlyinclude><div style="clear:{{{{{|safesubst:}}}#switch:{{{1}}}
| links|left = left
| rechts|right = right
| #default = both
}};"></div></onlyinclude>


== Vorstellung ==
== Unit-Test & Integrations-Test ==
Für die Vorstellung des Ergebnisse wurde der 18.10.19 12:30 Uhr vereinbart.
Im Folgenden sind die einzelnen Testfälle für den Unit- und Integrations-Test im Offline- und Online-Modell zu sehen.  


==Komponententest ==
'''Offline-Modell: '''
Durch die Eingabe von Parametern konnten folgende Testfälle in der Simulation geprüft werden.


Hier werden die verschiedenen entwickelten Komponente getestet. Die Testergebnisse ergaben nach bestimmten Eingaben die in der unteren Tabelle zu sehenden numerische Resultate.
{| class="wikitable" style="margin:auto" style="text-align: center;
{| class="mw-datatable"
|+ Tabelle 3: Tests für das Stopplinienverhalten in der Simulation.
! style="font-weight: bold;" | ID
! style="font-weight: bold;" | ID
! style="font-weight: bold;" | Testfallbeschreibung
! style="font-weight: bold;" | Testfallbeschreibung
! style="font-weight: bold;" | Eingänge(<code>SenKam_StoplinieAbst_f64</code>, <code>SenKam_StoplinieFlag_bit</code>)
! style="font-weight: bold;" | Eingänge
! style="font-weight: bold;" | Ausgang(<code>BSFVx_Faktor_i8</code>)
! style="font-weight: bold;" | Ausgang
! style="font-weight: bold;" | Erwartetes Ergebnis
! style="font-weight: bold;" | Erwartetes Ergebnis
! style="font-weight: bold;" | Testergebnis
! style="font-weight: bold;" | Testergebnis
Zeile 139: Zeile 135:
|-
|-
| 1
| 1
| Das Fahrzeug muss vor der Stopplinie immer langsamer fahren.
| Das Fahrzeug fährt mit der vorgegebenen Geschwindigkeit, wenn keine Stopplinie erkannt wurde.
| SenKam_StoplinienFlag_bit = 0,  SenKam_StoplinienAbst_f64 = 0  
| <code>SenKam_Stopplinienflag_bit = 0</code><code>SenKam_Stopplinienabstand_f64 = 0</code>
| 1
| 1
| Vollgas
| Vollgas
| 1
| 1
| Prof. Schneider
| Gosedopp, Wei
| 15.11.2019
| 04.01.2023
|-
|-
| 2
| 2
| Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung so muss es 10cm vor der Stopplinie anhalten
| Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung so muss es 0.15m vor der Stopplinie anhalten
| SenKam_StoplinienFlag_bit = 1, SenKam_StoplinienAbst_f64 <= 10% Max_Abstand
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>SenKam_Stopplinienabstand_f64 <= 0.15</code>
| 0
| 0
| Fahrzeug Stoppt  
| Fahrzeug Stoppt  
| 0
| 0
| Prof. Schneider
| Gosedopp, Wei
| 15.11.2019
| 04.01.2023
|-
|-
| 3
| 3
| Das Fahrzeug fährt weiter, wenn keine Stopplinie erkannt wurde.  
| Das Fahrzeug muss im Bereich zwischen 0.15m und 1m vor der Stopplinie immer langsamer fahren.
| SenKam_StoplinienFlag_bit = 0, SenKam_StoplinienAbst_f64 existiert
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>15 < SenKam_Stopplinienabstand_f64 <= 100</code>
| 1
| <code>0 < BSFVx_Faktor_f64 < 1 </code>
| Nicht plausibeler Fall. (Da keine Stopplinie erkannt wurde)  
| Bremsen  
| 1
| <code>0 < BSFVx_Faktor_f64 < 1 </code>
| Prof. Schneider
| Gosedopp, Wei
| 15.11.2019
| 04.01.2023
|-
|-
| 4
| 4
| Das Fahrzeug muss im Bereich zwischen 0.1m und 1m vor der Stopplinie immer langsamer fahren.
| Das Fahrzeug bremst bei eingeleiteter Bremsung weiter ab, auch wenn das Stopplinienflag verloren geht.
| SenKam_StoplinienFlag_bit = 1, 0<SenKam_StoplinienAbst_f64<=10
| <code>SenKam_Stopplinienflag_bit = 0</code>, <code>SenKam_Stopplinienabstand_f64 = 0</code>
| 0<<code>BSFVx_Faktor_i8</code><1 (Linieare Änderung)
| <code> 0 < BSFVx_Faktor_f64 < 1 </code>
| Bremsen   
| Bremsen   
| 0<<code>BSFVx_Faktor_i8</code><1 (Linieare Änderung)
| <code> 0 < BSFVx_Faktor_f64 < 1 </code>
| Prof. Schneider
| Gosedopp, Wei
| 15.11.2019
| 04.01.2023
|-
|-
| 5
| 5
| Das Fahrzeug muss bei Srtopplinienerkennung im Bereich weiter als 1m weiter normal fahren.
| Das Fahrzeug muss bei Stopplinienerkennung im Bereich weiter als 1m weiter normal fahren.
| SenKam_StoplinienFlag_bit = 0, SenKam_StoplinienAbst_f64>10
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>SenKam_Stopplinienabstand_f64 > 100</code>
| 0<<code>BSFVx_Faktor_i8</code><1 (Linieare Änderung)
| <code>BSFVx_Faktor_f64 = 1 </code>
| Nicht unterbrochene Fahrt  
| Nicht unterbrochene Fahrt  
| <code>BSFVx_Faktor_i8</code> = 1 (Linieare Änderung)
| <code>BSFVx_Faktor_f64 = 1 </code>
| Prof. Schneider
| Gosedopp, Wei
| 15.11.2019
| 04.01.2023
|-
| 6
| Liegt eine Vorfahrtssituation vor, muss das Fahrzeug solange warten, bis das Hindernis die Kreuzung überquert hat.
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>SenKam_Stopplinienabstand_f64 <= 15</code>, <code>Vorfahrtssituation_bit = 1</code>
| <code>BSFVx_Faktor_f64 = 0 </code>
| Fahrzeug wartet, bis Hindernis die Kreuzung überquert hat
| <code>BSFVx_Faktor_f64 = 0 </code>
| Gosedopp, Wei
| 04.01.2023
|}
|}
Die Abbildung "Simulationsergebnis unter Berücksichtigung unterschiedlicher Testfälle" steht ferner graphisch dar, wie sich die Werte des <code>BSFVx_Faktor_i8</code> in Abhängigkeit der simulierten Werte für <code>SenKam_StoplinienFlag_bit </code> und <code>SenKam_StoplinienAbst_f64</code> verändert. Dies erfolgt unter Anwendung des entwickelten Moduls zur Steeurung des Fahrzeugsverhaltens an der Stopplinie. (Siehe Abb. 4)


== Fazit ==
Die fehlerfreie Funktionsweise ist zudem im eingefügten Video zu sehen.
Das Modell ist fertig bearbeitet worden und funktioniert gemäß der Anforderungen einwandfrei. Die Entwicklung weiterer Algorithmen ist demmnach möglich, die im Zusammenhang mit dem modellierten Anteil arbeiten. Noch zu erledigen ist die Integration des Software ins reale Fahrzeug, wobei zur reisbungslosen Funktionalität des Modells zusammen mit den anderen Projektkompartimenten einige Anpassungen bezüglich der Kennlinienerkennung noch optimiert werden müssen! Dies umfasst eine der Hauptaufgaben des Teams zur Objekterkennung.
[[Datei:SDE Praktikum 20-21 Stoppkreuzung.gif|none|<b>Abbildung 7: Video der Simulation.</b>]]
 
'''Online-Modell: '''
 
{| class="wikitable" style="margin:auto" style="text-align: center;
|+ Tabelle 4: Tests für das Stopplinienverhalten am Fahrzeug.
! style="font-weight: bold;" | ID
! style="font-weight: bold;" | Testfallbeschreibung
! style="font-weight: bold;" | Eingänge
! style="font-weight: bold;" | Ausgang
! style="font-weight: bold;" | Erwartetes Ergebnis
! style="font-weight: bold;" | Testergebnis
! style="font-weight: bold;" | Testperson
! style="font-weight: bold;" | Datum
|-
| 1
| Das Fahrzeug fährt mit der vorgegebenen Geschwindigkeit, wenn keine Stopplinie erkannt wurde.
| <code>SenKam_StoplinienFlag_bit = 0</code>,  <code>SenKam_StoplinienAbst_f64 = 0 </code>
|
| Das Fahrzeug fährt mit Vollgas.
|
|
|
|-
| 2
| Das Fahrzeug muss im Bereich zwischen 0.15m und 1m vor der Stopplinie immer langsamer fahren.
| <code>SenKam_StoplinienFlag_bit = 1</code>, <code>15 < SenKam_StoplinienAbst_f64 <= 100</code>
|
| Fahrzeug bremst ab.
|
|
|
|-
| 3
| Das Fahrzeug bremst bei eingeleiteter Bremsung weiter ab, auch wenn das Stopplinienflag verloren geht.
| <code>SenKam_StoplinienFlag_bit = 0</code>, <code>SenKam_StoplinienAbst_f64 = 0</code>
|
| Fahrzeug bremst ab. 
|
|
|
|-
| 4
| Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung so muss es 0.15m vor der Stopplinie anhalten
| <code>SenKam_StoplinienFlag_bit = 1</code>, <code>SenKam_StoplinienAbst_f64 <= 0.15</code>
|
| Fahrzeug stoppt vollständig.
|
|
|
|-
| 5
| Das Fahrzeug muss bei Stopplinienerkennung im Bereich weiter als 1m weiter normal fahren.
| <code>SenKam_StoplinienFlag_bit = 1</code>, <code>SenKam_StoplinienAbst_f64 > 100</code>
|
| Fahrzeug bremst nicht ab.
|
|
|
|-
| 6
| Liegt eine Vorfahrtssituation vor, muss das Fahrzeug solange warten, bis das Hindernis die Kreuzung überquert hat.
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>SenKam_Stopplinienabstand_f64 <= 15</code>, <code>Vorfahrtssituation_bit = 1</code>
|
| Fahrzeug wartet, bis Hindernis die Kreuzung überquert hat
|
|
|
|}


[[Datei:Ergebnis_Simulation_1.GIF|mini|700px|Abb. 4: Simulationsergebnis unter Berücksichtigung unterschiedlicher Testfälle.]]


=''' Beispielartikel''' =
== Simulation einer Vorfahrtssituation ==
*[[Wiki-Artikel_schreiben | Tipps zum Schreiben eines Wiki-Artikels]]
*[[ArduMower:_Simulation_der_Kinematik_eines_Fahrzeugs_mit_drei_R%C3%A4dern|Beispiel-Artikel von Prof. Göbel]]
*[[ArduMower:_Kartierung_in_Matlab/Simulink|Beispiel-Artikel von Prof. Schneider]]


ACHTUNG! Die lauffähige Version wurde noch nicht in den trunk übertragen, da im Online-Modell noch keine Objektliste vorhanden ist. Dies würde die Software unkompilierbar machen! Die Ergebnisse finden sich allesamt in [https://svn.hshl.de/svn/MTR_SDE_Praktikum/branches/2022_12_14_OSE_Stopplinienverhalten/ diesem Branch]


Um eine Vorfahrtssituation zu simulieren, muss ein dynamisches Hindernis genau dann auf die Kreuzung zu fahren, wenn das CCF ebenfalls darauf zufährt oder schon da steht. Dazu müssen folgende Maßnahmen getroffen werden:


----
In der <code>start.m</code>-Datei muss als Simulinkmodus 4 und <code>PAR_Modi_Schalter_Fahrbahn_int = 1</code> gewählt werden. Dann muss in dem switch-case, wo der Simulinkmodus abgefragt wird, in Zustand 4 die Startposition des CCF auf
→ zurück zur Übersicht: [[SDE-Team_2019/20]]<br/>
<code>PAR_Esm_x0_I_f64  = 5.04;        % Startposition in x_I</code>
<code>PAR_Esm_y0_I_f64  = 0.5441;      % Startposition in y_I</code>
<code>PAR_Esm_psi0_I_f64 = 145 * pi/180; % Startausrichtung zu x_I</code>
gesetzt werden. Nun beginnt die Fahrt in der Kurve vor der Kreuzung. Anschließend muss ein passendes Hindernis in der Simulation platziert werden. Hierzu muss in der Parameterdatei <code>param_OSE_offline.m</code> ein Hindernis mit Index <code>aIndex = 368</code> auf Fahrbahn 2 hinzugefügt werden. Danach kann die Simulation gestartet werden.

Aktuelle Version vom 9. Januar 2023, 20:02 Uhr

Autoren: Hagen Heuer, Tim Kruse
Bearbeitet: Daniel Gosedopp, Ran Wei
Betreuer: Prof. Schneider, Prof. Göbel

Einleitung

Ziel ist es, das Verhalten des Fahrzeugs an Stopplinien entsprechend den Anforderungen im Lastenheft zu implementieren. Das Fahrzeug muss nach dem Lastenheft im Falle der Erkennung einer Haltelinie immer langsamer fahren. Befindet sich es an der Stopplinie, so muss es dort stoppen und zwei Sekunden halten. Liegt eine Vorfahrtssituation vor, muss dem Hindernis Vorfahrt gewährt und erst dann weitergefahren werden.

Anforderungen

Im Lastenheft des Projekts Carolo Cup wird die Anforderung an das Verhalten des Fahrzeugs an einer Stopplinie in REQ10.2340 festgehalten (s. Abbildung 1).

Die Umsetzung der Anforderung ist im Pflichtenheft wie folgt festgehalten:

Folgende Anforderungen können festgelegt werden und im späteren Projekt berücksichtigt werden.

  • Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung, so muss es 15 cm vor der Stopplinie anhalten.
  • Während das Fahrzeug auf die Stopplinie zufährt, muss die Geschwindigkeit des Fahrzeugs gedrosselt werden.
  • Das Fahrzeug muss vor der Stoppline halten und 2 Sekunden warten.
  • Nach der Wartezeit muss das Fahrzeug die Kreuzung passieren, ohne das die Stopplinie ein weiteres Mal erkannt wird.
  • Die Implementierung erfolgt in Matlab-Simulink.

Konzept

Als Basis für die Implementierung diente die vorhandene MATLAB-Funktion für das Verhalten an Stopplinien. Beim Testen dieser Funktion viel unter anderem auf, dass diese nicht lauffähig ist. Außerdem war die Implementierung der Weiterfahrt nach einer Stopplinie fehlerhaft, da das Fahrzeug die vorherige Stopplinie erneut erkennen würde. Daher wurde ein neues Konzept erstellt, in dem Teile der ursprünglichen Idee berücksichtigt wurden. Zunächst werden die externen Ein- und Ausgänge des Moduls definiert:

Grundidee

Das Modul BSF ermittelt unter anderem die Sollgeschwindigkeit des Fahrzeugs. Dies geschieht entweder auf Basis der Kurvenkrümmung oder wird bei Vorhandensein eines Hindernisses als konstant angenommen. Die Grundidee ist es, die Sollgeschwindigkeit bei Erkennung einer Stopplinie mit einem Faktor (Werte von 0 - 1) zu multiplizieren, also immer weiter zu verringern, bis das Fahrzeug 15cm vor der Linie stillsteht. Der Stillstand soll für zwei Sekunden beibehalten werden. Danach soll das Fahrzeug mit unveränderter Sollgeschwindigkeit weiterfahren (Faktor = 1). Den Verlauf des Faktorwertes zeigt Abb. 3.

Am Anfang ist der Faktor 1, bis eine Stopplinie erkannt wird. Dann verringert er sich kontinuierlich, bis zum Wert 0, sodass das Auto immer langsamer wird und schließlich 15cm vor der Stopplinie zum Stillstand kommt. Hier wird für zwei Sekunden gewartet. Danach wird der Faktor wieder auf 1 gesetzt, sodass wieder auf errechnete Sollgeschwindigkeit beschleunigt wird.

Festlegung von Ein- und Ausgängen

Zur Umsetzung der Funktion werden zunächst die Ein- und Ausgänge festgelegt. Diese zeigt Tab. 1.

Tabelle 1: Ein- und Ausgangsvariablen
Art Variablenname Beschreibung Einheit
Eingang SenKam_Stopplinienabstand_f64 Abstand von Fahrzeugfront zur Stopplinie m
Eingang SenKam_Stopplinienflag_bit Gesetzt, wenn eine Stopplinie erkannt wird -
Eingang Vorfahrtssituation_bit Gesetzt, wenn ein Hindernis an der Kreuzung steht. -
Eingang T Zykluszeit der Simulation s
Ausgang BsfVx_Faktor_f64 Geschwindigkeitsbegrenzungsfaktor, falls Stopplinie erkannt wurde -

Programmablauf

Das Programm wird als Zustandsautomat realisiert, dessen Zustandsdiagramm Abbildung 3 zeigt.

Zu Beginn werden Variablen eingelesen und initialisiert. Anschließend erfolgt die Abfrage des Zustands. Das Programm wird hierbei in vier Zustände unterteilt.

Zustand 1 - Auf Stopplinie warten
Im ersten Zustand werden zunächst Variablen an den Ausgang übergeben. Anschließend wird abgefragt, ob das Stopplinienflag 1 ist. Trifft dies zu wird der Zustand auf 2 gesetzt. Wurde keine Stopplinie gefunden, so wird der Zustand nicht gewechselt.

Zustand 2 - Abbremsen nach Stopplinienerkennung
In diesem Zustand wird abgebremst. Ist der Stopplinienabstand kleiner als 15cm, werden die Motoren abgeschaltet und der Zustand auf 3 gesetzt.

Zustand 3 - An Stopplinie warten
In diesem Zustand wird an der Stopplinie gewartet. Liegt keine Vorfahrtssituation vor, beträgt die Wartezeit 2 Sekunden, ansonsten wird solange gewartet, bis das Hindernis die Kreuzung passiert hat.

Zustand 4 - Kreuzung überfahren Hier wird solange gefahren, bis die Stopplinie überquert wurde, der Stopplinienabstand also <= 0 ist. Dies ist nötig, damit die Stopplinie nicht als neue Stopplinie erkannt wird und das Farzeug erneut anhält. Danach wechselt der Automat wieder in den ersten Zustand.

Umsetzung und Ergebnis der Simulation

Die Implementierung des Algorithmus erfolgt in Simulink als Stateflow Chart. Diese wurde nach dem Zustandsdiagramm aus Abbildung 3 aufgebaut. Der Zustandsautomat besitzt als Eingang den Stopplinienabstand. Die Kamera kann die Stopplinie aber nur bis ca. 52cm vor dem Auto sehen, sodass dieser bei Zufahrt auf die Kreuzung interpoliert werden muss. Dies geschieht im Subsystem "Berechnung_Stopplinienabstand". Um zu prüfen, ob eine Vorfahrtssituation vorliegt, muss auf die LiDAR-Objektliste zugegriffen werden. Das passiert im Subsystem "Überprüfung_Vorfahrtssituation". Im Lastenheft findet sich eine Abbildung, die zeigt, welche Bedingung zur Einleitung einer Vorfahrtssituation erfüllt sein muss. Wenn die Bedingung erfüllt ist, wird das "Vorfahrtssituation_bit" gesetzt.

Das Ergebnis des Stopplinienverhalten wird in der nachfolgenden Abbildung dargestellt.

Im ersten Diagramm ist das Stopplinienflag zu sehen, welches bei Detektion einer Stopplinie auf Eins wechselt.

Im zweiten Diagramm ist der dazugehörige Stopplinienabstand zu sehen. Dieser ist solange Null, bis eine Stopplinie erkannt wurde. Die Stopplinie kann ab einem Abstand von einem Meter oder weniger erfasst werden. Am Verlauf ist zudem gut zu erkennen, dass das Fahrzeug beginnt zu verzögern, da der Abstand nicht linear abnimmt. Nach der zweisekündigen Wartezeit beschleunigt das Fahrzeug wieder und der Abstand zur Stopplinie nimmt linear weiter ab. Erreicht dieser Null, so wird die Stopplinie überfahren.

Im letzten Diagramm wird die errechnete Sollgeschwindigkeit ausgegeben. Auch an dieser Kurve ist gut zu sehen, dass das Fahrzeug verzögert. Wenn der Abstand 15 cm oder weniger beträgt, werden die Motoren abgeschaltet, da der Faktor auf Null abfällt.

Unit-Test & Integrations-Test

Im Folgenden sind die einzelnen Testfälle für den Unit- und Integrations-Test im Offline- und Online-Modell zu sehen.

Offline-Modell: Durch die Eingabe von Parametern konnten folgende Testfälle in der Simulation geprüft werden.

Tabelle 3: Tests für das Stopplinienverhalten in der Simulation.
ID Testfallbeschreibung Eingänge Ausgang Erwartetes Ergebnis Testergebnis Testperson Datum
1 Das Fahrzeug fährt mit der vorgegebenen Geschwindigkeit, wenn keine Stopplinie erkannt wurde. SenKam_Stopplinienflag_bit = 0, SenKam_Stopplinienabstand_f64 = 0 1 Vollgas 1 Gosedopp, Wei 04.01.2023
2 Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung so muss es 0.15m vor der Stopplinie anhalten SenKam_Stopplinienflag_bit = 1, SenKam_Stopplinienabstand_f64 <= 0.15 0 Fahrzeug Stoppt 0 Gosedopp, Wei 04.01.2023
3 Das Fahrzeug muss im Bereich zwischen 0.15m und 1m vor der Stopplinie immer langsamer fahren. SenKam_Stopplinienflag_bit = 1, 15 < SenKam_Stopplinienabstand_f64 <= 100 0 < BSFVx_Faktor_f64 < 1 Bremsen 0 < BSFVx_Faktor_f64 < 1 Gosedopp, Wei 04.01.2023
4 Das Fahrzeug bremst bei eingeleiteter Bremsung weiter ab, auch wenn das Stopplinienflag verloren geht. SenKam_Stopplinienflag_bit = 0, SenKam_Stopplinienabstand_f64 = 0 0 < BSFVx_Faktor_f64 < 1 Bremsen 0 < BSFVx_Faktor_f64 < 1 Gosedopp, Wei 04.01.2023
5 Das Fahrzeug muss bei Stopplinienerkennung im Bereich weiter als 1m weiter normal fahren. SenKam_Stopplinienflag_bit = 1, SenKam_Stopplinienabstand_f64 > 100 BSFVx_Faktor_f64 = 1 Nicht unterbrochene Fahrt BSFVx_Faktor_f64 = 1 Gosedopp, Wei 04.01.2023
6 Liegt eine Vorfahrtssituation vor, muss das Fahrzeug solange warten, bis das Hindernis die Kreuzung überquert hat. SenKam_Stopplinienflag_bit = 1, SenKam_Stopplinienabstand_f64 <= 15, Vorfahrtssituation_bit = 1 BSFVx_Faktor_f64 = 0 Fahrzeug wartet, bis Hindernis die Kreuzung überquert hat BSFVx_Faktor_f64 = 0 Gosedopp, Wei 04.01.2023

Die fehlerfreie Funktionsweise ist zudem im eingefügten Video zu sehen.

Abbildung 7: Video der Simulation.
Abbildung 7: Video der Simulation.

Online-Modell:

Tabelle 4: Tests für das Stopplinienverhalten am Fahrzeug.
ID Testfallbeschreibung Eingänge Ausgang Erwartetes Ergebnis Testergebnis Testperson Datum
1 Das Fahrzeug fährt mit der vorgegebenen Geschwindigkeit, wenn keine Stopplinie erkannt wurde. SenKam_StoplinienFlag_bit = 0, SenKam_StoplinienAbst_f64 = 0 Das Fahrzeug fährt mit Vollgas.
2 Das Fahrzeug muss im Bereich zwischen 0.15m und 1m vor der Stopplinie immer langsamer fahren. SenKam_StoplinienFlag_bit = 1, 15 < SenKam_StoplinienAbst_f64 <= 100 Fahrzeug bremst ab.
3 Das Fahrzeug bremst bei eingeleiteter Bremsung weiter ab, auch wenn das Stopplinienflag verloren geht. SenKam_StoplinienFlag_bit = 0, SenKam_StoplinienAbst_f64 = 0 Fahrzeug bremst ab.
4 Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung so muss es 0.15m vor der Stopplinie anhalten SenKam_StoplinienFlag_bit = 1, SenKam_StoplinienAbst_f64 <= 0.15 Fahrzeug stoppt vollständig.
5 Das Fahrzeug muss bei Stopplinienerkennung im Bereich weiter als 1m weiter normal fahren. SenKam_StoplinienFlag_bit = 1, SenKam_StoplinienAbst_f64 > 100 Fahrzeug bremst nicht ab.
6 Liegt eine Vorfahrtssituation vor, muss das Fahrzeug solange warten, bis das Hindernis die Kreuzung überquert hat. SenKam_Stopplinienflag_bit = 1, SenKam_Stopplinienabstand_f64 <= 15, Vorfahrtssituation_bit = 1 Fahrzeug wartet, bis Hindernis die Kreuzung überquert hat


Simulation einer Vorfahrtssituation

ACHTUNG! Die lauffähige Version wurde noch nicht in den trunk übertragen, da im Online-Modell noch keine Objektliste vorhanden ist. Dies würde die Software unkompilierbar machen! Die Ergebnisse finden sich allesamt in diesem Branch

Um eine Vorfahrtssituation zu simulieren, muss ein dynamisches Hindernis genau dann auf die Kreuzung zu fahren, wenn das CCF ebenfalls darauf zufährt oder schon da steht. Dazu müssen folgende Maßnahmen getroffen werden:

In der start.m-Datei muss als Simulinkmodus 4 und PAR_Modi_Schalter_Fahrbahn_int = 1 gewählt werden. Dann muss in dem switch-case, wo der Simulinkmodus abgefragt wird, in Zustand 4 die Startposition des CCF auf PAR_Esm_x0_I_f64 = 5.04;  % Startposition in x_I PAR_Esm_y0_I_f64 = 0.5441;  % Startposition in y_I PAR_Esm_psi0_I_f64 = 145 * pi/180; % Startausrichtung zu x_I gesetzt werden. Nun beginnt die Fahrt in der Kurve vor der Kreuzung. Anschließend muss ein passendes Hindernis in der Simulation platziert werden. Hierzu muss in der Parameterdatei param_OSE_offline.m ein Hindernis mit Index aIndex = 368 auf Fahrbahn 2 hinzugefügt werden. Danach kann die Simulation gestartet werden.