From: Jan Michel <j.michel@gsi.de>
Date: Mon, 13 Oct 2014 16:37:29 +0000 (+0200)
Subject: added data format description of Adc Handler
X-Git-Url: https://jspc29.x-matter.uni-frankfurt.de/git/?a=commitdiff_plain;h=9de7d47978e79d748a00725f7398304fb9005058;p=daqdocu.git

added data format description of Adc Handler
---

diff --git a/trb3/AdcAddOn.tex b/trb3/AdcAddOn.tex
new file mode 100644
index 0000000..4fd11f8
--- /dev/null
+++ b/trb3/AdcAddOn.tex
@@ -0,0 +1,69 @@
+
+
+\begin{itemize*}
+ \item Schematics \href{http://jspc29.x-matter.uni-frankfurt.de/trb/schematics/AddOn\_ADC1-ALL.pdf}{AddOn\_ADC1-ALL.pdf}
+\end{itemize*}
+
+
+\subsubsection{Data Format}
+\begin{tabularx}{\textwidth}{|c|c|c|X|}
+\hline
+\textbf{Word} & \textbf{Bits} & \textbf{Value} & \textbf{Description} \\
+\hline\hline
+HDR & 31 -- 28 & 0x4     & ADC Header. Not required, e.g. can be omitted if the first word sent is DAT1 \\
+    & 23 -- 20 & 0 -- 11 & ADC Number \\
+    & 19 -- 16 & 0 -- 3, F  & ADC Channel. If channel is 0xF, the words following (e.g. status information) belongs to all channels of this ADC.\\
+    &  7 --  0 &         & Number of data words from this channel \\
+\hline
+DAT1 & 31 -- 28 & 0x0     & Normal (verbose) Data \\
+     & 23 -- 20 & 0 -- 11 & ADC Number \\
+     & 19 -- 16 & 0 -- 3  & ADC Channel\\
+     & 15 --  0 &         & Data \\
+\hline
+STAT & 31 -- 28 & 0x1     & Status Information word. E.g. to signal a broken channel \\
+     & 27 -- 24 &         & Type \\
+     & 23 --  0 &         & Information \\
+\hline
+INFO & 31 -- 28 & 0x2     & Configuration of the device. Information about ADC status. Only sent in trigger type 0xe events. Config words are sent for each ADC, the corresponding device is given in a HDR word.\\
+     & 27 -- 20 &         & Word type, see separate table\\
+     & 19 --  0 &         & Data \\
+\hline
+DAT2 & 31       & 1       & Compressed data word. Note the reduced bit width of 15 Bit. This type of word can only be sent after a HDR word.\\
+     & 30 -- 16 &         & First data word \\
+     & 14 --  0 &         & Second data word \\
+
+\hline
+\end{tabularx}
+
+
+\begin{tabularx}{\textwidth}{|c|c|X|}
+\hline
+\textbf{Type} & \textbf{Bits} & \textbf{Description} \\
+\hline
+0x01 & 10 --  0 & Configured buffer depth \\
+0x02 & 10 --  0 & Samples after trigger \\
+0x03 & 17 --  0 & Trigger threshold \\
+0x04 & 17 --  0 & Readout threshold \\
+0x05 &  7 --  0 & Number of ADC samples to sum before storing in Fifo \\
+     & 11 --  8 & Samples to average for baseline calculation (actual numer is 2**N of given value) \\
+     & 13 -- 12 & Number of blocks to process\\
+0x06 &  7 --  0 & Samples to sum before sending data (first block) \\
+     & 15 --  8 & Number of sums to be sent (first block) \\
+     & 19 -- 16 & Scaling factor (result is divided by 2**N before sending (first block)\\
+0x07 &          & See 0x06, but for second block \\     
+0x08 &          & See 0x06, but for third block \\     
+0x09 &          & See 0x06, but for fourth block \\     
+0x10 & 15 --  0 & Calculated baseline of first channel \\
+0x11 & 15 --  0 & See 0x10, but for second channel \\
+0x12 & 15 --  0 & See 0x10, but for third channel \\
+0x13 & 15 --  0 & See 0x10, but for fourth channel \\
+0x14 & 23 --  0 & Samples within last 100 ms for first channel\\
+0x15 & 23 --  0 & See 0x14, but for first channel\\
+0x16 & 23 --  0 & See 0x14, but for first channel\\
+0x17 & 23 --  0 & See 0x14, but for first channel\\
+\hline
+\end{tabularx}
+
+\subsubsection{Slow Control Registers}
+An up-to-date list of registers can be generated in daqtools/xml-db by running\\
+\verb!./xml-db2tex.pl -e ADC --pdf -o adc!\\
diff --git a/trb3/Makefile b/trb3/Makefile
new file mode 100644
index 0000000..fbbf3f0
--- /dev/null
+++ b/trb3/Makefile
@@ -0,0 +1,16 @@
+
+all: main clean
+
+pdflatex := pdflatex
+bibtex8 := bibtex8
+
+.PHONY: main
+main: main.tex biblio.bib
+	$(pdflatex) main.tex
+	$(pdflatex) main.tex
+
+
+.PHONY: clean
+clean:
+	-@rm *.toc *.log *.aux *.out *.bbl *.blg
+
diff --git a/trb3/main.tex b/trb3/main.tex
index fe47d0b..a064a3a 100644
--- a/trb3/main.tex
+++ b/trb3/main.tex
@@ -169,6 +169,10 @@
       \input{CtsAddOn}
     \subsection{General Purpose AddOn}
       \input{GPAddOn}
+    \clearpage  
+    \subsection{ADC AddOn}
+      \input{AdcAddOn}
+    \clearpage  
     \subsection{Padiwa}
       \input{WasaFrontend}