Stopplinien-Verhalten: Unterschied zwischen den Versionen

Aus HSHL Mechatronik
Zur Navigation springen Zur Suche springen
 
(29 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 4: Zeile 4:


== Einleitung ==
== 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. Anschließend überquert es Kreuzung und setzt die Weiterfahrt fort.
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 ==
== 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>
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>
<gallery mode = "traditional" widths=500px heights=150px>
File:Anforderungen.JPG|Abb. 1: Lastenheftauszug Stopplinien-Verhalten.
File:Anforderungen.JPG|<b>Abbildung 1: Lastenheftauszug Stopplinien-Verhalten.</b>
</gallery>
</gallery>


Die Umsetzung der Anforderung ist im Pflichtenheft wie folgt festgehalten:<br>
Die Umsetzung der Anforderung ist im Pflichtenheft wie folgt festgehalten:<br>
<gallery mode = "traditional" widths=1250px heights=230px>
<gallery mode = "traditional" widths=1250px heights=230px>
File:Pflichtenheft Heuer Kruse MS2.png|Abb. 2: Pflichtenheftauszug zu REQ10.2340.
File:Pflichtenheft Heuer Kruse MS2.png|<b>Abbildung 2: Pflichtenheftauszug zu REQ10.2340.</b>
</gallery>
</gallery>


Zeile 29: Zeile 29:


=== Grundidee ===
=== 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. 1.
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.


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


Zeile 46: Zeile 46:
|-
|-
| Eingang
| Eingang
| SenKam_StoplinienAbst_f64
| SenKam_Stopplinienabstand_f64
| Abstand von Fahrzeugfront zur Stopplinie
| Abstand von Fahrzeugfront zur Stopplinie
| m
| m
|-
|-
| Eingang
| Eingang
| SenKam_StoplinienFlag_bit
| SenKam_Stopplinienflag_bit
| Gesetzt, wenn eine Stopplinie erkannt wird
| Gesetzt, wenn eine Stopplinie erkannt wird
| -
| -
|-
|-
| Eingang
| Eingang
| BsfVx_VxSoll_f64
| Vorfahrtssituation_bit
| Aktuelle Sollgeschwindigkeit des Fahrzeugs
| Gesetzt, wenn ein Hindernis an der Kreuzung steht.
| m/s
| -
|-
| Eingang
| T
| Zykluszeit der Simulation
| s
|-
|-
| Ausgang
| Ausgang
Zeile 66: Zeile 71:
|}
|}


Die Funktion ist als Zustandsautomat implementiert, mit einigen internen Variablen arbeitet. Diese sind:
=== Programmablauf ===
 
Das Programm wird als Zustandsautomat realisiert, dessen Zustandsdiagramm Abbildung 3 zeigt.
{| class="wikitable" style="margin:auto" style="text-align: center;
|+ Tabelle 2: Interne Variablen des Zustandsautomaten
! Variable !! Variablenname (Ausgang/Eingang) !! Beschreibung !! Einheit
|-
| Zustand
| zustand/zustandIN
| Aktueller Zustand des Automaten
| -
|-
| Vorheriger Stopplinienabstand
| stopplinienabstandAlt/stopplinienabstandAltIN
| Abstand zur Stopplinie im vorherigen Zyklus
| m
|-
| Haltezyklus
| halteZyklus/halteZyklusIN
| Wenn die Zykluszeit 0.01s beträgt, dann müssen für eine Anhaltezeit von 2s 2s/0.01s = 200 Zyklen gewartet werden. Diese Variable dient als Laufvariable zum hochzählen der Anzahl der verstrichenen Zyklen.
| -
|-
| Faktor
| faktor/faktorIN
| Muss noch ermittelt werden.
| -
|}


 
<gallery mode = "traditional" widths=800px heights=380px>
Funktionstests ergaben, dass das Einspurmodell für diese Anwendung nicht verändert werden kann, da es Probleme mit einem stehenden Fahrzeug gibt. Daher wurde auf das Kinematikmodell zurückgegriffen und die Regelparameter angepasst, da dieses Modell auch für eine Geschwindigkeit kleiner 0,2 m/s² ausgelegt ist.
Datei:Stoppverhalen Automat.png|<b>Abb. 3: Progammablaufplan des Stopplinien-Verhaltens.</b>
 
