From 092eafcacf3b9f8432f7d7ea5f7ce58967f6d7c2 Mon Sep 17 00:00:00 2001 From: Christos Choutouridis Date: Fri, 17 Apr 2020 11:31:55 +0300 Subject: [PATCH] Final draft --- report/AuthReport.tex | 23 +- report/images/ADSL_frequency.png | Bin 0 -> 24335 bytes report/images/pcm-modulator.png | Bin 0 -> 36788 bytes report/report.tex | 186 ++++- report/session1.tex | 8 +- report/session2.tex | 6 +- report/source.tex | 1160 ++++++++++++++++++++++++++++++ 7 files changed, 1344 insertions(+), 39 deletions(-) create mode 100644 report/images/ADSL_frequency.png create mode 100644 report/images/pcm-modulator.png create mode 100644 report/source.tex diff --git a/report/AuthReport.tex b/report/AuthReport.tex index adfaa67..fc234dd 100644 --- a/report/AuthReport.tex +++ b/report/AuthReport.tex @@ -206,7 +206,7 @@ % [4]: Caption text % example: \InsertFigure{0.8}{fig:lala}{lala.png}{\eng{Makes lala}} \newcommand{\InsertFigure}[4]{ - \begin{figure*}[ht] + \begin{figure*}[h!] \captionsetup{format=plain} \centering \includegraphics[width=#1\textwidth]{#3} @@ -214,3 +214,24 @@ \label{#2} \end{figure*} } + +% \WrapFigure{}{}{}{} +% [1]: scale +% [2]: place left or right r,l,R,L +% [3]: Label +% [4]: Figure file +% [5]: Caption text +% example: \WrapFigure{0.8}{r}{fig:lala}{lala.png}{\eng{Makes lala}} +\newcommand{\WrapFigure}[5]{ + \begin{wrapfigure}{#2}{#1\textwidth} + \vspace{-30pt} + \begin{center} + \captionsetup{format=plain} + \includegraphics[width=#1\textwidth]{#4} + \caption{#5} + \label{#3} + \end{center} + \vspace{-30pt} + \end{wrapfigure} +} + diff --git a/report/images/ADSL_frequency.png b/report/images/ADSL_frequency.png new file mode 100644 index 0000000000000000000000000000000000000000..3fc72026d59e47c7d976323bdb166ea0ff398547 GIT binary patch literal 24335 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 literal 0 HcmV?d00001 diff --git a/report/report.tex b/report/report.tex index 45a8437..f47a2a9 100644 --- a/report/report.tex +++ b/report/report.tex @@ -2,13 +2,13 @@ % Network programming Lab sum report % % authors: -% Χρήστος Χουτουρίδης ΑΕΜ 8997 -% cchoutou@ece.auth.gr +% Χρήστος Χουτουρίδης ΑΕΜ 8997 +% cchoutou@ece.auth.gr % Document configuration \newcommand{\ClassName}{Δίκτυα Υπολογιστών Ι} -\newcommand{\DocTitle}{Αναφορά 1ης συνόδου} +\newcommand{\DocTitle}{Εργασία δικτυακού προγραμματισμού I} \newcommand{\InstructorName}{Δημήτριος Μητράκος} \newcommand{\InstructorMail}{mitrakos@eng.auth.gr} \newcommand{\CurrentDate}{\today} @@ -19,7 +19,9 @@ %\renewcommand{\AuthorMail}{cchoutou@ece.auth.gr} %\renewcommand{\AuthorAEM}{8997} -\setFancyHead{\ClassName}{Χρήστος Χουτουρίδης 8997} +%\setFancyHead{\ClassName}{Χρήστος Χουτουρίδης 8997} +\fancyhead[L]{\ClassName} +\fancyhead[R]{Χρήστος Χουτουρίδης 8997} % Document % ================= @@ -28,40 +30,162 @@ \FirstPage \tableofcontents -\listoffigures +%\listoffigures %\listoftables \section{Εισαγωγή} -Για την παρούσα σύνοδο ζητήθηκε η λήψη μετρήσεων τουλάχιστον 4 λεπτών μέσω του μηχανισμού \eng{Echo} και του μηχανισμού \eng{AQR}. -Ακόμα ζητήθηκε η λήψη δύο εικόνων από τον \eng{videoCoder} τόσο με σφάλματα όσο και χωρίς. -Τέλος ζητήθηκε μία εικόνα με 4 ίχνη \eng{GPS} από την διαδρομή 1, τα οποία πρέπει να απέχουν μεταξύ τους τουλάχιστων 4 \eng{sec}. -\par Για να είναι ικανή η εξαγωγή συμπερασμάτων για την κατανομή του χρόνου απόκρισης, αλλά και της κατανομής πιθανότητας επανεκπομπών αποφασίσαμε να επεκτείνουμε τον χρόνο μετρήσεων στα 40 λεπτά. -Σε αυτή την απόφαση συνέβαλλε και το γεγονός ότι οι μετρήσεις έγιναν σε τοποθεσία με πάρα πολύ κακή γραμμή και εν μέσω τεχνικών προβλημάτων. -\par Για την ανάλυση των μετρήσεων και την παραγωγή των γραφημάτων χρησιμοποιήσαμε \eng{matlab}. -Τον κώδικα για την ανάλυση μπορείτε να τον βρείτε στον κατάλογο \eng{matlab} του παραδοτέου καθώς και στο αποθετήριο της εργασίας. - -\section{Μετρήσεις μηχανισμού \eng{Echo}} +Η εργασία αυτή αφορά μια εφαρμογή δικτυακού προγραμματισμού που αναπτύχθηκε σε γλώσσα \eng{Java.} +Η εφαρμογή χρησιμοποιήθηκε ως εργαλείο επικοινωνίας με τον \eng{server} του εργαστηρίου “\textbf{Ιθάκη}”, ώστε να πραγματοποιήσει μία σειρά από μετρήσεις και λήψεις δεδομένων. +Με τα δεδομένα των μετρήσεων μπορέσαμε να εξάγουμε συμπεράσματα τόσο για την χρονική απόκριση του \eng{server} και του καναλιού επικοινωνίας, όσο και για την πιθανότητα εσφαλμένης μετάδοσης δεδομένων. +Για την επεξεργασία των δεδομένων και την παρουσίαση των αποτελεσμάτων χρησιμοποιήθηκε το \eng{matlab.} + +\section{Παραδοτέα} +Στο αρχείο που μεταφορτώνεται στην Ιθάκη υπάρχουν: +\begin{itemize} + \item Οι αναφορές σε μορφή \eng{pdf.} + \item Ο κατάλογος \eng{\textbf{matlab}} που περιέχει τον κώδικα που χρησιμοποιήθηκε για την επεξεργασία και μορφοποίηση των αποτελεσμάτων, καθώς και τα δεδομένα από τις συνόδους. + \item Ο κατάλογος \eng{\textbf{src}} που περιέχει τον κώδικα της εφαρμογής. + \item Ο κατάλογος \eng{\textbf{doc}} που περιέχει την τεκμηρίωση του κώδικα σε μορφή \eng{html.} +\end{itemize} +Τέλος στον σύνδεσμο \href{https://git.hoo2.net/hoo2/virtualModem}{\eng{git.hoo2.net/hoo2/virtualModem}} υπάρχει το \textbf{αποθετήριο με τον κώδικα} της εφαρμογής, τον κώδικα των αναφορών καθώς και τον κώδικα \eng{matlab} που χρησιμοποιήσαμε για να επεξεργαστούμε τα δεδομένα. + +% Backround - modem section +% ============================ +\section{Γενικά περί \eng{modem}} +Ξεκινώντας από την ονομασία τους, ο όρος \eng{modem} προέρχεται από τη συνένωση των λέξεων \eng{modulator-demodulator.} +Πρόκειται για ηλεκτρονική συσκευή η οποία είναι ικανή για την μετάδοση δεδομένων από ένα ηλεκτρονικό υπολογιστή σε έναν άλλο. +Ιστορικά οι συσκευές αυτές συνήθως χρησιμοποιούσαν τις τηλεφωνικές γραμμές. +Τα πρώτα \eng{modem} ήταν τα \eng{\textit{bell 101}} και άρχισαν να παράγονται μαζικά το 1958 από την εταιρία \eng{AT\&T}\cite{bell-101}, ώστε να χρησιμοποιηθούν στο υπολογιστικό σύστημα \eng{SAGE}\cite{sage}. +Ένα χαρακτηριστικό των \eng{modem,} το οποίο βρίσκεται κάτω από συνεχή έρευνα για βελτίωση, είναι η ταχύτητα δεδομένων τα οποία μπορούν να μεταδώσουν και η οποία μετράται σε \eng{bit/sec} ή \eng{bps.} +Για το σκοπό αυτό αναπτύχθηκαν πολλά πρωτόκολλα και τεχνολογίες. + +\par Κατά τα τέλη της δεκαετίας του 1990 αρκετές εταιρίες ανταγωνίζονται για να επιτύχουν καλύτερες ταχύτητες μετάδοσης με αποτέλεσμα τον Φεβρουάριο του 1998, η παγκόσμια ένωση τηλεπικοινωνιών να ανακοινώνει το πρότυπο \eng{v90}\cite{itu_v90}. +Δύο χρόνια αργότερα η ίδια το βελτιώνει, παρουσιάζοντας το \eng{v92}\cite{itu_v92}, το οποίο χρησιμοποιεί διαμόρφωση \eng{\textbf{PCM},} τόσο για την λήψη, όσο και για την αποστολή δεδομένων. +Η σπουδαιότητα αυτού φαίνεται από το γεγονός οτι το \eng{PCM} χρησιμοποιείται ευρέως μέχρι και σήμερα. + +\subsection{\eng{PCM - Pulse code modulation}} +\WrapFigure{0.5}{R}{fig:pcm-modulator}{pcm-modulator.png}{Διάγραμμα ενός \eng{PCM}} +Η διαμόρφωση \eng{PCM} είναι η απλούστερη μορφή κωδικοποίησης μιας κυματομορφής. +Το ζητούμενο είναι να μετατραπεί ένα αναλογικό σήμα σε ψηφιακή πληροφορία και το ανάποδο. +Ένας κωδικοποιητής \eng{PCM} χρησιμοποιείται για την παραγωγή ψηφιακής πληροφορίας από ένα αναλογικό σήμα, ενώ ένας αποκωδικοποιητής για αντίθετο. +Οι κωδικοποιητές \eng{PCM} αποτελούνται από τρία βασικά μέρη. +Ένα \textbf{δειγματολήπτη}, ένα \textbf{κβαντιστή} και ένα \textbf{κωδικοποιητή}. + +\par Τα στοιχεία που έκαναν την διαμόρφωση \eng{PCM} μια από τις ποιο βασικές τεχνικές κωδικοποίησης είναι: +\begin{itemize} + \item Η απλότητα του υλικού που απαιτείται για την υλοποίηση. + \item Η μή χρησιμοποίηση φέροντος. + \item Η ευρωστία απέναντι στους θορύβους και τις παρεμβολές. + \item Η ασφάλεια στη μετάδοση, καθώς διευκολύνεται η χρήση κρυπτογράφησης. +\end{itemize} + +\subsection{Αρχή λειτουργίας \eng{PCM}} +Όπως φαίνεται και στο σχήμα \ref{fig:pcm-modulator}, αρχικά το σήμα δειγματοληπτείται. +Εδώ ο δειγματολήπτης πρέπει να χρησιμοποιήσει μια συχνότητα μεγαλύτερη από τη συχνότητα \eng{Nyquist}\cite{shannon-1949}. +Έπειτα το δειγματοληπτημένο σήμα διέρχεται από τον κβαντιστή, απ' όπου και εξέρχεται σε πεπερασμένες στάθμες πλάτους. +Αυτό επιτυγχάνεται καθώς ο κβαντιστής αλλάζει την τιμή πλάτους του σήματος εξόδου σε προκαθορισμένες διακριτές τιμές, επιλέγοντας κάθε φορά μια τιμή που είναι κοντινότερη σε αυτή του σήματος εισόδου. +Τέλος η κάθε στάθμη κωδικοποιείται σε ένα ψηφιακό αριθμό, ομαδοποιείται σε ψηφιακές λέξεις των \eng{n bits} και εξέρχεται από τη διάταξη. + +\subsection{\eng{ADSL}} +\WrapFigure{0.5}{R}{fig:adsl-frequency}{ADSL_frequency.png}{\eng{Βandwith} συχνοτήτων που χρησιμοποιείται για φωνή, αποστολή και λήψη δεδομένων μιας γραμμής \eng{ADSL.}} +Μια ποιο πρόσφατη τεχνολογία στο χώρο των \eng{modem,} είναι η \eng{DSL (digital subscriber line).} +Σε αυτή την τεχνολογία γίνεται χρήση ενός μεγαλύτερου εύρους συχνοτήτων από αυτό της φωνής μιας τηλεφωνικής γραμμής. +Με αυτό τον τρόπο υπάρχει δυνατότητα για μετάδοση δεδομένων με μεγαλύτερο ρυθμό. +Μια υλοποίηση αυτής της τεχνολογίας είναι το \eng{ADSL (Asymmetric digital subscriber line)\cite{ADSL_ANSI-1998}\cite{w.Stallings},} όπου το \eng{bandwith} συχνοτήτων που χρησιμοποιείται για αποστολή δεδομένων είναι διαφορετικού μεγέθους από αυτό που χρησιμοποιείται για την λήψη (σχήμα \ref{fig:adsl-frequency}). + +% Session 1 analysis +% ============================ +\section{Ανάλυση πειραματικών δεδομένων} \subsection{Πρώτη σύνοδος} -Με βάση την απόκριση του συστήματος στα πακέτα \eng{echo} της πρώτης συνόδου διαγράμματος παράξαμε την κατανομή που φαίνεται παρακάτω. - -\InsertFigure{fig:E7837-dist} -{session1/E7837-dist.png} +\InsertFigure{0.9}{fig:E7837-dist}{session1/E7837-dist.png} {Κατανομή του χρόνου απόκρισης του συστήματος για αποστολές\eng{echo} 40 λεπτών} +Με βάση την απόκριση του συστήματος στα πακέτα \eng{echo G1} της πρώτης συνόδου, παράξαμε την κατανομή που φαίνεται στο σχήμα \ref{fig:E7837-dist}. -Με μια πρώτη ματιά μπορούμε να διακρίνουμε ότι ο μέσος χρόνος απόκρισης που φαίνεται στον κύριο λοβό, είναι περίπου 120 \eng{msec}, ενώ ακόμα αυτός είναι μή συμμετρικός και μετατοπισμένος προς τα αριστερά. +\par Με μια πρώτη ματιά μπορούμε να διακρίνουμε ότι ο μέσος χρόνος απόκρισης που φαίνεται στον κύριο λοβό, είναι περίπου 120 \eng{msec}, ενώ ακόμα αυτός είναι μή συμμετρικός και μετατοπισμένος προς τα αριστερά. Ακόμα η κατανομή παρουσιάζει εκτός του κύριου λοβού δύο ακόμα μικρότερους λοβούς σε χρόνους περί τα 180 και 210 \eng{msec} αντίστοιχα. -\subsection{Συμπεράσματα} -Εύκολα μπορεί κάποιος να παρατηρήσει πως οι μικρότεροι λοβοί είναι μια “σχεδόν μικρογραφία” του κύριου. -Αυτό μας οδηγεί στο συμπέρασμα πως δεν πρόκειται για απόκριση που οφείλεται \eng{server} της Ιθάκης, αλλά ίσως κάποια διαφορετική διαδρομή που ακολούθησαν τα συγκεκριμένα πακέτα, η οποία παίρνει περισσότερο χρόνο. -Το γεγονός ότι δημιουργούνται λοβοί, τόσο ο κύριος όσο και οι μικρότεροι, έγκειται στο ότι οι διαδρομές που ακολουθούν τα πακέτα είναι πεπερασμένες. - - -\section{Μετρήσεις μηχανισμού \eng{ARQ}} - - - - - +\par +\InsertFigure{0.9}{fig:ARQ1-dist}{session1/ARQ-dist.png} +{Κατανομή του χρόνου απόκρισης του συστήματος για αποστολές\eng{ARQ} 40 λεπτών} +Αντίστοιχα με βάση την απόκριση του συστήματος για αποστολές με το μηχανισμό \eng{ARQ G2} της πρώτης συνόδου παράξαμε την κατανομή του σχήματος \ref{fig:ARQ1-dist}. +Εδώ μπορούμε να διακρίνουμε επιπλέον μικρούς λοβούς οι οποίοι αφορούν τις κατανομές για πακέτα τα οποία χρειάστηκαν περισσότερες από μία αποστολές. + +\par Εύκολα μπορεί κάποιος να παρατηρήσει πως οι μικρότεροι λοβοί είναι μια “σχεδόν μικρογραφία” του κύριου. +Αυτό μας οδηγεί στο συμπέρασμα πως δεν πρόκειται για απόκριση που οφείλεται στον \eng{server} της Ιθάκης, αλλά ίσως κάποια διαφορετική διαδρομή που ακολούθησαν τα συγκεκριμένα πακέτα, η οποία παίρνει περισσότερο χρόνο. +Φυσικά δεν μπορούμε να αποκλείσουμε τον \eng{server,} καθώς κάλλιστα και αυτός θα μπορούσε να δημιουργεί τεχνικά τις ίδιες καθυστερήσεις. +Το γεγονός όμως ότι δημιουργούνται λοβοί, τόσο ο κύριος όσο και οι μικρότεροι, έγκειται στο ότι οι διαδρομές που ακολουθούν τα πακέτα είναι συγκεκριμένες και πεπερασμένες. + +\par Στο γράφημα του σχήματος \eng{G3} της πρώτης συνόδου φαίνεται ο αριθμός τον εκπομπών ανά πακέτο αλλά και ο κανονικοποιημένος αριθμός των επανεκπομπών. +Αυτός αντιστοιχεί ουσιαστικά στην πιθανότητα που έχει κάποιο πακέτο να χρειαστεί επανεκπομπή. + +\par Η εκτιμώμενη συνάρτηση που προσεγγίζει την πιθανότητα του αριθμού των επανεκπομπών, με βάση τα αποτελέσματα των μετρήσεων της πρώτης συνόδου είναι εκθετική και ακολουθεί την εξίσωση: +\[ + P(n) = 0.740089 e^{-1.36012n} +\] +Όπου \eng{n}, ο αριθμός των επανεκπομπών. + +% Session 2 analysis +% ============================ +\subsection{Δεύτερη σύνοδος} +\InsertFigure{0.9}{fig:E1510-dist}{session2/E1510-dist.png} +{Κατανομή του χρόνου απόκρισης του συστήματος για αποστολές\eng{echo} 60 λεπτών} +Με βάση την απόκριση του συστήματος στα πακέτα \eng{echo G1} της δεύτερης συνόδου, παράξαμε την κατανομή που φαίνεται στο σχήμα \ref{fig:E1510-dist}. + +\par Αρχικά βλέπουμε ότι το σύστημα έχει διπλό “κύριο” λοβό. +Αυτό πρόκυψε γιατί τα δεδομένα λήφθηκαν με σύνδεση μέσω \eng{GSM} και όπως φαίνεται και στο γράφημα \eng{G1} της δεύτερης συνόδου, περίπου μετά τα πρώτα 10000 πακέτα, η απόκριση του συστήματος μειώθηκε. +Η χρήση της γραμμής του \eng{GSM} έγινε λόγω τεχνικών προβλημάτων στην επίγεια γραμμή. +Παρόλα αυτά μπορούμε να παρατηρήσουμε πως οι κύριοι λοβοί δεν παρουσιάζουν την ασυμμετρία που είχαν στις μετρήσεις με την επίγεια γραμμή που είχαμε στην πρώτη σύνοδο. + +\par +\InsertFigure{0.9}{fig:ARQ2-dist}{session2/ARQ-dist.png} +{Κατανομή του χρόνου απόκρισης του συστήματος για αποστολές\eng{ARQ} 60 λεπτών} +Αντίστοιχα με βάση την απόκριση του συστήματος για αποστολές με το μηχανισμό \eng{ARQ G2} της δεύτερης συνόδου παράξαμε την κατανομή του σχήματος \ref{fig:ARQ2-dist}. +Εδώ χρησιμοποιήθηκε πάλι η επίγεια γραμμή, καθώς η βλάβη αποκαταστάθηκε. +Μπορούμε και σε αυτή την περίπτωση, όπως ακριβώς και στην αντίστοιχη της πρώτης συνόδου, να διακρίνουμε επιπλέον μικρούς λοβούς οι οποίοι αφορούν τις κατανομές για πακέτα τα οποία χρειάστηκαν περισσότερες από μία αποστολές. +Αυτή τη φορά η λοβοί είναι πολύ μικρότεροι, καθώς η πιθανότητα σφάλματος αυτή τη φορά είναι μικρότερη. + +\par Στο γράφημα του σχήματος \eng{G3} της δεύτερης συνόδου φαίνεται ο αριθμός τον εκπομπών ανά πακέτο αλλά και ο κανονικοποιημένος αριθμός των επανεκπομπών. +Αυτός και εδώ αντιστοιχεί στην πιθανότητα που έχει κάποιο πακέτο να χρειαστεί επανεκπομπή. + +\par Η εκτιμώμενη συνάρτηση που προσεγγίζει την πιθανότητα του αριθμού των επανεκπομπών, με βάση τα αποτελέσματα των μετρήσεων της δεύτερης συνόδου είναι επίσης εκθετική και ακολουθεί την εξίσωση: +\[ + P(n) = 0.851462 e^{-1.90528n} +\] +Όπου \eng{n}, ο αριθμός των επανεκπομπών. + +% Epilogue +% ============================ +\section{Επίλογος} +Συνολικά παρατηρούμε πως οι αποκρίσεις δεν έχουν σταθερή συμπεριφορά, κάτι που λέει πολλά για το περιβάλλον στο οποίο πρέπει να “ζουν” οι εφαρμογές που επικοινωνούν με το δίκτυο. +Κατά την εκπόνηση μόνο της παρούσας είχαμε τεχνικά προβλήματα στην επίγεια γραμμή όπως η απώλεια πακέτων ακόμη και στο \eng{ping.} +Παρόλα αυτά θεωρούμε ότι καταφέραμε να δημιουργήσουμε μια εφαρμογή που να “μιλάει” τη γλώσσα της \textbf{Ιθάκης} και να μπορεί να λάβει μετρήσεις και δεδομένα με σταθερότητα. +Κλείνοντας την παρούσα εργασία μπορούμε να πούμε πως μας πρόσφερε αρκετό έδαφος για πειραματισμό και αυτό είναι κάτι που εκτιμούμε ιδιαίτερα. + +% References +% ============================ +\begin{thebibliography}{100} + +\bibitem{bell-101} +\href{http://ethw.org/Bell_Telephone_Laboratories,_Inc._List_of_Significant_Innovations_\%26_Discoveries_(1925-1983)}{\eng{Bell Telephone Laboratories, Inc. List of Significant Innovations \& Discoveries (1925-1983)}} + +\bibitem{sage} +\eng{Kent C. Redmond \& Thomas M. Smith (2000). From Whirlwind to MITRE: The R\&D Story of the SAGE Air Defense Computer. MIT Press. ISBN 978-0-262-26426-6.(20th of April 1951 - p.1, National Security Act 1947 - p.12, April 1947 - p.13)} + +\bibitem{itu_v90} +\href{http://www.itu.int/newsarchive/press_releases/1998/04.html}{\eng{"Agreement reached on 56K Modem standard". International Telecommunication Union. 9 February 1998}} + +\bibitem{itu_v92} +\href{http://modemsite.com/56k/v92.asp}{\eng{Modern site: V.92}} + +\bibitem{shannon-1949} +\eng{Shannon, Claude E. (January 1949). "Communication in the presence of noise". Proceedings of the Institute of Radio Engineers. 37 (1): 10–21} + +\bibitem{ADSL_ANSI-1998} +\eng{ANSI T1.413-1998 "Network and Customer Installation Interfaces – Asymmetric Digital Subscriber Line (ADSL) Metallic Interface." (American National Standards Institute 1998)} + +\bibitem{w.Stallings} +\eng{Data and Computer Communications, William Stallings, ISBN 0-13-243310-9, ISBN 978-0-13-243310-5} + +\end{thebibliography} \end{document} \ No newline at end of file diff --git a/report/session1.tex b/report/session1.tex index b8cce55..32f4e15 100644 --- a/report/session1.tex +++ b/report/session1.tex @@ -61,11 +61,11 @@ q = 1 - \sqrt[\uproot{6}128]{\frac{1}{1.35978}} = 0.00239806 => q = 0.2398 \% \] -\par Τέλος με βάση τα πειραματικά αποτελέσματα της συνόδου (σχήμα \ref{fig:ARQ-dist-error}) η εκτιμώμενη συνάρτηση πιθανότητας του αριθμού των επανεκπομπών είναι εκθετική και ακολουθεί την εξίσωση: +\par Τέλος με βάση τα πειραματικά αποτελέσματα της συνόδου (σχήμα \ref{fig:ARQ-dist-error}) η εκτιμώμενη συνάρτηση που προσεγγίζει την πιθανότητα του αριθμού των επανεκπομπών είναι εκθετική και ακολουθεί την εξίσωση: \[ - P(x) = 0.740089 e^{-1.36012x} + P(n) = 0.740089 e^{-1.36012n} \] -Όπου \eng{x}, ο αριθμός των επανεκπομπών. +Όπου \eng{n}, ο αριθμός των επανεκπομπών. \newpage \section{Διαγράμματα και εικόνες από τη σύνοδο} @@ -98,6 +98,6 @@ % GPS \InsertFigure{0.8}{fig:P1124}{session1/P1124-2020-04-11-18:55:50.jpg} -{Εικόνα 8 σημείων της διαδρομής 1, με 10\eng{sec} διαφορά μεταξύ τους.} +{Εικόνα 8 σημείων της διαδρομής 1, εκκινώντας από το ίχνος 600, με 10\eng{sec} διαφορά μεταξύ τους.} \end{document} diff --git a/report/session2.tex b/report/session2.tex index 29b1c6d..7c4dfea 100644 --- a/report/session2.tex +++ b/report/session2.tex @@ -61,7 +61,7 @@ q = 1 - \sqrt[\uproot{6}128]{\frac{1}{1.17522}} = 0.00126057 => q = 0.126 \% \] -\par Τέλος με βάση τα πειραματικά αποτελέσματα της συνόδου (σχήμα \ref{fig:ARQ-dist-error}) η εκτιμώμενη συνάρτηση πιθανότητας του αριθμού των επανεκπομπών είναι εκθετική και ακολουθεί την εξίσωση: +\par Τέλος με βάση τα πειραματικά αποτελέσματα της συνόδου (σχήμα \ref{fig:ARQ-dist-error}) η εκτιμώμενη συνάρτηση που προσεγγίζει την πιθανότητα του αριθμού των επανεκπομπών είναι εκθετική και ακολουθεί την εξίσωση: \[ P(x) = 0.851462 e^{-1.90528x} \] @@ -98,9 +98,9 @@ % GPS \InsertFigure{0.8}{fig:P7683_1}{session2/P7683-2020-04-14-17:30:41.jpg} -{Εικόνα 8 σημείων της διαδρομής 1, με 8\eng{sec} διαφορά μεταξύ τους.} +{Εικόνα 8 σημείων της διαδρομής 1, εκκινώντας από το ίχνος 480, με 8\eng{sec} διαφορά μεταξύ τους.} \InsertFigure{0.8}{fig:P7683_2}{session2/P7683-2020-04-14-17:24:55.jpg} -{Εικόνα 8 σημείων της διαδρομής 1, με 6\eng{sec} διαφορά μεταξύ τους.} +{Εικόνα 8 σημείων της διαδρομής 1, εκκινώντας από το ίχνος 200, με 6\eng{sec} διαφορά μεταξύ τους.} \end{document} diff --git a/report/source.tex b/report/source.tex new file mode 100644 index 0000000..17e2c35 --- /dev/null +++ b/report/source.tex @@ -0,0 +1,1160 @@ +% +% Network programming Lab report source code +% +% authors: +% Χρήστος Χουτουρίδης ΑΕΜ 8997 +% cchoutou@ece.auth.gr + + +% Document configuration +\newcommand{\ClassName}{Δίκτυα Υπολογιστών Ι} +\newcommand{\DocTitle}{Κώδικας εφαρμογής} +\newcommand{\InstructorName}{Δημήτριος Μητράκος} +\newcommand{\InstructorMail}{mitrakos@eng.auth.gr} +\newcommand{\CurrentDate}{\today} + +\input{AuthReport.tex} + +%\renewcommand{\AuthorName}{Χρήστος Χουτουρίδης} +%\renewcommand{\AuthorMail}{cchoutou@ece.auth.gr} +%\renewcommand{\AuthorAEM}{8997} + +\fancyhead[L]{\ClassName} +\fancyhead[R]{Χρήστος Χουτουρίδης 8997} + +% Document +% ================= +\begin{document} + +\FirstPage + +\tableofcontents + +\section{Περιγραφή} +Για την ανάπτυξη του κώδικα χρησιμοποιήσαμε το περιβάλλον \eng{eclipse} και το \eng{openjdk} στην έκδοση 11. +Επειδή η εφαρμογή λειτουργεί ως \eng{command line tool,} χρησιμοποιήσαμε ακόμα το \eng{commons-cli} από \href{http://commons.apache.org/proper/commons-cli/}{\eng{apache commons}} ώς εργαλείο ανάγνωσης των ορισμάτων του χρήστη. +Η υλοποίηση της εφαρμογής είναι πολύ απλή. +Δεν χρησιμοποιούμε \eng{interfaces} ή κληρονομικότητα. +Αντίθετα έχουμε χωρίσει την εφαρμογή σε αυτόνομα αντικείμενα. +Τα αντικείμενα \eng{Com} και \eng{Log} παρέχουν τις βασικές λειτουργίες για την επικοινωνία με τον \eng{server} και την έξοδο του προγράμματος αντίστοιχα. +Τα αντικείμενα αυτά χρησιμοποιούνται απλώς μέσα υπόλοιπα. +Χρησιμοποιούμε δηλαδή την απλούστερη δυνατή τεχνική (\eng{build by composition}). + +\par Τον κώδικα καθώς και την παραγόμενη τεκμηρίωσή του μέσω \eng{JavaDoc} μπορείτε να την βρείτε στο παραδοτέο αρχείο στους καταλόγους \eng{src} και \eng{doc.} +Τέλος στο \href{https://git.hoo2.net/hoo2/virtualModem}{προσωπικό αποθετήριο} του συντάκτη υπάρχει όλος ο κώδικας της εφαρμογής, της εργασίας και της επεξεργασίας των αποτελεσμάτων. +Παραθέτουμε παρακάτω τον κώδικα της εφαρμογής σε μορφή !!κειμένου!!, όπως αυτό ζητήθηκε από την εκφώνηση της εργασίας. +Το κάθε κεφάλαιο αντιστοιχεί σε ξεχωριστό αρχείο του κώδικα. + +\selectlanguage{english} +\titleformat{\section}[block]{\large\textbf}{\thesection.}{1em}{} +\small +\section{virtualModem.java} +\begin{verbatim} +/** + * @file VirtualModem.java + * @brief + * Contain the Main class for the project VirtualModem + * + * Usage examples: + * ========================== + * java -jar ./VirtualModem.jar -v -l Exxxx-$(date +%F-%T).log -e Exxxx 600 + * java -jar ./VirtualModem.jar -v -l Qxxx-Rxxxx-$(date +%F-%T).log -a Qxxxx Rxxxx 600 + * java -jar ./VirtualModem.jar -v -l Pxxxx_600_80_8p-$(date +%F-%T).log -p Pxxxx 600 80 8 P1124-$(date +%F-%T) + * java -jar ./VirtualModem.jar -v -l Mxxxx-$(date +%F-%T).log -g Mxxxx Mxxxx-$(date +%F-%T) 2 + * java -jar ./VirtualModem.jar -v -l Gxxxx-$(date +%F-%T).log -g Gxxxx Gxxxx-$(date +%F-%T) 2 + * + * @author Christos Choutouridis AEM:8997 + * @email cchoutou@ece.auth.gr + */ +package net.hoo2.auth.vmodem; + +/** @name imports */ +/** @{ */ +import org.apache.commons.cli.*; /** command line utility */ +/** @} */ + + +/** + * @class VirtualModem + * + * @brief This is the main control class of the program. + * + * This class includes the main function which read the user input + * and create the appropriate object for the requested sequence to + * retrieve data. + */ +public class VirtualModem { + + /** @name Data */ + /** @{ */ + CommandLine line; /** Command line for the argument list */ + CommandLineParser parser; /** Parser for the argument list */ + Options options; /** Option configuration container */ + HelpFormatter formatter; /** An extra helper for -h */ + Com com; /** Reference to basic configuration module */ + Log log; /** Reference to basic logging module */ + /** @} */ + + /** + * @brief The main constructor of the class + * We allocate memory for the data needed for the command line + */ + public VirtualModem () { + parser = new DefaultParser(); + options = new Options(); + formatter = new HelpFormatter(); + com = new Com(); + + // Create argument options and a basic help file + // for future use. + Option verb = new Option ("v", "verbose", false, "Be more verbose to the console"); + Option help = new Option ("h", "help", false, "Print this message"); + Option timeout = Option.builder("t") + .longOpt("timeout") + .hasArg() + .valueSeparator('=') + .desc("Select timeout in [sec]") + .build(); + Option speed = Option.builder("s") + .longOpt("speed") + .hasArg() + .valueSeparator('=') + .desc("Select speed in [bps]") + .build(); + Option log = Option.builder("l") + .longOpt("log") + .hasArg() + .desc("Log file name to use") + .build(); + Option echo = Option.builder("e") + .longOpt("echo") + .numberOfArgs(2) + .desc ("Request echo sequence where = <1> <2>\n" + + " <1>: The echo requested code from virtual lab\n" + + " <2>: The time duration of the session [sec]") + .build(); + Option arq = Option.builder("a") + .longOpt("arq") + .numberOfArgs(3) + .desc ("Request arq sequence where = <1> <2> <3>\n" + + " <1>: The ACK requested code for virtual lab\n" + + " <2>: The NACK requested code from virtual lab\n" + + " <2>: The time duration for the session [sec]") + .build(); + Option img = Option.builder("g") + .longOpt("img") + .numberOfArgs(3) + .desc("Request an image sequence where = <1> <2> <3>\n" + + " <1>: The image requested code from virtual lab\n" + + " <2>: The filename to use for storing the image (without .jpg)\n" + + " <3>: The requested images to fetch.") + .build(); + Option gps = Option.builder("p") + .longOpt("gps") + .numberOfArgs(5) // G8164 10 800 8 gps_10_800 + .desc("Request a GPS sequence where = <1> <2> <3> <4>\n" + + " <1>: The gps requested code from virtual lab\n" + + " <2>: The time from trace to use as starting point [sec]\n" + + " <3>: The time duration for the trace to fetch [sec]\n" + + " <4>: The number of points to fetch from the above trace\n" + + " <5>: The filename to use for storing the image (without .jpg)") + .build(); + options.addOption(verb); + options.addOption(help); + options.addOption(timeout); + options.addOption(speed); + options.addOption(log); + options.addOption(echo); + options.addOption(arq); + options.addOption(img); + options.addOption(gps); + } + + /** @name private api */ + /**@{*/ + + /** + * parse the command line arguments + * @param args the arguments to parse + * @return the status of the operation + */ + private boolean getCmdOptions (String[] args) { + try { + // parse the command line arguments + line = parser.parse (options, args); + } + catch( ParseException exp ) { + // oops, something went wrong + System.err.println( "Parsing command line failed: " + exp.getMessage() ); + return false; + } + return true; + } + + /** + * Dispatch the correct functionality based on arguments + * @return the status of the operation (currently true) + */ + private boolean commandDispatcher () { + boolean verbose = false; + + if (line.hasOption("help")) { + formatter.printHelp( "virtualModem", options ); + return true; + } + + // Get log and verbose options first + if (line.hasOption("verbose")) + verbose = true; + if (line.hasOption("log")) + log = new Log (line.getOptionValue("log"), verbose); + else + log = new Log (null, verbose); + if (log.open() != true) + return false; + + // get other options + if (line.hasOption("timeout")) { + com.timeout(Integer.parseInt(line.getOptionValue("timeout"))); + } + if (line.hasOption("speed")) { + com.speed(Integer.parseInt(line.getOptionValue("speed"))); + } + + // Execution dispatcher + if (line.hasOption("echo")) { + byte[] code = line.getOptionValues("echo")[0].getBytes(); + Echo e = new Echo(com, log, code, + Integer.valueOf(line.getOptionValues("echo")[1])); + if (com.open()) { + e.caption(code); + e.run(); + com.close(); + } + } + else if (line.hasOption("arq")) { + byte[] ack = line.getOptionValues("arq")[0].getBytes(); + byte[] nack = line.getOptionValues("arq")[1].getBytes(); + ARQ a = new ARQ(com, log, ack, nack, + Integer.valueOf(line.getOptionValues("arq")[2])); + if (com.open()) { + a.caption(ack, nack); + a.run(); + com.close(); + } + } + else if (line.hasOption("img")) { + byte[] code = line.getOptionValues("img")[0].getBytes(); + Image im = new Image (com, log, code, + line.getOptionValues("img")[1], + Integer.valueOf(line.getOptionValues("img")[2])); + if (com.open()) { + im.caption(code); + im.run(); + com.close(); + } + } + else if (line.hasOption("gps")) { + byte[] code = line.getOptionValues("gps")[0].getBytes(); + GPS g = new GPS ( + com, log, code, + Integer.valueOf(line.getOptionValues("gps")[1]), + Integer.valueOf(line.getOptionValues("gps")[2]), + Integer.valueOf(line.getOptionValues("gps")[3]) + ); + Image im = new Image ( + com, log, null, + line.getOptionValues("gps")[4], 1 + ); + if (com.open()) { + g.caption(); + im.code(g.run().getBytes()); + im.run(); + com.close(); + } + } + + log.close(); + return true; + } + /**@}*/ + + + /** + * @brief Main function + */ + public static void main(String[] args) { + // allocate the main object + VirtualModem vmodem = new VirtualModem(); + + // prepare command line input + if (vmodem.getCmdOptions (args) != true) + return; + // Call the requested functionality + if (vmodem.commandDispatcher() != true) + return; + } +} +\end{verbatim} + +\section{Com.java} +\begin{verbatim} +/** + * @file Com.java + * + * @author Christos Choutouridis AEM:8997 + * @email cchoutou@ece.auth.gr + */ +package net.hoo2.auth.vmodem; + +/** @name imports */ +/** @{ */ +import java.util.Arrays; +import ithakimodem.*; +/** @} */ + +/** + * @class Com + * + * Wrapper object of the provided Modem class to provide + * a convenient and common API for all the session functionalities + */ +class Com { + static final int SPEED_DEFAULT = 48000; /** default communication speed [bps] */ + static final int TIMEOUT_DEFAULT = 2000; /** default timeout values [sec] */ + static final String URL_DEFAULT = "ithaki"; /** Default destination. Ithaki of-course */ + + private Modem modem_; /** Ref to Modem */ + private int speed_; /** Communication speed [bps] */ + private int timeout_; /** communication timeout [sec] */ + + /** + * Basic constructor + */ + Com () { + modem_ = new Modem(); + speed_ = SPEED_DEFAULT; + timeout_ = TIMEOUT_DEFAULT; + modem_.setSpeed(speed_); + modem_.setTimeout(timeout_); + } + /** A more fancy constructor + * + * @param log Reference to Log to use + * @param speed The desired speed [bps] + * @param timeout The desired timeout [sec] + * @note + * Currently not used + */ + Com (Log log, int speed, int timeout) { + modem_ = new Modem(); + speed_ = speed; + timeout_ = timeout; + modem_.setSpeed(speed_); + modem_.setTimeout(timeout_); + } + + /** @name Mutator interface */ + /**@{ */ + /** Get the current timeout value [sec] */ + int timeout () { return timeout_; } + /** Set the timeout value [sec] */ + void timeout (int timeout) { + if (timeout_ != timeout) { + timeout_ = timeout; + modem_.setTimeout(timeout_); + } + } + /** Get the current speed [bps] */ + int speed () { return speed_; } + /** Set the speed [bps] */ + void speed (int speed) { + if (speed_ != speed) { + speed_ = speed; + modem_.setSpeed(speed_); + } + } + /**@} */ + + /** @name Public API of the class */ + /**@{ */ + /** Open a communication channel with a URL */ + boolean open (String url) { return modem_.open(url); } + /** Open a communication channel with Ithaki */ + boolean open () { return modem_.open(URL_DEFAULT); } + /** Close the connection */ + boolean close() { return modem_.close(); } + + /** + * @grief The basic communication functionality + * + * This function sends a request to server and return the response. In order to + * do that, the main reading loop seeks for the starting pattern and use the data + * from that point up to the ending pattern. This is very helpful for binary incoming + * data. + * @note + * Blocking mode + * @param data Reference to Transaction data to use @see Transaction + * @param code The request code to send + * @param begin The starting pattern of the response data + * @param end The ending pattern of the response data + * @param bin A flag to indicate that the data are in binary form + * @return Reference to Transaction object with the response data. @see Transaction + */ + Transaction request (Transaction data, byte[] code, byte[] begin, byte[] end, boolean bin) { + int ch =0; + boolean have_begin = (begin != null) ? false : true; + boolean incoming = false; + + // Clear the receive buffer first + _clear (data.response, 0, data.response.length); + if (code != null) { + // if we have a request + data.code = code; // store the request code for the transaction + modem_.write(data.code); // send the code and mark the time + modem_.write((int)'\r'); + data.departure = System.currentTimeMillis();// - (long)((8*(data.code.length+1))*(1000.0/speed_)); + } + + // main receive loop + data.size =0; + do { + // escape guard for memory protection + if (data.size >= data.response.length) { + data.size =0; + return data; + } + // read the data byte from server + try { + ch = modem_.read(); + } + catch (Exception e) { + // Oops!!!! something went wrong. Break and return :( + System.err.println (e.getMessage()); + data.size =0; + return data; + } + if (!incoming) { + // first byte triggered. mark the time + incoming = true; + data.arrival = System.currentTimeMillis();// - (long)(8*(1000.0/speed_)); + } + data.response [data.size++] = (byte)ch; // store the byte + + if (!have_begin && (detect(data.response, begin, data.size) != -1)) { + // If begin pattern detected, start over. + _clear(data.response, 0, data.size); + data.size = _copy (data.response, begin); + have_begin = true; + } + } while ( + ch != -1 && ( + !have_begin || ( + (bin || (detect (data.response, "\r\n\n\n".getBytes(), data.size) == -1)) + && (bin || (detect (data.response, "NO CARRIER".getBytes(), data.size) == -1)) + && (detect (data.response, end, data.size) == -1) + ) + ) + ); + /*^ + * We loop until: + * 1) server returns -1 + * 2) A end pattern arrives + * 3) A "\r\n\n\n" sequence arrives (in character mode, not for binary files) + * 4) A "NO CARRIER" sequence arrives (in character mode, not for binary files) + */ + return data; + } + + /** + * @brief + * A pattern detect functionality. + * + * Search in data input for the pattern and return its position if found. + * @note + * O(n^2) in time. + * @param data The data buffer to search into + * @param pattern The pattern to search for + * @param max The maximum length to search + * @return The position of pattern in data, or -1 if not found + */ + static int detect (byte[] data, byte[] pattern, int max) { + if (pattern != null) { + for (int i =0 ; i= src.length) { + for (int i=0 ; i1) + file = filename_ + "_" + i + ".jpg"; + else + file = filename_ + ".jpg"; + line = new String(code_) + ": "; + log_.write(line); + transaction_ = com_.request(transaction_, code_, IMAGE_BEGIN, IMAGE_END, true); + line = "File= " + file + + " Tr= " + (transaction_.arrival - transaction_.departure) + " [msec]" + + " Tt= " + (System.currentTimeMillis() - transaction_.departure) + " [msec]"; + log_.write(line); + try { + ostream = new BufferedOutputStream(new FileOutputStream(file)); + ostream.write(transaction_.response); + ostream.flush(); + ostream.close(); + } + catch (Exception exp) { + System.err.println ("Error creating " + file + exp.getMessage()); + return; + } + } + } +} +\end{verbatim} + +\end{document} \ No newline at end of file