%! TEX root = ../thesis.tex
\chapter{Results}

\section{Firmware}

\subsection{I2C mapped Register-Table}
\input{./tabs/registerbuffer}

\section{Calibration}

\subsection{Calibration-Table}

\subsection{How to calibrate a PowerIt Board}

The Calibration process is based on the PItSTOP Python scripts\footnote{
 %TODO: insert repo, and link to docs
    \href{https://acereca.ddns.net:11443/acereca/pitstop}{PItSTOP Repo}
}.
These are split into \verb|server| and \verb|aggregator|. While the Server is handling the translation between raw I$^2$C data, and the JSON formatted result, the Aggregator takes this JSON and calculates a calibration.

Using the script any one of the following Values can be tested and calibrated:
\begin{itemize}
    \item Input Voltage (\verb|pitstop.Aggregator.test_v_48()|)
    \item Input Current (\verb|pitstop.Aggregator.test_i_48()|)
    \item 9.6V Output Voltage (\verb|pitstop.Aggregator.test_v_10()|)
    \item 1.8V Output Voltage (\verb|pitstop.Aggregator.test_v_18()|)
    \item 1.8V Output Current (\verb|pitstop.Aggregator.test_i_18()|)
\end{itemize}

\subsubsection{Setting up the Test Environment}
The simplest way to setup your environment consists of cloning the PItSTOP Project onto your Client:
\begin{mintylst}{bash}
    $ git clone https://url.to.pitstop
\end{mintylst}
then substituting the \verb|rsync| target:
\begin{mintylst}[makefile]{makefile}
    all:
        rsync --progress ./*.py /remote.url/
\end{mintylst}

, to be your server (should be a RaspberyyPi connected to the PowerIt) 

\subsubsection{Running a Test}
Runnig the test requires the following commands
\\
Serverside:
\begin{mintylst}{bash}
    $ python server.py
\end{mintylst}
Clientside:
\begin{mintylst}{bash}
    $ python aggregator.py
\end{mintylst}
Now just following the instructions given, the selected test can be run:
\begin{mintylst}{text}
    Setting up calibration test for {}
    Please be sure to:
     - connect the {} to the RaspberryPi running server.py.
     - connect the PowerIt to the RaspberyyPi as described in the documentation
     - and be sure to connect the {} to the {} Terminal.

    Continue (y/N): y

    What is the Name given to the connected PowerIt? [Bxx]: B05
\end{mintylst}


\section{Regulation}