some not-yet-really-creative stuff
authorfabb <Administrator@.(none)>
Fri, 19 Mar 2010 15:39:28 +0000 (16:39 +0100)
committerfabb <Administrator@.(none)>
Fri, 19 Mar 2010 15:39:28 +0000 (16:39 +0100)
doc/folien/05_VHDL_Architecture.pdf [new file with mode: 0644]
doc/folien/06_VHDL_Syntax.pdf [new file with mode: 0644]
doc/folien/VHDL_Grundelemente.pdf [new file with mode: 0644]
doc/folien/VHDL_Grundelemente.ppt [new file with mode: 0644]
spec/ProtocolHeader.sty
spec/spec.tex

diff --git a/doc/folien/05_VHDL_Architecture.pdf b/doc/folien/05_VHDL_Architecture.pdf
new file mode 100644 (file)
index 0000000..68c90ef
Binary files /dev/null and b/doc/folien/05_VHDL_Architecture.pdf differ
diff --git a/doc/folien/06_VHDL_Syntax.pdf b/doc/folien/06_VHDL_Syntax.pdf
new file mode 100644 (file)
index 0000000..5001c1d
Binary files /dev/null and b/doc/folien/06_VHDL_Syntax.pdf differ
diff --git a/doc/folien/VHDL_Grundelemente.pdf b/doc/folien/VHDL_Grundelemente.pdf
new file mode 100644 (file)
index 0000000..11c7ae1
Binary files /dev/null and b/doc/folien/VHDL_Grundelemente.pdf differ
diff --git a/doc/folien/VHDL_Grundelemente.ppt b/doc/folien/VHDL_Grundelemente.ppt
new file mode 100644 (file)
index 0000000..baa1eb1
Binary files /dev/null and b/doc/folien/VHDL_Grundelemente.ppt differ
index 20c6c24d959d2d9dedca82289279118634907d46..c7f307a9b187e4919600f0a1aa3360fda2c364e0 100644 (file)
-\usepackage{fancyhdr}
-\usepackage{graphicx}
-\usepackage{epsfig}
-\usepackage{color}
-\usepackage{listings}
-\usepackage{german}
-\usepackage[T1]{fontenc}
-\usepackage[utf8]{inputenc}
-%\usepackage[latin1]{inputenc}
-\usepackage{times}
-\usepackage[plainpages=false, pdfpagelabels]{hyperref} %Klickbare Links im PDF
-\usepackage{amssymb}
-\usepackage{amsmath}
-\usepackage{longtable,colortbl}
-
-\hypersetup{%
-  colorlinks=true,
-  citecolor=black,
-  linkcolor=black,
-  %bookmarks=true,
-  bookmarksnumbered=true,
-  pdfauthor={Bernhard Lewurm, Fabian Ehrentraud},
-  pdfcreator={},
-  pdfkeywords={Hardware Modelling, Calculator},
-  urlcolor=black,
-  plainpages=false,
-  breaklinks=true,
-  pdftitle={Specification of a Calculator to be implemented in VHDL}
-}
-
-\lstset{ %
-       language=vhdl,                  % choose the language of the code
-       extendedchars=true,
-       basicstyle=\footnotesize,       % the size of the fonts that are used for the code
-%      basicstyle=\scriptsize,         % the size of the fonts that are used for the code
-       numbers=left,                   % where to put the line-numbers
-       numberstyle=\footnotesize,      % the size of the fonts that are used for the line-numbers
-       stepnumber=1,                   % the step between two line-numbers. If it's 1 each line will be numbered
-       firstnumber=auto,
-       numberfirstline=true,
-       numbersep=5pt,                  % how far the line-numbers are from the code
-       backgroundcolor=\color{white},  % choose the background color. You must add \usepackage{color}
-       showspaces=false,               % show spaces adding particular underscores
-       showstringspaces=false,         % underline spaces within strings
-       showtabs=false,                 % show tabs within strings adding particular underscores
-%      frame=single,                     % adds a frame around the code
-       frame={tb},
-       tabsize=2,                          % sets default tabsize to 2 spaces
-       caption=\lstname,
-%      captionpos=b,                   % sets the caption-position to bottom
-       captionpos=t,                   % sets the caption-position to top
-       breaklines=true,                % sets automatic line breaking
-       breakatwhitespace=false,        % sets if automatic breaks should only happen at whitespace
-       escapeinside={\%*}{*)},         % if you want to add a comment within your code
-       prebreak={\space\hbox{\ensuremath\hookleftarrow}}
-}
-
-\sloppy
-\newcommand{\MakeTitleAndTOC}{
-       \begin{titlepage}
-       \setcounter{page}{0}
-  %-------------------------------------------------------------------------
-  % print title page
-  %-------------------------------------------------------------------------
-  \thispagestyle{empty}
-  ~ \\
-  ~ \\
-  \begin{center}
-  \noindent
-  {\LARGE Hardware-Modellierung VL}
-  ~ \\
-  ~ \\
-  {\Huge \bf Spezifikation f\"ur das Design eines Taschenrechners\\in Hardware}
-  \end{center}
-  ~ \\
-  ~ \\
-  % Author
-  \begin{center}
-  \noindent
-  {\large Gruppe: Nr. 20}
-  ~ \\
-  ~ \\
-  {\large Fabian Ehrentraud, MatrNr. 0725639, KNZ: 033 535}\\
-  {\small werteplus@gmail.com} \\
-  ~ \\
-  {\large Bernhard Urban, MatrNr. 0725771, KNZ: 033 535} \\
-  {\small lewurm@gmail.com} \\
-  ~ \\
-  ~ \\
-  ~ \\
-  ~ \\
-  {\large \today}
-  \end{center}
-  
-  \end{titlepage}
-
-  \newpage
-
-  %-------------------------------------------------------------------------
-  % print table of contents
-  %-------------------------------------------------------------------------
-  \tableofcontents
-  \newpage
-
-}
-
-
-
-\newcommand{\mc}[1]{ {{\small \texttt{#1}}}}
-%%footnote hack von http://bushednotes.wordpress.com/2007/03/25/footnotes-tabular-in-latex/
-\newcounter{myfootertablecounter}
-
-\newcommand\myfootnotemark{%
-       %\refstepcounter{footnote}%
-               \addtocounter{footnote}{1}%
-               \footnotemark[\thefootnote]%
-}%
-
-\newcommand\myfootnotetext[1]{%
-       \addtocounter{myfootertablecounter}{1}
-       \footnotetext[\value{myfootertablecounter}]{#1}
-}
-
-% from now on, myfootnote has to be used rather than footnote to
-% adapt the myfootercounter
-\newcommand\myfootnote[1]{%
-       \addtocounter{myfootertablecounter}{1}
-       \footnote{#1}
-}%
-
-\pagestyle{fancy}
-\setlength{\headheight}{14.5pt}
+\usepackage{fancyhdr}\r
+\usepackage{graphicx}\r
+\usepackage{epsfig}\r
+\usepackage{color}\r
+\usepackage{listings}\r
+\usepackage{german}\r
+\usepackage[T1]{fontenc}\r
+%\usepackage[utf8]{inputenc}\r
+\usepackage[latin1]{inputenc}\r
+\usepackage{times}\r
+\usepackage[plainpages=false, pdfpagelabels]{hyperref} %Klickbare Links im PDF\r
+\usepackage{amssymb}\r
+\usepackage{amsmath}\r
+\usepackage{longtable,colortbl}\r
+\r
+\hypersetup{%\r
+  colorlinks=true,\r
+  citecolor=black,\r
+  linkcolor=black,\r
+  %bookmarks=true,\r
+  bookmarksnumbered=true,\r
+  pdfauthor={Bernhard Lewurm, Fabian Ehrentraud},\r
+  pdfcreator={},\r
+  pdfkeywords={Hardware Modelling, Calculator},\r
+  urlcolor=black,\r
+  plainpages=false,\r
+  breaklinks=true,\r
+  pdftitle={Specification of a Calculator to be implemented in VHDL}\r
+}\r
+\r
+\lstset{ %\r
+       language=vhdl,                  % choose the language of the code\r
+       extendedchars=true,\r
+       basicstyle=\footnotesize,       % the size of the fonts that are used for the code\r
+%      basicstyle=\scriptsize,         % the size of the fonts that are used for the code\r
+       numbers=left,                   % where to put the line-numbers\r
+       numberstyle=\footnotesize,      % the size of the fonts that are used for the line-numbers\r
+       stepnumber=1,                   % the step between two line-numbers. If it's 1 each line will be numbered\r
+       firstnumber=auto,\r
+       numberfirstline=true,\r
+       numbersep=5pt,                  % how far the line-numbers are from the code\r
+       backgroundcolor=\color{white},  % choose the background color. You must add \usepackage{color}\r
+       showspaces=false,               % show spaces adding particular underscores\r
+       showstringspaces=false,         % underline spaces within strings\r
+       showtabs=false,                 % show tabs within strings adding particular underscores\r
+%      frame=single,                     % adds a frame around the code\r
+       frame={tb},\r
+       tabsize=2,                          % sets default tabsize to 2 spaces\r
+       caption=\lstname,\r
+%      captionpos=b,                   % sets the caption-position to bottom\r
+       captionpos=t,                   % sets the caption-position to top\r
+       breaklines=true,                % sets automatic line breaking\r
+       breakatwhitespace=false,        % sets if automatic breaks should only happen at whitespace\r
+       escapeinside={\%*}{*)},         % if you want to add a comment within your code\r
+       prebreak={\space\hbox{\ensuremath\hookleftarrow}}\r
+}\r
+\r
+\sloppy\r
+\newcommand{\MakeTitleAndTOC}{\r
+       \begin{titlepage}\r
+       \setcounter{page}{0}\r
+  %-------------------------------------------------------------------------\r
+  % print title page\r
+  %-------------------------------------------------------------------------\r
+  \thispagestyle{empty}\r
+  ~ \\\r
+  ~ \\\r
+  \begin{center}\r
+  \noindent\r
+  {\LARGE Hardware-Modellierung VL}\r
+  ~ \\\r
+  ~ \\\r
+  {\Huge \bf Spezifikation für das Design eines Taschenrechners in Hardware}\r
+  \end{center}\r
+  ~ \\\r
+  ~ \\\r
+  % Author\r
+  \begin{center}\r
+  \noindent\r
+  {\large Gruppe 20}\r
+  ~ \\\r
+  ~ \\\r
+  {\large Fabian Ehrentraud, MatrNr. 0725639, KNZ: 033 535}\\\r
+  {\small werteplus@gmail.com} \\\r
+  ~ \\\r
+  {\large Bernhard Urban, MatrNr. 0725771, KNZ: 033 535} \\\r
+  {\small lewurm@gmail.com} \\\r
+  ~ \\\r
+  ~ \\\r
+  ~ \\\r
+  ~ \\\r
+  {\large \today}\r
+  \end{center}\r
+  \r
+  \end{titlepage}\r
+\r
+  \newpage\r
+\r
+  %-------------------------------------------------------------------------\r
+  % print table of contents\r
+  %-------------------------------------------------------------------------\r
+  \tableofcontents\r
+  \newpage\r
+\r
+}\r
+\r
+\r
+\r
+\newcommand{\mc}[1]{ {{\small \texttt{#1}}}}\r
+%%footnote hack von http://bushednotes.wordpress.com/2007/03/25/footnotes-tabular-in-latex/\r
+\newcounter{myfootertablecounter}\r
+\r
+\newcommand\myfootnotemark{%\r
+       %\refstepcounter{footnote}%\r
+               \addtocounter{footnote}{1}%\r
+               \footnotemark[\thefootnote]%\r
+}%\r
+\r
+\newcommand\myfootnotetext[1]{%\r
+       \addtocounter{myfootertablecounter}{1}\r
+       \footnotetext[\value{myfootertablecounter}]{#1}\r
+}\r
+\r
+% from now on, myfootnote has to be used rather than footnote to\r
+% adapt the myfootercounter\r
+\newcommand\myfootnote[1]{%\r
+       \addtocounter{myfootertablecounter}{1}\r
+       \footnote{#1}\r
+}%\r
+\r
+\pagestyle{fancy}\r
+\setlength{\headheight}{14.5pt}\r
+\r
+\newcounter{reqcounter}\r
+\setcounter{reqcounter}{0}\r
+\newcommand{\req}[1]{\r
+       \noindent\r
+       \addtocounter{reqcounter}{1}\r
+       %\\\r
+       \textbf{Req \arabic{reqcounter}} #1\\\r
+       \label{Req \arabic{reqcounter}} %this could be done better with a second argument, but that's tiresome to write in the text\r
+}
\ No newline at end of file
index 0a75a2cad31fe1aeab88d208f312232639d05011..84fccdc4eda489de7f176d8937dfefc0a1cd21ec 100644 (file)
@@ -6,7 +6,6 @@
 \begin{document}
 \MakeTitleAndTOC
 
-
 % howto use graphics
 % \begin{figure}[!ht]
 % \includegraphics[width=\textwidth]{ftol_pic.pdf}
 %\chapter %for use with report class
 \section
 {Einleitung}
-%TODO
-Es ist ein einfacher Taschenrechner der die Grundrechnungsarten Addition, Subtraktion,
-Multiplikation und Division beherrscht in Hardware zu realisieren. Dabei soll als Input eine PS/2
-Tastatur beziehungsweise als Output ein VGA Monitor dienen. Als zus\"atzliches Feature soll eine
-History eingebaut werden, sodass vergangene Berechnungen wieder aus einem Buffer geladen werden
-koennen. Au\ss{}erdem besteht die M\"oglichkeit eine solche History per RS232-Schnittstelle zu
+
+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}
 
-%\chapter
-\section
-{High-Level Design Description}
+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.
 
-XXX
+Die Subsections sind vielleicht ein kleiner Overshoot.
 
-\subsection
-{Requirement Spezifikation}
 
-wie schaut syntax aus der eingabe? welche regeln gelten (punkt vor strich)?
-wie lang darf die eingabe sein?
-zahlentyp?
-was soll am bildschirm angezeigt werden?
-wie gross soll der buffer sein?
-wie wird zum pc gesendet bzw. empfangen?
+%TODO
+wie schaut syntax aus der eingabe? 
 
-... requirements durchnummierieren (wegen testfaelle)
+\subsection{Eingabe}
 
+\req{Der Taschenrechner soll eine Eingabe bestehend aus den Ziffern '0'-'9', Leerzeichen ' ', '+', '-', '*' und '/' ausrechnen können}
 
-\subsection
-{Module}
+\req{Der Syntax für so eine Eingabe - eine \textbf{Expression} - sieht folgendermaßen aus:
 
-was gibts fuer module? vorschlag:
-\begin{itemize}
-\item VGA
-\item PS/2
-\item RS232
-\item Historymodul fuer die Verwaltung des dahinterliegenden Buffers
-\item Parser der die Eingabe auswertet
-\item Controlmodul (nimmt eingabe entgegen, legt berechnungen im buffer ab, ...?)
-\item Modul fuer die Kommunikation zum PC? oder gleich im Historymodul implementieren? oder ins
-Controlmodul mit rein packen?
-\end{itemize}
+DIGIT = ``0`` \textbar ``1`` \textbar ``2`` \textbar ``3`` \textbar ``4`` \textbar ``5`` \textbar ``6`` \textbar ``7`` \textbar ``8`` \textbar ``9`` ;
 
+UNSIGNED = DIGIT { DIGIT } ;
 
-\subsection
-{VGA}
-ist gegeben.
+OPERAND = [``-``] UNSIGNED ;
 
+OPERATOR = ``+`` \textbar ``-`` \textbar ``*`` \textbar ``/`` ;
 
-\subsection
-{PS/2}
-ist gegeben.
+EXPRESSION = OPERAND \{ OPERATOR OPERAND \} ;
+}
 
+\req{Dabei soll Punkt- vor Strichrechnung gelten}
 
-\subsection
-{RS232}
-TODO. baudrate? kodierung? (8N1?)
+\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}
 
-\subsection
-{History}
-Verwaltet den dahinterliegenden Buffer fuer die History
+\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}
 
-\subsection
-{Parser}
-wertet ein gegeben Buffer aus.
+\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}
 
-\subsection
-{Control}
-soll das Bindeglied zwischen allen Modulen sein
+\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{Interfaces}
+
+\subsection{Externe Interfaces}
 
-\subsubsection
-{Physikalische 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)
 
@@ -104,12 +100,22 @@ to VGA'' unter ``physical interfaces'' (seite 10 in der exercise.pdf)
 Ersteres wuerde ich unter Logisches Interface verstehen.
 
 
-\subsubsection
-{Logische Interfaces}
+\subsection{Interfaces der Module}
+
+\subsubsection{VGA}
+
+\subsubsection{PS/2}
+
+\subsubsection{RS232}
+
+\subsubsection{History}
 
+\subsubsection{Parser}
+
+\subsubsection{Control}
+
+\subsection{Verhalten der Interfaces}
 
-\subsubsection
-{Verhalten der Interfaces}
 welche tasten als input erlauben (haben numblock und normale ziffern unterschiedliche scancodes?)?
 wie werden ueberlaeufe behandelt?
 fehlerhafte eingaben?
@@ -120,20 +126,32 @@ wie kann auf die history zugegriffen werden?
 soll in der eingabe auch mit pfeiltasten (links,rechts) gescrolled werden koennen?
 
 
-\subsection
-{Testf\"alle}
+\subsection{Testfälle}
+
 alle requirements muessen von testfaellen abgedeckt werden!
 
 
-%\chapter
-\section
-{Detailed Design Description}
+\section{Detailed Design Description}
+
 alle Module hier genauer beschreiben
 
+%TODO
 wie wollen wir das design implementieren?
-event sequence diagrams!
+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