\documentclass[paper=A4]{scrreprt}
% \usepackage[hscale=0.69,vscale=0.79,heightrounded,includehead]{geometry}
\usepackage{graphicx}
\usepackage{parskip}

% Title Page
\title{SaFariPark/MultiSFP manual}
\author{Vincent van Beveren}

\begin{document}
\maketitle

\chapter{Introduction}
The manual is very much a work in progress. So far there is not a lot in here.

\chapter{MultiSFP}


\chapter{SaFariPark}

\begin{figure}[h!]
	\includegraphics[width=\linewidth]{res/safaripark-screenshot}.	
	\caption{Start up screen of SaFariPark}
	\label{fig:start-screen}
\end{figure}

SaFariPark is the main GUI application for reading, calibrating and configuring SFP modules. When loaded a window should appear as presented in Figure~\ref{fig:start-screen}. All connected MultiSFP devices are listed in the device manager top right. Each bay shows the connection state and if a module is placed, the part identifier and serial number.

\section{Viewing and editing the SFP module contents}
SaFariPark shows, in the edit pane, a higher overview of the content loaded inside the SFP module.

\begin{figure}[h!]
	\includegraphics[width=\linewidth]{res/editor}.	
	\caption{The editor}
	\label{fig:editor}
\end{figure}

\section{Ubuntu configuration}

To run SaFariPark on Ubuntu two things need to happen:

\begin{itemize}
\item The rights of the FTDI device must be relaxed such that any use has read and write permissions
\item The ftdi\_sio driver must be prevented from loading, as it will interfere with opening the device
\end{itemize}

\subsubsection{Relaxing driver rights}
Create a file named 90-ftdi in /etc/udev/rules.d/ and put in the following statement:

\begin{verbatim}
  SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", MODE="0666" 
\end{verbatim}

\subsubsection{Prevent loading of the ftdi\_sio driver}
Edit the file /etc/modprobe.d/blacklist.conf and append the following line:
\begin{verbatim}
   blacklist ftdi_sio
\end{verbatim}

Note: This will prevent any FTDI based device from being loaded as a USB serial converted.

\section{Troubleshooting}

\subsection{The MultiSFP does not show up in the device manager}
When using a 'virgin' MultiSFP, the FTDI Template XML file must be loaded using FT_prog. 
This template is located in the GIT\\hw sudirectory.



\chapter{Appendices}

\section{Overlay XML description}


\end{document}          
