X-Git-Url: https://git.martlubbers.net/?a=blobdiff_plain;f=methods.tex;h=e25809c7034ec18fa86a88fbf8f1918e3d4e0f4c;hb=a0fc5b24e17c83d05fa5cb95e855e784abac8f3e;hp=1cf3b68de54ff97a5d7fb6e1dc728295dbd0f0f8;hpb=0bc7120dbe8ab9e0262b1f7cf98dacaf1d6a14ac;p=msc-thesis1617.git diff --git a/methods.tex b/methods.tex index 1cf3b68..e25809c 100644 --- a/methods.tex +++ b/methods.tex @@ -1,99 +1,8 @@ -\section{\acrlong{TOP}} -\subsection{\gls{iTasks}} -\gls{TOP} is a recent new programming paradigm implemented as -\gls{iTasks}\cite{achten_introduction_2015} in the pure lazy functional -language \gls{Clean}\cite{brus_cleanlanguage_1987}. \gls{iTasks} is a -\gls{EDSL} to model workflow tasks in the broadest sense. A \CI{Task} is just -a function that, given some state, returns the observable value of the -\CI{TaskValue}. A simple example is shown in Listing~\ref{lst:taskex} -accompanied with Figure~\ref{fig:taskex1},~\ref{fig:taskex2} and~% -\ref{fig:taskex3}. - -\begin{lstlisting}[language=Clean,label={lst:taskex},% - caption={An example \gls{Task} for entering a name}] -:: Name = { firstname :: String - , lastname :: String - } - -derive class iTask Name - -enterInformation :: String [EnterOption m] -> (Task m) | iTask m - -enterName :: Task Name -enterName = enterInformation "Enter your name" [] -\end{lstlisting} +\input{methods.top.tex} -\begin{figure}[H] - \begin{subfigure}{.25\textwidth} - \centering - \includegraphics[width=.9\linewidth]{taskex1} - \caption{Initial interface}\label{fig:taskex1} - \end{subfigure} - \begin{subfigure}{.25\textwidth} - \centering - \includegraphics[width=.9\linewidth]{taskex2} - \caption{Incomplete entrance}\label{fig:taskex2} - \end{subfigure} - \begin{subfigure}{.25\textwidth} - \centering - \includegraphics[width=.9\linewidth]{taskex3} - \caption{Complete entry}\label{fig:taskex3} - \end{subfigure} - \caption{Example of a generated user interface} -\end{figure} - -\subsection{Combinators} - -\section{\acrlong{EDSL}s} -\todo{while iTasks is also a DSL\ldots} -\glspl{mTask} are expressed in a class based shallowly embedded \gls{EDSL}. -There are two main types of \glspl{EDSL}. -\todo{Small shallow embedded dsl intro} -\todo{Small deep embedded dsl} -\todo{Show that class based has the best of both worlds} - -\section{Architecture} -\subsection{Devices} -The client code for the devices is compiled from one codebase. For a device to -be eligible for \glspl{mTask} it must be able to compile the shared codebase -and implement (part of) the device specific interface. The shared codebase only -uses standard \gls{C} and no special libraries or tricks are used. Therefore -the code is compilable for almost any device or system. Note that it is not -needed to implement a full interface. The full interface, listed in -Appendix~\label{app:device-interface}\todo{update interface listing}, also -includes functions for accessing the peripherals that not every device might -have. Devices can choose what to implement by setting the correct macros in the -top of the file. When a server connects to a client the specifications are -communicated. - -The current list of supported and tested devices is as follows: -\begin{itemize} - \item $^*$\texttt{NIX} systems such as Linux - \item STM32 like development boards supported by \texttt{ChibiOS}. - \item \emph{Arduino} compatible microcontrollers -\end{itemize} - -\subsection{Specification} -Devices are stored in a record type and all devices in the system are stored in -a \gls{SDS} containing all devices. From the macro settings in the interface -file a profile is created for the device that describes the specification. When -a connection between the server and a client is established the server will -send a request for specification. The client will serialize his specs and send -it to the server so that the server knows what the client is capable of. The -exact specification is listed in Listing~\ref{lst:devicespec} - -\begin{lstlisting}[language=Clean,label={lst:devicespec}, - caption={Device specification for \glspl{mTask}}] -:: MTaskDeviceSpec = - {haveLed :: Bool - ,haveAio :: Bool - ,haveDio :: Bool - ,bytesMemory :: Int - } -\end{lstlisting} -\todo{Explain specification, combine task and share space} +\input{methods.dsl.tex} -\subsection{Communication} +\input{methods.arch.tex} \section{mTasks} \subsection{\gls{EDSL}}