Der Programmablaufplan des neuen Konzeptes ist in Abb. 3 zu sehen.
 
<gallery mode = "traditional" widths=400px heights=1050px>
File:BSF Stopplinienverhalten.png|Abb. 3: Progammablaufplan
</gallery>
</gallery>


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


'''Case 1''' (Zustand == 1)<br/>
'''Zustand 1 - Auf Stopplinie warten'''<br>
In Case 1 werden zunächst Variablen an den Ausgang übergeben. Anschließend wird abgefragt, ob das Stopplinienflag 1 ist. Trifft dies zu wird das interne Stopplinienflag gesetzt und der Stopplinienabstand in der Variable Faktor gespeichert. Anschließt wird der Zustand auf 2 gesetzt. Wurde keine Stopplinie gefunden, so werden die Variablen überschrieben und der Zustand nicht gewechselt.
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.


'''Case 2''' (Zustand == 2)<br/>
'''Zustand 2 - Abbremsen nach Stopplinienerkennung'''<br>
Ist der Case 2 aktiv, so werden zunächst Variablen mit dem vorherigen Wert überschrieben. Wenn das Stopplinienflag intern Eins ist, wird dieses mit dem selben Wert überschrieben.
In diesem Zustand wird abgebremst. Ist der Stopplinienabstand kleiner als 15cm, werden die Motoren abgeschaltet und der Zustand auf 3 gesetzt.
Ist der Stopplinienabstand Null, so wurde die Stopplinie verloren und der Stopplinienabstand wird mit Hilfe der Geschwindigkeit und dem Faktor sowie der Simulationszeit interpoliert. Durch die Rechnung Stopplinienabstand = Stopplinienabstand alt - Geschwindigkeit * 0,005 wird die zurückgelegte Strecke im letzten Programmzyklus vom alten Abstand subtrahiert. Somit ergibt sich der neue Stopplinienabstand. Anschließend wird die neue Geschwindigkeit errechnet und der Zustand auf Zwei gesetzt.
Falls die errechnete Geschwindigkeit größer Eins sein sollte, wird der  Faktor auf Eins begrenzt.
Wenn der Stopplinienabstand kleiner 15 cm sein sollte, werden die Motoren abgeschaltet und der Zustand auf Drei gesetzt.


Sollte das Stopplinienflag intern nicht gesetzt sein, so wird dieses wieder auf Null gesetzt, das Fahrzeug auf Sollgeschwindigkeit beschleunigt und der Zustand auf 1 gesetzt.
'''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.


Zuletzt wird noch der Stopplinienabstand gesichert.
'''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.


'''Case 3'''  (Zustand = 3)<br/>
== Umsetzung und Ergebnis der Simulation ==
In Case 3 werden zunächst die Variablen gesichert. Anschließend wird der aktuelle Haltezyklus mit dem vorgegebenen Haltezyklus verglichen. Mit Hilfe dieser Haltezyklen kann die Haltezeit erfasst werden, da die Simulationszeit 0,005 Sekunden beträgt. Solange die Haltezyklen geringer sind wie die vorgegebene Zahl, werden diese um eins addiert und der Case 3 nicht verlassen. Im anderen Fall wird Fahrzeug wieder beschleunigt und es wird in den Case 4 gewechselt.  
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.


'''Case 4'''  (Zustand = 4)<br/>
<gallery mode = "traditional" widths=1100px heights=400px>
Im vierten Case wird der Abstand zur Stopplinie abgefragt. Falls dieser größer Null ist, soll das Fahrzeug weiter fahren und den Case nicht verlassen. Falls der Abstand zur Stopplinie Null ist, soll in den Case 1 gewechselt werden und dort auf eine neue Stopplinie reagiert werden.
File:Stoppverhalten_Stateflow.png|<b>Abbildung 5: Implementierung der Anhalte- und Vorfahrtlogik.</b>
 
Falls kein Case ausgewählt wurde, soll in den vorherigen Case gewechselt werden und das Fahrzeug weiter fahren.
 
== Umsetzung und Ergebnis der Simulationsumgebung ==
''' Autoren:''' Hagen Heuer, Tim Kruse<br/>
 
