Skip to content
Snippets Groups Projects
Commit 12902d62 authored by Robert Hartung's avatar Robert Hartung
Browse files

adds appendix

parent 0883c002
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Showing
with 70 additions and 49 deletions
manual.tex
+ 70
− 49
View file @ 12902d62
......@@ -114,7 +114,15 @@ The ADC has a resolution of 12 bit. However, the final resolution of the scope d
\chapter{Software}
The Command Line Interface (CLI) program can be downloaded online~\footnote{\url{https://gitlab.ibr.cs.tu-bs.de/potatoscope/cli}}.
This chapter describes the several software parts of the \PS.
\section{Firmware}
The firmware is available from \url{https://gitlab.ibr.cs.tu-bs.de/potatoscope/firmware}.
\section{CLI}
The Command Line Interface (CLI) program can be downloaded online at \url{https://gitlab.ibr.cs.tu-bs.de/potatoscope/cli}.
To start right away, the following command starts a measurement at 10000 kHz rate (\texttt{-r}) with a limit (\texttt{-l}) of 1000 samples.
Afterwards it waits for a notification (\texttt{-n}) of the new measurement (\texttt{--index}) and automatically retrieves the measurement.
The output format is CSV (\texttt{--csv}) and the values are automatically converted to voltage and current (\texttt{--convert}).
......@@ -128,9 +136,32 @@ The output format is CSV (\texttt{--csv}) and the values are automatically conve
\chapter{Measuring}
\begin{figure}[htb]
\tiny
\begin{tikzpicture}[node distance=0.1cm,minimum width=1cm]
This section describes how to measure different devices with the \PS.
\section{PotatoScope V1}
This section describes different measurements for the PotatoScope V1.
\subsection{INGA (red, Version 1.6)}
To measure a red INGA sensor node (version 1.6) connect one of the red 3,3V pins to IN (labed with 3,3V).
Afterwards connect OUT (labeled $V_{INGA}$) to the supply voltage of the INGA.
Finally one ground pin of INGA should be connected to any of the GND pins of the \PS.
\section{PotatoScope V2}
This section gives a short introduction on how to generally measure currents and voltages with the \PS. Your \emph{Supply Voltage} should be connected to \emph{IN1}. The output \emph{OUT1} should be connected to your device's supply pin. Make sure to use on of the \emph{GND} pins to connect the grounds.
To measure the supply voltage, add both \emph{Jumper 1} and \emph{Jumper 2}. Also make sure to add \emph{JP ADC1} and \emph{JP ADC2}.
\begin{appendix}
\chapter{Pinout diagrams}
\section{PotatoScope V1}
\begin{figure}[H]
\tiny
\begin{tikzpicture}[node distance=0.1cm,minimum width=1cm,show background rectangle]
% Marker
\node[draw,circle,fill=tuMediumOrange60] (trigger1) {T1};
\node[draw,circle,below=of trigger1,fill=tuMediumOrange60] (trigger2) {T2};
......@@ -139,7 +170,7 @@ The output format is CSV (\texttt{--csv}) and the values are automatically conve
% JTAG
\node[draw,circle,right=12cm of trigger4,yshift=-1cm,white,fill=tuBlack] (gnd-20) {GND};
\node[draw,circle,right=11cm of trigger1,yshift=-1cm,white,fill=tuBlack] (gnd-20) {GND};
\node[draw,circle,below=of gnd-20,white,fill=tuBlack] (gnd-18) {GND};
\node[draw,circle,below=of gnd-18,white,fill=tuBlack] (gnd-16) {GND};
\node[draw,circle,below=of gnd-16,white,fill=tuBlack] (gnd-14) {GND};
......@@ -150,7 +181,7 @@ The output format is CSV (\texttt{--csv}) and the values are automatically conve
\node[draw,circle,below=of gnd-6,white,fill=tuBlack] (gnd-4) {GND};
\node[draw,circle,below=of gnd-4,fill=tuRed] (vcc-2) {3.3V};
\node[draw,circle,right=of vcc-2,fill=tuRed] (vcc-1) {3.3V};
\node[draw,circle,right=of gnd-4,black,fill=tuMediumBlue60] (jtag-3) {!RST};
\node[draw,circle,right=of gnd-6,black,fill=tuMediumBlue60] (jtag-5) {TDI};
......@@ -161,9 +192,9 @@ The output format is CSV (\texttt{--csv}) and the values are automatically conve
\node[draw,circle,right=of gnd-16,black,fill=tuGray20] (jtag-15) {NC};
\node[draw,circle,right=of gnd-18,black,fill=tuGray20] (jtag-17) {NC};
\node[draw,circle,right=of gnd-20,black,fill=tuGray20] (jtag-19) {NC};
% IO
\node[draw,circle,below=8cm of trigger3,fill=tuGray60] (adc3) {ADC3};
\node[draw,circle,below=3cm of trigger3,fill=tuGray60] (adc3) {ADC3};
\node[draw,circle,below=of adc3,fill=tuGray60] (adc4) {ADC4};
\node[draw,circle,below=of adc4,fill=tuGray60] (tx) {TX};
\node[draw,circle,below=of tx,fill=tuGray60] (rx) {RX};
......@@ -200,24 +231,28 @@ The output format is CSV (\texttt{--csv}) and the values are automatically conve
\draw[ultra thick,dashed] (jpi) -- ++(0, -1cm) |- ($(in1)!0.5!(out1)+(0,-1)$) -- ($(in1)!0.5!(out1)$);
\begin{pgfonlayer}{background}
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpvcc) (jpdivider),fill=gray,label=left:{\normalsize Jumper 1}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpu) (adc1),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC1}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpi) (adc2),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC2}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpvcc) (jpdivider),fill=gray,label=left:{\normalsize Jumper 1}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpu) (adc1),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC1}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpi) (adc2),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC2}}] {};
\end{pgfonlayer}
\end{tikzpicture}
\caption{PotatoScope V1 pin headers}
\end{figure}
\begin{figure}[htb]
\tiny
\begin{tikzpicture}[node distance=0.1cm,minimum width=1cm]
\end{tikzpicture}
\caption{PotatoScope V1 pin headers}
\end{figure}
\section{PotatoScope V2}
\begin{figure}[H]
\tiny
\begin{tikzpicture}[node distance=0.1cm,minimum width=1cm,show background rectangle]
\node[draw,circle,fill=tuMediumOrange60] (trigger1) {T1};
\node[draw,circle,below=of trigger1,fill=tuMediumOrange60] (trigger2) {T2};
\node[draw,circle,below=of trigger2,fill=tuMediumOrange60] (trigger3) {T3};
\node[draw,circle,below=of trigger3,fill=tuMediumOrange60] (trigger4) {T4};
\node[right=12cm of trigger1] {};
\node[draw,circle,below=0.5cm of trigger4,fill=tuMediumBlue40] (vcc) {VCC};
\node[draw,circle,below=of vcc,fill=tuMediumBlue40] (clk) {CLK};
\node[draw,circle,below=of clk,fill=tuMediumBlue40] (gnd) {GND};
......@@ -255,37 +290,23 @@ The output format is CSV (\texttt{--csv}) and the values are automatically conve
\draw[ultra thick,dashed] (jpu) -- ++(-0.75cm, 0) |- (jpdivider);
\draw[ultra thick,dashed] (jpi) -- ++(0, -1cm) |- ($(in1)!0.5!(out1)+(0,-1)$) -- ($(in1)!0.5!(out1)$);
\begin{pgfonlayer}{background}
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpvcc) (jpdivider),fill=gray,label=left:{\normalsize Jumper 1}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,dashed,fit=(connvcc) (out2),label=left:{\normalsize Jumper 2}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpu) (adc1),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC1}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpi) (adc2),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC2}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(3v3) (in2),dashed,label={[rotate=90,right]above:{\normalsize Supply 3,3V}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(5v) (in2),dashed,label={[rotate=90,right]above:{\normalsize Supply 5V}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpvcc) (jpdivider),fill=gray,label=left:{\normalsize Jumper 1}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,dashed,fit=(connvcc) (out2),label=left:{\normalsize Jumper 2}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpu) (adc1),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC1}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(jpi) (adc2),fill=gray,label={[rotate=90,right]above:{\normalsize JP ADC2}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(3v3) (in2),dashed,label={[rotate=90,right]above:{\normalsize Supply 3,3V}}] {};
\node[draw,rectangle,rounded corners=0.2cm,inner sep=0.05cm,fit=(5v) (in2),dashed,label={[rotate=90,right]above:{\normalsize Supply 5V}}] {};
\end{pgfonlayer}
\end{tikzpicture}
\caption{PotatoScope V2 pin headers}
\end{figure}
\section{PotatoScope V1}
This section describes how to measure different devices with the different version of the \PS.
\subsection{INGA (red, Version 1.6)}
To measure a red INGA sensor node (version 1.6) connect one of the red 3,3V pins to IN (labed with 3,3V).
Afterwards connect OUT (labeled $V_{INGA}$) to the supply voltage of the INGA.
Finally one ground pin of INGA should be connected to any of the GND pins of the \PS.
\section{PotatoScope V2}
This section gives a short introduction on how to generally measure currents and voltages with the \PS. Your \emph{Supply Voltage} should be connected to \emph{IN1}. The output \emph{OUT1} should be connected to your device's supply pin. Make sure to use on of the \emph{GND} pins to connect the grounds.
\end{tikzpicture}
\caption{PotatoScope V2 pin headers}
\end{figure}
To measure the supply voltage, add both \emph{Jumper 1} and \emph{Jumper 2}. Also make sure to add \emph{JP ADC1} and \emph{JP ADC2}.
\end{appendix}
\end{document}
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment