Added Subsection for the Joystick lib

Latex/main.tex

@@ -19,7 +19,7 @@
 %	PACKAGES AND OTHER DOCUMENT CONFIGURATIONS
 %----------------------------------------------------------------------------------------
 
-\documentclass[12pt]{article}
+\documentclass{article}%[12pt]{article}
 % Include the file specifying the document structure and custom commands
 \input{structure.tex} 
 \usepackage{hyperref}
@@ -281,12 +281,14 @@ Das Commands Array wurde dann wie in der Sektion allgemeine Verwendung von RF24
 Der Roboter kann über ein Steuerkreuz mit 4 Buttons oder einen Joystick gesteuert werden. Begonnen wurde mit der Steuerung über die Buttons, dann wurde die Steuerung mittels Joystick realisiert und anschließend wurde diese dann noch stark variable als C++ Library Implementiert.
 
 \subsection{Button Steuerung} %Yves/Lukas
-%TODO verwendet wurde die lib ShiftRegButtons...
-Die Button Steuerung ermöglicht entweder Vorwärts, Rückwärts, Links oder Rechts zu fahren. Dabei werden die Beiden Motoren mit den jeweilig maximalen PwM-Werten angesprochen, sprich sie sind entweder eingeschaltet oder abgeschaltet.
+%TODO WOHER KOMMT DER CODE? aus der ShiftRegButtonLib?
+Das ansprechen der Buttons erfolgte mithilfe der ShiftRegButtonLib Library
+\cite{nanoGame} %TODO Hierher?!
+Die Button Steuerung ermöglicht entweder Vorwärts, Rückwärts, Links oder Rechts zu fahren. Dabei werden die Beiden Motoren mit den jeweilig maximalen PWM-Werten angesprochen, sprich sie sind entweder eingeschaltet oder abgeschaltet.
 \paragraph{Logik hinter der Steuerung}
 Der Roboter soll für Folgende Tasten folgende Bewegungen durchführen:
 \begin{itemize}
-\item Oben - vorwäts fahren
+\item Oben - vorwärts fahren
 \item Unten - rückwärts fahren
 \item Rechts - Drehung im Uhrzeigersinn
 \item Links - Drehung gegen den Uhrzeigersinn
@@ -294,37 +296,56 @@ Der Roboter soll für Folgende Tasten folgende Bewegungen durchführen:
 
 Realisiert wurde es folgendermaßen:
 \begin{itemize}
-\item vorwäts fahren - setzte PWM-Werte beider Motoren auf das Maximum
-\item rückwärts fahren - setzte PWM-Werte beider Motoren auf das minimum
-\item Drehung im Uhrzeigersinn - setze den PWM-Wert des rechten Motors auf das minimum und den des linken auf das maximum
-\item Drehung gegen den Uhrzeigersinn - setze den PWM-Wert des rechten linken auf das minimum und den des rechten auf das maximum
+\item vorwärts fahren - setzte PWM-Werte beider Motoren auf das Maximum
+\item rückwärts fahren - setzte PWM-Werte beider Motoren auf das Minimum
+\item Drehung im Uhrzeigersinn - setze den PWM-Wert des rechten Motors auf das Minimum und den des linken auf das Maximum
+\item Drehung gegen den Uhrzeigersinn - setze den PWM-Wert des rechten linken auf das Minimum und den des rechten auf das Maximum
 \end{itemize}
 
 \subsection{Joystick Steuerung} %Lukas
-Die Steuerung über einen Joystick ermöglicht das kontrolieren über die Aussteuerung des Joysticks. Verwendet wurde ein klassischer Joystick, welcher aus dem Consolen bereich stammt.
-%TODO Joysticknamen mit verlinkung auf datenblatt...
+Die Steuerung über einen Joystick ermöglicht das kontrollieren über die Aussteuerung des Joysticks. Verwendet wurde ein klassischer Joystick, welcher aus dem Consolen Bereich stammt. Da der verwendet Joystick von einen Billigproduzenten auch China stammt gibt es auch leider kein Datenblatt oder sonstige Informationen die hier verlinkt hätten werden können.
 \paragraph{Grundlegende Verwendung des Joysticks}