Die Umsetzung der Implementierung erfolgt wie bereits erwähnt im Offline-Modell mit Hilfe von Simulink und Matlab c-Code. Hierfür wurde eine Matlab-Funktion eingefügt und anhand des Programmablaufplans programmiert. Da die Funktion in jedem Zyklus neu aufgerufen wird, gehen die vorherigen Werte der Variablen verloren. Dies musst allerdings für zwei Werte verhindert werden, da diese im nächsten Zyklen von Bedeutung sind. Somit wurde das Ausgangssignal über einen Memory-Baustein an den Eingang zurück gegeben. Außerdem wurden im Memory-Baustein passende initialwerte hinterlegt, da im ersten Aufruf der Funktion noch keine Werte errechnet wurden.<br/>
Die Matlab-Funktion ist zudem in Abbildung 5 zu sehen.
 
<gallery mode = "traditional" widths=750px heights=400px>
File:Matlabfunktion Stopplinienverhalten.png|Abb. 5: Matlab-Funktion
</gallery>
</gallery>


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.
Das Ergebnis des Stopplinienverhalten wird in der nachfolgenden Abbildung dargestellt.
 
Im zweiten Diagramm ist der dazugehörige Stopplinienabstand zu sehen. Diese ist solange Null bis eine Stopplinie erkannt wurde. Die Stopplinie kann ab einem Abstand von 1 Meter oder weniger erfasst werden. In der Kurve ist zudem gut zu erkennen, dass das Fahrzeug beginnt zu verzögern, da der Abstand nicht Linear abnimmt.<br/>
Funktionstest ergaben, dass es zu einem Verlust der Stopplinie kommen kann. Für diesen Fall wurde eine Interpolation des Stopplinienabstands implementiert. Hierdurch kann auf Basis der Geschwindigkeit der Stopplinienabstand errechnet werden.
 
Im letzten Diagramm wird die errechnete Geschwindigkeit ausgegeben. Auf diese wird der Faktor aus der Matlab-Funktion addiert. Auch in 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.
 
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 und das Stopplinienflag wird wieder Null.


<gallery mode = "traditional" widths=800px heights=520px>
<gallery mode = "traditional" widths=800px heights=520px>
File:Ergebnis StopplinienverhaltenV2.png|Abb. 6: Ergebnis
File:Ergebnis StopplinienverhaltenV2.png|<b>Abbildung 6: Wichtige Variablenwerte beim Test der Funktion.</b>
</gallery>
</gallery>


Das Verhalten wird zudem im folgenden Video ersichtlich.
Im ersten Diagramm ist das Stopplinienflag zu sehen, welches bei Detektion einer Stopplinie auf Eins wechselt.
 
[[Datei:SDE Praktikum 20-21 Stoppkreuzung.gif|none|Abb. 7: Video der Simulation]]


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.


<onlyinclude><div style="clear:{{{{{|safesubst:}}}#switch:{{{1}}}
<onlyinclude><div style="clear:{{{{{|safesubst:}}}#switch:{{{1}}}
Zeile 160: Zeile 117:
}};"></div></onlyinclude>
}};"></div></onlyinclude>


== Unit-Test & Integrations-Test==
== Unit-Test & Integrations-Test ==
''' Autoren:''' Hagen Heuer, Tim Kruse<br/>
Im Folgenden sind die einzelnen Testfälle für den Unit- und Integrations-Test im Offline- und Online-Modell zu sehen.  
Im Folgenden sind die einzelnen Testfälle für den Unit- und Integrations-Test zu sehen. Durch die Eingabe von Parametern konnten folgende Testfälle geprüft werden.
 
Die fehlerfreie Funktionsweise ist zudem im eingefügten Video zu sehen.
'''Offline-Modell: '''
Durch die Eingabe von Parametern konnten folgende Testfälle in der Simulation geprüft werden.


