Update notes and documents

Signed-off-by: Severin Kaderli <severin@kaderli.dev>

documentation/thesis/content/02_preliminaries.tex

@@ -1 +1,13 @@
 \chapter{Preliminaries}
+\section{Web Worker}
+Web Workers are a web API that allows running JavaScript code in background threads in the browser. This way you can run CPU intensive processes without stalling the main thread and locking up the UI.
+
+There's a few limitations with Web Workers. A Web Worker doesn't have access to the DOM, the window object and some web APIs.
+
+The main thread and Web Workers can communicate together using messages. They can send their messages using a postMessage method and the other side receives a message event it can act upon. \cite{WebWorkers}
+
+Web Workers are used in this project to put a load on the CPU to modify the magnetic field without locking up the website itself.
+
+\section{Manchester Code}
+
+\section{Hall Sensor}

documentation/thesis/content/03_personas.tex

@@ -1,15 +1,8 @@
 \chapter{Personas}
-This chapter describes the personas with their goals and problems that they want
-to have solved. These personas are later used in the use cases and requirements
-in \autoref{chapter:requirements}.
+This chapter describes the personas with their motivations, goals and problems that they want
+to have solved. These motivations are then later used to create and describe the requirements in \autoref{chapter:requirements}.
 
-\section{Alice}
+\textbf{Alice} \\
 Alice wants to be able to receive a small piece of data over a website, similar
 to a QR code, with her smartphone but without other people being able to see the
-"code" over her shoulders. 
-
-\section{Eve}
-Eve wants to be able to transmit data from a secure system (e.g. a server) to
-her smartphone in an otherwise airgapped system (no internet or other
-connectivity methods available) in a limited amount of available time (e.g. 30
-minutes).
+code over her shoulders. She also wants to be able to receive data to her smartphone while it has connection available e.g. when it's in airplane mode.

documentation/thesis/content/04_requirements.tex

@@ -2,43 +2,73 @@
 \label{chapter:requirements}
 
 \section{Functional Requirements}
-\begin{table}[ht]
-    \begin{reqTblr}{lll}
+\begin{table}[H]
+    \begin{reqTblr}{l p{11.8cm}}
         ID & F01 \\
-        Title & Website Transmits Data using MI \\
-        Persona & Persona 1, Persona 2 \\
-        Description & Description here...
+        Title & Calibration on Website \\
+        Application & Website \\
+        Description & Alice visits the website and starts the calibration mode on the website. While in calibration mode the the website continously puts load on the CPU.
     \end{reqTblr}
     \caption{Functional Requirement 01}
 \end{table}
 
-\begin{table}[ht]
-    \begin{reqTblr}{lll}
+\begin{table}[H]
+    \begin{reqTblr}{l p{11.8cm}}
         ID & F02 \\
-        Title & Smartphone Receives the Data \\
-        Persona & Persona 1, Persona 2 \\
-        Description & Description here...
+        Title & Calibration on App \\
+        Application & Smartphone App \\
+        Description & In the app Alice can start the calibration process. By putting her smartphone on different location on her laptop the app will tell her the current strength of the magnetic field. The point with the strongest magnetic field is the optimal place for data transmission.
     \end{reqTblr}
     \caption{Functional Requirement 02}
 \end{table}
 
-\begin{table}[ht]
-    \begin{reqTblr}{lll}
+\begin{table}[H]
+    \begin{reqTblr}{l p{11.8cm}}
         ID & F03 \\
-        Title & Smartphone Displays the Data \\
-        Persona & Persona 1, Persona 2 \\
-        Description & Description here...
+        Title & Text Entry \\
+        Application & Website \\
+        Description & The website contains a text input field. Alice can enter any ASCII string in this text input.
     \end{reqTblr}
     \caption{Functional Requirement 03}
 \end{table}
 