-Der Joystick besitzt zwei analoge Anschlüsse und überträt dort werte von 0 bis 511 je nach aussteuerung des Joysticks, jede Achse hat somit ihren eigenen Pin.
+Der Joystick besitzt zwei analoge Anschlüsse und überträgt dort werte von 0 bis 511 je nach Aussteuerung des Joysticks, jede Achse hat somit ihren eigenen Pin.
 Die Werte der jeweiligen Achsen können dann über AnalogRead() mit dem Pin der Achse als Argument abgefragt werden.
 Die Mittelstellung des Joysticks ist demnach bei 255.
 \subparagraph{Mapping:}
-Da der Bereich der Werte nicht zu dem der benötigten PWM- Werten passt werden diese mithilfe der map() Funktion von 0 bis 511 auf -255 bis 255 gemapt. 
-Nach dem Mapping kann die Auswertung über die Richtung durchgeführt werden um dann in den entsprechenden fällen die gemappten werte als geschwindigkeit zu interpretieren.
-\subparagraph{Anbringung und dessen Auswrikung auf die Steuerung}
-Der Joystick wurde so an das Shield angebracht, so dass druch ein nach Vorne drücken die Achsenwerte für die Y-Achse kleiner werden und ein nach Links drücken die X-Achse ebenfalls kleiner werden. Die Aussteuerung nach Rechts folgt demnach zu einer erhöhung der Achsenwerte der X-Achse und die Aussteuerung nach unten eine erhöhung der Achsenwerte der Y-Achsen.   
+Da der Bereich der Werte nicht zu dem der benötigten PWM-Werten passt werden diese mithilfe der map() Funktion von 0 bis 511 auf -255 bis 255 gemapt. 
+Nach dem Mapping kann die Auswertung über die Richtung durchgeführt werden um dann in den entsprechenden fällen die gemappten werte als Geschwindigkeit zu interpretieren.
+\subparagraph{Anbringung und dessen Auswirkung auf die Steuerung}
+Der Joystick wurde so an das Shield angebracht, so dass durch ein nach Vorne drücken die Achsenwerte für die Y-Achse kleiner werden und ein nach Links drücken die X-Achse ebenfalls kleiner werden. Die Aussteuerung nach Rechts folgt demnach zu einer Erhöhung der Achsenwerte der X-Achse und die Aussteuerung nach unten eine Erhöhung der Achsenwerte der Y-Achsen.   
 \paragraph{Logik hinter der Steuerung}
-Zuerst wurde die Logik der Button Steuerung übernommen, jedoch mit folgenden veränderungen. 
-Vorwärtsfahren wird jetzt aktiviert, wenn der Achsenwert der Y-Achse kleiner als die Mittelstellung abzüglich einses toleranzbereiches ist.
-Das Rückwärtsfahren wird aktiviert, wenn der Achsenwert der Y-Achse größer als die Mittelstellung zuzüglich eines toleranzbereiches ist.
-Eine Drehung im Uhrzeigersinn wrid ausgelöst, wenn der Achsenwert der X-Achse größer als die Mittelstellung zuzüglich eines toleranzbereiches ist. Demnach wird eine Drehung gegen den Uhrzeigersinn ausgelöst, wenn der Achsenwert der X-Achse kleiner als die Mittelstellung abzüglich eines toleranzbereiches ist.
+Zuerst wurde die Logik der Button Steuerung übernommen, jedoch mit folgenden Veränderungen. 
+Vorwärtsfahren wird jetzt aktiviert, wenn der Achsenwert der Y-Achse kleiner als die Mittelstellung abzüglich eines Toleranzbereiches ist.
+Das Rückwärts-fahren wird aktiviert, wenn der Achsenwert der Y-Achse größer als die Mittelstellung zuzüglich eines Toleranzbereiches ist.
+Eine Drehung im Uhrzeigersinn wird ausgelöst, wenn der Achsenwert der X-Achse größer als die Mittelstellung zuzüglich eines Toleranzbereiches ist. Demnach wird eine Drehung gegen den Uhrzeigersinn ausgelöst, wenn der Achsenwert der X-Achse kleiner als die Mittelstellung abzüglich eines Toleranzbereiches ist.
 In dieser Version ist der Toleranzbereich im Code mit 20 Festgeschrieben.
 \paragraph{Umsetzung der Steuerung}