{| class="mw-datatable"
{| class="wikitable" style="margin:auto" style="text-align: center;
|+ 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 177: Zeile 136:
| 1
| 1
| Das Fahrzeug fährt mit der vorgegebenen Geschwindigkeit, wenn keine Stopplinie erkannt wurde.
| 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
| Heuer, Kruse
| Gosedopp, Wei
| 15.06.2020
| 04.01.2023
|-
|-
| 2
| 2
| Trifft das Fahrzeug bei seiner Rundfahrt an eine Stopp-Kreuzung so muss es 15cm 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 <= 15 Max_Abstand
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>SenKam_Stopplinienabstand_f64 <= 0.15</code>
| 0
| 0
| Fahrzeug Stoppt  
| Fahrzeug Stoppt  
| 0
| 0
| Heuer, Kruse
| Gosedopp, Wei
| 15.06.2020
| 04.01.2023
|-
|-
| 3
| 3
| Das Fahrzeug muss im Bereich zwischen 0.15m und 1m vor der Stopplinie immer langsamer fahren.
| 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
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>15 < SenKam_Stopplinienabstand_f64 <= 100</code>
| 0<<code>BSFVx_Faktor_i8</code><1
| <code>0 < BSFVx_Faktor_f64 < 1 </code>
| Bremsen   
| Bremsen   
| 0<<code>BSFVx_Faktor_i8</code><1
| <code>0 < BSFVx_Faktor_f64 < 1 </code>
| Heuer, Kruse
| Gosedopp, Wei
| 15.06.2020
| 04.01.2023
|-
|-
| 4
| 4
| Das Fahrzeug bremst bei eingeleiteter Bremsung weiter ab, auch wenn das Stopplinienflag verloren geht.
| Das Fahrzeug bremst bei eingeleiteter Bremsung weiter ab, auch wenn das Stopplinienflag verloren geht.
| SenKam_StoplinienFlag_bit = 0, SenKam_StoplinienAbst_f64 = 0
| <code>SenKam_Stopplinienflag_bit = 0</code>, <code>SenKam_Stopplinienabstand_f64 = 0</code>
| 0<<code>BSFVx_Faktor_i8</code><1
| <code> 0 < BSFVx_Faktor_f64 < 1 </code>
| Bremsen   
| Bremsen   
| 0<<code>BSFVx_Faktor_i8</code><1
| <code> 0 < BSFVx_Faktor_f64 < 1 </code>
| Heuer, Kruse
| Gosedopp, Wei
| 15.06.2020
| 04.01.2023
|-
|-
| 5
| 5
| Das Fahrzeug muss bei Stopplinienerkennung im Bereich weiter als 1m weiter normal fahren.
| Das Fahrzeug muss bei Stopplinienerkennung im Bereich weiter als 1m weiter normal fahren.
| SenKam_StoplinienFlag_bit = 1, SenKam_StoplinienAbst_f64>100
| <code>SenKam_Stopplinienflag_bit = 1</code>, <code>SenKam_Stopplinienabstand_f64 > 100</code>
| <code>BSFVx_Faktor_i8</code> = 1
| <code>BSFVx_Faktor_f64 = 1 </code>
| Nicht unterbrochene Fahrt  
| Nicht unterbrochene Fahrt  
| <code>BSFVx_Faktor_i8</code> = 1  
| <code>BSFVx_Faktor_f64 = 1 </code>
| Heuer, Kruse
| Gosedopp, Wei
| 15.06.2020
| 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
|}
|}


== Diskussion ==
Die fehlerfreie Funktionsweise ist zudem im eingefügten Video zu sehen.
''' Design-Review des Konzept '''
[[Datei:SDE Praktikum 20-21 Stoppkreuzung.gif|none|<b>Abbildung 7: Video der Simulation.</b>]]


In Abbildung 4 fehlt die Beschriftung der Achsen.
'''Online-Modell: '''
* Gelöst am 06.06.2020


Warum woher kommt die 0.8, durch die der Abstand zur Stopplinie geteilt wird?
{| class="wikitable" style="margin:auto" style="text-align: center;
* Behoben am 07.06.2020
|+ 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
|
|
|
|}


Wie soll mit dem "Verlust" einer Stopplinie Umgegangen werden?
(Stopplinie wird erkannt und als zu-überquerend klassifiziert, wird dann aber aus nicht näher bekannten Gründen nicht mehr erkannt)
* Konzept dahingehend überarbeitet am 10.06.2020


Hier und da finden sich Rechtschreibfehler.
== Simulation einer Vorfahrtssituation ==
* Rechtschreibfehler korrigiert am 27.06.2020


Review: Marius Köhler, 02.06.2020
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]


Review des überarbeiteten Konzepts ergab keine Beanstandung.
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:


Review II: Marius Köhler, 15.06.2020
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
----
<code>PAR_Esm_x0_I_f64  = 5.04;        % Startposition in x_I</code>
→ zurück zur Übersicht: [[SDE-Team_2020/21]]<br/>
<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.