-\section{Non Functional Requirements}
-\begin{table}[ht]
-    \begin{reqTblr}{lll}
-        ID & N01 \\
-        Title & Smartphone Requires No Connectivity \\
-        Persona & Persona 1, Persona 2 \\
-        Description & Description here...
+\begin{table}[H]
+    \begin{reqTblr}{l p{11.8cm}}
+        ID & F04 \\
+        Title & Sending Data \\
+        Application & Website \\
+        Description & Alice visits the website, enter a text and then clicks on the send send button. The website will attempt to send the string in the input field using MI. The data will be sent continously until Alice stops the sending by clicking on the stop button.
     \end{reqTblr}
-    \caption{Non Functional Requirement 01}
+    \caption{Functional Requirement 04}
+\end{table}
+
+\begin{table}[H]
+    \begin{reqTblr}{l p{11.8cm}}
+        ID & F05 \\
+        Title & Receiving Data \\
+        Application & Smartphone App \\
+        Description & Alice can start the receiving mode in the app. By putting her smartphone on the laptop she can receive the data that is sent by the website. The app displays the received text on the screen.
+    \end{reqTblr}
+    \caption{Functional Requirement 05}
+\end{table}
+
+
+\newpage
+\section{Non Functional Requirements}
+\begin{table}[H]
+    \begin{reqTblr}{l p{11.8cm}}
+        ID & N01 \\
+        Title & Working in Airplane Mode \\
+        Description & Alice can receive data using the app on her smartphone even if she has put her phone in airplane mode.
+    \end{reqTblr}
+    \caption{Non Functional Requirement 01} 
+\end{table}
+
+\begin{table}[H]
+    \begin{reqTblr}{l p{11.8cm}}
+        ID & N02 \\
+        Title & Transfer Rate \\
+        Description & The transfer speed between the laptop and smartphone should at least be \SI{2}{\bit\per\second}
+    \end{reqTblr}
+    \caption{Non Functional Requirement 02}
 \end{table}

documentation/thesis/content/05_solution.tex

@@ -1 +1,29 @@
 \chapter{Solution}
+The solution consists of two separate applications: a website used for transmitting data and a smartphone application used for receiving data. Transmission between the two application happens using a simple protocol on top of magnetic induction.
+
+\section{Protocol}
+The main communication protocol works over magnetic induction. By putting load on a CPU the resulting magnetic field can be changed. Using a magnetometer in a smartphone these changes can be measured and interpreted.
+
+For simplification purposes the protocol in this project is used to transmit ASCII text but in reality any bit stream can be transmitted.
+
+To indicate the start of a message in the transmission a preamble is used. The preamble used in this protocol is 3 high signals, followed by 1 low signal, followed by 3 high signals.
+
+\subsection{Sending}
+\begin{enumerate}
+    \item{Convert the text to an ASCII encoded bit stream}
+    \item{Encode the ASCII bit stream using manchester encoding}
+    \item{Start the transmission by sending the preamble}
+    \item{Transmit the manchester encoded bit stream}
+    \item{Repeat from step 3 until transmission is stopped}
+\end{enumerate}
+
+\subsection{Receiving}
+\begin{enumerate}
+    \item{Detect the preamble}
+    \item{Decode the received manchester encoded bit stream}
+    \item{Convert the ASCII bit stream to text}
+\end{enumerate}
+
+\section{Website}
+
+\section{App}

documentation/thesis/thesis.tex

@@ -30,6 +30,11 @@
 \usepackage{pgfgantt}
 \usepackage{rotating}
 
+\usepackage{siunitx}
+\sisetup{per-mode=symbol}
+
+\usepackage{float}
+
 % https://tex.stackexchange.com/a/24827
 \makeatletter
 \def\input@path{{documentation/thesis/content}}
@@ -75,6 +80,9 @@
 \bibliographystyle{plainurl} 
 \bibliography{thesis}
 
+\listoffigures
+\listoftables
+
 \appendix
 \chapter{First appendix Chapter}  
 \end{document}