-Die Umsetzung ist nichts anderes als die PWM-Werte für die beiden Motoren in jedem der Steuerungsfälle zu ermitteln. Da die werte schon gemappt wurden können diese nun hier wieder verwendet werden. In der Folgenden Graphik ist zu erkennen wann welche werte gesendet werden und ab welcher Aussterung die PWM-Werte negativ bzw. positiv werden.
-%TODO Graphik für die Übersetzung
+Die Umsetzung ist nichts anderes als die PWM-Werte für die beiden Motoren in jedem der Steuerungsfälle zu ermitteln. Da die werte schon gemappt wurden können diese nun hier wieder verwendet werden. In der Folgenden Graphik ist zu erkennen wann welche Aktion Ausgeführt werden soll. Wenn zum Beispiel der Joystick nach Vorne-rechts gerückt wird ist der wert von der X-Achse über dem Mittelwert und der der Y-Achse unter dem Mittelwert. Demnach werden dann die PWM-Werte entsprechend gesetzt.
+\begin{figure}[h]
+	\includegraphics[width=8cm]{JoystickToLogic.png}
+	\centering
+	\caption{Interpretation der Aussteuerung}
+\end{figure}
 
 \subsection{Überführung der Joystick Steuerung in eine Library} %Lukas
-%TODO Hier wurde besonderes Augenmerk auf wiederverwendbarkeit und varibilität gelegt.   
-
+Hier wurde besonderes Augenmerk auf Wiederverwendbarkeit und Variabilität gelegt.
+Des weiteren ist die Library komplett in C++ geschrieben. Wie genau eine C++ Library erstellt wird, wird in dieser Sektion nicht aufgefasst sondern nur die Besonderheiten betreffend der Joystick Library.
+\subsection{Aufbau der Klassen}
+Um eine höhere Variabilität und Wiederverwendbarkeit zu ermöglichen wurde die Library Objekt Orientiert programmiert. Dazu wurden drei Klassen Implementiert: Joystick, Motor und Steuerung.
+\begin{figure}[h]
+	\includegraphics[width=13cm]{JoystickUML.PNG}
+	\centering
+	%\caption{Interpretation der Aussteuerung}
+\end{figure}\begin{figure}[h]
+	\includegraphics[width=7cm]{MotorUML.PNG}
+	\centering
+	%\caption{Interpretation der Aussteuerung}
+\end{figure}\begin{figure}[h]
+	\includegraphics[width=8cm]{SteuerungUML.PNG}
+	\centering
+	%\caption{Interpretation der Aussteuerung}
+\end{figure}
+Von diesen Klassen ist die Steuerung diejenige, welche die die eigentliche Logik beinhaltet, jedoch benötigt man zur Verwendung der implementierten Steuerung zwei Motoren und einen Joystick. Um einen Motor zu erstellen reicht es den Höchsten und den Niedrigsten PWM-Wert anzugeben. Über das Attribut PWMValue lässt sich nach dem Aufruf der updateValues() Funktion der Steuerungsklasse der Aktuelle PWM-Wert jedes Motors einzeln abrufen. Beim instantiieren der Joystick-klasse müssen mehr Daten angegeben werden. Die ersten beiden Parameter legen die Pins fest an welchen die jeweilige Achse angeschlossen ist. Die nächsten zwei sind wieder der niedrige und Höchste Wert. Zum Schluss benötigt der Joystick noch einen Wert, der einen Abstand zum Mittelpunkt von der Aktivierung der Steuerung ausschließt das sogenannte spaceing. Es wird benötigt, da der Joystick selbst in der Mittelstellung werte sendet, die über bzw unter 0 liegen.   
 \newpage
 \section{Arduino Libaries} %Lukas
 \subsection{OneWire}