\documentclass[12pt,a4paper,titlepage,oneside]{article}
%\documentclass[12pt,a4paper,titlepage,oneside]{report}

\usepackage{ProtocolHeader}

\begin{document}
\MakeTitleAndTOC

% howto use graphics
% \begin{figure}[!ht]
% \includegraphics[width=\textwidth]{ftol_pic.pdf}
% \centering
% \caption{Ein kleines, fehlertolerantes Computersystem}
% \label{fig:angabe}
% \end{figure}

%\chapter %for use with report class
\section
{Einleitung}

Es ist ein einfacher Taschenrechner, der die Grundrechnungsarten Addition, Subtraktion,
Multiplikation und Division beherrscht, auf einem FPGA Board zu realisieren. Dabei soll als Eingabegerät eine PS/2
Tastatur beziehungsweise als Ausgabegerät ein VGA Monitor dienen. Als zusätzliches Feature soll eine
History eingebaut werden, sodass vergangene Berechnungen angezeigt werden
können. Außerdem besteht die Möglichkeit diese History per RS232-Schnittstelle zu
exportieren bzw. importieren.

\section{Requirement Spezifikation}

TODO: in der Angabe steht nix von einer extrigen Requirement Spezifikation neben der High Level Beschreibung, aber im Template und Auf den Folien ist es als 3. Punkt neben High- und Low Level Spec noch erwähnt.

Die Subsections sind vielleicht ein kleiner Overshoot.


%TODO
wie schaut syntax aus der eingabe? 

\subsection{Eingabe}

\req{Der Taschenrechner soll eine Eingabe bestehend aus den Ziffern '0'-'9', Leerzeichen ' ', '+', '-', '*' und '/' ausrechnen können}

\req{Der Syntax für so eine Eingabe - eine \textbf{Expression} - sieht folgendermaßen aus:

DIGIT = ``0`` \textbar ``1`` \textbar ``2`` \textbar ``3`` \textbar ``4`` \textbar ``5`` \textbar ``6`` \textbar ``7`` \textbar ``8`` \textbar ``9`` ;

UNSIGNED = DIGIT { DIGIT } ;

OPERAND = [``-``] UNSIGNED ;

OPERATOR = ``+`` \textbar ``-`` \textbar ``*`` \textbar ``/`` ;

EXPRESSION = OPERAND \{ OPERATOR OPERAND \} ;
}

\req{Dabei soll Punkt- vor Strichrechnung gelten}

\req{Die Zahlen dürfen im Zahlenbereich eines signed long liegen ($-2^31$ bis $2^31-1$)}

\req{Die Eingabe darf aus 70 Zeichen bestehen}

\req{Die Eingabe erfolgt über eine PS/2-Tastatur, 'Enter' schließt die Eingabe ab und berechnet das Ergebnis, 'Backspace löscht das zuletzt eingegebene Zeichen'}

\subsection{Ausgabe}

\req{Die Anzeige der Ein- und Ausgaben erfolgt über einen VGA Monitor. Es wird pro Zeile eine Eingabe oder Ausgabe angezeigt. Die aktuelle Eingabezeile befindet sich zuoberst, darunter das Ergebnis der vorigen Rechnung, darunter die Eingabe der vorigen Rechnung und so weiter}

\subsection{History}

\req{Die letzten 50 Ein- und Ausgaben korrekter Eingaben werden als History im Speicher gehalten}

\req{Die History soll über RS232, auf Anfrage vom PC, oder bei Betätigen eines Buttons am Development Board, zum PC gesendet werden}


\section{High-Level Design Description}

TODO In Abbildung X ist der Aufbau des Taschenrechners zu sehen. Der Taschenrechner besteht aus folgenden Modulen:

%\subsection{Module}

was gibts fuer module? vorschlag:
\begin{itemize}
\item VGA - ist gegeben.
\item PS/2 - ist gegeben.
\item RS232 - TODO. baudrate? kodierung? (8N1?)
\item Historymodul - Verwaltung des dahinterliegenden Buffers
\item Parser - wertet ein gegeben Buffer aus.
\item Controlmodul - soll das Bindeglied zwischen allen Modulen sein, nimmt eingabe entgegen, legt berechnungen im buffer ab, ...?
\item Modul für die Kommunikation zum PC? oder gleich im Historymodul implementieren? oder ins
Controlmodul mit rein packen?
\end{itemize}

%\subsection{Interfaces}

\subsection{Externe Interfaces}

das ist mir noch nicht ganz klar was die da wollen. was meinen die z.b. mit ``interfaces
to VGA'' unter ``physical interfaces'' (seite 10 in der exercise.pdf)

``physikalisch'' im sinne der VHDL entity? oder doch den physischen stecker?
Ersteres wuerde ich unter Logisches Interface verstehen.


\subsection{Interfaces der Module}

\subsubsection{VGA}

\subsubsection{PS/2}

\subsubsection{RS232}

\subsubsection{History}

\subsubsection{Parser}

\subsubsection{Control}

\subsection{Verhalten der Interfaces}

welche tasten als input erlauben (haben numblock und normale ziffern unterschiedliche scancodes?)?
wie werden ueberlaeufe behandelt?
fehlerhafte eingaben?
wie schaut die ausgabe aus?
was ausgaben bei fehler?
wie kann download oder upload einer history gestartet werden?
wie kann auf die history zugegriffen werden?
soll in der eingabe auch mit pfeiltasten (links,rechts) gescrolled werden koennen?


\subsection{Testfälle}

alle requirements muessen von testfaellen abgedeckt werden!


\section{Detailed Design Description}

alle Module hier genauer beschreiben

%TODO
wie wollen wir das design implementieren?
event sequence diagrams! UML?
wie schauen interne strukturen aus? (speicher, logische bloecke, parallele prozesse, state machines)

\subsection{VGA}

\subsection{PS/2}

\subsection{RS232}

\subsection{History}

\subsection{Parser}

\subsection{Control}


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%LISTINGS
%\newpage
%\appendix
%\section{Listings}
%howto include src files
%\subsection{einfache Variante -- generierter Sourcecode}
%\label{att:einfachsrc}
%\lstinputlisting{../einfach/einfach.src}
%\lstinputlisting[firstnumber=24, firstline=24, lastline=34]{bla.src} %firstnumber shouldn't be necessary, but there is probably a bug

\end{document}